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

يشرح هذا الدليل كيفية إعداد التزويد التلقائي بالمستخدمين والمجموعات بين Microsoft Entra ID ومنظمة Hugging Face الخاصة بك باستخدام SCIM.

تُعد هذه الميزة جزءًا من خطتي Enterprise وEnterprise Plus.

يتطلب SCIM إعداد SSO على مؤسستك أولاً. SSO الأساسي متاح ذاتياً، بينما يتم إعداد SSO المُدار مع فريق Hugging Face.

الخطوة 1: احصل على إعدادات SCIM من Hugging Face

1. سجّل الدخول إلى حساب Hugging Face يكون مالكًا للمنظمة.
2. انتقل إلى صفحة إعدادات مؤسستك على Hugging Face.
3. انتقل إلى علامة التبويب SSO، ثم انقر على علامة التبويب الفرعية SCIM.
4. انسخ SCIM Tenant URL. ستحتاج إلى هذا في إعداد Entra ID.
5. انقر على إنشاء رمز وصول. سيتم إنشاء رمز SCIM جديد. انسخ هذا الرمز فوراً واحفظه بأمان، حيث لن تتمكن من رؤيته مرة أخرى.

الخطوة 2: تكوين التهيئة في Microsoft Entra ID

1. في مركز إدارة Microsoft Entra، انتقل إلى تطبيق Hugging Face Enterprise الخاص بك.
2. في القائمة الجانبية اليسرى، اختر Provisioning.
3. انقر على ابدأ الآن.
4. غيّر وضع التهيئة من “يدوي” إلى تلقائي.

الخطوة 3: إدخال بيانات اعتماد المسؤول

1. في قسم Admin Credentials، الصق SCIM Tenant URL من Hugging Face في حقل Tenant URL.
2. الصق رمز SCIM من Hugging Face في حقل رمز السرية.
3. انقر على Test Connection. يجب أن ترى إشعارًا بالنجاح.
4. انقر على حفظ.

الخطوة 4: تكوين خرائط السمات

1. تحت قسم Mappings، انقر على Provision Microsoft Entra ID Users.

2. تتطلب خرائط السمات الافتراضية غالبًا تعديلات لضمان إعداد قوي. ننصح باستخدام الإعداد التالي. يمكنك حذف السمات غير المدرجة هنا:

   customappsso الخاصية	سمة Microsoft Entra ID	أولوية التطابق
   userName	Replace([mailNickname], ".", "", "", "", "", "")
   active	Switch([IsSoftDeleted], , "False", "True", "True", "False")
   emails[type eq "work"].value	userPrincipalName
   name.givenName	givenName
   name.familyName	surname
   externalId	objectId	1

3. يجب أن يتوافق اسم المستخدم مع القواعد التالية.

• يُقبل في اسم المستخدم الأحرف العادية ورمز `-` فقط.
• يُمنع استخدام -- (شرطة مزدوجة).
• لا يمكن أن يبدأ الاسم أو ينتهي بـ -.
• لا يتم قبول الأسماء المكوّنة من أرقام فقط.
• الحد الأدنى للطول هو 2 والحد الأقصى هو 42.
• يجب أن يكون اسم المستخدم فريدًا ضمن مؤسستك.

4. بعد تكوين خرائط المستخدمين، عُد إلى شاشة الإعداد (Provisioning) وانقر على Provision Microsoft Entra ID Groups لمراجعة خرائط المجموعات. عادةً ما تكون الإعدادات الافتراضية للمجموعات كافية.

الخطوة 5: بدء التهيئة

1. في شاشة الإعداد الرئيسية، اضبط حالة الإعداد على مفعّل.
2. تحت الإعدادات، يمكنك ضبط النطاق ليكون إما “مزامنة المستخدمين والمجموعات المُسندة فقط” أو “مزامنة جميع المستخدمين والمجموعات”. ننصح بالبدء بـ “مزامنة المستخدمين والمجموعات المُسندة فقط”.
3. احفظ تغييراتك.

