Sesión y cierre de sesión
Enviar la credencial en las rutas protegidas
Las rutas protegidas aceptan el token en la cabecera Authorization o la cookie de sesión emitida en el inicio de sesión.
export ACCESS_TOKEN='<access_token recibido>'
curl -i \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
"$API_BASE/download/list"Si la cabecera Authorization y la cookie __Host-dirl_session se envían juntas, prevalece la cabecera.
Expiración
La sesión deja de aceptarse cuando el token expira, según la política configurada en el entorno. Para los tokens OAuth, la validez en segundos se informa en expires_in.
Cuando una ruta protegida responda 401, obtenga una nueva credencial (nuevo inicio de sesión o nuevo token) y repita la llamada.
Finalizar la sesión
Use GET o POST /auth/logout y envíe la misma credencial usada en las rutas protegidas. Cuando corresponde, la API elimina la cookie de sesión.
curl -i -X POST \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
"$API_BASE/auth/logout"Para las sesiones abiertas mediante SSO, use el cierre de sesión federado.
Nota
Completar una transferencia no finaliza la sesión. Cierre la sesión explícitamente cuando la integración termine.