GET/api/sso/:tenantSlug/oidc/start

Inicia el inicio de sesión mediante OpenID Connect y redirige el navegador al proveedor de identidad configurado.

Llame al endpoint mediante navegación del navegador, no mediante una solicitud JavaScript. Si OIDC está configurado, el servidor responde con una redirección (302) al proveedor de identidad; tras iniciar sesión allí, el navegador vuelve mediante `oidc/callback`. Si OIDC no está configurado para la cuenta, el servidor responde con 404 `SSO_NOT_CONFIGURED` y un mensaje de error JSON.

Descripción general

Llamada: GET /api/sso/:tenantSlug/oidc/start. 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 es idempotente: las llamadas repetidas con los mismos datos devuelven el mismo resultado. Parámetros obligatorios: tenantSlug (ruta). Casos de error documentados: 404 -.

Autenticación y seguridad

No se requiere autenticación

Idempotente: Sí

Parámetros

tenantSlug(path, string, obligatorio)— Identificador (slug) de la cuenta para la que SSO está configurado

Respuesta de ejemplo

(redirección 302 al proveedor de identidad si OIDC está configurado para la cuenta)

Códigos de error

404 - — OIDC no está configurado para esta cuenta.

Comportamiento verificado

Para una cuenta sin OIDC, la llamada devuelve 404.

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/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.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