إذا كنت أنت أو أعضاء فريقك تواجهون صعوبة في تسجيل الدخول إلى AI Studios باستخدام SAML SSO، فعادةً ما تكون المشكلة ناتجة عن خطأ في إعدادات موفّر الهوية (IdP). سيرشدك هذا الدليل إلى الأسباب الأكثر شيوعًا وكيفية حلها.
تأكّد من أنك تستخدم SAML SSO
يدعم AI Studios تسجيل الدخول الموحّد (SSO) المستند إلى SAML 2.0. البروتوكولات الأخرى مثل OAuth أو OpenID غير مدعومة.
لاستخدام SSO، يجب أن يتوفر لدى شركتك ما يلي:
موفّر هوية متوافق مع SAML (مثل Okta أو Microsoft Entra ID / Azure AD)
تطبيق SAML مُعدّ بشكل صحيح
إذا لم تكن متأكدًا مما إذا كانت مساحة العمل تستخدم SSO، فتواصل مع فريق تقنية المعلومات أو مسؤول مساحة العمل.
المشكلات الشائعة وكيفية حلها
1. عدم التطابق التام بين حساب تسجيل الدخول في IdP والبريد الإلكتروني لتسجيل الدخول في AI Studios (مع مراعاة حالة الأحرف)
• عند تسجيل الدخول عبر MS Entra ID، تُمرَّر قيمة Unique User Identifier إلى AI Studios • يجب أن تتطابق هذه القيمة تمامًا (بما في ذلك حالة الأحرف) مع البريد الإلكتروني لتسجيل الدخول في AI Studios
كيفية الحل
الحالة 1. تغيير القيمة المحددة في Unique User Identifier
غيّر Unique User Identifier إلى user.displayname
اضبط Display name لكل مستخدم بحيث يطابق تمامًا (بما في ذلك حالة الأحرف) بريده الإلكتروني لتسجيل الدخول في AI Studios
دليل تغيير المعرّف الفريد للمستخدم في Microsoft Entra ID
دليل تغيير المعرّف الفريد للمستخدم في Microsoft Entra ID
الخطوة 1: انتقل إلى Attributes & Claims لتطبيق AI Studios في Microsoft Entra ID.
حدّد صف Unique User Identifier وانقر على Edit.
الخطوة 2: في صفحة التعديل، ابحث مرة أخرى عن حقل Unique User Identifier.
انقر على قائمة النقاط الثلاث في الجانب الأيمن من ذلك الصف.
الخطوة 3: في قائمة Manage Claim، ابحث عن مربع النص Source attribute.
غالبًا ما يكون مضبوطًا افتراضيًا على user.userprincipalname. غيّر هذه القيمة إلى:
user.displayname
الخطوة 5: انقر على Save.
الخطوة 6: تأكّد من أن كل مستخدم قد ضُبط بريده الإلكتروني لتسجيل الدخول في AI Studios كاسم العرض (Display name).
الحالة 2. الضبط لتمرير Unique User Identifier بأحرف صغيرة !! شرط مسبق !!
لا تصلح هذه الطريقة إلا إذا كان User principal name يطابق البريد الإلكتروني لتسجيل الدخول في AI Studios تمامًا، مع اختلاف في حالة الأحرف فقط
اضبط Transformation على ToLowercase(user.userprincipalname)
دليل إدارة التحويل (Transformation) في Microsoft Entra ID
دليل إدارة التحويل (Transformation) في Microsoft Entra ID
الخطوة 1: انتقل إلى Attributes & Claims لتطبيق AI Studios في Microsoft Entra ID.
حدّد صف Unique User Identifier وانقر على Edit.
الخطوة 2: في صفحة التعديل، ابحث مرة أخرى عن حقل Unique User Identifier.
انقر على قائمة النقاط الثلاث في الجانب الأيمن من ذلك الصف.
الخطوة 3: غيّر إعداد Source إلى Transformation. يكون مضبوطًا افتراضيًا على Attribute.
الخطوة 4: في قائمة Manage Transformation، اضبط Transformation على ToLowercase() .
الخطوة 5: اضبط Parameter 1 على attribute. ثم اختر user.userprincipalname من قائمة Attribute Name.
الخطوة 6: احفظ (Save) وتحقق مرة أخرى من حفظ هذا التحويل بشكل صحيح ضمن Unique User Identifier. يجب أن يظهر على النحو التالي: ToLowercase (user.userprincipalname)
2. إعداد مساحة العمل غير مكتمل
إذا لم يعمل رابط تسجيل الدخول عبر SSO، فقد يكون إعداد SSO لمساحة العمل غير مكتمل أو غير مفعّل.
كيفية الحل
يجب على مسؤول مساحة العمل:
النقر على صورة الملف الشخصي، واختيار Setting، ثم النقر على SAML SSO في القائمة اليسرى
التأكد من ملء جميع حقول IdP
التأكد من أن مفتاح SSO مفعّل
التحقق من نسخ ACS URL وEntity ID إلى IdP بشكل صحيح
3. بيانات IdP أو الشهادة غير صحيحة
قد يفشل SSO إذا كان أيّ مما يلي غير صحيح:
SSO Login URL
IdP Issuer
X.509 Certificate
انتهاء صلاحية الشهادة
كيفية الحل
راجع إعدادات موفّر الهوية مقارنةً بالحقول المتوفرة في AI Studios:
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 Certificate
هل ما زلت بحاجة إلى مساعدة؟
إذا تحققت من كل ما سبق وما زال SSO لا يعمل:
التقط لقطة شاشة لإعدادات SAML في موفّر الهوية
دوّن عنوان البريد الإلكتروني المستخدم أثناء تسجيل الدخول
تواصل مع مدير حسابك المخصص وزوّده بالتفاصيل
سنساعدك في استكشاف المشكلة وحلها من هناك.