Firmar tokens

Parte de la sección Autenticación y seguridad del Journey de Node.js de Coddy. Lección 15 de 24.

Un token solo vale algo si nadie más puede crear uno. Con HS256, jose combina el encabezado y la carga útil con un secreto que solo conoce el servidor, y calcula un hash del resultado. Ese hash es la firma. Sin el secreto, nadie puede crear uno que coincida.

El secreto proviene de una variable de entorno, process.env.JWT_SECRET, nunca del código: el código se comparte, se copia y se confirma en el repositorio. Esta lección configura JWT_SECRET por ti. jose lo necesita en forma de bytes.

const key = new TextEncoder().encode(process.env.INVITE_SECRET);

const invite = await new SignJWT({ room: 'design' })
    .setProtectedHeader({ alg: 'HS256' })
    .setSubject(guestId)
    .setIssuedAt()
    .setExpirationTime('2d')
    .sign(key);

setSubject recibe texto, y setExpirationTime recibe un intervalo como '30m' o '2d'.

Desafío

Fácil

Las aplicaciones que llaman a tu API, como una aplicación de teléfono, no conservan las cookies como lo hace un navegador. Dales un token en su lugar: un JWT firmado que envían con cada solicitud. POST /token es el inicio de sesión para esas aplicaciones.

En server.js, importa SignJWT de jose junto a decodeJwt. Encima de las rutas, convierte process.env.JWT_SECRET en bytes con un TextEncoder, como muestra la lección, porque jose firma con bytes. Esta lección configura JWT_SECRET por ti.
Añade POST /token. Recibe el mismo cuerpo que el inicio de sesión, {"username": "ada", "password": "correct horse"}, y comprueba el nombre de usuario y la contraseña del mismo modo que lo hace POST /login. Si son incorrectos, responde con el estado 401 y {"error": "Wrong username or password"}.
Si son correctos, firma un token y respóndelo como {"token": "..."}. El token debe:
- usar el algoritmo HS256, firmado con los bytes de JWT_SECRET;
- contener la reclamación username en su carga útil;
- tener el _id del usuario como texto en el asunto. Usa toHexString(), porque jose rechaza un asunto que no sea texto;
- caducar una hora después de su creación.
Un token de esta lección tiene este aspecto: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6ImFkYSIsInN1YiI6IjY2ZjFjMmE5ZTRiMGExYjJjM2Q0ZTVmNiIsImlhdCI6MTc5MzM2MTYwMCwiZXhwIjoxNzkzMzY1MjAwfQ.EdCrjAKSjZowcjE3-IjKttBLVK1VKKbL9DPnJDLdgug

Pruébalo: Pulsa «Jugar». Envía POST /signup con {"username": "ada", "password": "correct horse"}. Envía POST /token con el mismo cuerpo: estado 200 y {"token": "..."}. Copia el token y envía GET /inspect?token= seguido del token. Verás algo como {"username": "ada", "sub": "66f1c2a9e4b0a1b2c3d4e5f6", "iat": 1793361600, "exp": 1793365200}: exp está 3600 segundos después de iat. Envía POST /token con {"username": "ada", "password": "wrong horse"}: estado 401.

Pruébalo tú mismo

import express from 'express';
import { decodeJwt } from 'jose';
import { users } from './db.js';
import { hashPassword, verifyPassword } from './passwords.js';

const app = express();
app.use(express.json());

app.post('/signup', async (req, res) => {
    const username = String(req.body.username ?? '').trim().toLowerCase();
    const password = String(req.body.password ?? '');
    if (!username || password.length < 8) {
        return res.status(400).json({ error: 'Pick a username and a password of at least 8 characters' });
    }
    if (await users.findOne({ username })) {
        return res.status(409).json({ error: 'That username is taken' });
    }
    await users.insertOne({ username, passwordHash: await hashPassword(password) });
    res.status(201).json({ username });
});

app.post('/login', async (req, res) => {
    const username = String(req.body.username ?? '').trim().toLowerCase();
    const user = await users.findOne({ username });
    if (!user || !(await verifyPassword(String(req.body.password ?? ''), user.passwordHash))) {
        return res.status(401).json({ error: 'Wrong username or password' });
    }
    res.json({ username: user.username });
});

// Muestra lo que dice un token: GET /inspect?token=...
app.get('/inspect', (req, res) => {
    try {
        res.json(decodeJwt(String(req.query.token ?? '')));
    } catch {
        res.status(400).json({ error: 'Not a JWT' });
    }
});

// La página de administración. No se puede confiar en ninguna declaración antes de verificar su firma.
app.get('/admin', (req, res) => {
    res.status(403).json({ error: 'Admins only' });
});

app.listen(3000, () => {
    console.log('Vault is running on port 3000');
});

Todas las lecciones de Autenticación y seguridad

Practica por tu cuenta: Playground de Express