ملخص
يتيح لك Integrations ربط موفري هوية تسجيل الدخول الموحد (single sign-on) بحساب معيّن. بالنسبة لموفر OAuth، تكمل نموذجًا منظّمًا من حقول الاتصال، بما في ذلك نوع المنح (grant type)، وإصدار OAuth، ونقاط نهاية الموفر، والنطاق المطلوب، وبيانات اعتماد العميل الخاصة بك. يوضح هذا المقال كيفية إعداد موفر هوية OAuth.
مقدمة
يدير Integrations موفري هوية تسجيل الدخول الموحد المرتبطين بحساب معيّن. لكل موفر هوية نوع SSO، إما SAML أو OAuth. عندما تختار OAuth، يعرض KnowledgeCity نموذجًا منظّمًا تُدخل فيه نقاط نهاية الموفر وبيانات اعتماد العميل، حتى يتمكن مستخدموك من تسجيل الدخول بهذا الموفر بدلاً من كلمة مرور KnowledgeCity منفصلة.
يستخدم هذا الإجراء المسؤولون الذين يديرون المصادقة على مستوى الحساب. وهو يمنحهم طريقة واضحة، حقلاً بحقل، لتعريف اتصال OAuth باستخدام القيم التي يوفرها موفر الهوية الخاص بهم.
المفاهيم الأساسية
- موفر هوية SSO (SSO Identity Provider): خدمة خارجية تُصادق على مستخدميك حتى يتمكنوا من تسجيل الدخول عبر تسجيل الدخول الموحد. يخزّن Integrations واحدًا أو أكثر من هذه الاتصالات لكل حساب.
- نوع SSO (SSO type): ما إذا كان الاتصال يستخدم SAML أو OAuth. يؤدي اختيار OAuth إلى إظهار حقول اتصال OAuth.
- نوع المنح (Grant Type): منح OAuth الذي يستخدمه الموفر لإصدار الرموز.
- إصدار OAuth (OAuth Version): ما إذا كان الموفر يستخدم OAuth 2.0 أو 1.0.
- عنوان الحوار (Dialog URL): نقطة نهاية التفويض الخاصة بالموفر، حيث يُرسَل المستخدم لتسجيل الدخول والموافقة على الوصول.
- عنوان رمز الوصول (Access Token URL): نقطة نهاية الموفر التي يستدعيها KnowledgeCity للحصول على رمز وصول بعد نجاح التفويض.
- عنوان معلومات المستخدم (User Info URL): نقطة نهاية الموفر التي تُعيد تفاصيل ملف المستخدم الذي سجّل الدخول.
- النطاق (Scope): مستوى الوصول الذي يطلب الطلبُ من الموفر منحَه.
- معرّف العميل وسر العميل (Client ID and Client Secret): بيانات الاعتماد التي يصدرها الموفر لتعريف KnowledgeCity وتفويضه. تعامل مع سر العميل مثل كلمة المرور.
الخطوات المطلوبة
فتح إعدادات SSO
افتح إعدادات SSO الخاصة بالحساب، حيث تُدرَج اتصالات موفري الهوية للحساب وتُدار.
إضافة موفر هوية OAuth
أضف موفر هوية جديدًا واضبط نوع SSO (SSO type) على OAuth. عندئذٍ يعرض KnowledgeCity حقول اتصال OAuth لتكملها.
إدخال تفاصيل اتصال OAuth
أكمل حقول OAuth باستخدام القيم التي يوفرها موفر الهوية الخاص بك:
- Grant Type
- OAuth Version (2.0 أو 1.0)
- Dialog URL (نقطة نهاية التفويض الخاصة بالموفر)
- Access Token URL
- User Info URL
- Scope
- Client ID
- Client Secret
أدخل كل قيمة تمامًا كما يحددها الموفر، واحفظ سر العميل بأمان.
حفظ الاتصال
احفظ الاتصال لتخزينه. يمكنك العودة إلى إعدادات SSO لاحقًا لتحديث الحقول، أو إزالة اتصال لم تعد بحاجة إليه.
الخاتمة
تعني تهيئة موفر هوية OAuth في Integrations اختيار نوع SSO الخاص بـ OAuth وإكمال حقول اتصاله المنظّمة، أي نوع المنح، وإصدار OAuth، ونقاط النهاية، والنطاق، وبيانات اعتماد العميل، ثم الحفظ. وبعد إنشاء الاتصال، يمكن لمستخدميك تسجيل الدخول من خلال موفر OAuth الذي يستخدمونه بالفعل.