Página en construcción
Las aplicaciones FundewebJS funcionan con un enfoque basado en servicios lo que implica que las comunicaciones son sin sesión. No obstante en ocasiones nuestra aplicación debe guardar el estado debido a que navega hace una navegación a una aplicación externa y luego se vuelve a ésta, es un wizard donde los cambios sólo se persisten al final, etc.
Con las herramientas disponibles parece que guardar el estado en Vuex puede ser la solución pero eso tiene riesgos de seguridad ya que no se garantiza la privacidad de los datos mantenidos en Vuex. Aunque sean locales a una pestaña de un navegador, cualquier extensión maliciosa podría acceder a ellos y procesarlos como quiera.
En consecuencia no se debe almacenar en Vuex ningún dato que contenga información personal o cualquiera otra que, procesada desde el navegador pueda suponer un problema de seguridad y/o privacidad.
Para solventar el problema de tener que gestionar una sesión sin exponer datos sensibles se ha desarrollado un mecanismo que permitirá guardar en base de datos un JSON con la información de la sesión en curso que, combinado con un ID de sesión que se podrá almacenar en VUEX, nos permitirá simular una sesión web sin estar expuestos a una posible vulneración de la privacidad de los datos.
Es importante destacar que para un posible ataque en un navegador es más peligroso que los datos estén en Vuex que en la pantalla renderizada, ya que en el segundo caso tendría que acceder y analizar el html generado, mientras que en el primero ya tendría la información disponible sin necesidad de hacer ningún procesamiento adicional.
Ciclo de vida de una sesión
A la hora de gestionar una sesión deberemos tener en cuenta en nuestra aplicación cuándo debemos crearla, cuándo debemos usarla y cuándo debemos cargarla. El grafo que se muestra a continuación esquematiza el ciclo de vida que deben implementar los endpoints que requieran hacer uso de sesiones.
Estructura de base de datos
Cada aplicación de servicios en api.um.es tendrá que tener su propia tabla de sesiones que contendrá los siguientes campos:
- ID: Será el valor del campo JTI que se encuentra en el token OAuth del usuario. Este valor es único por usuario por lo tanto identifica a la vez al usuario y a la sesión.
- FECHA_EXPIRACION: Cuando expirará el token y, a su vez, la sesión del usuario. El tiempo de vida es fijo para el token OAuth y la sesión de usuario no podrá durar más que el token.
- CONTENIDO_SESION: Un JSON con toda la información necesaria para restaurar la sesión.
Al mismo tiempo se deberá crear un JOB de base de datos que limpie esta tabla de las sesiones expiradas.
Detalle del ciclo de vida
Inicio de la sesión
La primera vez que el usuario acceda a la aplicación, si ésta requiere de sesión, la creará en el endpoint que reciba la acción de inicio del proceso del usuario. Este endpoint se deberá en cargar de: obtener los campos jti y exp del token OAuth ya validado, almacenar en la tabla de sesiones todos los datos requeridos y responder a la petición del frontend.
Desde el punto de vista del frontend la creación de sesiones, al basarse en el token OAuth, es totalmente transparente por lo que no afectará a las llamadas que se realicen.
Gestión de una petición que requiera sesión
El frontend llamará al servicio que requiera del backend pasándole el token OAuth y los parámetros que requiera dicha llamada. Una vez recibida esa petición en el endpoint y validado el token se extraerá el campo jti a partir del cual se recuperará la sesión del usuario en curso. En la lógica del endpoint se debe contemplar de manera explicita la recuperación de la sesión.
Una vez recuperado el JSON con los datos, este podrá ser mapeado a objetos java (si se precisa) y ejecutar la lógica de negocio implicada en el servicio.
Tras realizar todas las acciones pertinentes, el endpoint deberá actualizar el estado de la sesión y devolver el flujo al frontendo.
Cierre de sesión
Al estar la sesión asociada al token OAuth es importante cerrarla cuando consideremos que el flujo que ha seguido el usuario por la aplicación ha terminado ya que de lo contrario al volver a ejecutar el servicio se cargará la última sesión guardada.
El cierre de sesión lo gestionaremos mediante eventos para que no interfiera con la respuesta al frontend. El servicio lanzará un evento indicando qué sesión hay que cerrar y otro método (que estará escuchando ese tipo de eventos) se encargará de borrar el registro de base de datos.
Recuperar sesiones
Una implementación que podemos hacer en nuestros servicios que inician un proceso es comprobar si existe una sesión en base de datos y notificar al usuario que ya tiene una sesión completa hasta el paso X, preguntando si quiere continuarla o empezar una nueva. Esta lógica puede ser útil para tener en cuenta los casos en que se produzca un fallo sin que se pudiera cerrar la sesión, por ejemplo que el usuario se quede sin conexión a mitad de un proceso, reinicie el equipo y vuelva a probar.