GET/api/sso/:tenantSlug/saml/metadata
Возвращает SAML-метаданные Zentor App (XML) для импорта в вашего провайдера идентификации.
Метаданные содержат, среди прочего, Entity-ID и ACS-URL, которые нужны вашему провайдеру идентификации для настройки. Ответ является XML-документом, а не JSON. Если SAML не настроен для аккаунта, сервер отвечает кодом 404 `SSO_NOT_CONFIGURED`.
Обзор
Вызов: GET /api/sso/:tenantSlug/saml/metadata. Этот эндпоинт относится к группе «Демо-чат-бот и SSO» API Zentor App. Он общедоступен и не требует аутентификации. Вызов идемпотентен: повторные вызовы с теми же данными возвращают тот же результат. Обязательные параметры: 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/acsAssertion Consumer Service (ACS): принимает подписанный SAML-ответ провайдера идентификации через форму POST.