كيفية تكوين SCIM مع Okta

يشرح هذا الدليل كيفية إعداد توفير المستخدمين والمجموعات عبر SCIM بين Okta ومنظمة 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. ستحتاج إلى هذا في إعداد Okta.
5. انقر على إنشاء رمز وصول. سيتم إنشاء رمز SCIM جديد. انسخ هذا الرمز فوراً واحفظه بأمان، حيث لن تتمكن من رؤيته مرة أخرى.

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

1. في Okta، انتقل إلى Applications واختر تطبيق Hugging Face الخاص بك.
2. انتقل إلى علامة التبويب General وانقر على Edit في إعدادات التطبيق
3. لخيار التهيئة، اختر SCIM، ثم انقر على Save
4. انتقل إلى علامة التبويب Provisioning، ثم تحت Settings، انقر على Integration.
5. أدخل SCIM Tenant URL كعنوان URL الأساسي لاتصال SCIM.
6. أدخل userName لحقل المعرّف الفريد للمستخدمين.
7. حدد جميع الإجراءات اللازمة لإجراءات التهيئة المدعومة.
8. اختر HTTP Header لوضع المصادقة.
9. أدخل رمز الوصول الذي أنشأته كرمز المصادقة الحامل (Authorization Bearer Token).
10. انقر على اختبار إعداد الوسيط للتحقق من الاتصال.
11. احفظ تغييراتك.

الخطوة 3: تحقق من إعدادات SAML

في علامة التبويب عام، تحت إعدادات SAML، تأكد من أن:

• تنسيق معرّف الاسم هو Unspecified
• اسم المستخدم للتطبيق هو Custom، مع التعبير user.getInternalProperty("id")
• تحت عبارات السمات، يتم تعيين http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress إلى user.email

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

الخطوة 4: تكوين التهيئة

1. في علامة التبويب Provisioning، انقر على To App من شريط التنقل الجانبي.
2. انقر على تعديل ثم فعّل جميع الميزات التي تحتاجها، مثل إنشاء المستخدمين وتحديثهم وحذفهم.
3. انقر على حفظ في الأسفل.

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

1. ما زلت في علامة التبويب Provisioning، مرر للأسفل إلى قسم Attribute Mappings
2. تتطلب خرائط السمات الافتراضية غالبًا تعديلات لضمان إعداد قوي. ننصح باستخدام الإعداد التالي. يمكنك حذف السمات غير الموجودة هنا:

الخطوة 6: إسناد المستخدمين أو المجموعات

1. انتقل إلى علامة التبويب المهام، ثم انقر على تعيين
2. انقر على إسناد إلى أشخاص أو إسناد إلى مجموعات
3. بعد تحديد المستخدم أو المجموعة التي تحتاج إلى إسناد، انقر على إسناد بجانب اسمهم. اترك اسم المستخدم كما هو.
4. مرر للأسفل وانقر على حفظ والعودة
5. انقر على تم
6. تأكد من أن المستخدمين أو المجموعات يتم إنشاؤها أو تحديثها أو تعطيلها في منظمة Hugging Face الخاصة بك كما هو متوقع.

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

قبل أن تتمكن من ربط المجموعات بمجموعات الموارد في Hugging Face، عليك أولاً دفع مجموعات Okta الخاصة بك إلى Hugging Face باستخدام تبويب Push Groups. وهذا إجراء منفصل عن تعيين المستخدمين للتطبيق في الخطوة 6.

لا تدعم Okta استخدام المجموعة نفسها لكل من تعيين التطبيق (الخطوة 6) ودفع المجموعة. استخدم مجموعة مخصصة للدفع — حافظ على فصل مجموعات الدفع عن مجموعات التعيين.

1. في وحدة تحكم Okta للإدارة، انتقل إلى التطبيقات وحدد تطبيق Hugging Face الخاص بك.
2. انقر على علامة التبويب Push Groups.
3. انقر على مجموعات الدفع واختر البحث عن المجموعات بالاسم.
4. ابحث عن مجموعة Okta التي تريد الدفع إليها واخترها من النتائج.
5. اختر كيفية التعامل مع المجموعة في Hugging Face:
   • إنشاء مجموعة: ينشئ مجموعة SCIM جديدة في منظمة Hugging Face الخاصة بك.
   • مجموعة الروابط: روابط إلى مجموعة موجودة مسبقًا في منظمة Hugging Face الخاصة بك.
6. انقر على حفظ. لدفع مجموعات إضافية، انقر على حفظ وإضافة أخرى وكرر العملية.

بمجرد الدفع، ستظهر المجموعة تحت SCIM Groups في إعدادات منظمة Hugging Face الخاصة بك (SSO → SCIM tab). أي تغييرات في العضوية تقوم بها على المجموعة في Okta ستتم مزامنتها تلقائيًا مع Hugging Face.

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

بمجرد إنشاء مجموعاتك من Okta، يمكنك ربطها بمجموعات الموارد في 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 إلى مجموعة الموارد فورًا (عملية التعبئة الرجعية)، وتنعكس جميع تغييرات العضوية المستقبلية في Okta تلقائيًا. وسيتم حظر أي تعديلات يدوية على عضوية مجموعة الموارد عبر واجهة Hub أو عبر API.

Update on GitHub