Firmare i token

Fa parte della sezione Autenticazione e sicurezza del percorso Node.js di Coddy. Lezione 15 di 24.

Un token ha valore solo se nessun altro può crearne uno. Con HS256, jose combina l’intestazione e il payload con un segreto noto solo al server e calcola l’hash del risultato. Quell’hash è la firma. Senza il segreto, nessuno può crearne una corrispondente.

Il segreto proviene da una variabile d’ambiente, process.env.JWT_SECRET, mai dal codice: il codice viene condiviso, copiato e sottoposto a commit. Questa lezione imposta JWT_SECRET per te. jose lo vuole in formato byte.

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 accetta testo e setExpirationTime accetta una durata come '30m' o '2d'.

Sfida

Facile

Le app che chiamano la tua API, come un'app per telefono, non conservano i cookie come fa un browser. Fornisci loro invece un token: un JWT firmato che inviano nuovamente con ogni richiesta. POST /token è il login per queste app.

In server.js, importa SignJWT da jose accanto a decodeJwt. Sopra le route, converti process.env.JWT_SECRET in byte con un TextEncoder, come mostra la lezione, perché jose firma usando byte. Questa lezione imposta JWT_SECRET per te.
Aggiungi POST /token. Riceve lo stesso corpo della richiesta di login, {"username": "ada", "password": "correct horse"}, e verifica il nome utente e la password nello stesso modo in cui lo fa POST /login. Se non sono corretti, rispondi con lo stato 401 e {"error": "Wrong username or password"}.
Se sono corretti, firma un token e restituiscilo come {"token": "..."}. Il token deve:
- usare l'algoritmo HS256, firmato con i byte di JWT_SECRET;
- contenere la dichiarazione username nel proprio payload;
- avere come subject l'_id dell'utente sotto forma di testo. Usa toHexString(), perché jose rifiuta un subject che non è testo;
- scadere un'ora dopo la sua creazione.
Un token di questa lezione è simile a questo: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6ImFkYSIsInN1YiI6IjY2ZjFjMmE5ZTRiMGExYjJjM2Q0ZTVmNiIsImlhdCI6MTc5MzM2MTYwMCwiZXhwIjoxNzkzMzY1MjAwfQ.EdCrjAKSjZowcjE3-IjKttBLVK1VKKbL9DPnJDLdgug

Prova: Premi Run. Invia POST /signup con {"username": "ada", "password": "correct horse"}. Invia POST /token con lo stesso corpo: stato 200 e {"token": "..."}. Copia il token e invia GET /inspect?token= seguito dal token. Vedrai qualcosa del genere: {"username": "ada", "sub": "66f1c2a9e4b0a1b2c3d4e5f6", "iat": 1793361600, "exp": 1793365200}: exp è 3600 secondi dopo iat. Invia POST /token con {"username": "ada", "password": "wrong horse"}: stato 401.

Provalo tu

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 });
});

// Mostra il contenuto di 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 pagina di amministrazione. Nessuna dichiarazione può essere considerata attendibile prima che ne sia stata verificata la firma.
app.get('/admin', (req, res) => {
    res.status(403).json({ error: 'Admins only' });
});

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

Tutte le lezioni di Autenticazione e sicurezza

Esercitati da solo: Playground Express