身份认证与应用安全 / 系统课时

选择合适的 Token 存放位置

选择合适的 Token 存放位置

Token 放在哪里决定了浏览器重启后是否仍保持登录、前端脚本能否读取,以及请求是否会自动携带。没有一种位置同时消除 XSS、CSRF 和持久化风险,本篇比较内存、Web Storage 与 HttpOnly Cookie,并给出适合前后端分离项目的选择依据。

学习目标

  • 从脚本可读性、持久化和自动携带三个维度比较 Token 存储方案
  • 理解 XSS 与 CSRF 为什么会影响不同的存储方式
  • 根据登录体验和安全要求选择合适的 Token 保存位置

先分清三个判断维度

选择存储位置时,不要只问“浏览器关闭后 Token 还在不在”,而要同时看三个属性:JavaScript 能否读取、数据能保存多久、浏览器是否自动把凭据附加到请求中。

存放位置 JavaScript 可读 持久化特征 自动随请求携带 主要安全关注点
内存状态 是 刷新或关闭页面后通常丢失 否 XSS 运行期间仍可窃取或滥用 Token
sessionStorage 是 当前标签页生命周期内保存 否 XSS 可直接读取,关闭标签页后通常清除
localStorage 是 浏览器重启后通常仍存在 否 XSS 可直接读取长期保存的 Token
HttpOnly Cookie 否 由 Cookie 生命周期决定 是 降低脚本直接读取风险,但需要处理 CSRF

OWASP 当前安全指南明确提醒,不应把认证 Token、Session ID、刷新令牌等凭据保存在 localStorage 或 sessionStorage 中,因为同源 JavaScript 可以访问这些数据,一处 XSS 就可能导致凭据泄露;HttpOnly Cookie 可以阻止 JavaScript 直接读取 Cookie。([OWASP Cheat Sheet Series][3])

这里需要区分“不能读取”和“不能滥用”。HttpOnly 可以阻止恶意脚本直接读取 Token 字符串,但如果页面已经发生 XSS,恶意脚本仍可能以当前用户身份调用同源接口,因此它不是对 XSS 的完整解决方案。

内存存储适合缩短暴露时间

把 Token 只放在前端运行时内存中,例如应用状态对象或模块变量,不会留下长期的浏览器存储记录。刷新页面后状态通常消失,因此它适合可以接受重新登录,或者另有安全会话恢复机制的场景。

它的优势是持久化窗口短,并且浏览器不会自动把 Token 附加到跨站请求。代价则是用户刷新页面可能丢失登录状态,而且只要 XSS 恶意代码正在当前页面运行,它仍然可以读取内存中的 Token,或者直接调用应用已有的请求逻辑。

因此,“只放内存”降低的是长期窃取和残留风险,而不是让 Token 对 XSS 完全不可见。

Web Storage 用便利性换取脚本可读性

localStorage 最直接的优势是实现简单:登录后保存 Token,页面刷新或浏览器重启后继续读取,再由请求拦截器放入 satoken 等 Header。它不会像 Cookie 那样由浏览器自动附加,因此传统的跨站请求伪造场景较少依赖这种凭据携带方式。

问题也来自同一个特性:应用 JavaScript 能读,成功执行的恶意 JavaScript 通常也能读。sessionStorage 只是把保存范围缩短到标签页,并没有改变“同源脚本可访问”这一安全属性。([OWASP Cheat Sheet Series][3])

如果业务因为桌面端 SPA 的登录体验而必须采用这类持久化方案,应把它当作明确的安全取舍,而不是默认选项。同时需要严格治理 XSS 来源、避免危险 DOM 写入、缩短 Token 有效期,并确保退出登录后删除客户端 Token 和服务端会话。

HttpOnly Cookie 会改变主要风险

服务端把会话 Token 放入带 HttpOnly 的 Cookie 后,前端 JavaScript 无需也不能读取 Token,浏览器会按照 Cookie 的域、路径、SameSite 等规则自动携带它。对于主要运行在浏览器中的高价值会话,这可以降低 Token 被 XSS 直接复制走的风险。

自动携带也意味着需要认真处理 CSRF。常见防护包括合适的 SameSite 策略、只通过 HTTPS 发送的 Secure 属性,以及对状态修改请求使用 CSRF Token、Origin 或 Referer 校验等措施。OWASP 将 SameSite 视为重要的纵深防御,但并不建议在所有部署中把它当成唯一的 CSRF 防线。([OWASP Cheat Sheet Series][4])

如果前端和后端跨域且依赖 Cookie,请求端还需要按浏览器 API 要求启用凭据,服务端 CORS 也需要允许凭据并使用明确的可信来源,而不能把凭据模式与任意来源通配符简单组合。([Home][2])

Sa-Token 本身可以从 Header 和 Cookie 中读取 Token,当前核心配置中的这两个读取开关默认均为开启,因此存储方案可以根据项目的浏览器安全模型选择,而不是被框架限制为某一种方式。([GitHub][5])

用业务约束做选择

如果页面刷新后允许重新登录,并希望尽量减少持久化凭据,优先考虑内存。如果只要求单个标签页内保留状态,sessionStorage 的持久范围比 localStorage 更小,但二者都不能抵抗成功执行的 XSS 对凭据的读取。

如果浏览器重启后必须保持登录,并且架构要求 JavaScript 自己读取 Token、写入请求 Header,那么 localStorage 提供了最直接的持久化体验,但必须接受更明显的 XSS 凭据泄露风险。如果后端能够采用基于 Cookie 的浏览器会话,则可以评估 HttpOnly、Secure、合适的 SameSite 与 CSRF 防护组合。

无论最终选哪种位置,客户端存储都不能替代服务端的过期、注销和会话撤销机制。存储位置决定 Token 如何到达服务端,而真正决定失效边界的仍应是服务端认证策略。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选择合适的 Token 存放位置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通