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

子资源完整性

为什么重要 当你嵌入 https://cdn.example/lib.js 时,你信任的是今天以及之后每一天控制那台服务器的人。如果它被黑了,或者文件被悄悄改了,你的访客就会在你的网站上运行新的代码。子资源完整性让浏览器拒绝任何你没有批准的版本。

想想药瓶上的防拆封条。你在吞下任何东西之前先检查封条。如果它破了,你就不吃,不管是谁把它放上货架的。

子资源完整性(SRI):<script> 或 <link rel="stylesheet"> 标签上的一个 integrity 属性,里面存着你所期望的那个确切文件的哈希值。浏览器会对下载到的东西计算哈希,如果哈希不同,就拒绝使用这个文件。

哈希:一种把任何数据变成一个固定长度的简短指纹的函数。同样的字节总是得到同样的指纹;改动一个字节,指纹就会完全不同。SHA-384 是 SRI 最常用的哈希算法。

标签长什么样

<script src="https://cdn.example/lib.js"
        integrity="sha384-iht3RcshTShmtRmXjSLQ8CjUTiVO41jHRJzgK44j1lSJHvfC4YAeuY4ZOoMtzhi5"
        crossorigin="anonymous"></script>

这个值是算法名、一个短横线,然后是用 Base64 写出的哈希值(一种用字母、数字、+ 和 / 书写字节的方式)。对于来自另一个网站的文件,需要 crossorigin="anonymous" 这一部分:浏览器会不带 Cookie 地获取它们,而服务器必须用一个 Access-Control-Allow-Origin 请求头允许这样做,否则检查无法进行,文件会被拦截。SRI 在所有主流浏览器中都有效(2026 年 10 月核实)。

用 Python 计算一个

import base64, hashlib
data = b"console.log('hi')"
digest = hashlib.sha384(data).digest()          # 48 raw bytes
print("sha384-" + base64.b64encode(digest).decode("ascii"))

hashlib.new(name, data) 可以对任何按名字指定的算法做同样的事,比如 "sha256" 或 "sha512"。注意 .digest()(原始字节,SRI 要的就是这个)和 .hexdigest()(十六进制文本,在这里会是错的)的区别。

浏览器如何检查它

  1. 按空格切分这个属性。你可以列出好几个哈希值,比如在切换文件版本期间。
  2. 只保留带有它认识的算法的令牌:sha256、sha384、sha512。忽略其余的。(令牌末尾可能有 ?options;把那部分去掉。)
  3. 如果没有剩下任何可用的令牌,它就完全不做检查,直接使用文件。因此像 sha385-... 这样的笔误会悄无声息地关掉保护。一定要测试一下错误的哈希值是否真的会拦截文件。
  4. 否则,取出现的最强算法(sha512 强于 sha384 强于 sha256),并且只看使用该算法的令牌。只要其中任何一个和文件的哈希匹配,文件就会被使用;如果一个都不匹配,它就会被拦截。

一个常见的误解:“SRI 能让文件保密”。它什么都不隐藏,第三方仍然能看到请求。SRI 只保证代码就是你批准过的代码。它也没法用于经常变化的文件,比如广告脚本;对于这些,诚实的答案往往是不要嵌入它们。

用其他语言实现
# Shell (OpenSSL)
openssl dgst -sha384 -binary lib.js | openssl base64 -A
// JavaScript (Node)
const crypto = require("crypto");
const sri = "sha384-" + crypto.createHash("sha384").update(fs.readFileSync("lib.js")).digest("base64");
// Go
sum := sha512.Sum384(data)
sri := "sha384-" + base64.StdEncoding.EncodeToString(sum[:])
// PHP
$sri = 'sha384-' . base64_encode(hash('sha384', $data, true));
// C#
var sri = "sha384-" + Convert.ToBase64String(SHA384.HashData(data));

打包工具可以替你加上 SRI(比如 webpack-subresource-integrity 插件)。

回顾

  • SRI 把一个嵌入的脚本或样式表固定到你批准过的确切字节上。
  • 这个值是 algorithm-Base64(hash),跨站文件还需要 crossorigin="anonymous"。
  • 浏览器只使用列出的最强算法,而一个没有任何可用内容的属性意味着不做检查。
轮到你了

编写三个函数:

  1. sri_hash(data, algorithm="sha384"):data 是字节。返回 SRI 值:算法名、一个短横线,以及原始摘要的 Base64(使用 hashlib.new(algorithm, data).digest() 和 base64.b64encode)。
  2. verify_sri(data, integrity):按照浏览器的方式检查 data。按空白切分 integrity;保留那些第一个 - 之前的部分是 sha256、sha384 或 sha512、并且值不为空的令牌,去掉从 ? 开始的所有内容。如果一个都没保留下来,返回 True(不做检查)。否则只使用出现的最强算法,如果它的任何一个值和数据在该算法下的哈希匹配,就返回 True,否则返回 False。
  3. script_tag(url, data):准确地返回 <script src="URL" integrity="VALUE" crossorigin="anonymous"></script>,其中使用 data 的 sha384 值。
最后打印练习用库的标签。测试使用随机数据。

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

这个练习即将开放

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