Podpisywanie tokenów

Część sekcji Uwierzytelnianie i bezpieczeństwo ścieżki Node.js w Coddy. Lekcja 15 z 24.

Token ma wartość tylko wtedy, gdy nikt inny nie może go utworzyć. W przypadku HS256 biblioteka jose łączy nagłówek i ładunek z sekretem znanym tylko serwerowi, a następnie oblicza skrót wyniku. Ten skrót jest podpisem. Bez sekretu nikt nie może utworzyć pasującego podpisu.

Sekret pochodzi ze zmiennej środowiskowej process.env.JWT_SECRET, nigdy z kodu: kod jest udostępniany, kopiowany i zatwierdzany. Ta lekcja ustawia dla Ciebie JWT_SECRET. Biblioteka jose potrzebuje go w postaci bajtów.

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 przyjmuje tekst, a setExpirationTime — przedział czasu, taki jak '30m' lub '2d'.

Wyzwanie

Łatwy

Aplikacje korzystające z Twojego API, takie jak aplikacja na telefon, nie przechowują plików cookie tak jak przeglądarka. Zamiast tego przekaż im token: podpisany JWT, który będą wysyłać z każdym żądaniem. POST /token to punkt logowania dla tych aplikacji.

W pliku server.js zaimportuj SignJWT z jose obok decodeJwt. Nad trasami zamień process.env.JWT_SECRET na bajty za pomocą TextEncoder, tak jak pokazano w lekcji, ponieważ jose podpisuje dane w postaci bajtów. Ta lekcja ustawia za Ciebie JWT_SECRET.
Dodaj POST /token. Otrzymuje takie samo body jak logowanie, {"username": "ada", "password": "correct horse"}, i sprawdza nazwę użytkownika oraz hasło tak samo jak POST /login. Jeśli są nieprawidłowe, zwróć status 401 i {"error": "Wrong username or password"}.
Jeśli są prawidłowe, podpisz token i zwróć go w postaci {"token": "..."}. Token musi:
- używać algorytmu HS256, podpisanego bajtami JWT_SECRET;
- zawierać claim username w swoim payloadzie;
- mieć tekstową wartość _id użytkownika jako subject. Użyj toHexString(), ponieważ jose nie akceptuje subjectu, który nie jest tekstem;
- wygasać godzinę po utworzeniu.
Token z tej lekcji wygląda tak: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6ImFkYSIsInN1YiI6IjY2ZjFjMmE5ZTRiMGExYjJjM2Q0ZTVmNiIsImlhdCI6MTc5MzM2MTYwMCwiZXhwIjoxNzkzMzY1MjAwfQ.EdCrjAKSjZowcjE3-IjKttBLVK1VKKbL9DPnJDLdgug

Wypróbuj: Naciśnij „Graj”. Wyślij POST /signup z {"username": "ada", "password": "correct horse"}. Wyślij POST /token z tym samym body: status 200 i {"token": "..."}. Skopiuj token i wyślij GET /inspect?token=, a następnie wklej go. Zobaczysz coś takiego: {"username": "ada", "sub": "66f1c2a9e4b0a1b2c3d4e5f6", "iat": 1793361600, "exp": 1793365200}: exp jest o 3600 sekund większe niż iat. Wyślij POST /token z {"username": "ada", "password": "wrong horse"}: status 401.

Spróbuj swoich sił

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

// Pokazuje zawartość tokenu: 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' });
    }
});

// Strona administratora. Nie można ufać żadnej deklaracji, dopóki nie zostanie zweryfikowany jej podpis.
app.get('/admin', (req, res) => {
    res.status(403).json({ error: 'Admins only' });
});

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

Wszystkie lekcje w sekcji Uwierzytelnianie i bezpieczeństwo

Poćwicz samodzielnie: Edytor online Express