Cookie 的安全性由属性决定,而不是值本身。会话 Cookie 应同时设置 Secure 与 HttpOnly,默认使用 SameSite=Lax,只有在真正的跨站流程中才使用 SameSite=None; Secure;优先用 __Host- 前缀而不是 Domain,配合较短的 Max-Age,在登录后轮换会话标识,并为所有改变状态的请求增加 CSRF Token 与 Origin 校验。
- Secure 保护传输,HttpOnly 阻止脚本读取,SameSite 限制跨站发送,Domain 与 Path 定义作用域,但它们都不加密 Cookie 的值。
- host-only 的 __Host- Cookie 是最稳妥的默认值:禁止 Domain、要求 Path=/ 与 Secure,同级子域无法覆盖它。
- SameSite=Lax 能挡住大多数跨站写操作,但挡不住一级 GET 导航,改变状态的请求仍然需要 CSRF Token 与 Origin 校验。
- Cookie 投掷与子域遮蔽之所以成立,是因为被攻陷的同级子域可以设置父域 Cookie;通配 Domain 不合法,前缀能堵住这个口子。
- 会话标识必须在登录时轮换、在服务端以哈希保存,并受空闲超时与绝对超时约束,权限变化后还要重新生成。
Cookie 是浏览器自动附带的一小段状态。它的安全几乎完全取决于属性,而不是值里写了什么。一个没有任何标记的 Cookie 会通过明文 HTTP 传输,能被页面上的任何脚本读取,也可能被其他站点触发。每个属性关掉一扇门:Secure 限制传输通道,HttpOnly 限制脚本访问,SameSite 限制跨站发送,Domain 与 Path 限制发送范围。这些属性都不负责加密。浏览器只执行它能执行的部分,授权、会话校验与撤销仍然必须由服务端负责。
Cookie 属性究竟控制什么
服务端在响应中发送 Set-Cookie,浏览器保存名称、值与属性,之后请求只回传 Cookie: name=value。属性不会原样回传,因此一个配置错误的 Cookie 可能在服务端日志里看起来正常,到了浏览器却行为异常。属性可以分成五类工作:传输(Secure)、脚本可见性(HttpOnly)、请求携带(SameSite)、作用域(Domain、Path)与生命周期(Max-Age、Expires)。__Host-、__Secure- 名称前缀和 Partitioned 属性是两项较新的机制,改变的是浏览器如何接受和存储 Cookie。
属性由浏览器执行,不是由你的框架执行。读取 Cookie 请求头的服务端必须自己校验会话标识、检查过期记录,绝不能因为 Cookie 存在就认定用户身份。要把值当作指向服务端状态的不可猜测句柄,而不是角色、价格或个人数据的容器。任何能接触设备、安装浏览器扩展或使用调试代理的人,都能读取所有非 HttpOnly 的 Cookie,并在浏览器配置目录里检查其余内容。
Secure、HttpOnly 与 Domain、Path 作用域
Secure 表示只通过 HTTPS 发送。它能抵御被动网络嗅探和降级到明文的攻击,但不会对 JavaScript、扩展或服务端日志隐藏值。现代浏览器还要求 SameSite=None 必须同时带 Secure;缺少 Secure 的 None Cookie 会被直接拒绝,这是最常见的“登录悄悄失效”原因之一。
HttpOnly 让 Cookie 从 document.cookie 中消失。它提高了 XSS 的成本,因为注入的脚本无法直接窃取会话标识;但脚本仍然可以在页面内发起已认证请求,所以只要标签页还开着,XSS 依然等同于会话被完全控制。
Domain 决定跨主机共享。不写 Domain 时是 host-only:由 app.example.com 设置,就只回传给 app.example.com。写了 Domain=example.com,所有子域都会收到,包括营销站、状态页和被遗忘的预发主机。现代浏览器会忽略前导点,而 Domain=*.example.com 这种通配写法不是合法语法,浏览器要么拒绝,要么按字面主机处理,两种结果都不是你想要的。除非同级主机确实需要共享,否则不要写 Domain。
Path 是前缀匹配,不是访问控制。Path=/account 的 Cookie 会发往 /account 和 /account/settings,但不会发往 /login。由于同源的任何响应都能设置 Path=/ 的 Cookie,Path 无法防止同源代码读取或覆盖它;同名但路径不同的 Cookie 还可以共存,到达服务端的顺序未必符合预期。
| 属性 | 控制的内容 | 安全默认值 | 常见错误 |
|---|---|---|---|
Secure | 传输通道 | 始终设置 | 降级后仍通过 HTTP 发送 |
HttpOnly | 脚本访问 | 只用会话 Cookie | 令牌可被 XSS 读取 |
SameSite | 跨站请求 | Lax | None 不带 Secure |
Domain | 主机作用域 | 省略,host-only | 使用通配或父域 |
Path | 请求路径作用域 | 应用使用 / | 当成权限控制 |
Max-Age | 相对生命周期 | 会话保持较短 | 省略后变成会话 Cookie |
Expires | 绝对生命周期 | 仅作兜底 | 与 Max-Age 冲突 |
__Host- | 名称强制作用域 | 会话与 CSRF Cookie | 加了 Domain 后被拒绝 |
Partitioned | 存储分区 | 嵌入式第三方组件 | 误以为能替代 SameSite |
SameSite:Lax、Strict 与 None 的实际取舍
站点由协议和可注册域名共同决定。app.example.com 与 www.example.com 虽然源不同,却属于同一站点,因此 SameSite 不会把子域彼此隔离;它管的是请求由另一个站点发起时,Cookie 是否附带。
SameSite=Strict 在所有跨站请求中都不发送 Cookie。用户从邮件点链接进入已登录的控制台时,请求不带会话 Cookie,可能先看到登录页再跳转一次。SameSite=Lax 会在安全的一级导航中发送,例如点击链接或直接输入 URL,但不会在跨站 POST、fetch、iframe 加载或子资源请求中发送。属性缺省时浏览器默认按 Lax 处理,但依赖隐式默认值很脆弱,旧客户端和非浏览器代理的行为并不一致。
SameSite=None 允许跨站发送,并且必须带 Secure。SSO 回调、支付 iframe 和嵌入式组件需要它,同时必须配套 CSRF 防护,因为 Cookie 现在会随其他站点发起的请求一起走。不要为了让一个坏掉的集成“先跑起来”就改成 None:常见根因是本该同源代理的跨域 XHR,放宽 Cookie 等于把会话暴露给每一个嵌入页面。
会话 Cookie、Max-Age 与 Expires
会话 Cookie 既没有 Max-Age 也没有 Expires。浏览器会在会话结束时丢弃它,但会话恢复和移动浏览器可能让它保留数天,所以“会话 Cookie”描述的是存储行为,不是安全级别。持久 Cookie 用秒为单位的 Max-Age 或绝对日期的 Expires。两者同时存在时 Max-Age 优先,值为零或负数会立即删除 Cookie。
HTTP/1.1 204 No Content
Set-Cookie: __Host-sid=61f2c9a7d0e84b1f9a3c5e7d2b4a6c8e; Path=/; Secure; HttpOnly; SameSite=Lax; Max-Age=1800
Set-Cookie: __Host-csrf=9d41ab7c3e5f8062a1b4d7c9e2f30518; Path=/; Secure; SameSite=Lax; Max-Age=1800
Set-Cookie: theme=dark; Path=/; Secure; SameSite=Lax; Max-Age=31536000
例子里的会话与 CSRF Cookie 因为不写 Domain 而是 host-only;CSRF 值保持可读,前端才能把它放进请求头。偏好 Cookie 可以活得更久,因为丢失它没有代价。
新代码应优先用 Max-Age,它是相对时间,不受客户端时钟偏差影响;Expires 只留给不认识 Max-Age 的客户端。生命周期取满足流程的最短值:管理会话十五到六十分钟,低风险消费者会话最多几天。续期逻辑放在服务端,由会话记录独立执行空闲超时和绝对超时,而不是相信浏览器里存了什么。
会话 Cookie 并不会自动比持久 Cookie 安全。Cookie 文件、会话恢复和浏览器同步都可能把它保留下来。真正限制暴露时间的是服务端过期与轮换策略,而不是有没有写过期属性。
__Host-、__Secure- 前缀、Cookie 投掷与子域遮蔽
__Secure- 前缀要求 Cookie 在 HTTPS 下设置并带 Secure。__Host- 更严格:必须带 Secure、不能有 Domain、并且 Path=/。违反任一条件,浏览器都会拒绝写入。由于 __Host- Cookie 是 host-only,同级子域无法替父域覆盖它,因此它适合作为应用主机上的会话 Cookie 和 CSRF Cookie 名称。
Cookie 投掷利用的正是缺少这层保护。如果应用的会话 Cookie 叫 sid 而不是 __Host-sid,攻击者控制或攻陷 blog.example.com 后,就可以设置一个 Domain=example.com、名称同为 sid 的值。浏览器此时持有两个同名 Cookie,顺序由路径长度和创建时间决定,不同的服务端框架可能读第一个,也可能读最后一个。如果攻击者的值胜出,受害者会被固定到攻击者的会话,或者攻击者发起的请求会被当成受害者。
子域遮蔽是更广泛的情形:悬空的 DNS 记录、通配 DNS、*.example.com 上的用户生成内容,以及被遗忘的第三方主机,都会让外部人员获得同站位置。防御必须是结构性的:会话 Cookie 使用 __Host-;能省略 Domain 就省略;不让不可信内容进入子域;在边缘拒绝同名重复 Cookie;查询会话前先校验标识符格式。通配 Domain 解决不了这个问题,它本身就不合法,只会增加混乱。
CSRF、可读 Cookie 与 JWT 的位置
Cookie 会被自动附带,这正是 CSRF 的定义:另一个站点让浏览器发出已认证请求。SameSite=Lax 能挡住大多数跨站写操作,但挡不住一级 GET 导航,而把状态变更放在 GET 后面本身就是缺陷。可靠的防御是与会话绑定的随机 CSRF Token,在每个改变状态的请求上校验,再配合 Origin 或 Sec-Fetch-Site 白名单。双提交模式让 Token 保持 JavaScript 可读,并把 Cookie 与请求头做比较;这是少数必须不使用 HttpOnly 的合理场景。
把 JWT 放进可读 Cookie 是常见错误。没有 HttpOnly 时,任何 XSS 都能读取并窃取它;加了 HttpOnly,脚本读不到,但浏览器仍会自动附带,CSRF 风险照旧,XSS 也能借页面发起操作。长期 Bearer Token 放在 Cookie 里,还会继承会话 Cookie 的全部撤销难题,却缺少不透明会话标识对应的服务端控制。更稳妥的做法是把不透明会话标识放进 __Host- Cookie,把 Token 留在服务端;或者使用短期访问令牌、轮换机制和严格 CSP。
体积上限、分区存储与 CHIPS
浏览器通常允许每个 Cookie 约 4 KB(名称、值和属性都算),每个域允许几十到几百个 Cookie,具体取决于浏览器。超过任一上限都会静默驱逐或拒绝:应用看到的是 Cookie 消失,而不是报错。不要把会话拆成许多 Cookie,也不要把用户资料塞进去。需要更多状态时,让 Cookie 只保存标识符,把数据放到服务端存储,或放进为此设计的签名加密令牌。
Partitioned 实现的是 CHIPS:Cookie 以包含顶层站点的键存储,嵌入式组件在每个宿主站点拥有独立分区,不能拿一个分区的标识在另一个站点识别用户。它要求 Secure,面向真正的第三方嵌入。它不能替代 SameSite=None,不会把 Cookie 变成第一方,也不能免除 CSRF 防护;它还让会话可能存在的副本变多,因此登出时必须同时清除分区 Cookie 和第一方 Cookie。
第三方 Cookie 限制因浏览器和用户设置而异。嵌入组件要按失败关闭设计:拿不到分区 Cookie 时显示未登录状态,而不是退回到保护更弱的标识符。
轮换、撤销与长期会话
会话标识必须来自密码学安全的随机源,至少 128 位熵。随机令牌生成器可以生成这个范围的值;不要用计数器、时间戳或会泄露结构的 UUID。服务端只保存标识符的哈希,这样数据库泄露不会直接交出可用会话。
登录时轮换标识以防会话固定,权限变化后再轮换一次,长期会话还要定期轮换。轮换意味着签发新值、迁移服务端记录并让旧值失效;只改浏览器里的 Cookie 却不撤销旧记录,被偷走的副本仍然有效。要执行空闲超时和绝对超时,登出时立即失效,并在改密码或怀疑泄露时撤销该用户的全部会话。
长期会话不做轮换是最安静的事故:Cookie 一旦被截获,几个月内都有效,服务端没有任何事件会终止它。API 场景应使用带重放检测的刷新令牌轮换;同一个刷新令牌第二次出现就让整个令牌族失效。设备信号只能作为风险输入,不能作为唯一校验,因为共享网络和移动浏览器会产生大量误报。
验证清单与明确的通过标准
先验证响应头,再验证浏览器。用生产环境的真实登录响应开始;本地服务器放宽属性不能证明任何事。
# 1. 查看登录响应设置的每一个 Cookie
curl -sS -D - -o /dev/null -c jar.txt -X POST https://app.example.com/login | grep -i '^set-cookie:'
# 2. 带上 Cookie 罐,用外来 Origin 重放一个改变状态的接口
curl -sS -o /dev/null -w '%{http_code}\n' -b jar.txt \
-H 'Origin: https://evil.example' -X POST https://app.example.com/account/email
HTTP 响应头解析器可以解析第一个响应并标出缺失的属性。curl 模拟不了 SameSite,因为它不实现浏览器的站点模型,所以第二条命令只测试服务端是否执行 Origin 校验;跨站行为必须在浏览器里确认。
在开发者工具的 Application、Cookies 面板逐个读取属性。在控制台输入 document.cookie:带 HttpOnly 的会话 Cookie 必须不出现。再把应用放进跨站 iframe 或另一个本地源,确认哪些 Cookie 会被发送。只有下表全部满足才算通过。
| 检查项 | 验证方式 | 通过标准 |
|---|---|---|
| 会话 Cookie 属性 | 登录后查看 Application 面板 | Secure、HttpOnly、SameSite=Lax、__Host- 名称、host-only |
| 会话不可读 | 控制台执行 document.cookie | 会话标识不出现,只有 CSRF 或偏好值 |
| 跨站写操作 | 从另一个源带 Cookie 发 POST | 没有有效 CSRF Token 和允许的 Origin 时被拒绝 |
| 前缀完整性 | 尝试带 Domain 属性设置该 Cookie | 浏览器拒绝 __Host- Cookie |
| 过期策略 | 检查 Max-Age 与 Expires 列 | 生命周期较短,服务端执行空闲与绝对超时 |
| 分区存储 | 在两个顶层站点嵌入同一组件 | 分区值彼此独立,登出时两边都清除 |
| 轮换 | 连续登录两次并比较标识 | 值发生变化,旧标识被服务端拒绝 |
HTTP 请求工作台可以按原样重放抓到的请求,适合代理或框架改写请求头的场景。把结果写进发布检查单:属性回归在单元测试里看不见,在 Cookie 转储里却一目了然。
常见错误与生产规则
代价高昂的错误总是重复出现:
- 图省事使用通配或父域
Domain,把会话暴露给所有子域。 SameSite=None不带Secure,浏览器直接丢弃 Cookie,登录陷入循环。- 把 JWT 放在可读 Cookie 里,或者使用无法服务端撤销的长期 Bearer Token。
- 承载会话的 Cookie 没有
HttpOnly、没有轮换,却设置了一年Max-Age。 - 只靠
SameSite防 CSRF,同时保留用 GET 改状态的接口。 - 把
Path当权限控制,以为/admin作用域的 Cookie 能保护管理接口。 - 以为会话 Cookie 比持久 Cookie 安全,而服务端对两者都不设过期。
- 让被攻陷或被遗忘的子域设置父域 Cookie,遮蔽真实会话。
- 登出时不删除 Cookie,或只删浏览器副本却保留服务端记录。
- 把角色、价格或个人数据写进 Cookie,并在没有签名与服务端校验时直接信任。
规则很短:默认使用 host-only 的 __Host- 会话 Cookie,带 Secure、HttpOnly、SameSite=Lax 和较短的 Max-Age。除非同级主机确实需要,否则不写 Domain,也绝不用通配符。为改变状态的请求增加 CSRF Token 与 Origin 校验,只对真正的跨站嵌入使用 SameSite=None; Secure。登录和权限变化时轮换标识,服务端保存哈希,登出时撤销。Cookie 控制在 4 KB 内,不要拿它当数据库。用 curl 和浏览器验证生产属性,并在每次认证改动后重新检查。
常见问题
所有 Cookie 都应该设置 Secure 和 HttpOnly 吗?
所有 Cookie 都应设置 Secure,包括统计和偏好设置,否则明文传输会泄露它们。HttpOnly 只用于 JavaScript 不需要读取的 Cookie;CSRF Token 通常需要保持可读,而会话标识绝不能交给脚本。
SameSite=Lax 和 SameSite=Strict 有什么区别?
Strict 在所有跨站请求中都不发送 Cookie,包括从其他站点点击链接进来,因此用户刚到达时可能看起来未登录。Lax 会在安全的一级导航中发送,例如点击链接,但不会在跨站 POST、fetch 或 iframe 加载中发送,是更合适的默认值。
为什么浏览器拒绝我设置的 __Host- Cookie?
__Host- Cookie 必须通过 HTTPS 设置,带 Secure,完全不能有 Domain,并且 Path=/。任何 Domain 属性、不同的路径或明文来源都会让浏览器静默丢弃它,表现通常是登录循环,而不是报错。
可以把 JWT 放进 HttpOnly Cookie 吗?
可以,但 HttpOnly 只去掉了 JavaScript 读取路径,既不能阻止 XSS 借页面发起已认证请求,也不能消除 CSRF 风险,因为浏览器仍会自动附带 Cookie。要让脚本接触不到令牌,同时加上 SameSite 与 CSRF 防护;需要即时撤销时优先使用服务端会话。
Partitioned 属性可以替代 SameSite=None 吗?
不能。Partitioned 属于 CHIPS,把嵌入式第三方 Cookie 按顶层站点分区存储,避免跨站复用。它仍然要求 Secure,通常还要配合 SameSite=None;它收窄的是跟踪范围,不能替代 CSRF 与会话控制。
JsonMind 指南由工程团队撰写和复核。我们会对照相关 RFC 或厂商文档检查内容,列出主要来源,并在行为变化时更新指南。
每篇指南末尾都列出了主要来源。