GET/api/sso/:tenantSlug/oidc/callback

Recibe la redirección del proveedor de identidad después del inicio de sesión OIDC y redirige el navegador de vuelta a Zentor App.

Este endpoint solo lo llama el proveedor de identidad mediante redirección del navegador; debe introducirse como URI de redirección en su configuración. 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`. En caso de error, por ejemplo si el parámetro de seguridad `state` falta o no es válido, 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`. En ese caso, vuelva a iniciar el inicio de sesión.

Descripción general

Llamada: GET /api/sso/:tenantSlug/oidc/callback. 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). 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á configurado

Respuesta de ejemplo

Redirección 302 a https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (ejemplo sin `state` válido)

Códigos de error

302 SSO_STATE_MISSING — Redirección a la página de inicio de sesión con `sso_error` si `state` falta o no es válido.

Comportamiento verificado

Sin un `state` válido, el servidor redirige a la página de inicio de sesión con 302 y `sso_error=SSO_STATE_MISSING`.

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/saml/startInicia el inicio de sesión mediante SAML y redirige el navegador al proveedor de identidad configurado.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): recibe la respuesta SAML firmada del proveedor de identidad mediante un POST de formulario.GET /api/sso/:tenantSlug/saml/metadataDevuelve los metadatos SAML de Zentor App (XML) para su importación en su proveedor de identidad.

Artículos relacionados

← Chatbot de demostración y SSO