Что такое JWT

Часть раздела Аутентификация и безопасность путешествия по Node.js на Coddy. Урок 14 из 24.

Сессия требует обращения к базе данных при каждом запросе. JWT (JSON Web Token) содержит сами данные: три части, разделённые точками. Каждая часть записана в base64url — формате записи байтов с помощью букв, цифр, - и _. Заголовок указывает алгоритм, полезная нагрузка содержит утверждения (sub — чей это токен, exp — когда срок его действия истекает), а подпись подтверждает, что токен создал сервер.

Base64url — это кодирование, а не шифрование. Любой, у кого есть токен, может прочитать его полезную нагрузку:

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

decodeJwt(token) из jose, пакета для JWT, делает то же самое. Он считывает полезную нагрузку, не проверяя подпись, и вызывает исключение, если текст не является JWT. Поэтому никогда не помещай секретные данные в полезную нагрузку и никогда не принимай решений на основании утверждения, которое вернул decodeJwt: любой может указать любое утверждение.

Задание

Легко

В этой главе добавляется второй способ входа — с помощью токенов — для приложений, которые обращаются к вашему API. Работа начинается с уменьшенной копии сервера: в ней есть регистрация и вход, но нет сессий и заметок. JWT содержит свои данные внутри себя, и любой может их прочитать. Создайте маршрут, который показывает, что содержится в токене, и закройте страницу администратора, которая доверяет всему, что заявляет токен.

В server.js напишите GET /inspect. Он читает токен из строки запроса, например GET /inspect?token=eyJ..., и возвращает содержащиеся в нём утверждения в формате JSON. Прочитайте их с помощью decodeJwt, которая уже импортирована. Для токена с полезной нагрузкой {"sub": "lin", "plan": "free"} маршрут возвращает ровно {"sub": "lin", "plan": "free"}.
decodeJwt вызывает ошибку, если текст не является JWT. Перехватите её и верните ответ со статусом 400 и {"error": "Not a JWT"}. Например, запрос GET /inspect?token=hello получает этот ответ со статусом 400.
Посмотрите на GET /admin. Он читает токен с помощью decodeJwt и показывает секрет, если в токене указано "admin": true. Но decodeJwt никогда не проверяет подпись, поэтому любой может составить токен, в котором указано "admin": true. Этот сервер пока не умеет проверять подписи. Поэтому настройте GET /admin так, чтобы он отвечал статусом 403 и {"error": "Admins only"} на каждый запрос, независимо от полученного токена. 403 Forbidden означает «вам нельзя это видеть». В главе 4 страница администратора снова станет доступна, но только настоящим администраторам.

Попробуйте: Нажмите «Запустить». В строке запроса изначально указан GET /admin?token=, за которым следует этот токен: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJtYWxsb3J5IiwiYWRtaW4iOnRydWV9.c2lnbmF0dXJl Злоумышленник по имени mallory написал его вручную, не имея секретного ключа. Отправьте его, прежде чем что-либо менять: исходный сервер возвращает {"secret": "The vault key is 42"}. После изменений снова нажмите «Запустить» и отправьте тот же запрос: статус 403 и {"error": "Admins only"}. Отправьте GET /inspect?token=, за которым следует тот же токен: {"sub": "mallory", "admin": true} — данные прочитаны без какого-либо ключа. Отправьте GET /inspect?token=hello: статус 400 и {"error": "Not a JWT"}.

Попробуйте сами

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

// Показывает содержимое токена: GET /inspect?token=...
app.get('/inspect', (req, res) => {
    res.status(501).json({ error: 'Not written yet' });
});

// Страница администратора.
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');
});