التزويد عبر SCIM

باستخدام SCIM 2.0 يدير مزوّد الهوية لديكم، مثل Microsoft Entra ID أو Okta، مستخدمي exoCortex نيابةً عنكم: عند توظيف شخص يُنشأ المستخدم، وعند تغيّر دوره يُحدَّث، وعند مغادرته الشركة يُعطَّل.

ربط مزوّد الهوية

1. في exoCortex Core افتحوا Identity → SCIM وأنشئوا رمز SCIM. انسخوه فورًا: فهو يُعرض مرة واحدة فقط.
2. في مزوّد الهوية لديكم أضيفوا تطبيقًا يدعم التزويد عبر SCIM 2.0 وحدّدوا:
   • عنوان URL الأساسي: https://exocortex-api.ai-exo-cortex.com/scim/v2
   • المصادقة: رمز bearer، باستخدام الرمز الذي أُنشئ في الخطوة 1.
3. شغّلوا اختبار اتصال من مزوّد الهوية، ثم أسندوا إلى التطبيق المستخدمين والمجموعات المطلوب مزامنتها.

ينتمي الرمز إلى مستأجر (tenant) واحد: يرى مزوّد الهوية مستخدمي ذلك المستأجر فقط ويديرهم.

ما الذي يدعمه exoCortex

الوظيفة	الدعم
المستخدمون: الإنشاء، والقراءة، والاستبدال، والتحديث (PATCH)، والحذف	نعم
المجموعات: الإنشاء، والقراءة، والتحديث (PATCH)، والحذف	نعم
عوامل التصفية	نعم، مثل userName eq "[email protected]"، ومع and أيضًا؛ حتى 200 نتيجة
الفرز	نعم
العمليات الجماعية (bulk)	لا
تغيير كلمة المرور	لا: المستخدم هو من يختار كلمة المرور
ETag	لا

سمات المستخدم

يستخدم exoCortex السمات القياسية لمخطط مستخدم SCIM:

• userName: معرّف المستخدم، وهو عادةً البريد الإلكتروني للشركة؛
• externalId: معرّف المستخدم في مزوّد الهوية لديكم؛
• name.givenName وname.familyName، وdisplayName؛
• emails، مع تمييز العنوان الرئيسي بـ primary؛
• active: إذا كانت قيمتها false، يكون المستخدم معطّلًا؛
• title وuserType، إن وُجدا.

تعطيل مستخدم وإزالته

عندما يغادر مستخدم الشركة، يعطّله مزوّد الهوية عبر PATCH يضبط active على false:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [{ "op": "replace", "path": "active", "value": false }]
}

يؤدي طلب DELETE على المستخدم إلى إزالته من التزويد (إلغاء التزويد deprovisioning).

الأخطاء

تستجيب نقاط نهاية SCIM بمستندات أخطاء SCIM ‏(RFC 7644). يشير الرمز 401 إلى رمز مميز مفقود أو غير صالح أو ملغى أو منتهي الصلاحية: أنشئوا رمزًا جديدًا وحدّثوه في مزوّد الهوية.