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) для импорта в вашего провайдера идентификации.