الملخص
يتيح لك قسم Integrations إرفاق اتصالات مزوّد خدمة تسجيل الدخول الموحد (Single Sign-On) بحساب من خلال علامة التبويب SSO SP. بالإضافة إلى SAML، الذي يستخدم نموذجًا منظّمًا، تدعم علامة التبويب أنواع مزوّدي خدمة غير SAML مثل SIP2 وPatronSSLAPI وOAuth وRegex. تُكوَّن هذه الأنواع غير SAML من خلال محرر JSON خام بدلاً من حقول إدخال فردية، وتوضح هذه المقالة الغرض من كل نوع وكيفية العمل معها.
مقدمة
تدير علامة التبويب SSO SP اتصالات مزوّد الخدمة التي تتيح لنظام خارجي مصادقة المستخدمين لتسجيل الدخول إلى KnowledgeCity. لكل اتصال نوع. عند اختيار SAML، تعرض Integrations نموذجًا منظّمًا بحقول مخصصة. عند اختيار نوع غير SAML، تعرض Integrations لوحة قابلة للطي تحتوي على محرر JSON، لأن هذه الأنواع لا تملك بعد نموذجًا ثابتًا.
يستخدم هذا التدفق المسؤولون الذين يديرون المصادقة على مستوى الحساب، بما في ذلك الاتصالات بأنظمة المكتبات وأنظمة روّاد المكتبات (patron systems). يمنحهم ذلك طريقة مرنة لتعريف اتصال من خلال تحرير إعدادات اتصاله مباشرة، وهو أمر مفيد عندما يحتاج المزوّد إلى خيارات تكوين لا يعرضها نموذج ثابت.
المفاهيم الأساسية
- اتصال مزوّد خدمة SSO: نظام خارجي يصادق مستخدميك حتى يتمكنوا من تسجيل الدخول إلى KnowledgeCity. تخزّن Integrations واحدًا أو أكثر من هذه الاتصالات لكل حساب.
- نوع مزوّد الخدمة (SP type): فئة الاتصال. يستخدم SAML نموذجًا منظّمًا، بينما تُكوَّن الأنواع غير SAML من خلال محرر JSON.
- SIP2: نوع غير SAML يُستخدم لمصادقة روّاد المكتبات. وبصفته نوعًا غير SAML، تُدخل إعدادات اتصاله بصيغة JSON.
- PatronSSLAPI: نوع غير SAML يُستخدم لمصادقة الرواد من خلال واجهة برمجة تطبيقات (API) لمزوّد. يُكوَّن من خلال محرر JSON بدلاً من نموذج ثابت.
- OAuth: نوع غير SAML يعتمد على الرموز (token based) ولا يملك بعد نموذجًا منظّمًا، لذا تُعرَّف إعدادات اتصاله بصيغة JSON.
- Regex: نوع غير SAML يعتمد على مطابقة نمط (pattern). وكما هو الحال مع الأنواع غير SAML الأخرى، تُدخل إعداداته بصيغة JSON.
- لوحة JSON: لوحة قابلة للطي تحتوي على محرر لاتصال واحد غير SAML. يعرض رأسها نوع الاتصال واسمه، ويمكنك توسيعها أو طيّها لتحرير الإعدادات.
- إعدادات الاتصال (Connection settings): بنية JSON التي تحتوي على جميع تكوينات الاتصال. الحقول المتاحة في المحرر هي أي حقول تحتوي عليها هذه البنية، ويُستمد اسم الاتصال من اسم مؤسسة الاتصال، أو من تسمية العرض الخاصة به عندما لا يكون اسم المؤسسة موجودًا.
الخطوات التي يجب اتباعها
فتح علامة التبويب SSO SP
انتقل إلى شاشة تحرير الحساب وافتح علامة التبويب SSO SP. تعرض هذه العلامة اتصالات مزوّد الخدمة المكوَّنة للحساب، وهي المكان الذي تضيف فيه اتصالات جديدة وتحررها.
اختيار نوع مزوّد الخدمة
حدد نوع الاتصال للمزوّد الذي تريد ربطه. إذا اخترت SAML، تعرض Integrations نموذجًا منظّمًا بحقول فردية. إذا اخترت نوعًا غير SAML مثل SIP2 أو PatronSSLAPI أو OAuth أو Regex، تعرض Integrations لوحة JSON لذلك الاتصال بدلاً من ذلك.
تحديد النوع الذي يجب استخدامه
طابِق النوع مع النظام الخارجي. استخدم SAML عندما يدعم المزوّد اتحاد SAML (SAML federation) وتريد نموذجًا موجَّهًا. استخدم OAuth للمصادقة القائمة على الرموز. استخدم SIP2 أو PatronSSLAPI عند الاتصال بنظام مكتبة أو نظام مصادقة روّاد يتحدث بهذه البروتوكولات. استخدم Regex عندما يُحدَّد الوصول عبر مطابقة نمط. في كل اختيار غير SAML، يُدخل التكوين بصيغة JSON.
تحرير إعدادات الاتصال بصيغة JSON
بالنسبة لنوع غير SAML، وسّع لوحة JSON واستخدم منطقة النص في المحرر لإدخال أو تحرير إعدادات الاتصال. وبما أن هذه الأنواع لا تستخدم نموذجًا منظّمًا، تُعرَّف كل قيمة تكوين هنا كحقل ضمن JSON. أدخل صيغة JSON صحيحة حتى يقبل المحرر إدخالك. يعكس رأس اللوحة نوع الاتصال واسمه، حيث يأتي الاسم من اسم مؤسسة الاتصال أو تسمية العرض الخاصة به.
حل أي أخطاء تحقق (validation)
يتحقق المحرر من صيغة JSON خلال عملك. إذا لم يكن المحتوى صيغة JSON صالحة، تظهر رسالة خطأ أسفل منطقة النص. صحّح المشكلة المُبلَّغ عنها، مثل فاصلة مفقودة أو قوس غير متوازن، إلى أن تختفي رسالة الخطأ.
حفظ الاتصال أو إزالته
عندما تكون إعداداتك صحيحة، استخدم إجراء التحديث (Update) في اللوحة لحفظ الاتصال. لإزالة اتصال لا تحتاجه بعد الآن، استخدم إجراء الحذف (Delete) في نفس اللوحة.
الخاتمة
تدعم Integrations عدة أنواع من مزوّدي الخدمة في علامة التبويب SSO SP. يستخدم SAML نموذجًا منظّمًا، بينما تُكوَّن الأنواع غير SAML وهي SIP2 وPatronSSLAPI وOAuth وRegex من خلال تحرير إعدادات الاتصال كصيغة JSON خام في لوحة قابلة للطي. اختر النوع الذي يطابق النظام الخارجي، وحافظ على صحة صيغة JSON، وحدّث الاتصال حتى يحتفظ المسؤولون بالتحكم الكامل في المزوّدين الذين لا يملكون بعد نموذجًا ثابتًا.