服务端阅读 05月28日 00:41
如何使用 Cookie 实现"记住我"功能？需要注意哪些安全问题？
核心答案Cookie 实现"记住我"的核心思路是：登录成功后生成一个加密的长期 Token，存入设置了 HttpOnly + Secure + SameSite 的持久化 Cookie，服务端同时将 Token 哈希存入数据库。下次访问时浏览器自动携带 Cookie，服务端校验 Token 哈希完成自动登录，无需用户再次输入密码。关键安全原则有三条：永远不要在 Cookie 中存储明文密码或密码哈希，只用随机生成的不可预测 Token每次使用后轮换 Token，旧的立即失效，防止重放攻击Cookie 必须设置 HttpOnly + Secure + SameSite=Strict，堵住 XSS 窃取、中间人截获、CSRF 伪造三条攻击路径实现方案对比方案一：持久 Session Cookie最简单的方式——延长 Session Cookie 的过期时间：// 服务端设置（Node.js Express）function setRememberMeCookie(res, token, rememberMe) { const options = { httpOnly: true, secure: process.env.NODE_ENV === 'production', sameSite: 'strict', path: '/' }; if (rememberMe) { // 勾选"记住我"：30天有效 options.maxAge = 30 * 24 * 60 * 60 * 1000; } else { // 未勾选：会话 Cookie，浏览器关闭即失效 delete options.maxAge; } res.cookie('authToken', token, options);}优点：实现简单，适用于小型应用。缺点：Token 不轮换，一旦泄露可被长期使用；单 Token 承载所有功能，撤销困难。方案二：双令牌机制（推荐）将短期的访问令牌和长期的刷新令牌分离：const crypto = require('crypto');const jwt = require('jsonwebtoken');function generateTokens(userId) { // 访问令牌：短期，用于接口鉴权 const accessToken = jwt.sign( { userId }, process.env.JWT_SECRET, { expiresIn: '15m' } ); // 刷新令牌：长期，仅用于换取新的访问令牌 const refreshToken = crypto.randomBytes(32).toString('hex'); // 服务端存储刷新令牌的哈希值（不是明文） const tokenHash = crypto .createHash('sha256') .update(refreshToken) .digest('hex'); await db.saveRefreshToken({ userId, tokenHash, // 只存哈希，数据库泄露也无法还原 Token expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000), userAgent: req.headers['user-agent'], ipAddress: req.ip }); return { accessToken, refreshToken };}// 设置 Cookiefunction setAuthCookies(res, tokens, rememberMe) { res.cookie('accessToken', tokens.accessToken, { httpOnly: true, secure: true, sameSite: 'strict', maxAge: 15 * 60 * 1000 // 15分钟 }); if (rememberMe) { res.cookie('refreshToken', tokens.refreshToken, { httpOnly: true, secure: true, sameSite: 'strict', maxAge: 30 * 24 * 60 * 60 * 1000 // 30天 }); }}优点：访问令牌短命即使泄露影响有限，刷新令牌可单独撤销，支持多设备管理。缺点：实现复杂度更高，需要额外的刷新接口和存储。安全防护要点Token 生成：必须用加密安全随机数// 正确：crypto.randomBytesconst token = crypto.randomBytes(32).toString('hex');// 错误：Math.random 或时间戳——可预测，可被暴力破解const badToken = Date.now().toString(36) + Math.random().toString(36);Math.random() 是伪随机数，攻击者可以通过观察输出模式预测后续值。crypto.randomBytes() 使用操作系统提供的真随机源，不可预测。Token 存储：数据库只存哈希数据库中存储 Token 的 SHA-256 哈希，而非明文。这样即使数据库被拖库，攻击者也无法用哈希反推原始 Token 伪造 Cookie。// 存储const tokenHash = crypto.createHash('sha256').update(token).digest('hex');await db.save({ tokenHash, userId, expiresAt });// 验证const inputHash = crypto.createHash('sha256').update(cookieToken).digest('hex');const record = await db.findOne({ tokenHash: inputHash });Token 轮换：用一次换一个每次用刷新令牌换新的访问令牌时，同时生成新的刷新令牌，旧的立即删除：async function rotateRefreshToken(oldToken, req) { const inputHash = crypto.createHash('sha256').update(oldToken).digest('hex'); const record = await db.findOne({ tokenHash: inputHash }); if (!record || record.expiresAt < new Date()) { throw new Error('Invalid or expired token'); } // 异地登录检测：User-Agent 或 IP 变化时告警 if (record.userAgent !== req.headers['user-agent']) { // 可选：通知用户，或要求重新验证 await notifyUser(record.userId, '检测到新设备登录'); } // 删除旧令牌 await db.deleteOne({ tokenHash: inputHash }); // 生成新令牌 const newToken = crypto.randomBytes(32).toString('hex'); const newHash = crypto.createHash('sha256').update(newToken).digest('hex'); await db.save({ userId: record.userId, tokenHash: newHash, expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000), userAgent: req.headers['user-agent'], ipAddress: req.ip }); return newToken;}不轮换的后果：攻击者偷走 Token 后可以无限期使用，用户改密码也不会失效。Cookie 属性：三件套缺一不可| 属性 | 作用 | 不设置的后果 ||------|------|-------------|| HttpOnly | 禁止 JS 读取 Cookie | XSS 攻击可通过 document.cookie 窃取令牌 || Secure | 仅 HTTPS 传输 | HTTP 明文传输，中间人可直接截获 || SameSite=Strict | 跨站请求不携带 Cookie | CSRF 攻击可伪造用户操作 |撤销与清理用户主动登出或修改密码时，必须清除所有刷新令牌：async function revokeAllTokens(userId) { await db.deleteMany({ userId }); // 清除客户端 Cookie res.clearCookie('accessToken'); res.clearCookie('refreshToken');}// 修改密码后强制所有设备重新登录async function changePassword(userId, newPassword) { await updateUserPassword(userId, newPassword); await revokeAllTokens(userId);}客户端自动登录流程// 页面加载时尝试自动登录async function checkAutoLogin() { // 浏览器自动携带 HttpOnly Cookie，无需手动读取 const response = await fetch('/api/auth/refresh', { method: 'POST', credentials: 'include' // 确保携带 Cookie }); if (response.ok) { const { accessToken } = await response.json(); // 短期访问令牌可存内存（或 sessionStorage），不放 localStorage return accessToken; } // 刷新失败，跳转登录页 window.location.href = '/login'; return null;}注意：访问令牌不要存 localStorage，因为 XSS 可以直接读取。存在内存变量或 sessionStorage 中更安全。面试追问Q1：Cookie 的 SameSite 设为 Strict 会不会影响从外部链接跳转过来的自动登录？会。SameSite=Strict 意味着任何跨站请求都不带 Cookie，包括从搜索引擎、邮件链接点进来。如果需要兼顾体验，可以用 SameSite=Lax（GET 请求仍携带 Cookie），再配合 CSRF Token 做双重保护。Q2：刷新令牌被偷了怎么办？轮换机制本身就在降低风险——旧令牌用一次就作废。更完善的方案是记录每个令牌的 IP 和 User-Agent，发现异常变化时：通知用户、要求二次验证、或直接撤销该用户所有令牌。Q3：为什么不用 JWT 直接做"记住我"？JWT 一旦签发就无法撤销（除非引入黑名单，但那就失去了无状态的优势）。长期有效的 JWT 泄露后攻击者可以一直使用到过期。用不透明 Token + 服务端存储 + 轮换机制，撤销只需要删一条数据库记录。Q4：多设备同时登录怎么管理？每台设备生成独立的刷新令牌，数据库记录每条令牌的设备信息（User-Agent、IP、最后使用时间）。用户可以在"已登录设备"页面查看并逐个撤销。
