POST/api/sso/:tenantSlug/saml/acs

خدمة استقبال التأكيد (ACS): تستقبل استجابة SAML الموقَّعة من مزوّد الهوية عبر POST عبر نموذج.

يستدعي هذا المسار مزوّد الهوية فقط؛ ويجب إدراجه في إعداداته كعنوان ACS (انظر `saml/metadata`). يُرسل مزوّد الهوية الاستجابة الموقَّعة والمُشفَّرة بـbase64 في حقل النموذج `SAMLResponse`. في حال النجاح، تُعيد Zentor App توجيه المتصفح مع الرمز لمرة واحدة في معامل الاستفسار `sso_code`؛ ويُستبدَل هذا الرمز عبر `POST /api/auth/sso/exchange` برمز وصول. إذا كانت الاستجابة غير صالحة أو غابت عملية تسجيل الدخول المرتبطة بها، يُعيد الخادم التوجيه إلى صفحة تسجيل الدخول مع معامل الاستفسار `sso_error`، على سبيل المثال `sso_error=SSO_STATE_MISSING`.

نظرة عامة

الاستدعاء: POST /api/sso/:tenantSlug/saml/acs. تنتمي نقطة النهاية هذه إلى مجموعة «روبوت الدردشة التجريبي وSSO» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: tenantSlug (المسار), SAMLResponse (النص (Body)). حالات الخطأ الموثقة: 302 SSO_STATE_MISSING.

المصادقة والأمان

لا يلزم أي مصادقة

متطابق القوة: لا

المعلمات

tenantSlug(path, string، إلزامي)— مُعرِّف (Slug) الحساب الذي يُهيَّأ له SSO
SAMLResponse(body, string، إلزامي)— استجابة SAML الموقَّعة من مزوّد الهوية (XML، مُشفَّرة بـbase64) كحقل نموذج

مثال استجابة

تحويل 302 إلى https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (مثال دون استجابة SAML صالحة)

رموز الأخطاء

302 SSO_STATE_MISSING — إعادة توجيه إلى صفحة تسجيل الدخول مع `sso_error`، إذا كانت استجابة SAML غير صالحة أو غابت عملية تسجيل الدخول المرتبطة.

السلوك المُتحقَّق منه

استجابة `SAMLResponse` غير صالحة تؤدي إلى التحويل (302) مع `sso_error` إلى صفحة تسجيل الدخول.

روبوت الدردشة التجريبي وSSO

POST /api/global-chatbot/demoيُرسل رسالة إلى روبوت الدردشة التجريبي العام على zentor-app.de/demo ويُرجع رده. يمكن تجربة العرض التجريبي في المتصفح دون تسجيل.GET /api/global-chatbot/demo/historyيحمّل سجل الرسائل السابق لمحادثة تجريبية، بحيث يبقى محفوظًا عند إعادة فتح العرض التجريبي.POST /api/global-chatbot/demo/pollيستدعي الرسائل الجديدة لمحادثة تجريبية، كما يحدث عند تولّي أحد موظفي Zentor المحادثة. تستدعي صفحة العرض التجريبي هذا المسار على فترات.POST /api/global-chatbot/demo/ratingيحفظ تقييم محادثة تجريبية (مفيدة أو غير مفيدة) مع تعليق اختياري.POST /api/global-chatbot/demo/trackيسجّل أحداث استخدام مجهولة الهوية لصفحة العرض التجريبي لإحصاءات زوار Zentor.POST /api/global-chatbot/demo/voice-transcribeيحوّل تسجيلًا صوتيًا على صفحة العرض التجريبي إلى نص (إدخال صوتي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.POST /api/global-chatbot/demo/voice-speakيحوّل النص إلى كلام منطوق (إخراج صوتي في صفحة العرض التجريبي)، إذا كانت وظيفة الصوت في العرض التجريبي مفعّلة.GET /api/sso/:tenantSlug/statusيتحقق مما إذا كان تسجيل الدخول الموحد (SAML أو OIDC) مُهيَّأ لحساب معيّن. تستخدم صفحة تسجيل الدخول النتيجة لعرض خيار الدخول عبر SSO.GET /api/sso/:tenantSlug/oidc/startيبدأ تسجيل الدخول عبر OpenID Connect ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.GET /api/sso/:tenantSlug/oidc/callbackيستقبل تحويل مزوّد الهوية بعد تسجيل الدخول عبر OIDC، ويعيد توجيه المتصفح إلى Zentor App.GET /api/sso/:tenantSlug/saml/startيبدأ تسجيل الدخول عبر SAML ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.GET /api/sso/:tenantSlug/saml/metadataيُقدّم بيانات تعريف SAML الخاصة بـ Zentor App (XML) لاستيرادها في مزوّد الهوية الخاص بكم.

مقالات ذات صلة

← روبوت الدردشة التجريبي وSSO