Sesión en httpOnly cookie o JWT en localStorage: qué elegir para una aplicación web
La pregunta está planteada de forma inexacta.
El debate entre cookies y JWT confunde dos soluciones independientes:
- 1.Donde el cliente almacena el token: cookie httpOnly, que el propio navegador envía, o
localStorage, desde donde JavaScript la lee y la coloca en el encabezadoAuthorization. - 2.¿Qué es este token? un identificador de sesión opaco mediante el cual el servidor encuentra una entrada en la base de datos, o un JWT firmado y autosuficiente.
El JWT se puede almacenar en una cookie httpOnly y el ID de sesión en localStorage. Por tanto, analizaremos cada solución por separado.
Dónde almacenar: consecuencias XSS
Si se ejecutó el script de otra persona en la página (dependencia vulnerable, entrada del usuario sin escape, script de análisis comprometido):
- Token en `localStorage` el script leerá y enviará a su servidor. El atacante utiliza la sesión de su máquina mientras el token es válido, incluso después de que la víctima haya cerrado la pestaña.
- El script no puede leer el token en la cookie httpOnly. Puede enviar solicitudes en nombre del usuario mientras la página está abierta; XSS sigue siendo una vulnerabilidad grave. Pero no puedes robar una sesión y llevártela contigo.
La diferencia no es si la cookie "protege contra XSS" (no lo hace), sino la magnitud del daño. Para una aplicación web donde la interfaz y la API están en el mismo sitio, esto resuelve el problema a favor de las cookies.
Precio de las cookies: CSRF
El navegador envía cookies automáticamente, incluidas las solicitudes iniciadas por otro sitio. Protección en varias capas:
SameSite=Lax(predeterminado en los navegadores Chromium, pero configurado explícitamente) no envía cookies con solicitudes POST entre sitios.- Para modificar solicitudes, el servidor verifica el encabezado
Originy rechaza solicitudes de origen extranjero. - Cambios de estado: solo usando métodos POST/PUT/PATCH/DELETE, nunca GET.
Las acciones del servidor en Next.js verifican Origin ellas mismas; Para sus propios manejadores de ruta, usted escribe el cheque.
Qué almacenar: recuperación de sesión
El servidor verifica el JWT firmado sin acceder a la base de datos. La desventaja: no se puede revocar antes de la fecha de vencimiento. El usuario hizo clic en "cerrar sesión en todos los dispositivos", el administrador bloqueó la cuenta, se detectó el token robado: JWT continúa funcionando. Las soluciones alternativas (vida útil corta más token de actualización, lista revocada) devuelven el acceso al almacenamiento, por lo que se eligió que faltara el JWT.
La sesión del servidor es una entrada en una tabla. Revocación: eliminación de una línea, con efecto inmediato. Un acceso a la base de datos por solicitud es invisible para la mayoría de las aplicaciones y se almacena en caché si es necesario.
Implementación de una sesión de servidor.
CREATE TABLE sessions ( id_hash bytea PRIMARY KEY, user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, expires_at timestamptz NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), user_agent text ); CREATE INDEX sessions_user_idx ON sessions (user_id);
// lib/auth/sessions.ts
import "server-only";
import { createHash, randomBytes } from "node:crypto";
import { cookies } from "next/headers";
import { db } from "@/lib/db";
const COOKIE = "__Host-session";
const TTL_DAYS = 30;
const sha256 = (s: string) => createHash("sha256").update(s).digest();
export async function createSession(userId: string, userAgent?: string) {
const token = randomBytes(32).toString("base64url");
const expires = new Date(Date.now() + TTL_DAYS * 86_400_000);
await db.query(
"INSERT INTO sessions (id_hash, user_id, expires_at, user_agent) VALUES ($1, $2, $3, $4)",
[sha256(token), userId, expires, userAgent?.slice(0, 200) ?? null]
);
const jar = await cookies();
jar.set(COOKIE, token, {
httpOnly: true, secure: true, sameSite: "lax", path: "/", expires,
});
}
export async function currentUserId(): Promise<string | null> {
const token = (await cookies()).get(COOKIE)?.value;
if (!token) return null;
const { rows } = await db.query(
"SELECT user_id FROM sessions WHERE id_hash = $1 AND expires_at > now()",
[sha256(token)]
);
return rows[0]?.user_id ?? null;
}
export async function destroySession() {
const jar = await cookies();
const token = jar.get(COOKIE)?.value;
if (token) await db.query("DELETE FROM sessions WHERE id_hash = $1", [sha256(token)]);
jar.set(COOKIE, "", { httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 0 });
}Detalles clave:
- La base de datos tiene un hash, no un token. La filtración de un volcado o acceso de solo lectura a la tabla no proporciona sesiones listas para usar.
- 32 bytes aleatorios de un generador criptográfico: la fuerza bruta no es posible, no se requiere firma.
- Nueva sesión al iniciar sesión, en lugar de aumentar los derechos de la anterior. De lo contrario, es posible fijar la sesión: el atacante pasa su identificador a la víctima antes de iniciar sesión.
- `cookies()` es asincrónico en Next.js 15, por lo tanto,
await. Puede configurar cookies en Acciones del servidor y Controladores de ruta, pero no al representar el componente del servidor.
“Cerrar sesión en todos los dispositivos” - DELETE FROM sessions WHERE user_id = $1. Una lista de sesiones activas con user_agent y fecha es un bono gratuito de este esquema.
Cuando el token en el encabezado está justificado
- Aplicación móvil o CLI. Las cookies son un inconveniente allí, el token se almacena en el almacenamiento seguro de la plataforma (Keychain, Keystore) y no en
localStorage. - API para clientes de terceros. Se les emiten claves independientes o tokens OAuth con derechos limitados.
- Llamadas entre servicios. El JWT de corta duración entre sus servicios es conveniente precisamente porque se verifica sin una base común.
Errores frecuentes
- Actualizar token en
localStoragecuando el token de acceso sea de corta duración. Un token de actualización robado brinda acceso a largo plazo: se pierden todos los beneficios a corto plazo. Domain=.example.compara cookies de sesión innecesariamente. Cualquier subdominio, incluida una página de destino vulnerable, lo recibirá. El prefijo__Host-deshabilita el atributoDomainy cierra esta opción.- Comprobando
exppara JWT sin verificación de firma o con el algoritmo del encabezado del token. Registre el algoritmo en el servidor.
Resumen
Para una aplicación web con backend propio: identificador opaco en cookie httpOnly, registros de sesión en la base de datos, SameSite=Lax y marcar Origin. JWT y encabezado Authorization - para clientes que no son de navegador y para comunicación entre servicios.