إعداد تسجيل الدخول الموحد (SSO)
آخر تحديث
أعد تسجيل الدخول عبر SAML 2.0 أو OpenID Connect في AI CodeOps ضمن خطة Enterprise: تحقق من نطاقك، وأنشئ اتصالا، واضبط مزود الهوية (IdP) لديك، ثم فعّله.
يتيح تسجيل الدخول الموحد لأشخاصك الدخول إلى AI CodeOps عبر مزود الهوية (IdP) الخاص بكم، ببروتوكول SAML 2.0 أو OpenID Connect (OIDC). ويعمل أي مزود هوية يدعم أحد البروتوكولين؛ وتدخل تفاصيله بنفسك، فلا توجد إعدادات مسبقة للمزودين.
قبل أن تبدأ
- الخطة. SSO جزء من خطة Enterprise، وكذلك التحقق من النطاق. ومن دونها، تعرض البطاقة "SSO (SAML 2.0 / OIDC) is available on the Enterprise plan." راجع Enterprise.
- من يستطيع إعداده. SSO يخص المؤسسة، لا مساحة عمل واحدة. ويرى البطاقة مالكو المؤسسة ومسؤولوها. ولا يستطيع إنشاء اتصال وتعديله وتفعيله إلا مالك. ويستطيع المالكون والمسؤولون التحقق من النطاقات، وضبط مساحة العمل الافتراضية لـ SSO، وتعطيل الاتصالات وحذفها.
- الوصول إلى DNS. تحتاج إلى إضافة سجل TXT لنطاق بريدك الإلكتروني.
الإعدادات موجودة في Configure → Settings، في البطاقة Single sign-on.
1. تحقق من نطاقك
- ضمن Verified Domains، أدخل نطاق بريدك الإلكتروني، مثل
example.com، واختر Verify a domain (التحقق من نطاق). - أضف سجل TXT المعروض إلى DNS لديك: - الاسم (Name):
_codeopsstudio-verify.example.com- القيمة (Value): الرمز الظاهر على الشاشة - اختر Check now (تحقق الآن). قد تأخذ تغييرات DNS وقتا لتظهر، فتحقق مرة أخرى لاحقا إذا لم يكن النطاق موثقا بعد.
لا تستطيع إنشاء اتصال لنطاق قبل التحقق منه.
2. أنشئ اتصالا
- اختر Add SSO connection (إضافة اتصال SSO).
- في New SSO Connection، املأ:
| الحقل | SAML 2.0 | OpenID Connect |
|---|---|---|
| Protocol | SAML 2.0 | OpenID Connect |
| Display Name | اسم تعرفه، مثل "Okta" | اسم، مثل "Azure AD" |
| Email Domain | نطاق موثق | نطاق موثق |
| Default Role | الدور Member أو Developer أو Viewer | الدور Member أو Developer أو Viewer |
| تفاصيل IdP | IdP Entity ID, IdP SSO URL, IdP Certificate (PEM) | Issuer URL, Client ID, Client Secret |
- اختر Create Connection (إنشاء الاتصال).
سر عميل OIDC يشفر وهو مخزن. ولا يوجد حقل لعنوان بيانات IdP الوصفية؛ فانسخ القيم من مزود الهوية لديك.
3. اضبط مزود الهوية لديك
تعرض بطاقة الاتصال القيم التي يحتاج إليها مزود الهوية:
| البروتوكول | التسمية | المسار | الاستخدام |
|---|---|---|---|
| SAML | Metadata URL | /sso/saml/<connection-id>/metadata | البيانات الوصفية لمزود الخدمة، ومعرف الكيان له |
| SAML | ACS URL | /sso/saml/<connection-id>/acs | خدمة Assertion Consumer Service (عبر HTTP-POST) |
| OIDC | Redirect URI | /sso/oidc/<connection-id>/callback | عنوان إعادة التوجيه لتطبيق OIDC لديك |
المسارات تكون على عنوان لوحة التحكم، مثل https://console.aicodeops.dev.
SAML. أرسل عنوان البريد الإلكتروني للمستخدم بوصفه NameID (بصيغة عنوان البريد الإلكتروني) أو بوصفه السمة email. ويجب أن توقّع التأكيدات (assertions) بالشهادة التي أدخلتها. ويفحص AI CodeOps التوقيع، والجمهور المستهدف (audience)، وانتهاء الصلاحية، وأن الرد يجيب عن تسجيل دخول بدأه هو. ويجب أن يبدأ تسجيل الدخول من AI CodeOps؛ فالمربع في لوحة مزود الهوية لديك لن يعمل.
OIDC. يطلب AI CodeOps النطاقات openid email profile ويستخدم PKCE.
4. فعّل الاتصال وشارك الرابط
الاتصال الجديد يكون قيد الاختبار إلى أن تفعله. وما دام كذلك، لا يسجل دخول إلا الأشخاص الموجودين أصلا في مؤسستك، ولا ينشئ حسابات. ولتجربته بحسابك، افتح /sso/saml/<connection-id>/login أو /sso/oidc/<connection-id>/login على عنوان لوحة التحكم.
- في بطاقة الاتصال، اختر Activate (تفعيل).
- شارك رابط تسجيل الدخول مع أشخاصك:
https://console.aicodeops.dev/sso/login?domain=example.com
يفتح الرابط صفحة Continue with single sign-on إذا كان النطاق مفقودا، فيستطيع الأشخاص أيضا كتابة بريد العمل هناك. ويجد الاتصال المفعل للنطاق ويرسلهم إلى مزود الهوية لديك.
المستخدمون الجدد والأدوار
أول تسجيل دخول عبر SSO ينشئ حساب الشخص إذا لم يكن له حساب ويضيفه إلى مؤسستك.
لوضع الأشخاص الجدد مباشرة في مساحة عمل، افتح إعدادات تلك المساحة واختر Set this workspace as SSO default في بطاقة الاتصال. فينضمون إليها بالدور المحدد في Default Role للاتصال. ومن دون مساحة عمل افتراضية يصلون إلى مساحة عملهم الشخصية إلى أن يدعوهم أحد. ويمكنك تغيير دورهم لاحقا؛ راجع الأدوار والصلاحيات.
الجلسات تبقى داخل مؤسستك
تسجيل الدخول عبر SSO الخاص بكم لا يصل إلا إلى مساحات عمل مؤسستك وإلى مساحة العمل الشخصية للشخص نفسه. ومساحات عمل المؤسسات الأخرى ممنوعة في تلك الجلسة، حتى لو كان الشخص عضوا فيها.
التعطيل أو الحذف
- الخيار Deactivate يوقف عمليات تسجيل الدخول الجديدة عبر SSO ويبقي الإعداد.
- الخيار Delete يزيل الاتصال بعد أن تؤكد بالزر Delete connection. وبعدها يسجل مستخدموه الدخول بكلمة مرور أو بحساب اجتماعي.
تسجل تغييرات SSO بوصفها أحداث تدقيق من النوعين sso.connection.* و sso.domain.* على المؤسسة. ولا تظهر في صفحة سجل التدقيق الخاصة بمساحة العمل، وتحفظ 7 أيام.
الخطوات التالية
الأسئلة الشائعة
أي خطة تتضمن SSO؟
خطة Enterprise. وفي الخطط الأخرى تذكر بطاقة Single sign-on أن SSO متاح في خطة Enterprise.
أين عنوان بيانات SAML الوصفية (metadata)؟
في بطاقة الاتصال بعد أن تنشئ الاتصال، بالتسمية Metadata URL. وصيغته /sso/saml/<connection-id>/metadata وهو أيضا معرف الكيان (entity ID) لمزود الخدمة.
هل يستطيع الأشخاص مع ذلك تسجيل الدخول بكلمة مرور بعد تشغيل SSO؟
نعم. يضيف SSO طريقة لتسجيل الدخول؛ ولا يوقف تسجيل الدخول بكلمة المرور أو بالحسابات الاجتماعية لنطاقك.