令牌过期

本课属于 Coddy Node.js 学习旅程的“身份验证与安全”单元。第 17 课，共 24 课。

服务器无法撤回令牌：它不会存储任何内容，因此被盗的令牌会一直有效，直到过期。让令牌的有效期较短，以分钟而不是天计算，并让客户端请求新的令牌。

jwtVerify 已经会拒绝 exp 时间已过的令牌。exp 是从 1970 年 1 月 1 日起按秒计算的一个时刻。它会抛出 errors.JWTExpired。对于这类错误，err instanceof errors.JWTExpired 的结果为 true，因此你可以区分过期令牌和伪造令牌，并说明原因：读取到 令牌已过期 的客户端会知道需要重新登录。

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 中，将令牌的有效期设为生成后 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 日过期的令牌：eyJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6ImFkYSIsInN1YiI6IjY2ZjFjMmE5ZTRiMGExYjJjM2Q0ZTVmNiIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI2NTAwfQ.PL8VCHpGNwBJ-7EawZ60veEEE-ZyosNC7xYQQpgT2uE在 Headers 字段中，将 Authorization 设为 Bearer、一个空格和该令牌，然后发送 GET /me：状态码为 401，返回 {"error": "Token expired"}。将令牌中间部分的一个字母改掉，再次发送：状态码为 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 请求头中的 token；如果无效，则返回 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);
});

// 显示 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');
});

身份验证与安全中的所有课

自己练习： Express 在线编辑器