检测 Chrome 中的第三方 Cookie 可用性

Chrome 提议推出一种新的体验,让用户在浏览网页时选择如何处理第三方 Cookie。网站和服务可能需要检测在给定上下文中是否可以使用第三方 Cookie。Chrome 有两种主要方法来检测嵌入式内容对第三方 Cookie 的访问:使用 hasStorageAccess JavaScript 方法和观察 Sec-Fetch-Storage-Access 标头。

Privacy Sandbox 引入了一些 API,这些 API 可能会在满足特定条件的情况下向特定框架授予对第三方 Cookie 的访问权限。因此,能够按嵌入检测对未分区 Cookie 的访问非常重要。

检测 iframe 中对第三方 Cookie 的访问

如果 iframe 的内容托管在与用户地址栏中显示的网站不同的网站上,则会被视为跨网站,并且可能会受到第三方 Cookie 限制。iframe 可以通过调用 await document.hasStorageAccess() 来检测其当前是否可以访问第三方 Cookie。此方法会返回 true 或 false,具体取决于框架是否有权访问未分区 Cookie。

如果您的 iframe 使用 Storage Access API (SAA) 来获取对未分区跨网站 Cookie 的访问权限(单独使用 SAA 或与 Related Website Sets 搭配使用),您可以检查 storage-access 权限,以确定该框架是否可以选择启用访问未分区的 Cookie。

检测 HTTP 请求中的第三方 Cookie 访问

从 Chrome 133 开始,标头 Sec-Fetch-Storage-Access 会随凭证请求一起发送,以便让服务器知道其调用上下文是否有权访问未分区 Cookie。此标头包含以下三个值之一:

  • none:嵌入内容无权访问未分区 Cookie
  • inactive:嵌入应用有权访问未分区 Cookie,但尚未激活该权限
  • active:嵌入内容可以访问未分区 Cookie

向嵌入内容授予未分区 Cookie 访问权限的条件

您可以通过多种方式授予对未分区第三方 Cookie 的访问权限,以支持这些 Cookie 提供必要功能的情况。以下方法会授予对未分区 Cookie 的访问权限。在很多情况下,必须先调用 requestStorageAccess() 或 requestStorageAccessFor(),然后才能授予访问权限。

方法 示例 必须调用 requestStorageAccess?
Storage Access API 提示 系统提示用户允许存储空间访问权限,用户选择“允许”。 是
Federated Credential Management 用户使用联合身份提供方 (IdP) 登录;IdP 的框架请求存储空间访问权限。 是
Related Website Set 嵌入内容和嵌入方属于同一 RWS。 是
在用户设置中启用了第三方 Cookie 用户选择允许在所有浏览活动中使用 3PC,或仅允许在特定来源中使用 3PC。 否
企业政策 公司的 Chrome 企业版管理员已选择允许部分或全部流量使用第三方 Cookie。 否