قد يستغرق المزامنة الأولية ما يصل إلى 40 دقيقة حتى تبدأ. يمكنك مراقبة التقدم في تبويب سجلات التهيئة.

تعيين المستخدمين والمجموعات للتجهيز

للتحكم في المستخدمين والمجموعات التي يتم إعدادها لمنظمتك على Hugging Face، يجب تعيينهم في تطبيق Hugging Face Enterprise في Microsoft Entra ID. يتم ذلك في تبويب المستخدمون والمجموعات في تطبيقك.

1. انتقل إلى تطبيق Hugging Face Enterprise الخاص بك في مركز إدارة Microsoft Entra.
2. انتقل إلى علامة التبويب المستخدمون والمجموعات.
3. انقر على إضافة مستخدم/مجموعة.
4. حدد المستخدمين والمجموعات التي تريد إعدادها ثم انقر على إسناد.

لن يتم إعداد المستخدمين والمجموعات التي تحددها هنا على Hugging Face إلا إذا قمت بتعيين Scope إلى “Sync only assigned users and groups”.

اعتبارات خطة Active Directory

• مع خطط Free وOffice 365 وPremium P1/P2، يمكنك تعيين مستخدمين فرديين للتطبيق من أجل الإعداد.
• مع خطط Premium P1/P2، يمكنك أيضًا تعيين مجموعات. هذا هو النهج الموصى به لإدارة الوصول على نطاق واسع، حيث يمكنك إدارة عضوية المجموعة في AD، وستنعكس التغييرات تلقائيًا في Hugging Face.

الخطوة 6: التحقق من الإعداد في Hugging Face

بمجرد اكتمال المزامنة، انتقل مرة أخرى إلى إعدادات منظمة Hugging Face الخاصة بك:

• ستظهر المستخدمين المُخصَّصين في تبويب إدارة المستخدمين.
• ستظهر المجموعات المُخصَّصة في تبويب SCIM تحت SCIM Groups. يمكن بعد ذلك إسناد هذه المجموعات إلى Resource Groups للتحكم الدقيق في الوصول.

الخطوة 7: ربط مجموعات SCIM بمجموعات الموارد في Hugging Face

بمجرد إنشاء مجموعاتك من Entra ID، يمكنك ربطها بمجموعات الموارد في Hugging Face لإدارة الأذونات على نطاق واسع. ويتيح ذلك لجميع أعضاء مجموعة SCIM الحصول تلقائيًا على أدوار محددة (مثل القراءة أو الكتابة) لمجموعة من الموارد.

قبل إنشاء الربط، تأكد من أن مجموعة الموارد التي تريد ربطها فارغة (لا تحتوي على أعضاء حاليين) ولم يتم تفعيل الانضمام التلقائي فيها إطلاقًا. كلا الشرطين مطلوبان — وإلا فسيفشل الربط.

1. في إعدادات مؤسستك على Hugging Face، انتقل إلى تبويب SSO -> SCIM. ستجد قائمة بمجموعاتك المُهيّأة تحت SCIM Groups.

2. حدد المجموعة التي ترغب في تكوينها ثم انقر على Link resource groups في صفها.
3. سيظهر مربع حوار. انقر على ربط مجموعة موارد.
4. من قوائم الاختيار المنسدلة، اختر Resource Group الذي تريد ربطه وRole Assignment الذي تريد منحه لأعضاء مجموعة SCIM.
5. انقر على رابط إلى مجموعة SCIM واحفظ التخصيص.

بمجرد الربط، تصبح مجموعة الموارد مُدارةً عبر SCIM: حيث يُضاف أي أعضاء موجودون مسبقًا في مجموعة SCIM إلى مجموعة الموارد فورًا (عملية التعبئة الرجعية)، وتنعكس جميع تغييرات العضوية المستقبلية في Entra ID تلقائيًا. وسيتم حظر أي تعديلات يدوية على عضوية مجموعة الموارد عبر واجهة Hub أو عبر API.

Update on GitHub