SCIM Provisioning for Microsoft Entra

يمكن استخدام توفير SCIM جنبًا إلى جنب مع التوفير عند الطلب (JIT). يتميز التوفير عند الطلب بمزامنة معلومات الهوية والدور والمجموعة للمستخدم بمجرد تسجيل دخوله، مقارنة بتوفير SCIM الذي يتم مزامنته كل 40 دقيقة. من ناحية أخرى، يسمح توفير SCIM بمزامنة المعلومات دون الحاجة إلى تسجيل دخول المستخدم. نوصي باستخدام SCIM للمؤسسات الكبيرة التي تحتوي على مجموعات مستخدمين معقدة.

يرجى ملاحظة أن توفير SCIM مدعوم حاليًا فقط إذا تم تمكين تسجيل الدخول الأحادي (SSO). يُفترض في هذا الدليل أنك قد قمت بالفعل بـ تكوين SSO لحساب 6clicks الخاص بك.

قبل المتابعة، تأكد من أنك مطلع على وثائق Microsoft Entra المتعلقة بـ توفير التطبيقات الآلي. يرجى ملاحظة أن 6clicks تُعتبر تطبيقًا "غير معروض في المعرض".

إنشاء مفتاح API

تتوفر نقاط نهاية واجهة برمجة تطبيقات SCIM كجزء من واجهة برمجة التطبيقات للمطورين في 6clicks. ستوجهك الخطوات التالية لإنشاء مفتاح API ورمز مميز طويل الأمد.

1. في 6clicks، تكون مفاتيح API مرتبطة بحسابات المستخدمين وترث أذوناتهم. نوصي بإنشاء حساب مستخدم مخصص يتمتع بالأذونات التالية:

   1. التكامل
   2. إنشاء مستخدم جديد
   3. تعديل المستخدم
   4. حذف المستخدم
   5. إنشاء وتعديل وحذف المجموعات
   6. إدارة أعضاء المجموعة

    

2. قم بتسجيل الدخول باستخدام الحساب الجديد
3. إنشاء مفتاح API للمطورين

توليد رمز مميز طويل الأمد

في 6clicks، قم بالتحقق من وثائق واجهة برمجة التطبيقات وسجل عنوان URL الخاص بواجهة برمجة التطبيقات:

بعد ذلك، قم بتوليد رمز وصول طويل الأمد. يمكنك القيام بذلك مباشرةً من خلال وثائق واجهة برمجة التطبيقات بالنقر على "Try it out" على نقطة النهاية /auth-api/1.0/auth/token.

قم بلصق مفتاح API الخاص بك واختر true لمعلمة IsLongLivedToken.

انسخ القيمة المعادة في معلمة "accessToken" (مع إزالة علامات الاقتباس المزدوجة):

يمكنك اختبار الرمز المميز بالنقر على زر Authorize بالقرب من أعلى صفحة وثائق API وإدخاله كقيمة Bearer .

بعد ذلك، جرب نقطة النهاية GET /scim/users.

بعد تنفيذ الطلب، تأكد من استلام استجابة ناجحة برمز 200.

ربط التوفير في Entra مع 6clicks

1. قم بتسجيل الدخول إلى مركز إدارة Microsoft Entra بصفة مسؤول تطبيقات على الأقل (Application Administrator).

2. انتقل إلى الهوية > التطبيقات > تطبيقات المؤسسة.

3. اختر تطبيق 6clicks المرتبط بحسابك.

4. اختر التوفير لإدارة إعدادات توفير حساب المستخدم للتطبيق المحدد.

5. اختر "Connect your application"
   
   ملاحظة: راجع التحذير أعلاه إذا لم تتمكن من رؤية رابط "Connect your application".

6. أدخل عنوان URL لنقطة نهاية SCIM الخاصة بواجهة برمجة التطبيقات للمطورين في حقل Tenant URL. يجب أن يكون هذا العنوان هو العنوان الذي قمت بتدوينه سابقًا، متبوعًا بمسار scim/.
   
   أدخل الرمز المميز الذي قمت بتوليده أعلاه في حقل Secret token:
   

7. اختبر الاتصال وتأكّد من استلامك لإشعار ناجح.
8. انقر على Create

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

<pيدعم data-hsprotectp="">

1. اختر تبويب Users and groups في Entra
   
2. أضف المستخدمين والمجموعات حسب الحاجة
3. انتقل إلى Attribute mapping
4. اختر Provision Microsoft Entra ID Users
5. تأكّد من تكوين الترابط التالي:
   

   Application attribute	Microsoft Entra ID attribute	Precedence
   emails[type eq "work"].value	mail	1
   userName	userPrincipalName	2
   active	Switch([IsSoftDeleted], , "False", "True", "True", "False")
   name.givenName	givenName
   name.familyName	surname
   externalId	objectId

6. ارجع إلى Attribute mapping
7. اختر Provision Microsoft Entra ID Groups
8. تأكّد من تكوين الترابط التالي:
   

   Application attribute	Microsoft Entra ID attribute	Precedence
   displayName	displayName	1
   externalId	objectId
   members	members

9. يمكن استخدام ميزة Provision on demand لاختبار التوفير:
   

10. بمجرد اكتمال تكوينك، اختر Overview في اللوحة اليسرى.

11. اختر Properties.

12. اضغط على رمز القلم لتعديل الخصائص. قم بتمكين رسائل البريد الإلكتروني للإشعارات وقدم بريدًا إلكترونيًا للمسؤول لاستلام رسائل البريد الإلكتروني عن الحجر الصحي.

13. نوصي بتمكين الحماية ضد الحذف العرضي مع تعيين العتبة المناسبة لمؤسستك. انقر على Apply لحفظ التغييرات.

14. اختر Start provisioning لتشغيل خدمة توفير Microsoft Entra.

أنواع المزامنة المدعومة

يعرض الجدول التالي أنواع البيانات التي يتم دعمها حاليًا للمزامنة:

 

ملاحظات

• من المهم جدولة وقت خلال العام القادم لإعادة توليد رمز API. لا يوفر 6clicks إشعارًا عند اقتراب انتهاء صلاحية الرمز.
• حذف مفتاح API أو المستخدم المرتبط به، أو إزالة الأذونات المطلوبة من المستخدم، سيعطل الرمز المميز المقابل.
• هناك عدة طرق يمكن أن تفشل من خلالها مزامنة عضوية المستخدم والمجموعة. من المهم مراقبة إشعارات البريد الإلكتروني من Entra لهذه الحالات.