POST/api/auth/sso/exchange

Último paso de un inicio de sesión SSO (SAML/OIDC): cambia el código de un solo uso de la redirección por un token de acceso y un token de actualización.

Tras iniciar sesión en el proveedor de identidad, Zentor App redirige el navegador con un código de un solo uso en el parámetro de consulta `sso_code`. Envíe este código en el campo `code`. La respuesta contiene `token` y `refreshToken`, como en un inicio de sesión normal. Cada código es válido solo una vez y durante poco tiempo. Un código ya usado, caducado o inválido da como resultado 400 `SSO_EXCHANGE_INVALID`; el usuario reinicia entonces el inicio de sesión SSO. Por ello, la llamada no es idempotente.

Descripción general

Llamada: POST /api/auth/sso/exchange. Este endpoint pertenece al grupo «Autenticación» 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: code (body). Casos de error documentados: 400 SSO_EXCHANGE_INVALID. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.

Autenticación y seguridad

No se requiere autenticación

Idempotente: No

Parámetros

code(body, string, obligatorio)— Código de un solo uso de la redirección SSO

Solicitud de ejemplo

{"code":"<Código de un solo uso del redirect de callback SSO>"}

Respuesta de ejemplo

{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}

Códigos de error

400 SSO_EXCHANGE_INVALID — El código es inválido, ya se ha usado o ha caducado.

Comportamiento verificado

Un código inválido devuelve 400 `SSO_EXCHANGE_INVALID`. El caso de éxito requiere un inicio de sesión completo en el proveedor de identidad configurado.

Autenticación

Artículos relacionados

← Autenticación