SCIM: مرجع تقني

• المتطلبات
• تمكين SCIM في حساب ‎DeepL‏
• نقاط نهاية الخدمة والمصادقة
• الموارد ونقاط النهاية
• العمليات القياسية
• السمات التي يستخدمها DeepL
• إجراءات SCIM الشائعة التي يفسرها DeepL

تشرح هذه الإرشادات كيف يمكن لمسؤولي تكنولوجيا المعلومات إعداد إدارة حسابات المستخدمين SCIM لفريقهم بعد إعداد تسجيل الدخول الأحادي (SSO) مع أي موفّر هوية يدعم بروتوكول SCIM 2.0. لمزيد من المعلومات حول إدارة حسابات المستخدمين SCIM، راجع هذه المقالة. 

تصف هذه المقالة نقاط نهاية SCIM الخاصة بـ DeepL والعمليات المدعومة. كما تشرح كيفية تعامل DeepL مع السمات وتفسير طلبات SCIM دون تعليمات خاصة بموفّر الهوية.

يتبع DeepL رسائل SCIM الواردة من موفّر الهوية. تعتمد دورات إدارة الحسابات على سلوك موفري الهوية، وليس على DeepL.

المتطلبات

• وصول المسؤول إلى DeepL
• تم إعداد تسجيل الدخول الأحادي (SSO) لـ DeepL. إذا لم تكن قد قمت بإعداد SSO، فاتبع التعليمات.
  • OpenID Connect
  • SAML
• قم بإزالة مزامنة المجموعة JIT والمجموعات، إذا تم تمكينها في إعداد سابق. اتبع التعليمات الواردة في هذه المقالة.
  • لا يتم حذف المستخدمين الحاليين الذين لم يتم تعيين تطبيق DeepL لهم في موفّر الهوية تلقائياً بواسطة SCIM. احذفهم يدويًا إذا لم تعد هناك حاجة إليهم.
  • لا يتم حذف المجموعات الحالية التي لم يتم منحها حق الوصول في موفّر الهوية تلقائياً. احذفها يدويًا إذا لم تعد هناك حاجة إليها.
  • يمكن إدارة المجموعات التي تم إنشاؤها مسبقًا (مثلاً، عبر مزامنة المجموعة JIT) بواسطة SCIM من الآن فصاعدًا. 
• إذا كنت تستخدم بروتوكول OpenID Connect في إعداد تسجيل دخول أحادي، فتحقق مما إذا كان التطبيق قد تم إنشاؤه عبر تطبيقات DeepL للمؤسسات وليس عبر تسجيل التطبيق. اتبع الإرشادات الواردة في هذه المقالة.

تمكين SCIM في حساب ‎DeepL‏

1. انتقل إلى الإعدادات في حساب ‎DeepL‏ الخاص بك
2. في قسم إدارة حسابات المستخدمين للفريق ، انقر فوق إدارة حسابات المستخدمين

3. حدد تمكين إدارة
   الحسابات بـ SCIM يتم إنشاء مفتاح API لمسؤول SCIM. ستحتاج إلى مفتاح API هذا لإعداداتك. لمزيد من المعلومات، راجع هذه المقالة.  

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

نقاط نهاية الخدمات والمصادقة

• عنوان URL الأساسي (عنوان URL للمستأجر) : https://scim.deepl.com
• المصادقة (الرمز السري) : استخدم مفتاح واجهة برمجة التطبيقات (API) الخاص بالإدارة الذي يتم إنشاؤه تلقائياً عند تمكين SCIM لفريقك. لمزيد من المعلومات حول كيفية الوصول إلى مفاتيح واجهة برمجة التطبيقات (API) الخاصة بالإدارة، راجع هذه المقالة . يجب أن يرسل موصل SCIM الخاص بموفّر الهوية هذا الرمز عند استدعاء نقاط نهاية SCIM.

قد يصف موفّر الهوية الخاص بك هذا الرمز بأنه رمز حامل أو رمز سري أو ما شابه ذلك. أدخل مفتاح API المسؤول لـ SCIM في الحقل الذي يوفره الموصّل الخاص بك لمصادقة SCIM.

الموارد ونقاط النهاية

المستخدمون:

POST /Users

PATCH /Users/{id}

DELETE /Users/{id}

المجموعات:

POST /Groups

PATCH /Groups/{id}

DELETE /Groups/{id}

تمثل هذه المسارات والأفعال المعلومات التي يتلقاها DeepL من موفري الهوية أثناء العمليات القياسية.

العمليات القياسية

المستخدمون: 

• التزويد (إنشاء)
• التحديث (السِّمات والحالة)
• إلغاء الحسابات

المجموعات: 

• التوفير (إنشاء)
• التحديث (الاسم وعضوية المجموعة)
• إلغاء الحسابات

السمات التي يستخدمها DeepL

المستخدمون: 

userName

active

externalId

name.formatted

locale

المجموعات: 

externalId

displayName

إجراءات SCIM الشائعة التي يفسرها DeepL

في حساب إدارة DeepL، يعني إدراج المستخدمين ضمن فئة "الترخيص غير مخصص" أن موفّر الهوية قد أزال ترخيصهم (مثلاً، عن طريق إلغاء تخصيص التطبيق أو تعيين active=false). 

أمثلة على الحمولات (SCIM عام) 

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

منح الوصول

POST /Users
Content-Type: application/scim+json

{
  "userName": "jane.doe@example.com",
  "externalId": "idp-12345",
  "name": { "formatted": "Jane Doe" },
  "preferredLanguage": "en",
  "active": true
}

إلغاء تنشيط المستخدم

PATCH /Users/2819c223-7f76-453a-919d-413861904646
نوع المحتوى: application/SCIM+JSON‏

{
 "Operations": [
   { "op": "Replace", "path": "active", "value": false }
 ]
}

إضافة مستخدم إلى مجموعة

PATCH /Groups/47aa02c1-5f27-4f3f-9d8d-1e3f2c5b9d10
نوع المحتوى: application/SCIM+JSON‏

{
 "Operations": [
   {
     "op": "Add",
     "path": "members",
     "value": [{ "value": "2819c223-7f76-453a-919d-413861904646" }]
   }
 ]

إنشاء مجموعة

POST /Groups
نوع المحتوى: application/scim+JSON‏

{
 "displayName": "DeepL-Translator",
 "externalId": "grp-98765",
 "members": []
}

اختبار إدارة الحسابات

إذا فشلت أي عملية أثناء الاختبار أو إدارة الحسابات، يرجى الاتصال بنا وإرسال تفاصيل الخطأ الكاملة، بما في ذلك معرف الطلب X-trace-id إذا كان موفّر الهوية الخاص بك يعرضه. تساعدنا هذه المعلومات في فحص سجلات جانب الخادم.
يمكنك أيضًا التحقق/التأكيد من النتائج في حساب ‎DeepL‏ الإداري الخاص بك (مثلاً، ظهور مستخدمين أو مجموعات جديدة ضمن علامة التبويب "المستخدمون").