إعداد SSO مع Okta

قم بإعداد تسجيل الدخول الموحد بين Okta وClevera ليتمكن فريقك من تسجيل الدخول باستخدام حساب Okta الخاص بهم. يمكنك الاتصال باستخدام SAML 2.0 أو OpenID Connect (OIDC)؛ يستعرض هذا الدليل كلاً من الجانب الخاص بـ Okta والحقول المطابقة لها في Clevera.

تتغير وحدة تحكم المسؤول في Okta من وقت لآخر. إذا لم يتطابق أحد الملصقات أدناه مع ما تراه، فابحث عن الإعداد الذي يحمل نفس المعنى، واستخدم الأدلة العامة للحصول على القائمة الكاملة للقيم: SAML، OIDC.

قبل البدء#

• أنت المالك لمساحة عمل Clevera ضمن خطة مخصصة.
• أنت مسؤول في Okta ولديك صلاحية إنشاء عمليات تكامل التطبيقات وتعيينها.
• أنت تعرف نطاقات البريد الإلكتروني التي يستخدمها فريقك في Okta، مثل acme.example.

افتح مربع حوار الإعداد في Clevera أولاً حتى تتمكن من نسخ القيم منه: افتح قائمة مساحة العمل في أعلى الشريط الجانبي، واختر إعدادات الفريق، ثم الأمان، وانقر على إعداد SSO. اختر Okta كـ مزود الهوية.

الاتصال باستخدام SAML 2.0#

1. إنشاء التطبيق في Okta#

   في وحدة تحكم مسؤول Okta، انتقل إلى Applications → Applications وانقر على Create App Integration. اختر SAML 2.0 وانقر على التالي. قم بتسميته Clevera وانقر على التالي.

2. إدخال قيم Clevera#

   تحت SAML Settings، املأ ما يلي:

   حقل Okta	القيمة من Clevera
   Single sign-on URL	ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. تأكد من تفعيل خيار Use this for Recipient URL and Destination URL.
   Audience URI (SP Entity ID)	Entity ID / Audience URI (انسخه من مربع حوار Clevera؛ ينتهي بمعرف مساحة العمل الخاص بك)
   Default RelayState	اتركه فارغاً
   Name ID format	EmailAddress
   Application username	Email

3. التحقق من التوقيع#

   انقر على Show Advanced Settings وتأكد من أن كلاً من Response و Assertion Signature مضبوطان على Signed، وأن Signature Algorithm هو RSA-SHA256، وأن Assertion Encryption هو Unencrypted. يحتاج Clevera إلى توقيع كل من الاستجابة والتأكيد.

4. إضافة سمات الاسم#

   تحت Attribute Statements، أضف firstName بالقيمة user.firstName و lastName بالقيمة user.lastName. يستخدمها Clevera لتسمية الحسابات الجديدة. انقر على التالي، وأجب على سؤال ملاحظات Okta بأنه تطبيق داخلي، ثم انقر على إنهاء.

5. نسخ قيم Okta إلى Clevera#

   في علامة التبويب Sign On الخاصة بالتطبيق، افتح تفاصيل إعداد SAML (View SAML setup instructions، أو More details في الإصدارات الأحدث من وحدة التحكم). في Clevera، اضبط Protocol على SAML 2.0، وانقر على متابعة، والصق القيم التالية:

   قيمة Okta	حقل Clevera
   Identity Provider Issuer (أو Issuer)	IdP Entity ID
   Identity Provider Single Sign-On URL (أو Sign on URL)	SSO sign-in URL
   X.509 Certificate (أو Signing Certificate)	X.509 certificate

   اترك Logout URL فارغاً ما لم تكن تستخدم تسجيل الخروج الموحد من Okta.

   

6. تعيين المستخدمين#

   في علامة التبويب Assignments الخاصة بالتطبيق، انقر على Assign وأضف الأشخاص أو المجموعات الذين يجب أن يستخدموا Clevera. الأشخاص غير المعينين لن يتمكنوا من تسجيل الدخول عبر Okta.

ثم أكمل الإعداد في Clevera: النطاقات والأدوار.

الاتصال باستخدام OpenID Connect#

1. إنشاء التطبيق في Okta#

   انتقل إلى Applications → Applications → Create App Integration. اختر OIDC - OpenID Connect، ثم Web Application، وانقر على التالي.

2. تعيين رابط إعادة التوجيه (Redirect URI)#

   في مربع حوار إعداد Clevera، اضبط Protocol على OpenID Connect وانسخ Redirect URI (callback URL) من المربع الرمادي. ثم املأ البيانات في Okta:

   حقل Okta	القيمة
   App integration name	Clevera
   Grant type	Authorization Code
   Sign-in redirect URIs	Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
   Sign-out redirect URIs	احذف المثال؛ اتركه فارغاً
   Controlled access	اختر من يمكنه استخدام التطبيق، أو Skip group assignment for now للتعيين لاحقاً

   انقر على حفظ.

3. نسخ بيانات الاعتماد#

   في علامة التبويب General الخاصة بالتطبيق، تحت Client Credentials، انسخ Client ID و Client secret. اترك Client authentication مضبوطاً على Client secret.

4. التعبئة في Clevera#

   في Clevera، انقر على متابعة وأدخل:

   حقل Clevera	القيمة
   Client ID	Client ID الخاص بـ Okta
   Client secret	Client secret الخاص بـ Okta
   Discovery URL	https:// نطاق Okta الخاص بك /.well-known/openid-configuration، على سبيل المثال https://acme.okta.com/.well-known/openid-configuration

   إذا كنت تستخدم خادم تفويض مخصصاً، فاستخدم رابط الاكتشاف (Discovery URL) الخاص به بدلاً من ذلك، على سبيل المثال https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

   

5. تعيين المستخدمين#

   في علامة التبويب Assignments، قم بتعيين الأشخاص أو المجموعات الذين يجب أن يستخدموا Clevera.

الإنهاء في Clevera#

1. في النطاقات والأدوار، أضف كل نطاق بريد إلكتروني يمتلكه مستخدمو Okta، واختر إنشاء حسابات عند تسجيل الدخول لأول مرة و الدور الافتراضي لأعضاء SSO الجدد.
2. في مراجعة، انقر على حفظ التكوين.
3. انقر على تشغيل الاختبار، وقم بتفعيل تمكين SSO، وسجل الدخول كمستخدم اختبار معين في نافذة خاصة، بدءاً من صفحة تسجيل الدخول إلى Clevera.
4. عندما يعمل كل شيء بشكل صحيح، قم بتفعيل طلب SSO إذا كنت تريد أن يكون SSO هو الطريقة الوحيدة لتسجيل الدخول.

يقوم الأعضاء بعد ذلك بكتابة بريدهم الإلكتروني الخاص بالعمل في صفحة تسجيل الدخول إلى Clevera والنقر على متابعة مع Okta.

استكشاف الأخطاء وإصلاحها#

المزيد من الرسائل: إصلاح مشاكل تسجيل الدخول عبر SSO.

ذات صلة#