课程大纲 第 67 课,共 156 课 · 内容安全策略与框架嵌入
内容安全策略与框架嵌入

Trusted Types

为什么重要 CSP 拦截的是被注入的脚本标签。但许多现代的漏洞藏在你自己的 JavaScript 里:像 box.innerHTML = comment 这样的一行,会把来自访客的文本变成活的 HTML。这就是第 10 模块讲的基于 DOM 的注入(第 59 课),它发生在页面加载之后。Trusted Types 会让浏览器拒绝那些危险的代码行,除非那个值经过了一项你写的检查。

想象一家工厂,只有盖了检验章的零件才能上装配线。没有人能把在停车场捡到的一个随便什么零件装上去,即使是无意的。Trusted Types 就是给你的代码送进危险地方的那些字符串加上这枚印章。

DOM:文档对象模型(Document Object Model)的缩写,浏览器根据页面构建的、JavaScript 可以读取和修改的那棵活的元素树。

汇点(sink):DOM 中一个字符串会变成代码或标记的地方。例如:element.innerHTML、outerHTML、insertAdjacentHTML、document.write、iframe.srcdoc、eval 以及 setTimeout 的字符串参数,还有 script.src。

Trusted Types:一项由 CSP 打开的浏览器功能,在它之下,那些汇点只接受由一个策略(一个由你编写并命名的小函数)生成的特殊对象(TrustedHTML、TrustedScript、TrustedScriptURL)。赋给汇点的普通字符串会抛出一个错误,而不是运行。

打开它

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script':在所有与脚本相关的汇点上强制执行它。
  • trusted-types comments:你的代码唯一可以创建的策略名称。一个被注入的脚本没法用另一个名字注册它自己的策略。trusted-types 'none' 禁止创建任何策略。

在你的代码里使用它

// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
  createHTML: (text) => escapeHtml(text),   // or a well-tested sanitiser
});

box.innerHTML = comment;                              // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment);   // allowed, escaped
box.textContent = comment;                            // not a sink at all: always fine

最大的好处在于审查者。你不必在一个庞大的代码库里搜寻每一个 innerHTML,只需审查那几个策略函数。如果它们是安全的,浏览器就会强制其他一切都经过它们。

名为 default 的策略很特殊:每当一个普通字符串到达一个汇点时,浏览器都会自动调用它。它在迁移旧代码时很有用,但它也是错误容易藏身的地方,所以要让它保持严格,并记录经过它的东西。

支持情况与上线

Trusted Types 在所有主流引擎中都得到了支持:基于 Chromium 的浏览器、Safari 26 和 Firefox 148(2026 年 10 月核实)。使用较老浏览器的访客只是得不到这项额外的检查,所以要保留转义,也要保留你基于 nonce 的 CSP。代码可以用 if (window.trustedTypes) 来检测它。

像任何策略一样上线它:先在一个 Content-Security-Policy-Report-Only 响应头里发送 require-trusted-types-for 'script'。每一个到达汇点的字符串都会被报告出来,准确地告诉你哪些代码行需要一个策略,或者更好的是,改用 textContent。

一个常见的误解:“Trusted Types 会替我清理 HTML”。它不会清理任何东西。它强制字符串经过你的策略。一个原样返回输入的策略(createHTML: s => s)能通过检查,却保护不了任何东西。

回顾

  • DOM 注入发生在你自己的 JavaScript 里,在像 innerHTML 这样的汇点上;仅靠脚本标签的规则抓不住它。
  • require-trusted-types-for 'script' 让汇点拒绝普通字符串;trusted-types NAME 限制可以存在哪些策略。
  • 审查那几个策略函数,而不是每一个汇点,并在可以的地方优先使用 textContent。
  • 在所有主流引擎中都得到了支持(2026 年 10 月核实);先在仅报告模式下上线。

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

这个练习即将开放

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