CHIPS 用于嵌入组件状态,而非跨站身份
CHIPS 会为嵌入组件的每个顶级站点创建独立的 Cookie 存储。了解它适用于哪些场景,以及为什么它无法提供跨第三方站点共享的身份。
分区 Cookie 可以让嵌入式 widget 在某个站点保持登录状态,但无法让它在所有嵌入它的站点上共享同一身份。这一区别会影响开发者设计聊天、支付、文档和账户服务嵌入组件的方式。
CHIPS 为每个嵌入站点创建独立会话
CHIPS(Cookies Having Independent Partitioned State)允许跨站嵌入组件通过 Partitioned 属性选择分区存储。浏览器会同时根据设置 Cookie 的站点和顶级站点对 Cookie 进行分区。同一服务商被嵌入两个互不相关的站点时,会得到两个独立的 Cookie 存储,而不是一个服务商共享的存储。
例如,嵌入在 shop.example 中的 support.example 可以设置一个仅属于该嵌入上下文的会话 Cookie:
Set-Cookie: __Host-widget_session=opaque-value; Secure; Path=/; SameSite=None; Partitioned
这些保证取决于浏览器支持情况。不支持的 Partitioned 属性可能被忽略;如果浏览器允许第三方 Cookie,就可能留下未分区的第三方 Cookie。请测试每个目标浏览器,不要假定仅凭该属性就能实现隔离。
widget 在 shop.example 下加载时,浏览器会发送该 Cookie;同一个 widget 在 docs.example 下加载时则不会发送。用户直接访问 support.example 时,这个分区 Cookie 也不会变成通用 Cookie。每个顶级站点都是独立上下文,因此用户首次通过另一个嵌入站点访问时,widget 不会带有前一个站点的会话。
当嵌入组件需要仅属于某个发布站点的状态时,这种机制很有用:例如与该站点关联的客服对话、站点专属偏好,或单个商店的购物车。嵌入组件可以保存状态,而无需把它出现在互不相关站点上的事实当作共享标识。
根据所需状态选择 Cookie
如果功能在每个嵌入站点都有独立会话时仍能正常工作,就适合使用 CHIPS。服务器应预期新顶级站点可能没有 Cookie,并为该嵌入上下文创建新会话,而不是据此认定用户已在所有地方退出登录,也不应悄悄把这个会话与另一站点的状态合并。
不要把分区 Cookie 当作账户 Cookie,用于需要在互不相关的第三方站点上识别同一用户的服务。浏览器强制执行的是相反行为:同一个第三方 origin 在不同顶级上下文中会收到不同的分区状态。需要共享账户的 widget 必须通过单独且明确的流程获取身份。
这种分离是架构选择,不是应该通过重命名 Cookie 或轮换值来绕过的缺陷。如果嵌入组件的核心功能依赖同一身份在所有地方可用,仅靠 CHIPS 无法满足需求。如果只需要嵌入组件自身状态保持连续,分区存储比依赖跨站共享的第三方 Cookie 更合适。
Storage Access 是另一种契约
如果嵌入组件确实需要访问其未分区的第一方状态,例如展示用户已在服务商自己的网站登录的账户,**Storage Access API(SAA)**提供了另一种请求方式。嵌入文档可以检查 document.hasStorageAccess(),并在需要时调用 document.requestStorageAccess()。授权针对该嵌入上下文的访问,并不会把 CHIPS Cookie 变成共享 Cookie 存储。
应把此请求视为产品流程中的一个条件分支。浏览器可能要求用户激活、用户曾以顶级页面访问过该站点,或满足其他资格条件;请求也可能被拒绝。例如,WebKit 的实现指南要求通过用户操作触发请求,并要求此前发生过第一方交互。不同浏览器的策略并不相同,因此某个引擎中的成功结果不能证明所有用户的嵌入组件都能获得访问权限。
loginButton.addEventListener("click", async () => {
try {
await document.requestStorageAccess();
await loadAccount();
} catch {
showSignedOutExperience();
}
});
降级路径是功能的一部分,而不是异常错误页。无法获得访问权限时,仍应允许用户使用嵌入组件的公开功能或本地状态功能;需要账户数据时,再提供明确的登录操作。还要注意,获得嵌入文档自身存储的访问权限,不会自动让该身份附加到发往另一个 origin 的 API 请求中。
测试边界,而不只是成功路径
将同一个嵌入组件放在两个不同的顶级站点下测试,并确认两边都从独立状态开始。随后测试服务商作为顶级站点时的行为、SAA 请求被拒绝时的行为,以及嵌入组件发出的跨 origin API 请求。使用浏览器开发者工具检查分区键,并确认实际到达每个 endpoint 的 Cookie。
这些测试能暴露嵌入式应用常见的错误假设:第三方组件可以出现在多个位置,但这不代表它在每个位置都对应同一个已登录用户。对于属于单个嵌入站点的状态,使用 CHIPS;产品确实需要共享账户时,则使用明确且由用户参与的身份流程。
Comments
Loading comments…