GuíasWeb app

Tutorial: inicio de sesión con enlace mágico, sin contraseña

Por el equipo de Banzai LabsActualizado el 2 min de lectura

Recibir el enlaceEnlace · 15 minConectadoToken aleatorio, de un solo uso, que caduca prontoSin contraseña que recordar ni robar
El correo recibe un enlace de un solo uso que abre la sesión.

1. Enviar el enlace

import { randomBytes, createHash } from 'node:crypto';

const token = randomBytes(32).toString('base64url');
const hash = createHash('sha256').update(token).digest('hex');
await db.enlaces.crear({ email, hash, caduca: Date.now() + 15 * 60_000 });
await enviarEmail(email, `https://ejemplo.es/acceso?t=${token}`);

Solo se guarda el hash: una fuga de la base de datos no da ningún enlace válido.

2. Consumirlo

  1. 1Página de confirmaciónEl enlace abre una página con un botón, sin consumir nada.
  2. 2VerificaciónHash encontrado, sin caducar, nunca usado.
  3. 3Uso únicoEl token se borra en el acto.
  4. 4SesiónCookie HttpOnly, Secure, SameSite=Lax.

3. Las salvaguardas

Riesgo Solución
Envíos en ráfaga Límite por dirección y por IP
Enlace interceptado tarde Caducidad de 10 a 15 minutos
Enlace reutilizado Borrado al primer uso
Revelar las cuentas Mismo mensaje en todos los casos

Para el límite de envíos: limitar las peticiones de una API. El marco general: crear una web app.

Preguntas frecuentes

¿Es tan seguro como una contraseña?
La seguridad descansa en el buzón de correo, igual que el restablecimiento de una contraseña. No hay contraseña reutilizada o débil que robar.
¿Por qué el enlace ya está usado cuando hago clic?
Algunos filtros de correo abren los enlaces para analizarlos. Por eso el enlace lleva a una página con un botón «Iniciar sesión», y es ese clic el que consume el token.
¿Hay que decir si la dirección no existe?
No. Se muestra siempre el mismo mensaje («si existe una cuenta, se ha enviado un enlace») para no revelar quién está registrado.

Para leer después

Todas las guías