الملخص
يُستخدم رمز SCIM API للمصادقة على مزوّد الهوية (Identity Provider) الخاص بك لدى KnowledgeCity، حتى يتمكن من إنشاء حسابات المستخدمين والمجموعات وتحديثها وإلغاء تنشيطها بشكل تلقائي. من قسم Integrations يمكنك نسخ عنوان SCIM API URL والرمز الخاص به، وإنشاء رمز جديد كلما احتجت إلى تدوير بيانات الاعتماد. تؤدي إعادة إنشاء الرمز إلى إصدار سرّ جديد يحل محل السابق، بما يحافظ على أمان الاتصال.
مقدمة
يتيح توفير SCIM (System for Cross-domain Identity Management) لمزوّد الهوية الخاص بك إنشاء الحسابات وتحديثها وإلغاء تنشيطها، وضبط عضوية المجموعات في KnowledgeCity تلقائيًا، بحيث تعكس دورة حياة الحساب دليلك (directory) دون إدخال بيانات يدوي. للقيام بذلك، يتصل مزوّد الهوية الخاص بك بنقطة نهاية SCIM API (عنوان URL) ويصادق باستخدام رمز SCIM API.
تُستخدم هذه الميزة من قِبل المسؤولين ومالكي التكامل — الأشخاص المسؤولين عن توفير الوصول والحفاظ على الاتصال بين مزوّد الهوية الخاص بك وKnowledgeCity. تحل إعادة إنشاء الرمز مشكلة تدوير بيانات الاعتماد بشكل دوري أو استبدال رمز تعتقد أنه قد تم كشفه، وكل ذلك دون مغادرة إعدادات Integrations.
المفاهيم الأساسية
- توفير SCIM — الإنشاء والتحديث وإلغاء التنشيط التلقائي لحسابات المستخدمين وعضوية مجموعاتهم، بقيادة مزوّد الهوية الخاص بك، بحيث تبقى الحسابات متزامنة مع دليلك.
- عنوان SCIM API URL — نقطة النهاية التي يتصل بها مزوّد الهوية الخاص بك لإرسال طلبات التوفير إلى KnowledgeCity.
- رمز SCIM API — بيانات الاعتماد السرية التي يقدّمها مزوّد الهوية الخاص بك للمصادقة على طلباته إلى SCIM API؛ تعامل معه كما تتعامل مع كلمة مرور.
- نسخ — الإجراء الذي يضع عنوان SCIM API URL أو الرمز في الحافظة (clipboard) لديك، حتى تتمكن من لصقه في تكوين مزوّد الهوية الخاص بك.
- إعادة إنشاء الرمز — إصدار رمز SCIM API جديد يحل محل الرمز السابق، بحيث يتوقف الرمز القديم عن العمل ولا تبقى صالحة إلا القيمة الجديدة.
- تدوير بيانات الاعتماد — ممارسة استبدال الرمز بشكل دوري، أو استبداله فورًا إذا كان قد تم كشفه، للحد من خطر الوصول غير المصرح به.
الخطوات التي يجب اتباعها
فتح إعدادات Integrations
سجّل الدخول كمسؤول وافتح قسم Integrations من إعدادات حسابك. من هنا تتم إدارة تفاصيل اتصال SCIM الخاصة بحسابك، إلى جانب إعدادات التكامل الأخرى.
نسخ عنوان SCIM API URL
حدد موضع عنوان SCIM API URL واستخدم إجراء النسخ (Copy) لوضعه في الحافظة. الصق هذه القيمة في تكوين التوفير لدى مزوّد الهوية الخاص بك حتى يعرف نقطة النهاية التي يجب أن يرسل الطلبات إليها.
نسخ رمز SCIM API الحالي
حدد موضع رمز SCIM API واستخدم إجراء النسخ (Copy) لوضعه في الحافظة. الصقه في مزوّد الهوية الخاص بك إلى جانب العنوان حتى يتمكن من مصادقة طلبات التوفير الخاصة به. احتفظ بهذه القيمة بعيدًا عن رسائل البريد الإلكتروني والمنتديات العامة والتعليمات البرمجية من جانب العميل (client-side code) — فأي شخص يحصل عليها يمكنه التصرف باسم نقطة نهاية SCIM الخاصة بك.
إنشاء رمز SCIM جديد
عندما تكون في مرحلة تدوير بيانات الاعتماد بشكل دوري، أو تشتبه في أن الرمز الحالي قد تم كشفه، أنشئ رمز SCIM جديدًا. تؤدي إعادة إنشاء الرمز إلى إصدار سرّ جديد يحل محل السابق، مما يعني أن الرمز القديم يتوقف عن العمل. وبسبب إبطال القيمة السابقة، فإن أي نظام لا يزال يستخدم الرمز القديم سيفقد الوصول إلى أن يتم تحديثه.
تحديث مزوّد الهوية الخاص بك بالرمز الجديد
بعد إنشاء الرمز الجديد، انسخه والصقه في تكوين SCIM لدى مزوّد الهوية الخاص بك، لتحل محل القيمة القديمة. احفظ التكوين من جانب مزوّد الهوية حتى يستمر التوفير دون انقطاع. من الممارسات الجيدة التأكد من أن مزامنة المستخدمين والمجموعات لا تزال تعمل بعد التغيير.
الخاتمة
يربط عنوان SCIM API URL والرمز مزوّد الهوية الخاص بك بـ KnowledgeCity، بحيث يبقى توفير المستخدمين والمجموعات تلقائيًا ودقيقًا. يُفعّل نسخ هاتين القيمتين الاتصال، وتتيح لك إعادة إنشاء رمز جديد تدوير بيانات الاعتماد بأمان — فقط تذكّر أن الرمز الجديد يحل محل القديم، لذا حدّث مزوّد الهوية الخاص بك على الفور لتجنّب أي انقطاع في التوفير.