Volver al blog

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.

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 trabajoEjemploCubre
Iniciar sesiónPOST /api/loginEl hash, la cookie protegida y el mensaje de fallo único
Cada solicitudUna comprobación que se ejecuta antes de cada ruta protegidaLa decisión del servidor, la sesión activa y la caducidad
Llamadas de datosCada endpoint que devuelve registrosEl acceso a los datos del registro solicitado
Cerrar sesiónPOST /api/logoutEl fin de la sesión en el servidor y en la base de datos
Lógica compartidaUn módulo que comparten las llamadas anterioresEl hash de contraseñas, las sesiones, los atributos de la cookie y la caducidad
Lado del navegadorUna utilidad que usa cada páginaIniciar 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.