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

في هذا الدليل، سنستخدم Microsoft Entra ID كمزوّد لتسجيل الدخول الأحادي (SSO)، مع اعتماد بروتوكول لغة وسم المصادقة الأمنية (SAML) كبروتوكول الهوية المفضّل لدينا.

ندعم حاليًا المصادقة التي تبدأ من جهة الخدمة (SP) والمصادقة التي تبدأ من مزود الهوية (IdP). فيما يتعلق بتزويد المستخدمين، راجع SCIM.

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

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

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

انتقل إلى “Enterprise applications” وانقر على زر “New application”.

سيتم تحويلك إلى هذه الصفحة، انقر على “Create your own application”، املأ اسم تطبيقك، ثم انقر على “Create” لإنشاء التطبيق.

ثم اختر “Single Sign-On” (تسجيل الدخول الأحادي)، واختر SAML

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

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

انسخ “SP Entity Id” من إعدادات المؤسسة على Hugging Face، ثم الصقه في حقل “Identifier (Entity Id)” على Azure (1).

انسخ “Assertion Consumer Service URL” من إعدادات المؤسسة على Hugging Face، ثم الصقه في حقل “Reply URL” على Azure (2).

يبدو الرابط على النحو التالي: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

ثم تحت “SAML Certificates” (شهادات SAML)، تحقق من أن “Signin Option” (خيار تسجيل الدخول) مضبوط على “Sign SAML response and assertion” (توقيع استجابة SAML والتأكيد).

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

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

في تطبيق Azure الخاص بك، تحت “Set up”， ابحث عن الحقل التالي:

• رابط تسجيل الدخول

وتحت “SAML Certificates”:

• Download the “Certificate (base64)”

ستحتاج إليها لإتمام إعداد SSO على Hugging Face.

في قسم SSO بإعدادات مؤسستك، انسخ هذه القيم من Azure والصقها:

• رابط تسجيل الدخول -> رابط تسجيل الدخول
• شهادة -> شهادة عامة

يجب أن يكون للشهادة العامة الصيغة التالية:

-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----

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

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

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

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

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

بمجرد التفعيل، يجب على أعضاء منطمتك إكمال تدفق المصادقة عبر SSO الموصوف في قسم كيف يعمل.