子资源完整性
为什么重要 当你嵌入 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()(十六进制文本,在这里会是错的)的区别。
浏览器如何检查它
- 按空格切分这个属性。你可以列出好几个哈希值,比如在切换文件版本期间。
- 只保留带有它认识的算法的令牌:
sha256、sha384、sha512。忽略其余的。(令牌末尾可能有?options;把那部分去掉。) - 如果没有剩下任何可用的令牌,它就完全不做检查,直接使用文件。因此像
sha385-...这样的笔误会悄无声息地关掉保护。一定要测试一下错误的哈希值是否真的会拦截文件。 - 否则,取出现的最强算法(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"。 - 浏览器只使用列出的最强算法,而一个没有任何可用内容的属性意味着不做检查。
编写三个函数:
sri_hash(data, algorithm="sha384"):data是字节。返回 SRI 值:算法名、一个短横线,以及原始摘要的 Base64(使用hashlib.new(algorithm, data).digest()和base64.b64encode)。verify_sri(data, integrity):按照浏览器的方式检查data。按空白切分integrity;保留那些第一个-之前的部分是sha256、sha384或sha512、并且值不为空的令牌,去掉从?开始的所有内容。如果一个都没保留下来,返回True(不做检查)。否则只使用出现的最强算法,如果它的任何一个值和数据在该算法下的哈希匹配,就返回True,否则返回False。script_tag(url, data):准确地返回<script src="URL" integrity="VALUE" crossorigin="anonymous"></script>,其中使用data的 sha384 值。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。