> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# المؤسسات لتطبيقات B2B: الأعضاء والأدوار وSSO للشركات

> نمذج عملاءك من الشركات كمؤسسات في Didit Authentication، مع الأعضاء والأدوار والدعوات والنطاقات الموثّقة والانضمام التلقائي وSSO خاص بكل مؤسسة.

تتيح المؤسسات في Didit Authentication لتطبيق B2B الخاص بك تجميع مستخدميه حسب الشركة التي يعملون فيها.
لكل مؤسسة أعضاؤها وأدوارها الخاصة، ويمكنها التحقق من نطاقات بريدها الإلكتروني حتى ينضم زملاؤها تلقائياً، ويمكنها تسجيل دخول أفرادها عبر مزوّد الهوية الخاص بها باستخدام SAML أو OIDC.
يقرأ تطبيقك المؤسسات والأدوار الخاصة بالشخص من الـ token والجلسة، ويحدد ما يمكن لكل دور أن يفعله.

> [!NOTE]
>
> المؤسسة هنا هي واحدة من **عملائك** داخل تطبيقك.
> وهي منفصلة عن مؤسستك في Didit، التي تضم فريقك في Business Console.

## تفعيل المؤسسات

المؤسسات متوقفة افتراضيًا في التطبيق الجديد.
افتح **Authentication > Organizations** في لوحة التحكم، ثم في بطاقة **Settings**:

