إعداد SAML SSO

ستقوم بإعداد تكاملَي تطبيقات في Okta لكل مؤسسة في ClickHouse: تطبيق SAML واحد وتطبيق إشارة مرجعية واحد لاحتواء الرابط المباشر الخاص بك.

أنشئ مجموعة لإدارة الوصول

1. سجّل الدخول إلى مثيل Okta الخاص بك بصفتك Administrator.
2. اختر Groups من الجهة اليسرى.
3. انقر على Add group.
4. أدخل اسمًا ووصفًا للمجموعة. ستُستخدم هذه المجموعة للحفاظ على اتساق المستخدمين بين تطبيق SAML وتطبيق الإشارة المرجعية المرتبط به.
5. انقر على Save.
6. انقر على اسم المجموعة التي أنشأتها.
7. انقر على Assign people لتعيين المستخدمين الذين تريد منحهم حق الوصول إلى مؤسسة ClickHouse هذه.

أنشئ تطبيق إشارة مرجعية لتمكين المستخدمين من تسجيل الدخول بسلاسة

1. اختر Applications من الجهة اليسرى، ثم اختر العنوان الفرعي Applications.
2. انقر على Browse App Catalog.
3. ابحث عن Bookmark App وحدده.
4. انقر على Add integration.
5. اختر تسمية للتطبيق.
6. أدخل عنوان URL بالشكل https://console.clickhouse.cloud/?connection={organizationid}
7. انتقل إلى علامة التبويب Assignments وأضف المجموعة التي أنشأتها أعلاه.

أنشئ تطبيق SAML لتمكين الاتصال

1. اختر Applications من الجهة اليسرى، ثم اختر العنوان الفرعي Applications.

2. انقر على Create App Integration.

3. اختر SAML 2.0 ثم انقر على Next.

4. أدخل اسمًا لتطبيقك وحدد مربع الاختيار بجوار Don't display application icon to users، ثم انقر على Next.

5. استخدم القيم التالية لملء شاشة إعدادات SAML.

   الحقل	القيمة
   Single Sign-On URL	انسخ Single Sign-On URL من Console
   Audience URI (SP Entity ID)	انسخ Service Provider Entity ID من Console
   Default RelayState	اتركه فارغًا
   Name ID format	غير محدد
   Application username	Email
   Update application username on	إنشاء وتحديث

6. أدخل Attribute Statement التالي.

   الاسم	تنسيق الاسم	القيمة
   email	Basic	user.email

7. انقر على Next.

8. أدخل المعلومات المطلوبة في شاشة Feedback ثم انقر على Finish.

9. انتقل إلى علامة التبويب Assignments وأضف المجموعة التي أنشأتها أعلاه.

10. في علامة التبويب Sign On لتطبيقك الجديد، انقر على زر Copy metadata URL.

11. ارجع إلى إضافة metadata URL إلى SAML configuration لمتابعة العملية.

ستُهيِّئ تطبيق SAML واحدًا في Google لكل مؤسسة، ويجب تزويد المستخدمين بالرابط المباشر (https://console.clickhouse.cloud/?connection={organizationId}) لإضافته إلى الإشارات المرجعية إذا كنت تستخدم تسجيل الدخول الأحادي متعدد المؤسسات.

إنشاء تطبيق ويب في Google

1. انتقل إلى وحدة تحكم Google Admin (admin.google.com).

   

2. انقر على Apps، ثم Web and mobile apps في الجهة اليسرى.

3. انقر على Add app من القائمة العلوية، ثم اختر Add custom SAML app.

4. أدخل اسمًا للتطبيق ثم انقر على Continue.

5. انسخ URL البيانات الوصفية واحفظه في مكان ما.

6. أدخل ACS URL وEntity ID أدناه.

   Field	Value
   ACS URL	انسخ URL تسجيل الدخول الأحادي من وحدة التحكم
   Entity ID	انسخ معرّف كيان موفّر الخدمة من وحدة التحكم

7. حدِّد مربع Signed response.

8. اختر EMAIL في Name ID Format واترك Name ID على Basic Information > Primary email.

9. انقر على Continue.

10. أدخل تعيين السمات التالي:

    Field	Value
    المعلومات الأساسية	البريد الإلكتروني الأساسي
    سمات التطبيق	email

11. انقر على Finish.

12. لتمكين التطبيق، انقر على OFF للجميع ثم غيّر الإعداد إلى ON للجميع. ويمكن أيضًا تقييد الوصول على مجموعات أو وحدات تنظيمية معيّنة من خلال تحديد الخيارات في الجانب الأيسر من الشاشة.

13. ارجع إلى إضافة URL البيانات الوصفية إلى تهيئة SAML لمتابعة العملية.

قد يُشار أيضًا إلى Azure (Microsoft) SAML باسم Azure Active Directory (AD) أو Microsoft Entra.

أنشئ تطبيق Azure للمؤسسات

ستُعدّ تكامل تطبيق واحد مع URL تسجيل دخول منفصل لكل organization.

1. سجّل الدخول إلى مركز إدارة Microsoft Entra.

2. انتقل إلى Applications > Enterprise applications في الجانب الأيسر.

3. انقر على New application في القائمة العلوية.

4. انقر على Create your own application في القائمة العلوية.

5. أدخل اسمًا، ثم حدّد Integrate any other application you don't find in the gallery (Non-gallery)، وبعد ذلك انقر على Create.

   

6. انقر على Users and groups في الجانب الأيسر، ثم عيّن المستخدمين.

7. انقر على Single sign-on في الجانب الأيسر.

8. انقر على SAML.

9. استخدم الإعدادات التالية لملء شاشة Basic SAML Configuration.

   الحقل	القيمة
   Identifier (Entity ID)	انسخ Service Provider Entity ID من Console
   Reply URL (Assertion Consumer Service URL)	انسخ Single Sign-On URL من Console
   Sign on URL	https://console.clickhouse.cloud/?connection={organizationid}
   Relay State	اتركه فارغًا
   Logout URL	اتركه فارغًا

10. أضف (A) أو حدّث (U) ما يلي ضمن Attributes & Claims:

    اسم المطالبة	التنسيق	سمة المصدر
    (U) Unique User Identifier (Name ID)	عنوان البريد الإلكتروني	user.mail
    (A) email	Basic	user.mail
    (U) /identity/claims/name	محذوف	user.mail

    

11. انسخ metadata URL ثم ارجع إلى أضف metadata URL إلى تكوين SAML لمتابعة العملية.

أنشئ موفر خدمة SAML عامًا لـ Duo

1. اتبع الإرشادات الخاصة بـ Duo Single Sign-On for Generic SAML Service Providers.

2. استخدم تعيين Bridge Attribute التالي:

   Bridge Attribute	ClickHouse Attribute
   عنوان البريد الإلكتروني	email

3. استخدم القيم التالية لتحديث تطبيق Cloud لديك في Duo:

   Field	Value
   Entity ID	انسخ Service Provider Entity ID من وحدة التحكم
   Assertion Consumer Service (ACS) URL	انسخ Single Sign-On URL من وحدة التحكم
   Service Provider Login URL	https://console.clickhouse.cloud/?connection={organizationid}

4. انسخ metadata URL ثم ارجع إلى إضافة metadata URL إلى SAML configuration لمتابعة العملية.