トークンの有効期限

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

サーバーはトークンを取り消せません。何も保存されないため、盗まれたトークンは有効期限が切れるまで使えます。トークンの有効期間は短くし、日単位ではなく分単位にして、新しいトークンをクライアントから要求できるようにしましょう。

jwtVerify は、exp の期限が過ぎたトークンをすでに拒否します。exp は、1970年1月1日からの秒数で表される時点です。errors.JWTExpired をスローします。err instanceof errors.JWTExpired はこの種のエラーに対して true になるため、期限切れのトークンと偽造されたトークンを区別して、その旨を伝えられます。Token expired と表示されたクライアントは、再度ログインする必要があるとわかります。

import { errors, jwtVerify } from 'jose';

try {
    await jwtVerify(inviteToken, inviteKey);
} catch (err) {
    if (err instanceof errors.JWTExpired) {
        return res.status(410).json({ error: 'This invite has run out' });
    }
    return res.status(400).json({ error: 'Not a real invite' });
}

チャレンジ

簡単

サーバーはトークンを取り消せないため、盗まれたトークンは有効期限が切れるまで使われ続けます。トークンの有効期間を短くし、トークンの有効期限が切れたときにアプリへ明確に知らせて、再度ログインする必要があると分かるようにしましょう。

server.js の POST /token で、トークンの有効期限を、作成から1時間後ではなく15分後に設定します。
requireUser で、jwtVerify が投げるエラーを確認します。有効期限切れのトークンに対して、jose は errors.JWTExpired を投げます。jose から errors をインポートします。この種類のエラーの場合は、ステータス401と {"error": "Token expired"} を返します。
それ以外の問題では、引き続きステータス401と {"error": "Log in first"} を返します。ヘッダーがない、トークンが変更されている、別のキーで署名されている場合などです。

試してみましょう：「実行」を押します。POST /signup、次に POST /token を送り、どちらにも {"username": "ada", "password": "correct horse"} を指定します。新しいトークンを続けて GET /inspect?token= を送ります。exp は iat の900秒後になっています。どちらも1970年1月1日からの経過秒数です。次に、このサーバーの秘密鍵で署名され、2026年1月1日に期限切れになったトークンを使います。Headers欄で、Authorization に Bearer、スペース、そしてそのトークンを設定し、GET /me を送ります。ステータス401と {"error": "Token expired"} が返ります。トークンの中間部分の文字を1つ変更して、もう一度送ります。ステータス401と {"error": "Log in first"} が返ります。変更されたトークンは、日付を読み取る前に署名チェックで失敗します。

自分で試してみよう

import express from 'express';
import { SignJWT, decodeJwt, jwtVerify } 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 });
});

// Authorization ヘッダー内のトークンを検証し、無効な場合は 401 を返す。
async function requireUser(req, res, next) {
    const token = (req.get('authorization') ?? '').replace(/^Bearer /, '');
    let payload;
    try {
        ({ payload } = await jwtVerify(token, secret));
    } catch {
        return res.status(401).json({ error: 'Log in first' });
    }
    req.user = { id: payload.sub, username: payload.username };
    next();
}

app.get('/me', requireUser, (req, res) => {
    res.json(req.user);
});

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

認証とセキュリティのすべてのレッスン

自分で練習してみよう: Expressプレイグラウンド