POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): recibe la respuesta SAML firmada del proveedor de identidad mediante un POST de formulario.
Este endpoint solo lo llama el proveedor de identidad; debe introducirse como URL de ACS en su configuración (véase `saml/metadata`). El proveedor de identidad envía la respuesta firmada, codificada en base64, en el campo de formulario `SAMLResponse`. Si tiene éxito, Zentor App redirige el navegador de vuelta con el código de un solo uso en el parámetro de consulta `sso_code`; este código se intercambia por un token de acceso mediante `POST /api/auth/sso/exchange`. Si la respuesta no es válida o falta el proceso de inicio de sesión asociado, el servidor redirige a la página de inicio de sesión con el parámetro de consulta `sso_error`, por ejemplo `sso_error=SSO_STATE_MISSING`.
Descripción general
Llamada: POST /api/sso/:tenantSlug/saml/acs. Este endpoint pertenece al grupo «Chatbot de demostración y SSO» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: tenantSlug (ruta), SAMLResponse (body). Casos de error documentados: 302 SSO_STATE_MISSING.
Autenticación y seguridad
No se requiere autenticación
Idempotente: No
Parámetros
tenantSlug(path, string, obligatorio)— Identificador (slug) de la cuenta para la que SSO está configuradoSAMLResponse(body, string, obligatorio)— Respuesta SAML firmada por el proveedor de identidad (XML, codificada en base64) como campo de formularioRespuesta de ejemplo
Redirección 302 a https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (ejemplo sin respuesta SAML válida)
Códigos de error
302 SSO_STATE_MISSING — Redirección a la página de inicio de sesión con `sso_error` si la respuesta SAML no es válida o falta el proceso de inicio de sesión.Comportamiento verificado
Una `SAMLResponse` no válida conduce a una redirección (302) a la página de inicio de sesión con `sso_error`.
Chatbot de demostración y SSO
POST /api/global-chatbot/demoEnvía un mensaje al chatbot de demostración público en zentor-app.de/demo y devuelve su respuesta. La demo se puede probar en el navegador sin registrarse.GET /api/global-chatbot/demo/historyCarga el historial de mensajes de una conversación de demostración para que se conserve al volver a abrir la demo.POST /api/global-chatbot/demo/pollObtiene los nuevos mensajes de una conversación de demostración, por ejemplo cuando un empleado de Zentor ha tomado el relevo de la conversación. La página de demostración llama al endpoint a intervalos.POST /api/global-chatbot/demo/ratingGuarda la valoración de una conversación de demostración (útil o no útil) con un comentario opcional.POST /api/global-chatbot/demo/trackRegistra eventos de uso anónimos de la página de demostración para las estadísticas de visitantes de Zentor.POST /api/global-chatbot/demo/voice-transcribeConvierte una grabación de voz en la página de demostración en texto (entrada de voz), si la función de voz de la demo está activada.POST /api/global-chatbot/demo/voice-speakConvierte texto en voz (salida de voz en la página de demostración), si la función de voz de la demo está activada.GET /api/sso/:tenantSlug/statusComprueba si el inicio de sesión único (SAML u OIDC) está configurado para una cuenta. La página de inicio de sesión utiliza el resultado para ofrecer el inicio de sesión SSO.GET /api/sso/:tenantSlug/oidc/startInicia el inicio de sesión mediante OpenID Connect y redirige el navegador al proveedor de identidad configurado.GET /api/sso/:tenantSlug/oidc/callbackRecibe la redirección del proveedor de identidad después del inicio de sesión OIDC y redirige el navegador de vuelta a Zentor App.GET /api/sso/:tenantSlug/saml/startInicia el inicio de sesión mediante SAML y redirige el navegador al proveedor de identidad configurado.GET /api/sso/:tenantSlug/saml/metadataDevuelve los metadatos SAML de Zentor App (XML) para su importación en su proveedor de identidad.