# كيفية تكوين SSO عبر OIDC مع Microsoft Entra ID (Azure AD)

ستستخدم هذه الدليل Microsoft Entra ID كمزوّد لتسجيل الدخول الأحادي (SSO)، وبروتوكول Open ID Connect (OIDC) كبروتوكول الهوية المفضّل لدينا.

> [!WARNING]
> تُعد هذه الميزة جزءًا من باقات الفريق والمؤسسات.

## الخطوة 1: إنشاء تطبيق جديد في مزوّد الهوية

افتح تبويبًا/نافذةً جديدة في متصفحك وسجّل الدخول إلى بوابة Azure الخاصة بمنظمتك.

انتقل إلى مركز إدارة Microsoft Entra ID وانقر على "تطبيقات المؤسسات"

ستتم إعادة توجيهك إلى هذه الصفحة. ثم انقر على تطبيق جديد في الأعلى وعلى إنشاء تطبيقك الخاص.

أدخل اسمًا لتطبيقك (على سبيل المثال، Hugging Face SSO)، ثم اختر «تسجيل تطبيق للتكامل مع Microsoft Entra ID (التطبيق الذي تعمل على تطويره)».

## الخطوة 2: تكوين تطبيقك على Azure

افتح تبويبًا أو نافذة جديدة في متصفحك وانتقل إلى قسم SSO في إعدادات مؤسستك. اختر بروتوكول OIDC.

انسخ "Redirection URI" من إعدادات المنظمة على Hugging Face والصقه في حقل "Redirect URI" على Azure Entra ID. تأكد من اختيار "Web" من القائمة المنسدلة. يبدو الرابط على النحو التالي: `https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume`.

احفظ تطبيقك الجديد.

## الخطوة 3: إتمام الإعداد على Hugging Face

سنحتاج إلى جمع المعلومات التالية لإتمام الإعداد على Hugging Face:

- معرف العميل للتطبيق OIDC
- سر العميل للتطبيق OIDC
- عنوان المُصدِر (Issuer URL) لتطبيق OIDC

في Microsoft Entra ID، انتقل إلى Enterprise applications، ثم انقر على التطبيق الذي أنشأته حديثًا في القائمة.

في نظرة عامة على التطبيق، انقر على "تسجيل الدخول الأحادي"، ثم انقر على "الانتقال إلى التطبيق"

في نظرة عامة على تطبيق OIDC، ستجد حقلًا قابلًا للنسخ باسم "Application (client) ID". انسخ هذا المعرّف إلى الحافظة ثم ألصقه في حقل "Client ID" على Hugging Face.

التالي، انقر على Endpoints في القائمة العلوية في Microsoft Entra. انسخ القيمة الموجودة في حقل OpenID connect metadata document والصقها في حقل Issue URL في Hugging Face.

عند العودة إلى Microsoft Entra، انتقل إلى "الشهادات والأسرار" (Certificates & secrets)، وأنشئ سراً جديداً بالنقر على "سر عميل جديد" (New client secret).

بمجرد إنشاء السر، انسخ قيمة السر والصقها في حقل "Client secret" على Hugging Face.

يمكنك الآن النقر على "تحديث واختبار إعدادات OIDC" لحفظ الإعدادات.

يجب أن يتم تحويلك إلى شاشة تسجيل الدخول لدى مزوّد SSO (IdP). بعد تسجيل الدخول، سيتم تحويلك إلى صفحة إعدادات مؤسستك.

ستُظهر علامة صح خضراء بالقرب من محدد OIDC أن الاختبار نجح.

## الخطوة 4: تفعيل تسجيل الدخول الأحادي في مؤسستك

الآن بعد أن تم تكوين تسجيل الدخول الموحّد واختباره، يمكنك تفعيله لأعضاء منظمتك بالنقر على زر "تفعيل".

بمجرد التفعيل، يجب على أعضاء منطمتك إكمال تدفق المصادقة عبر SSO الموصوف في قسم [كيف يعمل](./security-sso-basic#how-it-works).