# Cookie 安全属性：Secure、HttpOnly、SameSite 与作用域

> 正确配置 Secure、HttpOnly、SameSite、Domain、Path、Max-Age 与 Cookie 前缀，防御投掷与 CSRF，并在浏览器中验证真实行为。

**快速答案:** 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
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 位熵。[随机令牌生成器](/tools/random-token-generator)可以生成这个范围的值；不要用计数器、时间戳或会泄露结构的 UUID。服务端只保存标识符的哈希，这样数据库泄露不会直接交出可用会话。

登录时轮换标识以防会话固定，权限变化后再轮换一次，长期会话还要定期轮换。轮换意味着签发新值、迁移服务端记录并让旧值失效；只改浏览器里的 Cookie 却不撤销旧记录，被偷走的副本仍然有效。要执行空闲超时和绝对超时，登出时立即失效，并在改密码或怀疑泄露时撤销该用户的全部会话。

长期会话不做轮换是最安静的事故：Cookie 一旦被截获，几个月内都有效，服务端没有任何事件会终止它。API 场景应使用带重放检测的刷新令牌轮换；同一个刷新令牌第二次出现就让整个令牌族失效。设备信号只能作为风险输入，不能作为唯一校验，因为共享网络和移动浏览器会产生大量误报。

## 验证清单与明确的通过标准

先验证响应头，再验证浏览器。用生产环境的真实登录响应开始；本地服务器放宽属性不能证明任何事。

```bash
# 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 响应头解析器](/tools/http-headers)可以解析第一个响应并标出缺失的属性。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 请求工作台](/tools/http-request)可以按原样重放抓到的请求，适合代理或框架改写请求头的场景。把结果写进发布检查单：属性回归在单元测试里看不见，在 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 与会话控制。

## 参考资料

- [RFC 6265bis：Cookie 的 HTTP 状态管理机制](https://datatracker.ietf.org/doc/draft-ietf-httpbis-rfc6265bis/)
- [MDN：Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie)
- [OWASP：会话管理备忘单](https://cheatsheetseries.owasp.org/cheatsheets/Session_Management_Cheat_Sheet.html)
- [OWASP：CSRF 防护备忘单](https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html)

---

- Canonical: https://www.jsonmind.com/zh-CN/guides/cookie-security-attributes
- Locale: zh-CN
- Published: 2026-11-17
- Updated: 2026-11-17
- Tools: http-headers, http-request, random-token-generator