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

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

تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.

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

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

انتقل إلى مركز إدارة Microsoft Entra ID وانقر على “Enterprise applications”

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

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

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

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

انسخ «URI إعادة التوجيه» من إعدادات المنظمة على Hugging Face والصقه في حقل «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.

Next، انقر على 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 الموصوف في قسم كيف يعمل.

Update on GitHub