Verificando tokens

Parte da seção Autenticação e segurança do Journey de Node.js da Coddy. Lição 16 de 24.

Um cliente de API envia seu token em um cabeçalho em cada solicitação: Authorization: Bearer <token>. Lê-lo com decodeJwt aceitaria qualquer token digitado por qualquer pessoa. jwtVerify(token, key) recalcula a assinatura com seu segredo e lança um erro quando ela não corresponde, quando o token expirou ou quando ele não é um JWT. Você só pode confiar em payload depois que a função retornar.

async function requireDevice(req, res, next) {
    const token = (req.get('authorization') ?? '').replace(/^Bearer /, '');
    try {
        const { payload } = await jwtVerify(token, deviceKey);
        req.device = payload.sub;
    } catch {
        return res.status(401).json({ error: 'Unknown device' });
    }
    next();
}

Desafio

Fácil

Agora aceite os tokens que você assina. Um app envia seu token em um cabeçalho em cada solicitação, e o servidor verifica a assinatura antes de confiar em qualquer coisa que esteja nele.

Em server.js, importe jwtVerify de jose.
Escreva um middleware requireUser(req, res, next). Ele lê o cabeçalho Authorization. Esse cabeçalho contém a palavra Bearer, um espaço e, em seguida, o token. Extraia o token dele.
Verifique o token com jwtVerify, usando a mesma chave com que você assina. jwtVerify lança um erro quando a assinatura não corresponde, quando o token expirou ou quando o texto nem sequer é um token. Em todos esses casos, e quando não houver cabeçalho, responda com o status 401 e {"error": "Log in first"}.
Quando o token for válido, defina req.user como um objeto com id, obtido da declaração sub do token, e username, obtido da declaração username do token. Em seguida, chame next().
Adicione GET /me com requireUser. Ele retorna req.user: {"id": "66f1c2a9e4b0a1b2c3d4e5f6", "username": "ada"}.

Teste: pressione Executar. Envie GET /me: status 401 e {"error": "Log in first"}. Envie POST /signup e, em seguida, POST /token, ambos com {"username": "ada", "password": "correct horse"}, e copie o token. No campo Cabeçalhos, adicione um cabeçalho chamado Authorization, cujo valor seja Bearer, um espaço e seu token. Envie GET /me: status 200, com seu id e "username": "ada". Agora altere uma letra na parte do meio do token, entre os dois pontos, e envie GET /me novamente: status 401, porque a assinatura não corresponde mais.

Experimente você mesmo

import express from 'express';
import { SignJWT, decodeJwt } from 'jose';
import { users } from './db.js';
import { hashPassword, verifyPassword } from './passwords.js';

const secret = new TextEncoder().encode(process.env.JWT_SECRET);

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

app.post('/token', 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' });
    }
    const token = await new SignJWT({ username: user.username })
        .setProtectedHeader({ alg: 'HS256' })
        .setSubject(user._id.toHexString())
        .setIssuedAt()
        .setExpirationTime('1h')
        .sign(secret);
    res.json({ token });
});

// Mostra o que um token contém: 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' });
    }
});

// A página de administração. Nenhuma declaração pode ser considerada confiável antes que sua assinatura seja verificada.
app.get('/admin', (req, res) => {
    res.status(403).json({ error: 'Admins only' });
});

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

Teste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Autenticação e segurança

Pratique por conta própria: Playground de Express