En Fiado, el simulador de créditos e inversiones que hicimos en equipo para una cooperativa, me tocaron el registro y la sesión. La sesión vive en dos cookies httpOnly: un access token (un JWT de 15 minutos) y un refresh token de 30 días para pedir otro sin volver a escribir la contraseña. El que importa es el segundo: quien lo tenga se queda con la cuenta un mes.
Opaco, y en la base sólo su huella
El refresh token no es un JWT: son 32 bytes aleatorios. Su validez no está en el token sino en una fila de AuthSession, así que se puede revocar de verdad. En la base se guarda su SHA-256, no el token: si se filtrara la tabla, no serviría para entrar.
export const newRefreshToken = () => randomBytes(32).toString('base64url');
export const hashRefreshToken = (token: string) =>
createHash('sha256').update(token).digest('hex');Y la cookie sólo viaja a /api/auth: el navegador ni siquiera la adjunta en el resto de peticiones a la API.
const REFRESH_PATH = '/api/auth';
response.cookie(REFRESH_COOKIE, tokens.refreshToken, {
...base(),
path: REFRESH_PATH,
maxAge: refreshTtlSeconds() * 1000,
});Cada renovación lo cambia
Al renovar, el token usado queda marcado (rotatedAt) y se emite otro de la misma familia (familyId: una por inicio de sesión). Cada token sirve una sola vez. Si llega uno que ya se usó, alguien más tiene una copia: el dueño o un ladrón, y el servidor no puede saber cuál. Así que revoca la familia entera y los dos tienen que volver a entrar. Una cookie robada no sobrevive a la siguiente renovación de su dueño.
if (session.rotatedAt || session.revokedAt) {
await this.revokeFamily(session.familyId);
throw new UnauthorizedException(
'Sesión revocada: ese token de renovación ya había sido usado',
);
}La trampa: dos pestañas a la vez
Si dos peticiones renuevan con el mismo token casi al mismo tiempo (dos pestañas, un doble clic, un reintento), las dos lo leen como válido. La segunda en escribir lo encontraría ya rotado y, con la regla de arriba, cerraría la sesión de alguien que no hizo nada malo.
Por eso el token no se marca leyendo y después escribiendo, sino con una sola escritura condicionada a su estado:
const { count } = await this.prisma.authSession.updateMany({
where: { id: session.id, rotatedAt: null, revokedAt: null },
data: { rotatedAt: new Date() },
});
if (count === 0) throw new UnauthorizedException(INVALID_SESSION);
return this.issueSession(session.user, session.familyId, context);La base decide quién gana: sólo una de las dos escrituras encuentra la fila sin rotar. La que pierde recibe un 401 y no revoca nada; la cookie nueva que dejó la ganadora sirve para las dos pestañas. La alarma de robo sólo salta cuando el token ya estaba rotado al leerlo, no en un empate.
Lo que me llevo
Una regla de seguridad que castiga el reúso tiene que distinguir el reúso de la concurrencia. Esa distinción no se puede hacer en la aplicación con dos consultas seguidas: hay que dejársela a la base, en una escritura atómica.