课程大纲 第 74 课,共 156 课 · 你自己网站上的第三方
你自己网站上的第三方

Permissions-Policy

为什么重要 浏览器能访问摄像头、麦克风、位置等等。你的商店一样都不需要。如果一个被注入的脚本或一个嵌入的框架在你的网站上请求摄像头,访客在提示框里看到的是你的名字。Permissions-Policy 让你能够声明“我的页面上谁都不许提出请求”。

想象贴在冰箱上的家规:“任何人都不许用车。花园只供家人使用。”客人也许都很好,但规则在任何人开口之前就做了决定。Permissions-Policy 就是一份针对强大浏览器功能的家规。

Permissions-Policy:一个响应头,告诉浏览器你的页面以及其中的框架可以使用哪些强大的功能。被关闭的功能无法使用,浏览器甚至不会显示权限提示。

语法

Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=(self "https://pay.example")
  • feature=():一个空列表。谁都不许使用它,连你自己的页面也不行。
  • feature=(self):只有你自己的源(你的协议加主机名,比如 https://shopd.example)。
  • feature=(self "https://pay.example"):你的源以及列出的那一个源(用引号括起来)。
  • feature=*:任何人,这很少是你想要的。

在一个典型的网站上,你可能想关闭的功能有:camera、microphone、geolocation、usb、bluetooth、midi、payment(如果你不使用浏览器的 Payment Request),display-capture,以及 accelerometer 和 gyroscope 这样的运动传感器。

框架也需要权限

来自另一个网站的框架,只有在你同时用 allow 属性在标签上授予它时,才能获得一项强大的功能:

<iframe src="https://maps.example/embed" allow="geolocation"></iframe>

两者必须一致:响应头必须允许那个源,框架标签必须请求它。只授予每个框架真正需要的东西。许多嵌入内容什么都不需要也能正常工作。

支持情况,实话实说

基于 Chromium 的浏览器会强制执行这个响应头。其他引擎的支持情况各不相同,并且在不断扩大,而 iframe 上的 allow 属性则得到了广泛的支持(2026 年 10 月核实)。所以既要发送这个响应头,也要精确地写好 allow。你可能会在较老的指南里看到旧名称 Feature-Policy,以及添加 interest-cohort=() 的建议。那是用来关闭一项广告实验的,而浏览器早已放弃了那项实验,所以它不再有任何实际作用。

一个常见的误解:“访客反正会看到权限提示,所以这毫无意义”。一个带着你网站名字的提示,正是狡猾的注入脚本想要的,因为人们信任你的网站。关闭这项功能,就意味着没有任何东西可以骗人去接受。

在 Django 里

Django 不会替你设置这个响应头。一小段中间件(在每个响应上运行的代码)就能做到:

def permissions_policy(get_response):
    def middleware(request):
        response = get_response(request)
        response["Permissions-Policy"] = "camera=(), microphone=(), geolocation=()"
        return response
    return middleware
用其他语言实现
// JavaScript (Express)
app.use((req, res, next) => {
  res.set("Permissions-Policy", "camera=(), microphone=(), geolocation=()");
  next();
});
# nginx
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
// Go (net/http)
w.Header().Set("Permissions-Policy", "camera=(), microphone=(), geolocation=()")

试一试 在一个网站上打开 DevTools,在 Network 标签页里选中主文档,查看它的响应头里有没有 Permissions-Policy。在基于 Chromium 的浏览器里,Application 面板还有一个“Frames”部分,列出每个框架可以使用哪些功能。

回顾

  • Permissions-Policy 在任何人能请求之前就把强大的功能关掉。
  • feature=() 表示谁都不行;(self) 表示只有你;列出的源要用引号括起来。
  • 来自其他网站的框架还需要一个 allow 属性,而且只给它们真正需要的。

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

这个练习即将开放

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