Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/authentication.mdx

View on GitHub
---
title: "المصادقة"
description: "تكامل أفضل للمصادقة مع البريد الإلكتروني/كلمة المرور ومقدمي الخدمات الاجتماعية والمؤسسات وبيانات اعتماد حامل MCP."
---

# المصادقة

تستخدم التطبيقات الأصلية للوكيل [Better Auth](https://better-auth.com) للمصادقة من خلال تصميم الحساب أولاً. يقوم المستخدمون بإنشاء حساب عند الزيارة الأولى ويحصلون على هوية حقيقية من اليوم الأول.

## نظرة عامة {#overview}

يتم تكوين المصادقة تلقائيًا عبر `autoMountAuth(app)` في البرنامج الإضافي لخادم المصادقة. هناك ثلاثة أوضاع:

- **الافتراضي:** روابط تسجيل الدخول السحرية أولاً في Better Auth عندما يكون البريد الصادر جاهزًا، مع استخدام البريد الإلكتروني/كلمة المرور كخيار احتياطي ومقدمي الخدمات الاجتماعية. اضبط `AUTH_MAGIC_LINK=0` لفرض الخيار الاحتياطي.
- **جهاز التحكم عن بعد MCP OAuth:** معيار OAuth 2.1 لمضيفي MCP مثل Claude Code وموصلات ChatGPT.
- **مخصص:** قم بإحضار المصادقة الخاصة بك عبر رد الاتصال `getSession`.

<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض ومضيفي MCP والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>

```html
<div class="auth-modes">
  <div class="diagram-col">
    <div class="diagram-card">
      <span class="diagram-pill accent">تقصير</span><strong>مصادقة أفضل</strong
      ><small class="diagram-muted"
        >email/password &middot; جوجل &middot; جيثب</small
      >
    </div>
    <div class="diagram-card">
      <span class="diagram-pill">جهاز التحكم عن بعد MCP OAuth</span
      ><strong>OAuth 2.1 + MCP</strong
      ><small class="diagram-muted">موصلات Claude Code، ChatGPT</small>
    </div>
    <div class="diagram-card">
      <span class="diagram-pill">مخصص</span><strong>رد اتصال getSession</strong
      ><small class="diagram-muted"
        >موظف &middot; مصادقة0 &middot; Firebase</small
      >
    </div>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-panel center">
    <span class="diagram-pill ok">AuthSession</span
    ><small class="diagram-muted"
      >بريد إلكتروني &middot; orgId &middot; orgRole</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-box">سياق الطلب &amp; نطاق البيانات</div>
</div>
```

```css
.auth-modes {
  display: flex;
  align-items: center;
  gap: 14px;
  flex-wrap: wrap;
}
.auth-modes .diagram-col {
  display: flex;
  flex-direction: column;
  gap: 10px;
}
.auth-modes .diagram-card {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: 10px 12px;
}
.auth-modes .diagram-arrow {
  font-size: 22px;
  line-height: 1;
}
.auth-modes .center {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 4px;
}
```

</Diagram>

تدفق المتصفح هو نفس تدفق المصادقة الأفضل في كل مكان - لا يوجد **تجاوز مصادقة التطوير**، ولا يعود `getSession()` أبدًا إلى حارس `local@localhost`. ما يتغير بين البيئات هو احتكاك الاشتراك، وليس جدار تسجيل الدخول:

| البيئة                  | سلوك التحميل الأول                                                                     | التحقق من البريد الإلكتروني                                |
| ----------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **التطوير المحلي**      | إنشاء حساب مطور سريعًا تلقائيًا وتسجيل دخولك (بدون جدار تسجيل الدخول)                  | يتم تخطيه افتراضيًا (وفي حالة عدم وجود مزود بريد إلكتروني) |
| **سؤال وجواب / معاينة** | اشتراك عادي، ولكن يمكن تخطي عملية التحقق حتى لا ينتظر المختبرون وصول البريد الإلكتروني | التخطي باستخدام `AUTH_SKIP_EMAIL_VERIFICATION=1`           |
| **الإنتاج**             | تسجيل/تسجيل مصادقة أفضل عادي                                                           | مطلوب (عند تكوين موفر البريد الإلكتروني)                   |

تقوم بعض الأعلام بضبط هذا؛ التفاصيل الكاملة موجودة في جدول [Environment Variables](#environment-variables):

- `AGENT_NATIVE_DISABLE_AUTO_DEV_ACCOUNT=1` — استخدم صفحة التسجيل العادية في حساب التطوير المحلي بدلاً من حساب التطوير التلقائي.
- `AUTH_DISABLED=true` - تخطي تسجيل الدخول/الاشتراك بالكامل وتشغيل كل طلب كمستخدم مشترك واحد (التطوير المحلي / المعاينات / العروض التوضيحية فقط، لا يتم الإنتاج مطلقًا مع مستخدمين حقيقيين).
- `AUTH_MODE=local` - يؤثر فقط على هوية CLI/الوكيل (التي يعمل بها مستخدم التطوير `pnpm action`)؛ إنه **ليس** تجاوزًا لتسجيل الدخول إلى المتصفح.

<Callout id="doc-block-18jli2j" tone="warning">

`AUTH_DISABLED=true` runs **every request as one shared user**. Use it only for local dev, previews, or demos — never in production with real users, where it would expose all data to anyone.

</Callout>

## تسجيل الدخول في التطوير المحلي {#local-development-sign-in}

على خادم تطوير يستخدم عنوان loopback، تعرض صفحة تسجيل الدخول المشتركة **Continue as local dev** أولًا. تنشئ حساب تطوير وجلسة حقيقيين في Better Auth أو تعيد استخدامهما، لذلك تستخدم مسار المصادقة نفسه المستخدم في بقية التطبيق.

اختر **Show full sign in options** لعرض خيارات التسجيل العادية وكلمة المرور والرابط السحري ومقدمي الخدمات الاجتماعية. إذا تعذر إنشاء الجلسة المحلية، تعرض الصفحة هذه الخيارات تلقائيًا حتى تتمكن من متابعة المصادقة القياسية.

تتوفر هذه الميزة فقط عندما يتصل المتصفح عبر `localhost` أو `127.0.0.0/8` أو `::1` في بيئة التطوير أو الاختبار. ويتم تعطيلها في معاينات النشر والإنتاج المستضاف. إنها ليست تجاوزًا للمصادقة. اضبط `AGENT_NATIVE_DISABLE_AUTO_DEV_ACCOUNT=1` لإلغاء الاشتراك وعرض صفحة تسجيل الدخول العادية في التطوير المحلي.

## مصادقة أفضل (افتراضي) {#better-auth}

بشكل افتراضي، تقوم Better Auth بتشغيل المصادقة. ويقدم:

- التسجيل عبر رابط سحري وتسجيل الدخول، مع البريد الإلكتروني/كلمة المرور كخيار احتياطي
- مقدمو الخدمات الاجتماعية (Google، وGitHub، وأكثر من 35 آخرين)
- المؤسسات ذات الأدوار والدعوات
- رموز JWT للوصول إلى API وA2A
- دعم الرمز المميز للعملاء الآليين

تم تثبيت مسارات المصادقة الأفضل على `/_agent-native/auth/ba/*`. يوفر إطار العمل أيضًا نقاط نهاية متوافقة مع الإصدارات السابقة:

- `GET /_agent-native/auth/session` — احصل على الجلسة الحالية
- `POST /_agent-native/auth/magic-link` — طلب رسالة بريد إلكتروني تحتوي على رابط سحري
- `POST /_agent-native/auth/login` — تسجيل الدخول بالبريد الإلكتروني/كلمة المرور
- `POST /_agent-native/auth/register` — إنشاء حساب
- `POST /_agent-native/auth/logout` — تسجيل الخروج

## مجالات ملفات تعريف الارتباط {#cookie-realms}

يتبع مجال ملف تعريف الارتباط للجلسة شكل النشر، لذا فإن التطبيقات التي تشترك في
تسجيل الدخول إلى قاعدة البيانات/مشاركة الأصل والتطبيقات التي لا تظل معزولة:

| شكل النشر                                      | مجال ملفات تعريف الارتباط                                                                                                    |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| تطبيق مستقل                                    | معزولة لكل تطبيق بواسطة سبيكة (`APP_NAME`، أو اسم الحزمة في المطور المحلي)؛ بادئة `an` مستقرة في الإنتاج                     |
| وضع مساحة العمل (`AGENT_NATIVE_WORKSPACE=1`)   | عالم مشترك واحد - تشترك تطبيقات مساحة العمل في الأصل وقاعدة البيانات                                                         |
| النطاقات الفرعية المخصصة لقاعدة البيانات نفسها | اشتراك في ملفات تعريف الارتباط المشتركة مع `COOKIE_DOMAIN`                                                                   |
| استضافة الطرف الأول (`*.agent-native.com`)     | مساحة اسم معزولة لكل تطبيق (لكل تطبيق قاعدة بيانات مصادقة خاصة به)؛ يتم تجاهل `COOKIE_DOMAIN=.agent-native.com` بشكل افتراضي |

يحتوي كل من التطبيقات المستضافة من الطرف الأول على قاعدة بيانات مصادقة خاصة به، لذا فإن تسجيل الدخول عبر التطبيقات
يمر عبر [Cross-App SSO](/docs/cross-app-sso) بدلاً من ملف تعريف الارتباط المشترك.
يجب أن توفر عمليات النشر هذه `APP_NAME` أو تطبيق مشتق URL (`APP_URL`, `URL`,
`DEPLOY_PRIME_URL`، أو `DEPLOY_URL`)؛ وإلا فسيفشل بدء التشغيل بدلاً من السقوط
الرجوع إلى اسم `an_session` المشترك. لمشاركة قاعدة بيانات مصادقة واحدة عن قصد
عبر النطاقات الفرعية، قم بتعيين `AGENT_NATIVE_SHARE_COOKIE_DOMAIN=1` جنبًا إلى جنب مع
`COOKIE_DOMAIN`.

## حسابات ضمان الجودة {#qa-accounts}

تتخطى عمليات التطوير والاختبارات المحلية التحقق من البريد الإلكتروني للتسجيل بشكل افتراضي، لذا
إنشاء حسابات بريد إلكتروني/كلمات مرور حقيقية دون انتظار البريد الوارد. للقوة
التحقق محليًا أثناء اختبار هذا التدفق، قم بتعيين `AUTH_SKIP_EMAIL_VERIFICATION=0`.

بالنسبة لبيئات ضمان الجودة المستضافة حيث يحتاج المختبرون إلى حسابات حقيقية ولكن لا ينبغي عليهم الانتظار
عند تسليم البريد الإلكتروني، قم بتعيين:

```bash
AUTH_SKIP_EMAIL_VERIFICATION=1
```

عند تعيين هذه العلامة، لا يتطلب الاشتراك بالبريد الإلكتروني/كلمة المرور بريدًا إلكترونيًا
لم يتم إرسال التحقق والبريد الإلكتروني للتحقق من الاشتراك. استخدمه فقط من أجل ضمان الجودة
أو معاينة البيئات، وتسمية حسابات الاختبار بعنوان `+autoz`
(`name+autoz@example.com`) حتى يسهل التعرف عليها.

## سياسة التحقق من البريد الإلكتروني {#email-verification-policy}

`AUTH_SKIP_EMAIL_VERIFICATION` هو وسيلة راحة محلية ولضمان الجودة — وتتجاهله أي
عملية نشر مُستضافة. لتحديد السياسة لأي بيئة، بما في ذلك الإنتاج، صرِّح بها في
الإعدادات:

```ts
defineAppConfig({ auth: { requireEmailVerification: false } });
```

الاسم المستعار للنشر هو `AUTH_REQUIRE_EMAIL_VERIFICATION=0`. القيمة المُصرَّح بها
تتفوق على `AUTH_SKIP_EMAIL_VERIFICATION` وعلى الافتراضي الخاص بكل بيئة معًا.

تقبل القيمة `false` عنوانًا غير مُتحقق منه كبيانات اعتماد لتسجيل الدخول — إذ
يمكن لأي شخص المطالبة بأي بريد إلكتروني — لذا استخدمها فقط حيث يكون الاشتراك
مقيدًا بالفعل بطريقة أخرى. أما `true` في عملية نشر بلا مزوّد بريد إلكتروني فتعطل
الاشتراك بكلمة مرور بدلًا من ذلك، لأن رسالة التحقق لن يمكن تسليمها أبدًا.

## مقدمو الخدمات الاجتماعية {#social-providers}

قم بتعيين متغيرات البيئة لتمكين تسجيل الدخول الاجتماعي. تكتشفها المصادقة الأفضل تلقائيًا:

```bash
# Google OAuth
GOOGLE_SIGN_IN_CLIENT_ID=your-low-scope-sign-in-client-id
GOOGLE_SIGN_IN_CLIENT_SECRET=your-low-scope-sign-in-client-secret

# احتياطي متوافق مع الإصدارات السابقة وبيانات اعتماد الموفر OAuth للقوالب
# التي تتصل بـ Google واجهات برمجة التطبيقات مثل Gmail أو Calendar.
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret

# GitHub OAuth
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret
```

تعرض النماذج التي تستخدم `createGoogleAuthPlugin()` صفحة "تسجيل الدخول باستخدام Google". يعالج رد الاتصال Google OAuth الارتباط العميق للجوال للتطبيقات الأصلية تلقائيًا.

يُفضل `GOOGLE_SIGN_IN_CLIENT_ID` / `GOOGLE_SIGN_IN_CLIENT_SECRET` للوضع العادي
تسجيل الدخول للتطبيق. يجب أن يطلب هذا العميل نطاقات الهوية فقط. احتفظ
`GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` لعمليات تكامل المنتجات التي تحتاج إلى
نطاقات Google API، أو كبديل قديم عندما لا يتم تقسيم النشر
حتى الآن. يجب أن تستخدم تطبيقات البريد والتقويم عملاء المزودين الخاصين بها OAuth لذلك
لا تؤثر شاشات الموافقة واسعة النطاق على تسجيل الدخول العام إلى التطبيق.

### توقيع الحالة OAuth {#oauth-state-secret}

قم بتعيين `OAUTH_STATE_SECRET` على قيمة عشوائية تزيد عن 32 حرفًا في الإنتاج، بحيث تكون مظاريف الحالة OAuth (Google وAtlassian وZoom) موقعة بـ HMAC بمفتاح مخصص مستقل عن أي سر لجهة خارجية. راجع [Security — OAuth State Signing](/docs/security#oauth-state) للاطلاع على المتطلبات الكاملة ونموذج التهديد.

## المنظمات {#organizations}

يوفر إطار العمل نظامًا تنظيميًا مدمجًا. هذه هي وحدة `org/` الخاصة بإطار العمل - والمدعومة بجداول `organizations` و`org_members` - وليست مكونًا إضافيًا لمؤسسة Better Auth، والذي لم يتم تسجيله عمدًا. يدعم كل تطبيق:

- إنشاء المنظمات
- دعوة الأعضاء بأدوار (`owner`، `admin`، `member`)
- تبديل المؤسسة النشطة
- تحديد نطاق البيانات لكل مؤسسة عبر أعمدة `org_id`

يتم تعقب المؤسسة النشطة في الجلسة باسم `session.orgId`، ويؤدي تبديل المؤسسات إلى تغيير البيانات التي يراها المستخدم والوكيل. يحدث تحديد نطاق البيانات نفسه في أسفل المكدس - راجع [Security & Data Scoping](/docs/security#data-scoping) للتعرف على خط أنابيب `session.orgId → AGENT_ORG_ID → SQL` الكامل ووحدات حماية الوصول. تغطي مستندات [Multi-Tenancy](/docs/multi-tenancy) سطح إدارة المؤسسة.

## رموز حامل MCP الثابتة {#access-tokens}

`ACCESS_TOKEN` و`ACCESS_TOKENS` ليسا بمثابة مصادقة للمتصفح ولا يجعلان التطبيق خاصًا. وتظل فقط بمثابة بيانات اعتماد حامل ثابتة لعملاء MCP/connect الذين لا يمكنهم استخدام تدفق OAuth.

```bash
# رمز مميز واحد
ACCESS_TOKEN=my-secret-token

# رموز مميزة متعددة
ACCESS_TOKENS=token1,token2,token3
```

لا يؤدي تكوين هذه المتغيرات أبدًا إلى عرض صفحة تسجيل دخول مميزة للزائرين. يظل تسجيل الدخول عبر الويب على Better Auth أو موفر `getSession` المخصص لديك.

## جهاز التحكم عن بعد MCP OAuth {#remote-mcp-oauth}

يمكن أن تعمل نقطة نهاية MCP لكل تطبيق كمورد MCP قياسي محمي. يمكن تكوين العملاء القادرين على OAuth باستخدام MCP URL البعيد فقط:

```text
https://mail.agent-native.com/mcp
```

تقوم طلبات MCP غير المصادق عليها بإرجاع تحدي `WWW-Authenticate` الذي يشير إلى `/.well-known/oauth-protected-resource`. يكتشف العميل بعد ذلك بيانات تعريف OAuth الخاصة بالتطبيق، ويسجل عميلًا عامًا ديناميكيًا، ويفتح صفحة ترخيص التطبيق، ويتبادل رمز التفويض مع PKCE للوصول إلى الرموز المميزة وتحديثها.

<Diagram id="doc-block-awngem" title={"البعيد MCP OAuth المصافحة"} summary={"يبدأ تشغيل العميل القادر على OAuth من مجرد التحدي MCP URL - والاكتشاف والتسجيل الديناميكي، ثم تبادل التعليمات البرمجية PKCE."}>

```html
<div class="mcp-flow">
  <div class="diagram-node">
    1 &middot; طلب MCP<br /><small class="diagram-muted">لا رمز</small>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-node warn">
    2 &middot; تحدي 401<br /><small class="diagram-muted"
      >WWW-Authenticate</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-node">
    3 &middot; اكتشف البيانات الوصفية<br /><small class="diagram-muted"
      >.well-known</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-node">
    4 &middot; تسجيل العميل<br /><small class="diagram-muted"
      >ديناميكية، عامة</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-node">
    5 &middot; تفويض + MCP<br /><small class="diagram-muted">تبادل الكود</small>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-node ok">
    6 &middot; الوصول + التحديث<br /><small class="diagram-muted"
      >audience-bound</small
    >
  </div>
</div>
```

```css
.mcp-flow {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-wrap: wrap;
}
.mcp-flow .diagram-node {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: 8px 12px;
}
.mcp-flow .diagram-arrow {
  font-size: 20px;
  line-height: 1;
}
```

</Diagram>

يتم توقيع رموز الوصول باستخدام `A2A_SECRET` عند تعيينها، وإلا مع `BETTER_AUTH_SECRET`. وهي تحمل هوية المستخدم/المؤسسة الموقعة ونطاقات `mcp:read` و/أو `mcp:write` و/أو `mcp:apps` and `offline_access`، وهي مرتبطة بالجمهور بمورد MCP الدقيق URL. يتم تخزين رموز التحديث فقط كتجزئة ولا يتم تدويرها: يعيد التحديث الرمز نفسه، ولا تنتهي صلاحية منح التحديث في موعد ثابت، مع إمكانية إبطالها. يعيد كل طلب وكل تحديث التحقق من أن المستخدم لا يزال عضوًا في مؤسسة الرمز، لذلك يفقد العضو المحذوف وصوله إلى MCP عند طلبه التالي. يتم تشغيل استدعاءات الأدوات وقراءات موارد تطبيقات MCP داخل نفس سياق الطلب مثل المستخدم الذي قام بتسجيل الدخول؛ لا يتلقى إطار iframe لتطبيق MCP المضمن رموز OAuth الأولية أبدًا.

تسجّل رموز تفويض MCP ورموز التحديث الجديدة مالكها وقت الإصدار. ترفض عمليات استبدال الرموز المنح القديمة غير المرتبطة بمالك أو عدم تطابق ربط المالك، وتعيد `invalid_grant` دون استنتاج مالك للمنح القديمة. يؤدي تغيير البريد الإلكتروني المقصود إلى تحديث هوية الإصدار. ويؤدي ذلك أيضًا إلى إيقاف العنوان القديم: تُرفض رموز الوصول ورموز Connect الموقّعة له قبل التغيير، ولا تُصدر له رموز جديدة ما لم يسجّل حساب هذا العنوان من جديد. يحصل عملاء OAuth على رموز للعنوان الجديد عند تحديثهم التالي. يُلغي إخراج العضو المنح أو يحذفها دون نقل ربط الإصدار.

يتطلب تحديث ربط مالك OAuth أن يُجرى [اتصال جديد مرة واحدة](/docs/external-agents#reconnect) لكل اتصال OAuth قائم. تُرفض رموز وصول OAuth القديمة بعد طرح التحديث. تُعيد رموز التحديث القديمة غير المرتبطة بمالك `invalid_grant`، ويجب إعادة بدء الموافقة لرموز التفويض القديمة التي لم تُستخدم بعد. تستخدم رموز الوصول الصادرة حديثًا مدة الصلاحية المضبوطة، وتخضع لفحوص العضوية المباشرة. لا يغيّر هذا الانتقال بيانات اعتماد `mcp-connect` القديمة بتنسيق A2A أو رموز A2A بين التطبيقات. ويجب أيضًا إعادة الاتصال للاتصالات التي تستخدم رموز Connect القديمة بتنسيق OAuth.

يكتب `npx @agent-native/core@latest connect <url> --client claude-code` إدخال URL فقط MCP لهذا التدفق القياسي. بالنسبة للعملاء الذين لا يمكنهم تنفيذ MCP OAuth عن بعد، استخدم صفحة الاتصال أو البديل `npx @agent-native/core@latest connect --token <token>` لكتابة إدخال صريح للرمز المميز للحامل.

## إحضار المصادقة الخاصة بك {#byoa}

قم بتمرير رد اتصال `getSession` مخصص لاستخدام أي موفر مصادقة (Clerk، Auth0، Firebase، وما إلى ذلك):

```ts
// server/plugins/auth.ts
import { createAuthPlugin } from "@agent-native/core/server";

export default createAuthPlugin({
  getSession: async (event) => {
    // Your custom auth logic here
    const session = await myAuthProvider.verify(event);
    if (!session) return null;
    return { email: session.email };
  },
  publicPaths: ["/api/webhooks"],
});
```

يجب أيضًا تهيئة رد الاتصال الاختياري `AuthOptions.getBrowserSession` للمصادقة المخصصة من أجل إمكانات واجهة المستخدم وموافقات المتصفح. يقبل `H3Event` ويعيد `AuthSession | null`، مثل `getSession`، لكن يجب أن يقرأ ملفات تعريف ارتباط المتصفح فقط، ولا يقرأ مطلقًا رموز الحامل أو رموز الاستعلام أو أي ترويسات أخرى. من دون هذا الخطاف الصريح، تُرجع هذه العمليات المخصصة للمتصفح `401`.

## تطبيقات مساحة العمل العامة {#public-workspace-apps}

تعتبر تطبيقات مساحة العمل داخلية بشكل افتراضي. للسماح للزائرين المجهولين بتحميل ملف عام
الموقع مع الاحتفاظ بصفحات الإدارة خلف المصادقة، قم بإعلان الوصول إلى المسار
`apps/<id>/package.json`:

```json
{
  "agent-native": {
    "workspaceApp": {
      "audience": "public",
      "protectedPaths": ["/admin"]
    }
  }
}
```

بالنسبة للشكل المعكوس، احتفظ بالجمهور الداخلي الافتراضي واعرضه فقط
صفحات عامة محددة:

```json
{
  "agent-native": {
    "workspaceApp": {
      "publicPaths": ["/", "/share"]
    }
  }
}
```

يستخدم `publicPaths` و`protectedPaths` مطابقة البادئات، لذا فإن `"/admin"` أيضًا
يغطي `"/admin/users"`. تفتح هذه الإعدادات التنقل في الصفحة فقط. الإطار
لا تزال المسارات (`/_agent-native/*`) ومسارات API المخصصة (`/api/*`) بحاجة إلى مصادقة
ما لم يضيف التطبيق هذه البادئات بشكل صريح إلى
`createAuthPlugin({ publicPaths: [...] })`.

## الجلسة API {#session-api}

كائن الجلسة الذي تم إرجاعه بواسطة `getSession(event)` له هذا الشكل:

```ts
interface AuthSession {
  email: string; // User's email (primary identifier)
  userId?: string; // Better Auth user ID
  token?: string; // Session token
  name?: string; // Display name from the auth provider, when available
  image?: string; // Profile image from the auth provider, when available
  orgId?: string; // Active organization ID
  orgRole?: string; // Role in active org (owner/admin/member)
}
```

على العميل، استخدم الخطاف `useSession()`:

```ts
import {
  useSession,
} from "@agent-native/core/client/hooks"
function MyComponent() {
  const { session, isLoading } = useSession();
  if (isLoading) return <p>Loading...</p>;
  if (!session) return <p>Not signed in</p>;
  return <p>Hello, {session.email}</p>;
}
```

## تسجيل الدخول باستخدام Return URL {#sign-in-return-url}

النماذج التي تحتوي على **صفحات عامة** (مشاركة الروابط والتضمينات وصفحات التسويق) غالبًا ما تحتاج إلى CTA داخل الصفحة والذي يطلب من المشاهدين المجهولين تسجيل الدخول وإعادتهم إلى الصفحة التي كانوا فيها. يوفر إطار العمل نقطة دخول واحدة لهذا:

```
/sign-in?return=<same-origin-path>
```

عندما يصل عارض مجهول إلى URL، يتم عرض صفحة تسجيل الدخول الخاصة بإطار العمل. بعد تسجيل الدخول بنجاح (أي تدفق — الرمز المميز أو البريد الإلكتروني/كلمة المرور أو Google OAuth)، يتم تحويل العارض إلى `return`.

تم التحقق من صحة المعلمة `return` باعتبارها **مسارًا من نفس الأصل**. مراجع مسار الشبكة (`//evil.com/...`)، وURLs المطلقة، ومخططات `data:` / `javascript:`، وأحرف التحكم المضمنة كلها تعود إلى `/`. تتم إعادة إنشاء المسار الذي تم التحقق من صحته من المحلل اللغوي URL، ولم يتم تكراره مرة أخرى من الإدخال.

**من مكون React:**

```tsx
import { Button } from "@/components/ui/button";

function SignInCta() {
  const onClick = () => {
    const ret = window.location.pathname + window.location.search;
    window.location.href = "/sign-in?return=" + encodeURIComponent(ret);
  };
  return <Button onClick={onClick}>Sign in</Button>;
}
```

### المسارات الخاصة ذات الإشارات المرجعية

تستخدم صفحات التطبيق العادية غلاف SSR واحدًا عامًا وقابلاً للتخزين المؤقت لجميع الزوار. يتحقق `AppProviders` من الجلسة على العميل؛ وفي مسار خاص مثل `/dashboard` يعيد توجيه الزائر المجهول إلى `/sign-in?return=%2Fdashboard` قبل عرض واجهة التطبيق الخاصة. بعد تسجيل الدخول يعود الزائر إلى `/dashboard`. استخدم `isPublicPath` للمسارات العامة أو مسارات SEO، أو `sessionBypass` لسطح تتم مصادقته بآلية محددة أخرى مثل رمز تضمين MCP.

مدة تخزين هذا الغلاف مؤقتًا هي إعداد على مستوى عملية النشر بأكملها — انظر [SSR Caching](/docs/ssr-caching) لـ `AGENT_NATIVE_SSR_CACHE`. تقصير التخزين المؤقت أو تعطيله يغيّر المدة فقط؛ لا يزال SSR يعرض الفرع المجهول مع إزالة ملفات تعريف الارتباط.

### خلف الكواليس: Google OAuth

يربط كلا التدفقين (نقطة الدخول `/sign-in` الصريحة وحالة المسار ذي الإشارة المرجعية) الإرجاع URL خلال حالة OAuth. الولاية موقعة بـ HMAC، لذا لا يمكن تزويرها أثناء النقل. في رد الاتصال، تتم إعادة التحقق من صحة الإرجاع URL باعتباره نفس الأصل قبل إعادة التوجيه - لذلك لا يزال من غير الممكن تحويل مفتاح التوقيع المسرب إلى أوراكل إعادة توجيه مفتوحة.

إذا كان القالب الخاص بك يلتف حول `/_agent-native/google/auth-url` مباشرةً (على سبيل المثال، تقوم قوالب البريد والتقويم بذلك لتوسيع النطاقات)، فاقبل استعلام `?return=<path>` وأعد توجيهه عبر نموذج كائن الخيارات `encodeOAuthState`:

```ts
const returnUrl = getQuery(event).return;
const state = encodeOAuthState({
  redirectUri,
  desktop,
  returnUrl: typeof returnUrl === "string" ? returnUrl : undefined,
});
```

يقوم مسار `/_agent-native/google/auth-url` الافتراضي بذلك تلقائيًا - ولا يتم التجاوز إلا إذا كان القالب الخاص بك يحتاج إلى معالجة OAuth مخصصة.

## متغيرات البيئة {#environment-variables}

| متغير                                   | الغرض                                                                                                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `BETTER_AUTH_SECRET`                    | مفتاح التوقيع لمصادقة أفضل (يتم إنشاؤه تلقائيًا إذا لم يتم تعيينه)                                                                                                       |
| `AUTH_SKIP_EMAIL_VERIFICATION`          | قم بالتعيين على `1` في بيئات ضمان الجودة/المعاينة للسماح بمتابعة عمليات الاشتراك في البريد الإلكتروني/كلمة المرور دون التحقق؛ يتم تخطي التطوير/الاختبار المحلي افتراضيًا |
| `AUTH_REQUIRE_EMAIL_VERIFICATION`       | عيِّنه على `0` أو `1` لتحديد سياسة التحقق لاشتراكات كلمة المرور في أي بيئة، بما في ذلك الإنتاج؛ يتفوق على `AUTH_SKIP_EMAIL_VERIFICATION`                                 |
| `AUTH_DISABLED`                         | اضبط على `true` أو `1` لتخطي تسجيل الدخول/الاشتراك؛ يتم تشغيل جميع الطلبات كمستخدم واحد مشترك (للتطوير/المعاينة المحلية فقط - وليس للإنتاج مع مستخدمين حقيقيين)          |
| `AGENT_NATIVE_DISABLE_AUTO_DEV_ACCOUNT` | اضبط على `1` لتعطيل تسجيل الدخول التلقائي للمضيف المحلي في قاعدة بيانات جديدة للمطورين                                                                                   |
| `AUTH_MODE`                             | يحل `local` هوية CLI/الوكيل فقط (الذي يعمل عليه مستخدم التطوير `pnpm action`)؛ لا تقم أبدًا بتجاوز تسجيل الدخول إلى المتصفح                                              |
| `COOKIE_DOMAIN`                         | الاشتراك في ملفات تعريف الارتباط للجلسة المشتركة عبر النطاقات الفرعية لقاعدة البيانات نفسها (راجع [Cookie Realms](#cookie-realms))                                       |
| `AGENT_NATIVE_WORKSPACE`                | يتم تشغيل `1` في وضع مساحة العمل — نطاق جلسة مشتركة واحدة عبر تطبيقات مساحة العمل                                                                                        |
| `AGENT_NATIVE_SHARE_COOKIE_DOMAIN`      | قم بالتعيين باستخدام `COOKIE_DOMAIN` لمشاركة قاعدة بيانات مصادقة واحدة عبر النطاقات الفرعية للطرف الأول                                                                  |
| `OAUTH_STATE_SECRET`                    | مفتاح HMAC مخصص لمظاريف حالة OAuth (راجع [Security — OAuth State Signing](/docs/security#oauth-state))                                                                   |
| `GOOGLE_SIGN_IN_CLIENT_ID`              | معرف عميل Google OAuth المفضل لتسجيل الدخول إلى التطبيق                                                                                                                  |
| `GOOGLE_SIGN_IN_CLIENT_SECRET`          | سر Google OAuth المفضل منخفض النطاق لتسجيل الدخول إلى التطبيق                                                                                                            |
| `GOOGLE_CLIENT_ID`                      | الإجراء الاحتياطي القديم لتسجيل الدخول إلى Google، ومعرف العميل OAuth للموفر لعمليات تكامل Google API                                                                    |
| `GOOGLE_CLIENT_SECRET`                  | الإجراء الاحتياطي القديم لتسجيل الدخول إلى Google، وسر الموفر OAuth لعمليات تكامل Google API                                                                             |
| `GITHUB_CLIENT_ID`                      | تمكين GitHub OAuth                                                                                                                                                       |
| `GITHUB_CLIENT_SECRET`                  | GitHub OAuth سر                                                                                                                                                          |
| `ACCESS_TOKEN`                          | الحامل الاحتياطي الثابت لعملاء MCP/connect؛ ليست مصادقة المتصفح                                                                                                          |
| `ACCESS_TOKENS`                         | احتياطيات حامل ثابت مفصولة بفواصل لعملاء MCP/connect؛ ليست مصادقة المتصفح                                                                                                |
| `A2A_SECRET`                            | السر المشترك للتحقق من هوية A2A عبر التطبيقات الموقعة بواسطة JWT، وتوقيع رمز الوصول MCP OAuth، عند وجوده،                                                                |

تتحكم علامة Dispatch الافتراضية المتوقفة `desktop.workspace-sso` في الإتاحة فقط؛ وتظل فحوص المصادقة والتوقيع وnonce والأصل والاستدعاء والجلسة والإلغاء إلزامية دائمًا. عند توقف العلامة أو تعذر قراءتها، لا يغيّر Desktop تسجيل الدخول أو الخروج لكل تطبيق ولا إعداداته.
علامة وكيل مستخدم Canary هي تلميح للإتاحة وليست إثباتًا عن بُعد؛ ولا تعتمد عليها المصادقة أو التفويض.
تتعرف التطبيقات المستضافة الأساسية على طلبات Desktop SSO Canary المجمعة من دون إعداد بيئة مركز هوية لكل تطبيق. وتبقى المتصفحات العادية على تسجيل الدخول المعتاد لكل تطبيق. تحتاج التطبيقات ذاتية الاستضافة إلى `AGENT_NATIVE_IDENTITY_HUB_URL` فقط لمسار Desktop الصريح أو اتحاد الخادم المتبقي. لا تبدأ إصدارات Desktop المستقرة الوسيط قبل الموافقة على إصدار لاحق بشكل منفصل.
لا يعترض إصدار Canary تنقّل تسجيل الدخول المجهول للتطبيق. يجب على المستخدم اختيار تسجيل الدخول إلى مساحة العمل صراحةً من إعدادات سطح المكتب للتطبيق المسجّل النشط؛ ويظل تسجيل الدخول العادي للتطبيق هو المسار الافتراضي.

## تخصيص صفحة تسجيل الدخول

يضبط قالب Chat القيمة `marketing: false` في `server/plugins/auth.ts`. يؤدي توفير كائن marketing إلى تفعيل اللوحة، وتظهر أسفل النموذج على الهاتف. يصف `AuthMarketingProps` خصائص الصفحة المعروضة، ويقبل المكون حقول `marketing` أدناه. يضيف `authHeadHtml` محتوى HTML موثوقًا كتبه التطبيق بعد الأنماط المضمنة. لا تمرر إليه مدخلات المستخدم.

```ts filename="server/plugins/auth.ts"
import { createToolkitAuthPlugin } from "@agent-native/toolkit/app/auth/server";

export default createToolkitAuthPlugin({
  rootAuth: true,
  marketing: { appName: "My app", tagline: "Make work easier" },
  authHeadHtml: "<style>.auth-root { font-family: sans-serif; }</style>",
});
```

## النشر المُدار وتسجيل الدعوات

للنشر المُدار، اضبط `AUTH_SIGNUP=invited` و`ORG_CREATION=closed` و`AUTO_CREATE_DEFAULT_ORG=0`. يشرح [دليل النشر المُدار](/docs/administered-deployments) حسابات مسؤولي التهيئة، والدعوات، والنطاقات المسموح بها. دعوة العضوية وسياسة الانضمام عبر النطاق قاعدتان منفصلتان.
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall