GET/api/sso/:tenantSlug/saml/start

Запускає вхід через SAML і переспрямовує браузер до налаштованого провайдера ідентифікації.

Викликайте кінцевий пункт через навігацію браузера. Якщо SAML налаштовано, сервер відповідає переспрямуванням (302) до провайдера ідентифікації; його відповідь потім надходить на `saml/acs`. Якщо SAML не налаштовано для акаунта, сервер відповідає кодом 404 `SSO_NOT_CONFIGURED` і повідомленням про помилку у форматі JSON.

Огляд

Виклик: GET /api/sso/:tenantSlug/saml/start. Цей ендпоінт належить до групи «Демо-чат-бот і SSO» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик ідемпотентний: повторні виклики з тими самими даними повертають той самий результат. Обов’язкові параметри: tenantSlug (шлях). Задокументовані випадки помилок: 404 -.

Автентифікація та захист

Автентифікація не потрібна

Ідемпотентний: Так

Параметри

tenantSlug(path, string, обов'язково)— Ідентифікатор (slug) акаунта, для якого налаштовано SSO

Приклад відповіді

(переспрямування 302 до провайдера ідентифікації, якщо SAML налаштовано для акаунта)

Коди помилок

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.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): приймає підписану SAML-відповідь провайдера ідентифікації через форму POST.GET /api/sso/:tenantSlug/saml/metadataПовертає SAML-метадані Zentor App (XML) для імпорту у вашого провайдера ідентифікації.

Споріднені статті

← Демо-чат-бот і SSO