Qué es un JWT

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

Una sesión necesita consultar la base de datos en cada solicitud. Un JWT (token web JSON) lleva los datos en sí: tres partes en formato base64url unidas por puntos. El encabezado indica el algoritmo, la carga útil contiene las afirmaciones (sub indica de quién es el token, exp indica cuándo vence) y la firma demuestra que lo creó el servidor.

Base64url es una codificación, no un cifrado. Cualquiera que tenga un token puede leer su carga útil:

const payload = token.split('.')[1];
JSON.parse(Buffer.from(payload, 'base64url').toString());
// { sub: '42', name: 'Lin', exp: 1767225600 }

decodeJwt(token) de jose hace lo mismo y omite la firma. Así que nunca pongas un secreto en una carga útil y nunca tomes decisiones basándote en una afirmación que te haya proporcionado decodeJwt: cualquiera puede escribir cualquier afirmación.

Desafío

Fácil

GET /inspect?token=... responde con las afirmaciones del token en formato JSON, o con 400 { "error": "Not a JWT" }.
GET /admin responde con 403 { "error": "Admins only" } a todas las solicitudes.

Primero envía el token de Mallory a GET /admin?token= y mira qué abre: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJtYWxsb3J5IiwiYWRtaW4iOnRydWV9.c2lnbmF0dXJl. Arréglalo y después envía el mismo token a /inspect.

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) => {
    res.status(501).json({ error: 'Not written yet' });
});

// La página de administración.
app.get('/admin', (req, res) => {
    const claims = decodeJwt(String(req.query.token ?? ''));
    if (claims.admin === true) {
        return res.json({ secret: 'The vault key is 42' });
    }
    res.status(403).json({ error: 'Admins only' });
});

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