* فعّل **Organizations**.
* اختر **Default role for new members**، وهو الدور الذي يحصل عليه الأشخاص عند الانضمام عبر نطاق موثّق أو تسجيل الدخول الموحد (`member` افتراضيًا).
* أبقِ **Require MFA for organization admins** مفعّلًا، وهي سياسة المصادقة متعددة العوامل الافتراضية (راجع [أدناه](#المصادقة-متعددة-العوامل-لمسؤولي-المؤسسات)).

بعد ذلك تدير المؤسسات من لوحة التحكم: يُنشئ زر **New organization** مؤسسة باسمها ومعرّف مختصر (slug) فريد داخل التطبيق.
يُنشئ فريقك المؤسسات، ولا يستطيع الأشخاص إنشاء مؤسساتهم الخاصة من تطبيقك حتى الآن.
تعرض القائمة الأعضاء والنطاقات الموثّقة وحالة تسجيل الدخول الموحد وقاعدة المصادقة متعددة العوامل وتاريخ الإنشاء لكل مؤسسة، وتعرض فوقها المقاييس الرئيسية عدد المؤسسات والأعضاء واتصالات تسجيل الدخول الموحد والنطاقات الموثّقة.

![صفحة Organizations في لوحة تحكم أعمال Didit، تعرض المقاييس الرئيسية وقائمة المؤسسات مع أعضائها ونطاقاتها الموثّقة وحالة تسجيل الدخول الموحد](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## الأعضاء والأدوار

يمكن للشخص أن ينتمي إلى عدة مؤسسات ضمن تطبيقك، ولكل منها دور واحد.

| الدور | الغرض |
| - | - |
| `admin` | الأشخاص الذين يديرون المؤسسة في تطبيقك. |
| `member` | كل شخص آخر. وهو الدور الافتراضي. |
| `billing` | الأشخاص الذين يتولون فوترة المؤسسة في تطبيقك. |

في خطتي Scale وEnterprise، وفي كل تطبيق في البيئة التجريبية، يمكنك أيضًا تحديد **أدوار مخصصة**، لكل منها مفتاح والصلاحيات التي يتحقق منها تطبيقك، على سبيل المثال `payouts.approve`.
يمكن للعضو أن يحمل دورًا مخصصًا إلى جانب دوره.

افتح مؤسسة لعرض تسجيل الدخول الموحد الخاص بها، والنطاقات الموثّقة، والأعضاء، والأدوار، والدعوات.

![مؤسسة مفتوحة في Didit Business Console، تعرض تسجيل الدخول الموحد عبر SAML مع رابط الإعداد، ونطاقًا موثقًا مع الانضمام التلقائي، وأعضاءها وأدوارها](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

تسجيل الدخول الموحد للمؤسسة، والنطاقات الموثّقة، والأعضاء، والأدوار.

## الدعوات

اختر **Invite member** في إحدى المؤسسات، وأدخل حتى 20 عنوان بريد إلكتروني والدور الذي سيحصل عليه كل شخص (`admin` أو `member` أو `billing`)، وسيرسل Didit إلى كل شخص دعوة عبر البريد الإلكتروني.
تبقى الدعوة سارية لمدة 7 أيام، وتفتح صفحة `/invite` المستضافة على أصل تسجيل الدخول الخاص بك، حيث يسجّل الشخص الدخول أو ينشئ حسابًا ثم ينضم إلى المؤسسة.
تعرض قائمة **Invitations** الخاصة بالمؤسسة موعد انتهاء كل دعوة، مع الخيارين **Resend** و**Revoke**.

## النطاقات الموثّقة والانضمام التلقائي

يمكن للمؤسسة أن تُثبت ملكيتها لنطاق بريد إلكتروني:

1. أضف النطاق إلى المؤسسة.
2. أضف سجل TXT الذي يعرضه Didit على `_didit-auth.<domain>` لدى مزوّد DNS لديك، ويحتوي على رمز التحقق.
3. تحقّق من النطاق. يظهر بالحالة **Verified** بعد العثور على السجل.

مع تفعيل **Auto-join** لنطاق موثّق، ينضم الشخص الذي يسجّل الدخول ببريد إلكتروني موثّق في ذلك النطاق إلى المؤسسة تلقائياً، بالدور الافتراضي الذي حددته.
لا يمكن لنطاق أن يُفعّل الانضمام التلقائي إلا لمؤسسة واحدة من تطبيقك.

## تسجيل الدخول الموحّد للشركات

يمكن للمؤسسة أن تسجّل دخول أعضائها عبر مزوّد الهوية الخاص بها، باستخدام SAML أو OIDC.

* **رابط الإعداد.** اختر **Copy setup link** من بطاقة **Single sign-on** الخاصة بالمؤسسة، وشاركه بأمان مع مسؤول تقنية المعلومات في المؤسسة. يعمل الرابط لمدة سبعة أيام، ويرشدهم خلال خطوات ربط الاتصال. تتطلب روابط الإعداد خطة Scale أو Enterprise، أما تطبيقات البيئة التجريبية فتتوفر فيها هذه الروابط على أي خطة.
* **SAML.** تُنشر بيانات تعريف مزوّد الخدمة الخاصة بك على `{origin}/sso/saml/metadata/`.
* **العثور على الاتصال.** تعثر صفحة تسجيل الدخول المستضافة على اتصال المؤسسة من نطاق البريد الإلكتروني الذي تم التحقق منه للشخص، أو من **Use single sign-on**، أو من `organization=<slug>` في عنوان تسجيل الدخول.
* **الحالة.** تُظهر قائمة المؤسسات ما إذا كان كل اتصال نشطًا، أو غير مُعدّ، أو بانتظار رابط إعداد تم إرساله.

ينضم الأشخاص الذين يسجّلون الدخول عبر مزوّد الهوية الخاص بالمؤسسة إليها بالدور الافتراضي الخاص بك.
توجد حقول إعداد كل بروتوكول في [طرق تسجيل الدخول](https://docs.didit.me/ar/authentication/sign-in-methods.md#تسجيل-الدخول-الموحّد-للمؤسسة).

## المصادقة متعددة العوامل لمسؤولي المؤسسات

السياسة الافتراضية للمصادقة متعددة العوامل، `organization_admins`، تُلزم بعامل ثانٍ من كل شخص يحمل الدور `admin` في أي مؤسسة ضمن تطبيقك.
يجب على الشخص الذي يصبح مسؤولاً أن يسجّل عامل مصادقة، ويتوقف `GET /session/` عن قبول جلسته حتى تستوفي الجلسة متطلبات السياسة مجددًا.
غيّر السياسة من **Authentication > Security and sessions**، أو باستخدام `mfa_policy` في [إعدادات التطبيق](https://docs.didit.me/ar/authentication/overview.md#إعدادات-التطبيق).

## قراءة المؤسسات في تطبيقك

عند تفعيل المؤسسات، تخبر token والجلسة الخاصة بالمستخدم تطبيقك بالمؤسسات التي ينتمي إليها:

| المكان | ما يحتويه |
| - | - |
| المطالبة `org` في tokenَي الوصول والهوية | `{"id", "role"}` الخاصة بأقدم عضوية للمستخدم في مؤسسة، أو `null`. |
| `organizations` في `GET /session/` | كل العضويات، وتتضمن `organization_id` و`organization__name` و`role` و`custom_role` (وهو `key` و`permissions`، أو `null`). |
| `organizations` في جلسة SDK | القائمة نفسها، مثل `session.organizations` في JavaScript و`user.organizations` في React. |

```json theme={null}
{
  "organizations": [
    {
      "organization_id": "3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b",
      "organization__name": "Northwind",
      "role": "admin",
      "custom_role": {"key": "approver", "permissions": ["payouts.approve"]}
    }
  ]
}
```

تحقّق من الدور والأذونات في الخادم الخلفي لتطبيقك، انطلاقاً من token موثَّق أو من `GET /session/`، قبل كل إجراء يعتمد عليهما.
عند إيقاف المؤسسات، تكون قيمة `org` هي `null` والقائمة فارغة.

## استيراد المؤسسات الحالية

يمكنك، عند [استيراد المستخدمين](https://docs.didit.me/ar/authentication/migration.md) من منصة أخرى، نقل عضوياتهم في المؤسسات.
راجع [الروابط الاجتماعية وأدوات المصادقة والمؤسسات](https://docs.didit.me/ar/authentication/migration.md#الروابط-الاجتماعية-وتطبيقات-المصادقة-والمؤسسات).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.