Czym jest JWT

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

Sesja wymaga wyszukania danych w bazie przy każdym żądaniu. JWT (JSON Web Token) zawiera te informacje samodzielnie: trzy części połączone kropkami. Każda część jest zapisana w formacie base64url, który pozwala zapisywać bajty za pomocą liter, cyfr, - i _. Nagłówek określa algorytm, ładunek zawiera deklaracje (sub określa, czyj to token, a exp — kiedy wygasa), a podpis potwierdza, że token został utworzony przez serwer.

Base64url to kodowanie, a nie szyfrowanie. Każdy, kto ma token, może odczytać jego ładunek:

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

decodeJwt(token) z pakietu JWT jose robi to samo. Odczytuje ładunek bez sprawdzania podpisu i zgłasza błąd, gdy tekst nie jest JWT. Dlatego nigdy nie umieszczaj sekretu w ładunku i nigdy nie podejmuj żadnych decyzji na podstawie deklaracji zwróconej przez decodeJwt: każdy może wpisać dowolną deklarację.

Wyzwanie

Łatwy

Ten rozdział wprowadza drugi sposób logowania za pomocą tokenów, przeznaczony dla aplikacji korzystających z Twojego API. Zaczyna się od mniejszej kopii serwera, która obsługuje rejestrację i logowanie, ale nie sesje ani notatki. JWT zawiera swoje dane wewnątrz, a każdy może je odczytać. Utwórz trasę, która pokazuje, co zawiera token, i zamknij stronę administratora, która ufa wszystkiemu, co deklaruje token.

W pliku server.js napisz GET /inspect. Odczytuje on token z ciągu zapytania, jak w GET /inspect?token=eyJ..., i zwraca zawarte w nim deklaracje w formacie JSON. Odczytaj je za pomocą decodeJwt, który jest już zaimportowany. Dla tokenu, którego ładunek to {"sub": "lin", "plan": "free"}, trasa zwraca dokładnie {"sub": "lin", "plan": "free"}.
decodeJwt zgłasza błąd, gdy tekst nie jest JWT. Przechwyć go i odpowiedz statusem 400 oraz {"error": "Not a JWT"}. Na przykład GET /inspect?token=hello zwraca ten status 400.
Spójrz na GET /admin. Odczytuje token za pomocą decodeJwt i ujawnia sekret, gdy token zawiera "admin": true. Jednak decodeJwt nigdy nie sprawdza podpisu, więc każdy może wpisać token z deklaracją "admin": true. Ten serwer nie potrafi jeszcze sprawdzać podpisów. Dlatego ustaw, aby GET /admin odpowiadało statusem 403 i {"error": "Admins only"} na każde żądanie, niezależnie od otrzymanego tokenu. 403 Forbidden oznacza „nie możesz tego zobaczyć”. Rozdział 4 ponownie otworzy stronę administratora — tym razem tylko dla prawdziwych administratorów.

Wypróbuj: Naciśnij „Uruchom”. Pasek żądania zaczyna się od GET /admin?token=, po którym następuje ten token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJtYWxsb3J5IiwiYWRtaW4iOnRydWV9.c2lnbmF0dXJl Atakujący o nazwie mallory napisał go ręcznie, bez tajnego klucza. Wyślij go, zanim cokolwiek zmienisz: wersja początkowa zwraca {"secret": "The vault key is 42"}. Po wprowadzeniu zmiany uruchom ponownie i wyślij to samo żądanie: status 403 oraz {"error": "Admins only"}. Wyślij GET /inspect?token=, po którym następuje ten sam token: {"sub": "mallory", "admin": true} — odczytany bez żadnego klucza. Wyślij GET /inspect?token=hello: status 400 oraz {"error": "Not a JWT"}.

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, co zawiera token: GET /inspect?token=...
app.get('/inspect', (req, res) => {
    res.status(501).json({ error: 'Not written yet' });
});

// Strona administratora.
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');
});

Sprawdź się

Ta lekcja zawiera krótki quiz. Zacznij lekcję, żeby na niego odpowiedzieć i śledzić swoje postępy.

Wszystkie lekcje w sekcji Uwierzytelnianie i bezpieczeństwo

Poćwicz samodzielnie: Edytor online Express