Cómo funciona un inicio de sesión
Un inicio de sesión parece un solo formulario. Detrás, el navegador, el servidor y la base de datos se pasan una docena de mensajes, y los controles del camino mantienen segura la cuenta. Este es el patrón básico que cada desarrollador de nuestro equipo aprende primero.
El primer proyecto de nuestra estudiante en prácticas fue un sitio web propio del que no depende ningún cliente. Le enseña nuestra estructura de archivos, nuestras convenciones de nombres y los patrones que usamos para agrupar componentes y utilidades. También le da una base sobre la que construir.
Las páginas y el enrutamiento salieron rápido. El inicio de sesión fue el primer problema difícil. Es complejo para quien nunca ha construido uno, y un diagrama ayuda. Así lo abordamos.
Un inicio de sesión parece un solo formulario. Detrás, el navegador, el servidor y la base de datos se pasan una docena de mensajes, y los controles del camino mantienen segura la cuenta.
Este es el patrón básico del inicio de sesión, y cada desarrollador de nuestro equipo lo aprende primero.
La columna vertebral
Navegador: envía los datos de inicio de sesión al servidor.
Servidor: busca al usuario.
Base de datos: devuelve el registro almacenado.
Servidor: verifica los datos de inicio de sesión contra el registro almacenado y crea una sesión con una caducidad.
Base de datos: almacena la sesión.
Servidor: devuelve un token al navegador en una cookie.
Navegador: envía esa cookie con cada solicitud posterior.
Servidor: comprueba la sesión antes de devolver cualquier dato.
Base de datos: confirma que la sesión existe y sigue activa.
Servidor: rechaza una sesión caducada y cierra la sesión cuando el usuario sale.
Base de datos: elimina el registro de sesión en ambos casos.
Puntos de control clave
El servidor decide en cada solicitud
El servidor decide quién es el usuario y a qué puede acceder. El navegador presenta los datos de inicio de sesión o el token. El servidor los valida, comprueba el registro de sesión en la base de datos en cada solicitud y responde con lo que ese usuario puede ver. Una solicitud sin una sesión activa recibe un 401 y ningún dato.
Almacenar un hash lento de cada contraseña
El servidor almacena un hash lento y de un solo sentido de cada contraseña, con una sal única. La contraseña en sí nunca se almacena. Al iniciar sesión, el servidor calcula el hash de la contraseña enviada de la misma manera y compara los dos resultados. Una base de datos robada contiene solo hashes con sal, y cada intento contra ellos es lento.
Guardar el token en una cookie protegida
El navegador adjunta automáticamente una cookie a cada solicitud a su sitio, y puede mantener la cookie fuera del alcance de los scripts de la página. Ponga tres atributos en la cookie. HttpOnly impide que los scripts de la página la lean. Secure la envía solo por HTTPS. SameSite impide que otros sitios la adjunten a los formularios y solicitudes en segundo plano que envían al suyo.
Comprobar el acceso en cada solicitud de datos
Una sesión activa demuestra quién es el usuario. Cada llamada que devuelve datos comprueba también que ese usuario puede ver el registro solicitado. La sesión de cada cliente alcanza solo los datos de ese cliente.
Dar a cada sesión una caducidad
El servidor almacena cada sesión en la base de datos con su caducidad. En cada solicitud, el servidor comprueba esa caducidad antes de devolver datos. Una sesión termina a una hora fijada o tras un periodo de inactividad, y el servidor elimina su registro de la base de datos. Una caducidad corta y un límite de inactividad acotan cuánto tiempo funciona un token copiado.
Cerrar la sesión en el servidor
El navegador pide al servidor que cierre la sesión. El servidor elimina el registro de sesión de la base de datos y luego borra la cookie. Un token copiado deja de funcionar en el momento en que el registro desaparece.
Responder igual a cada inicio de sesión fallido
"Usuario o contraseña incorrectos" cubre cada fallo. Mensajes distintos para un usuario desconocido y una contraseña errónea le dicen a un atacante qué cuentas existen. El servidor también frena los intentos repetidos por cada cuenta y cada dirección.
El código, por flujo de trabajo
El diagrama muestra una docena de mensajes. El código que hay detrás sigue el flujo de trabajo. Una llamada se ocupa de varios pasos, y la lógica que los pasos comparten vive en un solo lugar.
| Flujo de trabajo | Ejemplo | Cubre |
|---|---|---|
| Iniciar sesión | POST /api/login | El hash, la cookie protegida y el mensaje de fallo único |
| Cada solicitud | Una comprobación que se ejecuta antes de cada ruta protegida | La decisión del servidor, la sesión activa y la caducidad |
| Llamadas de datos | Cada endpoint que devuelve registros | El acceso a los datos del registro solicitado |
| Cerrar sesión | POST /api/logout | El fin de la sesión en el servidor y en la base de datos |
| Lógica compartida | Un módulo que comparten las llamadas anteriores | El hash de contraseñas, las sesiones, los atributos de la cookie y la caducidad |
| Lado del navegador | Una utilidad que usa cada página | Iniciar sesión, cerrar sesión y el usuario actual |
La llamada de inicio de sesión ejecuta todo el inicio de sesión en una sola solicitud. Busca al usuario, compara los hashes y pone la cookie. Devuelve el mismo error para cada fallo.
La comprobación de solicitudes se ejecuta antes de cada ruta protegida. Lee la cookie, comprueba la sesión en la base de datos y responde 401 cuando la sesión ya no existe.
El módulo compartido contiene la lógica que comparten las llamadas anteriores. El hash, los atributos de la cookie y la regla de caducidad viven allí una sola vez cada uno. Cada llamada los aplica de la misma manera.
La utilidad del navegador da a cada página el mismo inicio de sesión, el mismo cierre de sesión y el mismo usuario actual. Da forma a lo que muestra la página. El servidor decide qué datos salen.
Construir sobre él
El patrón es extensible, y esa es su principal ventaja. Con los fundamentos en su sitio, cada pieza se convierte en algo que puede sustituir. El inicio de sesión único mediante OpenID Connect o SAML cambia la forma en que un usuario demuestra quién es. Las claves de acceso también. El middleware en el servidor y en el navegador se engancha a los mismos pasos. Todos parten de los fundamentos anteriores.
Solicite una demostración
Contáctenos. Le mostramos Aptli con los tipos de registro que usted indique.