GET/api/sso/:tenantSlug/saml/metadata

يُقدّم بيانات تعريف SAML الخاصة بـ Zentor App (XML) لاستيرادها في مزوّد الهوية الخاص بكم.

تحتوي البيانات التعريفية في جملتها على المُعرِّف الفريد (Entity-ID) وعنوان ACS الذي يحتاجه مزوّد الهوية الخاص بكم للإعداد. الاستجابة هي وثيقة XML، لا JSON. إذا لم يكن SAML مُهيَّأ للحساب، يستجيب الخادم بـ404 `SSO_NOT_CONFIGURED`.

نظرة عامة

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

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

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

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

المعلمات

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

مثال استجابة

(بيانات تعريف SAML بصيغة XML، إذا كان SAML مُهيَّأ للحساب — دون JSON)

رموز الأخطاء

404 - — SAML غير مُهيَّأ لهذا الحساب.

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

حساب بلا SAML يُعيد الاستدعاء له 404.

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

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

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