Crear una Sesión y Mantenerla
Que se debe hacer para iniciar sesión y mantener la misma.
-
Requerimientos Previos:
- Haber realizado un registro mediante:
- POST | /auth/register
- Haber realizado un registro mediante:
-
Endpoints Requeridos:
- POST | /auth/login
- POST | /auth/refresh
Inicio de Sesión
- Se debe enviar un usuario y una contraseña al endpoint de login como se detalla en su página de uso.
- Luego de eso el endpoint va a asignar un token de refresco mediante una cookie llamada "refreshToken", pero el token de acceso (el cual es necesario para poder acceder a endpoints protegidos) no se asigna automáticamente, es decir, el cliente debe guardarlo manulamente en algún lugar.
- Finalmente una vez establecidos los 2 tokens el usuario puede comenzar a acceder a los endpoints que tenga permitido el acceso.
¿Como envío el token de acceso?
Renovación de la Sesión
- El token de refresco es renovado automáticamente por la misma API cuando sea necesario pero el token de acceso no, debido a esto es necesario que el cliente renueve manualmente el token de acceso, se recomienda que la renovación se haga cuando este finalmente se haya vencido y el usuario pierda acceso. ¿Como es esto?, una vez que el token de acceso se vence el usuario no va a poder acceder a los endpoints protegidos, el mismo cliente debe detectar ese problema de acceso y enviar una solicitud de renovación al backend mediante el endpoint de refresco como se detalla en su página de uso.