BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow 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.
content/locales/ar-SA/cross-app-sso.mdx
View on GitHub---
title: "تسجيل الدخول الأحادي بين التطبيقات"
description: "يميّز بين تسجيل الدخول المؤسسي عبر OIDC أو SAML واتحاد الهوية بين التطبيقات."
---
# تسجيل الدخول الأحادي للمؤسسة واتحاد التطبيقات
يسمح SSO للمؤسسة للموظفين باستخدام موفر هوية الشركة لتسجيل الدخول إلى نشر واحد. ينقل اتحاد التطبيقات الهوية المتحقق منها أو سياق المؤسسة بين عمليات نشر منفصلة، ولهما إعداد وحدود ثقة مختلفة.
تتيح صفحات تسجيل الدخول للتطبيقات الرسمية المسجلة بدقة إجراءً صريحًا بعنوان
"Continue with Agent-Native". يبدأ هذا الإجراء تدفق Dispatch الحالي للتحقق من
البريد الإلكتروني. وتشرح هذه الصفحة اتحاد الهوية عبر المتصفح وDesktop والخادم.
## اتحاد التطبيقات
### مساحة عمل Desktop
تسجيل الدخول إلى مساحة العمل إجراء صريح في إعدادات Desktop. عند تفعيله، يمكن لـ
Desktop تهيئة التطبيقات المسجلة المؤهلة من خلال وسيطه المخصص. يظل لكل تطبيق هدف
مخزن المستخدمين والجلسة وفحوصات الوصول الخاصة به. لا يعترض Desktop تنقل المتصفح
المجهول إلى صفحة تسجيل دخول التطبيق.
يكون التطبيق مؤهلا فقط عند تحقق الشروط التالية كلها:
- يفعّل Desktop SSO لمساحة العمل لهذا التطبيق.
- يكون عنوان الإنتاج HTTPS دقيقا.
- يحتوي Dispatch على تسجيل دقيق للتطبيق من جانب الخادم.
- تكون علامة الإطلاق <code>desktop.workspace-sso</code> مفعلة.
يكون التفضيل الخاص بالجهاز <code>desktopSsoEnabled</code> مفعلا افتراضيا. وتظل
القيمة false الصريحة خيار إلغاء. إذا لم تتوفر العلامة أو التفضيل أو التسجيل أو
فحص الأهلية، يظل تسجيل الدخول العادي لكل تطبيق متاحا.
### اتحاد من جانب الخادم
يستخدم الوسيط والمتصلون من جانب الخادم بروتوكولا قصير الأجل يتحقق منه الخادم.
يمكن لصفحات تسجيل الدخول للتطبيقات الرسمية المسجلة بدقة بدء البروتوكول نفسه بعد
أن يختار الشخص "Continue with Agent-Native":
1. يطلب المتصل ربطا دقيقا بتطبيق مسجل.
2. يتحقق Dispatch من هوية مساحة العمل ويعيد رمز تفويض قصير الأجل لمرة واحدة.
3. يستبدل خادم التطبيق الرمز باستخدام متحقق PKCE.
4. يتحقق التطبيق من التأكيد الموقع وربط التطبيق الدقيق وcallback والنطاق وnonce
ووقت الانتهاء.
5. يربط التطبيق مستخدما محليا أو ينشئه باستخدام البريد الإلكتروني المتحقق منه،
ثم يصدر جلسته المحلية العادية.
لا يعاد التأكيد إلا عبر التبادل بين الخوادم. ولا يظهر في عنوان URL للمتصفح وليس
رمز bearer قابلا لإعادة الاستخدام.
## اتحاد المؤسسات
تكون علامة <code>organization.cross-app-federation</code> متوقفة افتراضيا. عند
تفعيلها، يسجل التطبيق المصدر مؤسسته المحلية لدى Dispatch ويحفظ التعيين الدقيق
<code>(identity_authority, identity_id)</code>. لا يقبل التطبيق الهدف سوى معرّف
المؤسسة الأساسي واسمها ودور العضوية المتحقق منه من التأكيد الذي تحقق منه الخادم.
أسماء المؤسسات ونطاقات البريد وملفات تعريف الارتباط للمتصفح ليست مفاتيح ربط. تظل
المؤسسة المحلية التي بلا تعيين دون تغيير حتى إجراء ترحيل صريح. وتستمر العضويات
المرتبطة في استخدام فحوصات الوصول العادية للتطبيق الهدف.
يستخدم اتحاد المؤسسات بيانات اعتماد منفصلة لكل تطبيق مصدر مسجل:
- اضبط <code>AGENT_NATIVE_IDENTITY_FEDERATION_SECRET</code> في التطبيق المصدر.
- اضبط القيمة المطابقة
<code>AGENT_NATIVE_IDENTITY_FEDERATION_SECRET_<NORMALIZED_APP_ID></code>
في Dispatch.
- لا تعاود استخدام <code>A2A_SECRET</code> لحد السلطة هذا.
تستبدل لاحقة معرّف التطبيق كل سلسلة من المحارف غير الأبجدية الرقمية بشرطة
سفلية وتحول الناتج إلى أحرف كبيرة. على سبيل المثال، يستخدم معرّف التطبيق
<code>workspace-reports</code> المفتاح
<code>AGENT_NATIVE_IDENTITY_FEDERATION_SECRET_WORKSPACE_REPORTS</code>.
كتابات الهوية والمؤسسة إضافية فقط. يعاد استخدام المستخدم الحالي ذي البريد نفسه دون
تعديل. وينشئ البريد الإلكتروني المتحقق منه حديثا مستخدما محليا. ولا يؤدي تعطيل
الاتحاد إلى حذف البيانات.
## الإعداد
يحدد <code>AGENT_NATIVE_IDENTITY_HUB_URL</code> عنوان Dispatch لمسارات الخادم
والمتصفح عندما يحتاج تطبيق مستضاف ذاتيا إلى إعداد صريح. تعرض صفحات تسجيل الدخول
للتطبيقات الرسمية المسجلة بدقة إجراء "Continue with Agent-Native". تظل علامة
<code>browser.identity-sso</code> هي التي تتحكم في تسجيل الدخول الصامت
<code>prompt=none</code> والتهيئة بعد تسجيل الدخول المحلي. ويظل تسجيل الدخول
المحلي متاحا كخيار احتياطي.
في نشر Dispatch مستضاف ذاتيا، سجّل كل تطبيق مخصص بمعرّف التطبيق ومعرّف العميل
والأصل HTTPS ومسار callback وقدرة <code>identity-sso</code> الدقيقة عبر
<code>IDENTITY_SSO_APP_REGISTRY_JSON</code>.
يجب أن تستخدم تسجيلات الإنتاج HTTPS ومسار callback دقيقا. ولا يسمح بـ Localhost إلا
للتطوير المحلي. ترفض النطاقات الفرعية غير المعروفة ومعرّفات التطبيقات غير المتطابقة
والمسارات العشوائية وعمليات callback بين الأصول.
## التحقق والتراجع
بعد النشر:
1. تحقق من استمرار عمل البريد الإلكتروني وكلمة المرور والرابط السحري وموفري الخدمة
المكوّنين في المتصفح.
2. تحقق من ظهور إجراء "Continue with Agent-Native" ومن بقاء تسجيل الدخول المحلي
متاحا. عند إيقاف <code>browser.identity-sso</code> تحقق من استمرار الإجراء
الصريح وتسجيل الدخول المحلي. وعند تفعيله تحقق من الفحص الصامت
<code>prompt=none</code> ومن نموذج تسجيل الدخول المحلي كخيار احتياطي.
3. عند تفعيل Desktop SSO، تحقق من تطبيق مسجل بدقة من الإجراء الصريح في إعدادات Desktop.
4. عند تفعيل اتحاد المؤسسات، تحقق من معرّف المؤسسة الدقيق ودور العضوية في التطبيق الهدف.
للتراجع عن مسار المتصفح الصامت أو مسار Desktop، عطّل علامة الميزة المعنية. لإزالة
الإجراء الصريح من تطبيق مستضاف ذاتيا، أزل <code>AGENT_NATIVE_IDENTITY_HUB_URL</code>
أو تسجيل التطبيق الدقيق ثم أعد النشر. يظل تسجيل الدخول المحلي متاحا، وتبقى سجلات
الهوية والمؤسسة الإضافية دون تغيير.
## مستندات ذات صلة
- [المصادقة](/docs/authentication)
- [بروتوكول A2A](/docs/a2a-protocol)
- [Dispatch](/docs/dispatch)
- [الأمان ونطاق البيانات](/docs/security)
- [مساحات العمل متعددة التطبيقات](/docs/multi-app-workspace)
تسجيل الدخول المؤسسي عبر OIDC أو SAML يختلف عن اتحاد الهوية بين التطبيقات. يشرح [دليل النشر المُدار](/docs/administered-deployments) نموذج النشر المؤسسي. عند تفعيل `browser.identity-sso` يجري التطبيق فحصًا صامتًا عبر `prompt=none`، وتبقى صفحة تسجيل الدخول المحلية كخطة بديلة. راجع [تصميم الاتصال بين التطبيقات](/docs/cross-app-connect-design) للاتجاه المستقبلي.
## دليل طرح SSO للهوية في المتصفح
فعّل `browser.identity-sso` أولًا لبريد اختبار واحد. سجّل الدخول إلى Dispatch، ثم سجّل الخروج من التطبيق الهدف وأعد تحميله للتحقق من الفحص الصامت. كرّر الاختبار بدون جلسة hub وتأكد من ظهور نموذج الدخول المحلي عند `login_required`، ثم وسّع المجموعة بعد التحقق من الإلغاء. قد يتطلب التفعيل الأول إلغاء الجلسات الحالية مرة واحدة.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |