トークンの検証

CoddyのNode.jsジャーニー「認証とセキュリティ」セクションの一部。レッスン 11/17。

API クライアントは、すべてのリクエストでヘッダーにトークンを送信します：Authorization: Bearer <token>。decodeJwtで読み取ると、誰でも入力できるあらゆるトークンを受け入れてしまいます。jwtVerify(token, key)は秘密鍵を使って署名を再計算し、一致しない場合、トークンの有効期限が切れている場合、またはそもそもJWTではない場合に例外をスローします。この関数が戻った後にのみ、payloadを信頼できます。

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

チャレンジ

簡単

requireUserを作成します。Authorization: BearerトークンをjwtVerifyで検証し、そのクレームからreq.user = { id, username }を設定するか、401と{ "error": "Log in first" }を返します。
GET /meでこれを使用し、req.userを返します。

トークンを付けずにGET /meを送信します。POST /tokenでトークンを取得し、ヘッダーにAuthorization: Bearer <token>を追加して、もう一度GET /meを送信します。次に、トークンの文字を1つ変更して、もう一度送信します。

自分で試してみよう

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

// トークンの内容を表示する: 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' });
    }
});

// 管理者ページ。署名を検証するまでは、どのクレームも信頼できない。
app.get('/admin', (req, res) => {
    res.status(403).json({ error: 'Admins only' });
});

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