Single Sign-On
Guía relacionada: Single Sign-On.
El proveedor de identidad llama a los callbacks, a través del navegador del usuario, como parte de una transacción auténtica. No los llame con valores construidos manualmente.
GET /sso/login
Inicia el inicio de sesión federado y redirige el navegador al proveedor.
Acceso: público.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
provider | query | Sí | Identificador del proveedor configurado. |
Respuestas: 302 — redirección al proveedor de identidad.
GET /sso/logout
Inicia el cierre de sesión federado.
Acceso: sesión SSO.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
provider | query | Sí | Identificador del proveedor configurado. |
Respuestas: 302 — redirección al proveedor o al destino de cierre de sesión; 401 — sesión no aceptada.
GET POST /sso/oauth2/cb
Callback de autorización OAuth 2.0 y 2.1/OpenID Connect.
Acceso: proveedor.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
state | query (GET) o formulario (POST) | Sí | Estado creado al inicio del flujo. |
code | query (GET) o formulario (POST) | Sí | Código de autorización emitido por el proveedor. |
Respuestas: 302 — sesión establecida y redirección.
GET POST /sso/oauth2/logout/cb
Callback de cierre de sesión OAuth 2.0.
Acceso: proveedor.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
state | query (GET) o formulario (POST) | Sí | Estado del flujo de cierre de sesión. |
provider | query (GET) o formulario (POST) | Sí | Identificador del proveedor. |
Respuestas: 302 — redirección después del cierre de sesión.
POST /sso/saml2/acs
Assertion Consumer Service: recibe la respuesta de autenticación SAML 2.0.
Acceso: proveedor.
| Campo (formulario) | Obligatorio | Descripción |
|---|---|---|
SAMLResponse | Sí | Respuesta SAML en Base64. |
RelayState | No | Estado transmitido por el proveedor, cuando corresponde. |
Respuestas: 302 — sesión establecida y redirección.
GET POST /sso/saml2/slo
Single Logout: recibe el mensaje de cierre de sesión SAML 2.0.
Acceso: proveedor.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
SAMLResponse | query (GET) o formulario (POST) | No | Respuesta de cierre de sesión SAML en Base64. |
RelayState | query (GET) o formulario (POST) | No | Estado transmitido por el proveedor. |
Respuestas: 302 — redirección después del cierre de sesión.
GET /sso/saml2/metadata
Devuelve los metadatos XML del proveedor SAML 2.0, que se usan para registrar la API en el proveedor de identidad. El proveedor puede indicarse en la query string o en la ruta (/sso/saml2/metadata/{provider}).
Acceso: público.
| Parámetro | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
provider | query, o {provider} en la ruta | Sí | Identificador del proveedor SAML. |
Respuestas: 200 — metadatos XML.