Session、JWT 与 Token 认证机制
🎯 引言
学完这篇文章,你能创建并验证会话凭据和 JWT,并判断两种机制的取舍。
🎫 Token 是凭据,JWT 是一种格式
Token 泛指客户端用来证明某种身份或资格的值。随机 Session ID 是 Token,JWT 也可以作为 Token。它们不是三个互斥选项。
Session 方案通常让客户端保存随机值,服务端按这个值查登录记录。JWT 通常携带签名后的声明,服务端验证签名及约束,再使用其中的用户标识。签名用于验证内容没有被不可信方篡改,不等于把内容加密。
🗃 使用 express-session 保存登录状态
Express 项目可以使用 express-session 管理会话。它读取会话 Cookie、查找服务端记录,并通过 req.session 提供当前会话。
安装本节需要的依赖:
npm install express-session@1.19.0
新建 session-app.mjs,准备应用和会话密钥:
import express from 'express';
import session from 'express-session';
export const app = express();
const secret = process.env.SESSION_SECRET;
if (!secret || Buffer.byteLength(secret) < 32) throw new Error('请配置会话密钥');
SESSION_SECRET 应是随机生成并保存在服务端的秘密值,用于保护会话 Cookie 的签名。可以用内置加密模块生成一次,将输出保存到本地 .env 的 SESSION_SECRET 中,不提交仓库:
import { randomBytes } from 'node:crypto';
console.log(randomBytes(32).toString('hex'));
运行 node session-secret.mjs 会得到一段随机字符串。多个服务实例要使用一致的密钥,不能每次请求重新生成。
🍪 在路由前配置会话中间件
在 session-app.mjs 添加:
app.use(session({
name: 'sid',
secret,
resave: false,
saveUninitialized: false,
cookie: { httpOnly: true, sameSite: 'lax', secure: false, maxAge: 30 * 60_000 }
}));
name 指定 Cookie 名称;resave: false 避免未修改时重复保存;saveUninitialized: false 避免为未使用会话的访问者写入记录。Cookie 有效期为 30 分钟,HttpOnly 限制页面脚本读取,SameSite 限制跨站携带。
secure: false 仅适用于本机 HTTP 练习。正式 HTTPS 服务设为 true;经过反向代理时,还应按实际部署配置 Express 对可信代理的识别。
默认存储只适合本地开发,重启会丢失记录。正式部署在 session 配置的 store 中接入共享存储,让多个进程都能读取同一份登录状态,并由存储清理过期会话。
✅ 验证密码后保存用户 ID
账号密码验证成功后,先重新生成会话 ID,再保存可信用户 ID。这样登录前的旧会话不能继续用于登录后的身份。
下面的函数用于登录成功这一步,res.locals.user 是前面的密码验证步骤查询并确认的用户记录,例如 { id: 1 },不能直接赋为请求正文:
export function loginSuccess(req, res, next) {
req.session.regenerate(error => {
if (error) return next(error);
req.session.userId = res.locals.user.id;
req.session.save(error => {
if (error) return next(error);
res.json({ data: { loggedIn: true } });
});
});
}
把这个处理函数放在登录路由完成密码验证之后执行。regenerate 更换会话,save 确认记录已保存,再返回成功;失败则交给错误中间件。浏览器收到 Set-Cookie 后保存 sid,以后的符合条件的请求会自动携带它。
🔎 业务接口读取登录身份
在会话中间件之后添加 /me:
app.get('/me', (req, res) => {
if (!req.session.userId) {
return res.status(401).json({ error: '请先登录' });
}
res.json({ data: { userId: req.session.userId } });
});
没有有效登录记录时得到 401。登录为用户 1 后,同一个浏览器请求会得到 {"data":{"userId":1}},用户 ID 来自服务端会话,而非客户端自己声明。
🚪 退出时删除服务端会话
继续添加退出接口:
app.post('/logout', (req, res, next) => {
req.session.destroy(error => {
if (error) return next(error);
res.clearCookie('sid', { path: '/' });
res.status(204).end();
});
});
destroy 删除会话记录,clearCookie 通知浏览器删除对应 Cookie。成功返回 204,再请求 /me 就会得到 401。Cookie 认证的修改接口还需在修改前执行 CSRF 防护,具体做法见安全篇。
✍️ 使用库签发 JWT
在示例目录安装 JWT 库:
npm install jose@6.2.13
新建 tokens.mjs,准备签名密钥:
import { SignJWT, jwtVerify } from 'jose';
import { randomBytes } from 'node:crypto';
const key = randomBytes(32);
这是本地演示密钥,重启会变化。正式服务应从安全配置读取稳定密钥,并设计轮换;不能把密钥写进前端或源码仓库。
添加签发函数:
export function issueAccess(userId) {
return new SignJWT({})
.setProtectedHeader({ alg: 'HS256' })
.setSubject(String(userId))
.setIssuer('backend-demo')
.setAudience('web-demo')
.setExpirationTime('15m')
.sign(key);
}
sub 标识用户,iss 限定签发者,aud 限定使用方,exp 限定有效期。这里使用 HS256,由持有同一秘密密钥的一方签发和验证;密钥泄露后别人也能伪造令牌。
JWT 内容可被读取,不要放密码、身份证件等秘密信息。
✅ 验证后才能使用声明
在同一文件添加:
export async function verifyAccess(token) {
const { payload } = await jwtVerify(token, key, {
algorithms: ['HS256'], issuer: 'backend-demo', audience: 'web-demo'
});
if (typeof payload.sub !== 'string') throw new Error('缺少用户标识');
return payload.sub;
}
签名、算法、签发者、使用方或有效期不符合时会失败。仅解码载荷只能读取内容,不能证明内容可信。
新建 token-demo.mjs:
import { issueAccess, verifyAccess } from './tokens.mjs';
const token = await issueAccess(1);
console.log(await verifyAccess(token));
运行后得到字符串 1。接口收到 Bearer 凭据后调用 verifyAccess,验证失败应转换为 401,成功后再检查权限。
⚖️ 按撤销和部署需求选择
Session 可以通过删除记录立即撤销,但每次需要查服务端状态。JWT 可以在验证签名后读取声明,但退出登录不会自动作废已发出的 JWT;若要求立即撤销,仍要增加服务端状态检查或使用较短有效期。
JWT 中保存的角色可能过时。敏感权限应结合当前用户状态判断,不能仅因为令牌签名有效就永久相信旧权限。
❓ 知识问答
Q1:JWT 比 Session 一定更安全吗?
不是。两者都依赖密钥或凭据保护、有效期、撤销机制和请求权限检查,格式本身不保证整体安全。
Q2:Token 能放 URL 中吗?
不应这样传登录凭据,URL 容易进入历史与日志。使用合适的认证头或受保护 Cookie。
Q3:一个服务只验证签名就够了吗?
不够,还要检查有效期、签发者、使用方、允许算法和所需声明,并进行实际授权。
🧪 小练习
在项目登录流程中接入会话保存与退出,确认退出后 /me 返回 401;将 JWT 验证端 audience 改为其他值,确认同一令牌不能通过。
// 请在这里编写代码或记录验证结果
