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) الحساب الذي يُهيَّأ له SSOSAMLResponse(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) لاستيرادها في مزوّد الهوية الخاص بكم.