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

Nonce、哈希与仅报告模式

为什么重要 几乎每个真实的网站都有几个它自己的内联脚本。如果让它们继续工作的唯一办法是 'unsafe-inline',CSP 就完全不再能防范注入了。Nonce 和哈希能放行你的脚本,同时把注入的脚本挡在外面。仅报告模式能让你在第一天就打开一份策略,而不会给访客弄坏任何东西。

想象一场音乐会,每天晚上的手环颜色都不一样,只在开门前一小时才告诉工作人员。上周伪造的手环毫无用处。Nonce 就是你的内联脚本今晚的手环。

Nonce

Nonce:“number used once”(只用一次的数字)的缩写。服务器为每个响应生成的一个新的随机值,在响应头里写成 'nonce-VALUE',同时也以 nonce="VALUE" 的形式写进它自己的每一个内联脚本标签里。

Content-Security-Policy: script-src 'self' 'nonce-4fT9qLx2Zb8wRk1e'

<script nonce="4fT9qLx2Zb8wRk1e">startShop();</script>      runs
<script>sendCookies();</script>                          blocked: no nonce

一个注入了脚本标签的攻击者不知道这个响应的值,所以他们的脚本会被拒绝。有三条规则让这一点成立:

  • 不可预测:至少 128 位,来自一个安全的随机源,比如 Python 的 secrets.token_urlsafe(16)。
  • 每个响应都是新的:永远不要是配置文件里的一个固定值,还要小心那些会把同一个 nonce 提供给所有人的页面缓存。
  • 只放在你自己的标签上:一个给任何脚本标签(包括由用户输入构建的那些)都加上 nonce 的模板,就是把手环交给了攻击者。

这个网站用 django-csp 来做这件事:模板里的每一个内联脚本都写成 <script nonce="{{ request.csp_nonce }}">,而这个包会把匹配的值放进响应头里。

哈希

哈希来源:'sha256-BASE64',一个脚本标签里面确切文本的 SHA-256 指纹。如果文本匹配,它就会运行。这对那些没法为每个响应加上 nonce 的静态页面很有用。

import base64, hashlib
code = "startShop();"          # exactly what is between the tags
print("'sha256-" + base64.b64encode(hashlib.sha256(code.encode()).digest()).decode() + "'")

每一个字节都算数:多一个空格或换行,就会得到一个不同的哈希。哈希和 nonce 只覆盖内联的 <script> 块,不覆盖 onclick= 属性(一个很少用到的关键字 'unsafe-hashes' 可以放行一个经过哈希的处理程序,但把它移走会更干净)。用 addEventListener 把处理程序移到你的脚本里。

为什么有时会保留 'unsafe-inline'

当列出了 nonce 或哈希时,理解它们的浏览器会忽略 'unsafe-inline'。非常老旧的浏览器不理解 nonce,所以它们会回退到 'unsafe-inline',网站在那里仍然能工作。这就是为什么 floati.life 的策略两者都列出了。但如果没有 nonce 或哈希,'unsafe-inline' 会让每一个注入的脚本都运行。

再进一步是 'strict-dynamic':一个你用 nonce 信任过的脚本可以加载更多的脚本,而支持它的浏览器随后会忽略主机列表。它适合那些动态加载代码的大型应用。(练习检查器没有模拟它。)

安全地上线:仅报告模式

Content-Security-Policy-Report-Only:第二个响应头,语法相同。浏览器什么都不拦截,但会报告它本会拦截什么,报告在控制台里,如果你要求的话,还会发到你服务器上的一个地址。

Reporting-Endpoints: csp="https://shopd.example/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' 'nonce-...'; report-to csp

report-to 指定来自 Reporting-Endpoints 响应头的一个端点。较老的指南使用 report-uri https://...;许多网站两者都发送,而理解 report-to 的浏览器会忽略 report-uri。一个合理的上线方式:把新策略作为仅报告模式发送一两周,修复它报告的问题,然后把它切换到强制执行的响应头。你可以同时发送一份强制执行的策略和一份更严格的仅报告策略。

隐私说明:一份报告包含页面地址和被拦截的地址。页面地址的查询字符串里可能带有个人数据,所以要把报告发到你自己的服务器上,只保留很短的时间,并且永远不要发给外部的分析服务。

一个常见的误解:“在我测试期间,仅报告模式能保护访客”。它保护不了任何人。它是一个测量工具。不要让一份策略在仅报告模式下停留好几个月。

用其他语言实现
// JavaScript (Node)
const nonce = require("crypto").randomBytes(16).toString("base64");
// Go
b := make([]byte, 16); rand.Read(b)   // crypto/rand
nonce := base64.StdEncoding.EncodeToString(b)
// PHP
$nonce = base64_encode(random_bytes(16));

回顾

  • Nonce 是每个响应一个新的、猜不到的值,用来标记你自己的内联脚本。
  • 哈希只放行一个确切的内联脚本;它的文本有任何改动都需要一个新的哈希。
  • 当列出了 nonce 或哈希时,'unsafe-inline' 会被忽略;没有它们时,它很危险。
  • 先用 Content-Security-Policy-Report-Only 上线,然后再强制执行;把报告留在你自己的服务器上。

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

这个练习即将开放

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