课程大纲 第 121 课,共 156 课 · 搭建防御
搭建防御

存储访问规则

为什么重要 分区能阻止跟踪器,但它也会让你在那些你确实想要的嵌入内容中退出登录:一个评论框、一个你付费的视频、一个登录按钮。如果引擎不提供任何回去的路,人们就会把保护关掉。Storage Access API 就是那条回去的路,而它的规则决定了它是在帮你,还是在帮一个跟踪器。在这个实验里,你来编写这些规则。

想想一张图书馆借书证。你在图书馆办了卡,所以这张卡在那里能用。现在你在一位朋友家里,他们家的规矩是外面的卡在屋里不能用。如果是你有意把卡交出来,这家图书馆是你真正加入过的,而且这个许可只针对这一户人家、只在一段时间内有效,那你仍然可以在那里用你的卡。

在练习世界里,talk.example 是一个评论服务。Sam 在 talk.example 本身上登录。它的小部件嵌在 news.example 上。开启分区后,新闻网站上的这个小部件会得到一个全新的、空的 Cookie 罐,所以它显示“登录后发表评论”,尽管 Sam 已经登录了。

嵌入框架(iframe):显示在另一个页面里的一个页面,就像墙上的一扇窗。评论小部件就是一个位于 news.example 内部、来自 talk.example 的框架。

用户手势:这个人刚刚做出的一次真实的点击、轻触或按键。浏览器把它叫作用户激活。一个自行运行的脚本无法伪造它。

授权:浏览器的一条记录,表示一个嵌入的网站可以在一个顶层网站内使用它自己的 Cookie,直到一个过期时间。

真实的 API 是什么样子

在框架内部,一个脚本可以调用 document.hasStorageAccess()(我有我的 Cookie 吗?),并在一次点击之后调用 document.requestStorageAccess()(请把它们给我)。浏览器检查它的规则,可能会向这个人显示一个提示,然后回答是或否。这个 API 已在 Safari、Firefox 和 Chrome 中提供(Chrome 从 119 版起)。在 Chrome 中,它只对那些屏蔽了第三方 Cookie 的人有意义,因为 Chrome 默认仍然发送它们,而曾经会自动授予访问权限的“相关网站集”功能已经退役(2026 年 10 月核实)。上一个模块中的“Storage Access API”一课讲了各个引擎有什么不同;在这里,你来搭建核心规则。

我们引擎的规则

真实的引擎在细节上各不相同(提示、时间限制、额外的检查)。我们的练习引擎使用四条简单的规则,按顺序检查,它们抓住了这些引擎共有的思路:

  1. 如果框架的网站就是顶层网站,回答是:它已经有自己的存储了。
  2. 如果没有用户手势,回答否。小部件不能在页面加载时悄悄地请求。
  3. 如果这个人从来没有直接打开过框架的网站(作为顶层页面),回答否。这能阻止一个你从未选择过的广告框架仅仅因为你点了它就获得访问权限。
  4. 否则回答是,并为恰好这一对 (frame_site, top_site) 记录一条授权,它从现在起 GRANT_SECONDS(30 天)后过期。

之后检查访问权限更简单:同一个网站就回答是;否则就在授权中查找这一对,只有当它在那里并且还没有过期时才回答是。

你会用到的 Python 片段

grants = {}                                     # an empty dict
grants[("talk.example", "news.example")] = 5000 # key is a tuple, value an expiry time
expiry = grants.get(("talk.example", "blog.example"))
print(expiry)                                   # None: .get gives None when the key is missing
print(expiry is not None and 4000 < 5000)       # False, because expiry is None

x is not None 问的是“到底有没有值?”。把它放在一个 and 的最前面很重要:如果它为 False,Python 就会停下来,永远不会拿 None 去和一个数字比较,那样会出错。

练习世界里的时间是一个秒数(world.now),所以“从现在起 30 天”就是 now + 30 * 24 * 3600,模块以 GRANT_SECONDS 的形式把它提供给你。

你的规则必须通过的故事

widget_story(request_fn, access_fn) 会在练习用的 AccessBrowser 上演六个步骤,并返回一个由 (step, result) 对组成的列表:

步骤小部件应该处于登录状态吗?
1. Sam 打开 news.example(之前在 talk.example 上登录过)否:已分区
2. 小部件在页面加载时请求,没有点击否:没有手势
3. Sam 点击“登录后发表评论”是:为这一对授权
4. Sam 打开带有同一个小部件的 recipes.example否:授权只针对 news.example
5. AdCo 的广告框架在广告被点击后请求否:Sam 从未打开过 adco.example
6. 31 天后,再次打开 news.example否:授权已过期

模块里还保存着 EXPECTED_STORY,也就是正确答案的列表,这样你可以边做边对照。

一个常见的误解

“一旦一个小部件获得了访问权限,它就能到处跟着我。”在这些规则下不会。授权只针对一对网站。同一个小部件在另一个网站上又会从一个空罐子开始,而且授权会过期。正是这条“成对”规则,让这个 API 不会变成一种新的跟踪方式。

用其他语言实现

小部件这一侧,用一个真实的评论小部件会运行的 JavaScript:

// Inside the talk.example frame, on news.example
signInButton.addEventListener("click", async () => {      // a real click: a user gesture
  if (!(await document.hasStorageAccess())) {
    try {
      await document.requestStorageAccess();                // the browser applies its rules
    } catch {
      showMessage("Open talk.example to sign in first");   // refused
      return;
    }
  }
  loadComments();   // requests now carry talk.example's own cookie
});

引擎这一侧,也就是访问检查,用 Rust:

use std::collections::HashMap;
fn has_storage_access(grants: &HashMap<(String, String), u64>,
                      frame_site: &str, top_site: &str, now: u64) -> bool {
    if frame_site == top_site { return true; }
    match grants.get(&(frame_site.to_string(), top_site.to_string())) {
        Some(expiry) => now < *expiry,
        None => false,
    }
}

回顾

  • 分区给嵌入框架一个空罐子;Storage Access API 让一个你想要的小部件请求拿回它自己的 Cookie。
  • 好的规则需要一次真实的点击、一个这个人真正用过的网站,以及一条针对一对网站、会过期的授权。
  • 正是这条成对规则,阻止了这个 API 变成一个跟踪工具。
  • 这个 API 已在 Safari、Firefox 和 Chrome(Chrome 119)中提供,2026 年 10 月核实。
轮到你了

编写 request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now),按顺序使用这四条规则:同一个网站返回 True;没有 user_gesture 返回 False;没有 visited_before 返回 False;否则设置 grants[(frame_site, top_site)] = now + GRANT_SECONDS 并返回 True。编写 has_storage_access(grants, frame_site, top_site, now):同一个网站返回 True,否则只有当这一对在 grants 中并且 now 早于它的过期时间时才返回 True。然后设置 story = widget_story(request_storage_access, has_storage_access)。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。