إعداد مصادقة SAML

هذه عبارة عن دليل لإعداد المصادقة باستخدام SAML لحسابك، يفترض الدليل أن لديك موفر هوية (IdP) خاص بالعمل.

قبل أن تبدأ، هناك بعض النقاط التي يجب الانتباه إليها

• بمجرد تمكين SAML، لن يتمكن المستخدمون من الوصول إلى Chatwoot باستخدام كلمات المرور الخاصة بهم. عند تعطيل SAML، سيعود هذا السلوك كما كان.

• إذا كان المستخدم جزءًا من حسابات متعددة، وكان أي حساب منها يحتوي على إعداد SAML، فسيتعين عليه تسجيل الدخول عبر موفر SAML IdP فقط. من الأفضل تقييد المستخدمين ليكونوا ضمن نطاقك فقط.

إعداد SAML

يمكنك العثور على إعدادات SAML تحت الإعدادات > الأمان. فيما يلي الإعدادات التي يجب أن تكون على علم بها.

• رابط الدخول الموحد (SSO URL): العنوان المحدد عبر HTTPS على موفر الهوية حيث تبدأ عملية تسجيل الدخول عبر SAML؛ يقوم تطبيقك بإعادة توجيه المستخدمين هنا للمصادقة. فكر فيه كنقطة دخول "تسجيل الدخول" لموفر الهوية التي تقبل طلبات المصادقة SAML وتبدأ تدفق الدخول الموحد.

• معرّف كيان موفر الهوية (Identity Provider Entity ID): معرف فريد عالميًا (عادة سلسلة تبدو كـ URI) يحدد موفر الهوية في بيانات تعريف SAML. يستخدم موفر الخدمة هذا المعرف لاختيار إعدادات IdP الصحيحة وللتحقق من أن رسائل SAML الواردة تدعي فعليًا أنها من ذلك IdP.

• شهادة التوقيع (Signing Certificate): شهادة X.509 العامة لموفر الهوية والتي تُستخدم لتوقيع الاستجابات/الإثباتات الخاصة بـ SAML. يخزّن موفر الخدمة هذه الشهادة ويتحقق من التوقيعات باستخدامها، مما يضمن أن الرسالة لم يتم تغييرها وأنها جاءت فعلاً من موفر الهوية.

بعد الإعداد، ستجد المعلومات المطلوبة لتسجيل Chatwoot كمزود خدمة (SP) على موفر SAML الخاص بك. هذه هي التفاصيل التي ستحصل عليها

• رابط خدمة استقبال الإثباتات (ACS URL): نقطة النهاية الخاصة بخدمة استقبال الإثباتات على موفر الخدمة والتي تستلم استجابة SAML من موفر الهوية. بعد مصادقة المستخدم، يرسل IdP الإثبات الموقّع إلى هذا الرابط عبر HTTPS، حيث يقوم تطبيقك بالتحقق منه وإنشاء جلسة تسجيل دخول.

• معرّف كيان موفر الخدمة (SP Entity ID): المعرّف الفريد (غالبًا ما يكون URI) لموفر الخدمة في بيانات تعريف SAML. يستخدم IdP هذه القيمة للتأكد من أنه يصدر استجابة للتطبيق الصحيح ولاختيار رابط ACS الصحيح والإعدادات المناسبة.

في حال كنت بحاجة إلى هذه المعلومات بشكل مسبق، إليك الصيغة الخاصة بها

• رابط ACS: <your-chatwoot-installation>/omniauth/saml/callback?account_id=<your-account-id>

• معرّف كيان SP: <your-chatwoot-installation>/saml/sp/<your-account-id>

تعيين البيانات

يجب تكوين تعيين السمات التالية في موفر الهوية الخاص بك

• email

• first_name

• last_name

عند تسجيل دخول المستخدم لأول مرة، تُستخدم هذه المعلومات لإنشاء مستخدم جديد له. ولا تقوم بتحديث المعلومات بعد ذلك.

المصادقة

يمكنك الانتقال إلى هذا الرابط https://app.chatwoot.com/app/login/sso لعرض نموذج تسجيل الدخول عبر SAML. فقط أدخل عنوان البريد الإلكتروني وسيقوم التطبيق بإعادة توجيهك إلى موفر SAML الذي تم إعداده.