POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): приймає підписану SAML-відповідь провайдера ідентифікації через форму POST.
Цей кінцевий пункт викликається виключно провайдером ідентифікації; його потрібно вказати в його налаштуваннях як ACS-URL (див. `saml/metadata`). Провайдер ідентифікації надсилає закодовану в base64 підписану відповідь у полі форми `SAMLResponse`. У разі успіху Zentor App переспрямовує браузер назад з одноразовим кодом у query-параметрі `sso_code`; цей код обмінюється на токен доступу через `POST /api/auth/sso/exchange`. Якщо відповідь недійсна або відсутній відповідний процес входу, сервер переспрямовує на сторінку входу з query-параметром `sso_error`, наприклад `sso_error=SSO_STATE_MISSING`.
Огляд
Виклик: POST /api/sso/:tenantSlug/saml/acs. Цей ендпоінт належить до групи «Демо-чат-бот і SSO» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: tenantSlug (шлях), SAMLResponse (тіло). Задокументовані випадки помилок: 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) для імпорту у вашого провайдера ідентифікації.