跳转到内容

存储中的概念

分区 Cookie(CHIPS)

发布于 更新于

Cookies Having Independent Partitioned State(CHIPS)为嵌入的第三方按顶级站点分别保存 Cookie。服务端在 Set-Cookie 中加上 Partitioned 属性,就能让这个 Cookie 使用分区存储。聊天挂件或地图仍能在各站点上正常工作,但 Cookie 无法再充当跨站标识符:在 retail.example 下写入的 Cookie,在 news.example 下读不到。

分区 Cookie 使用两个键:设置它的主机和分区键。分区键取自顶级页面的站点(scheme 加可注册域名),以设置 Cookie 的请求开始时浏览器显示的页面为准。support.chat.example 在嵌入于 https://retail.example 时设置的 Cookie 以 {("support.chat.example"), ("https", "retail.example")} 为键;同一个嵌入内容在另一个站点上得到的是空罐子,并在那里设置自己的 Cookie(Cookies Having Independent Partitioned State,privacysandbox.google.com)。

浏览器只接受带 Secure 的分区属性,因此只能在 HTTPS 下使用;推荐加 __Host- 前缀,让 Cookie 绑定到单个主机名而不是可注册域名。SameSite=None 允许在第三方上下文中发送 Cookie,没有它,无论是否分区,嵌入请求都不会带上该 Cookie。

Set-Cookie: __Host-session=5f2b; Secure; Path=/; SameSite=None; Partitioned;

省略 Partitioned 的 Cookie 是未分区的,适用浏览器对第三方 Cookie 的既有策略:Firefox 严格模式和 Safari 默认拦截,Chrome 取决于用户设置。

Chrome 每个分区最多存 180 条 Cookie,且每个嵌入站点的分区上限为 10 KB;在一个繁忙的顶级站点上设置许多小 Cookie 的挂件会先撞到条数上限。每个顶级站点是一个独立分区,一千个站点嵌入同一个挂件,就有一千份独立的 Cookie 存储,各自受限。

Firefox 在增强型跟踪保护的严格模式和隐私窗口里按顶级站点分区所有第三方 Cookie 和存储 API,不需要任何属性,并且对网络状态(HTTP 缓存、DNS、连接池)做永久分区(State Partitioning,developer.mozilla.org)。CHIPS 需要显式启用,在各引擎中行为一致。因此,即使浏览器默认分区,也可以使用这个属性来兼容其他引擎。

该属性在 Chrome 100 至 116 的 origin trial 之后于 Chrome 114 发布,Firefox 141 与 Safari 26.2 跟进(BCD http.headers.Set-Cookie.Partitioned)。不认识 Partitioned 的引擎会忽略该属性并把 Cookie 按未分区存储,这正是 Secure 和 SameSite=None 要求的意义所在:它们让回退后的 Cookie 仍然可用。

在嵌入服务的服务器上设置 Cookie。浏览器允许时,脚本可以检查它的分区状态。

链接到“从被嵌入的服务设置分区会话 Cookie”一节

嵌入服务的服务器收到 iframe 首次请求后,在响应中设置 Cookie。嵌入页面无需任何改动。

// support.chat.example 上的 Express 处理函数
app.get('/widget/session', (req, res) => {
res.setHeader(
'Set-Cookie',
'__Host-chat=9b1f; Secure; Path=/; SameSite=None; Partitioned; Max-Age=86400'
);
res.json({ ok: true });
});

同一个 iframe 在同一个顶级站点上的下一次请求会带上该 Cookie;在另一个顶级站点上服务端看不到 Cookie 并开启新会话。

链接到“通过 Cookie Store API 读取分区状态”一节

document.cookie 只返回 name=value 对,脚本无法借它区分分区与未分区的 Cookie。Cookie Store API(Chrome 87、Firefox 140、Safari 18.4)在每条 Cookie 上暴露 partitioned 布尔值。

async function partitionedCookies() {
if (!('cookieStore' in window)) {
return null; // 没有 Cookie Store API:脚本观察不到分区状态
}
const cookies = await window.cookieStore.getAll();
return cookies.filter((cookie) => cookie.partitioned);
}

返回 null 时,改用服务端记录来判断。服务端可以记录 __Host- Cookie 是否到达,以及对应的 Sec-Fetch-Site 值。

规范

规范状态
无。