GET/api/sso/:tenantSlug/oidc/callback

يستقبل تحويل مزوّد الهوية بعد تسجيل الدخول عبر OIDC، ويعيد توجيه المتصفح إلى Zentor App.

يستدعي هذا المسار مزوّد الهوية فقط عبر تحويل المتصفح؛ ويجب إدراجه في إعداداته كـ Redirect-URI. في حال النجاح، تُعيد Zentor App توجيه المتصفح مع الرمز لمرة واحدة في معامل الاستفسار `sso_code`؛ ويُستبدَل هذا الرمز عبر `POST /api/auth/sso/exchange` برمز وصول. في حال حدوث خطأ — مثل غياب معامل الأمان `state` أو عدم صلاحيته — يُعيد الخادم التوجيه إلى صفحة تسجيل الدخول مع معامل الاستفسار `sso_error`، على سبيل المثال `sso_error=SSO_STATE_MISSING`. ابدأوا تسجيل الدخول من جديد في هذه الحالة.

نظرة عامة

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

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

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

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

المعلمات

tenantSlug(path, string، إلزامي)— مُعرِّف (Slug) الحساب الذي يُهيَّأ له SSO

مثال استجابة

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

رموز الأخطاء

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

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

دون `state` صالح، يُعيد الخادم التوجيه بـ302 و`sso_error=SSO_STATE_MISSING` إلى صفحة تسجيل الدخول.

روبوت الدردشة التجريبي و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/saml/startيبدأ تسجيل الدخول عبر SAML ويوجّه المتصفح إلى مزوّد الهوية المُهيَّأ.POST /api/sso/:tenantSlug/saml/acsخدمة استقبال التأكيد (ACS): تستقبل استجابة SAML الموقَّعة من مزوّد الهوية عبر POST عبر نموذج.GET /api/sso/:tenantSlug/saml/metadataيُقدّم بيانات تعريف SAML الخاصة بـ Zentor App (XML) لاستيرادها في مزوّد الهوية الخاص بكم.

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

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