Subresource Integrity

どのようなものか

Subresource
Integrityは、スクリプトやスタイルシートに含まれるべきバイト列をペー
ジが事前に指定し、届いた内容が異なればブラウザーにファイルを破棄させ
る仕組みです。通常はSRIと略します。ページは、ファイルの暗号学的ダイ
ジェストを`integrity`属性に書きます。この属性を付けるのは、ファイル
を読み込む`script`要素や`link`要素です。応答が届くと、ブラウザーは受
け取ったバイト列に同じハッシュ関数を適用し、その結果を要素上のダイ
ジェストと比較します。一致すれば、ファイルは通常どおり実行されるか、
ページの装飾に使われます。異なれば、ブラウザーは応答をネットワークエ
ラーとして扱い、スクリプトを実行せず、スタイルシートも適用しません。

値は、ハッシュ関数名、ハイフン、base64形式のダイジェストをつないだも
のです。完成したファイルに一つのコマンドを実行すれば作れます。二度実
行してみると、わずかな変更で結果が変わることが分かります。

```text
$ printf "alert('Hello, world.');" > hello.js
$ openssl dgst -sha384 -binary hello.js | openssl base64 -A
H8BRh8j48O9oYatfu5AZzq6A9RINhZO5H16dQZngK7T62em8MUt1FLm52t+eX6xO
$ echo >> hello.js
$ openssl dgst -sha384 -binary hello.js | openssl base64 -A
qu8P7hCLFcBpas8BOnGmaANCkfXJIpFttDEaxOj0Pq9H6Q8NYjsMb+PVqwuJygVe
```

最初の出力の前に`sha384-`を付けると、その一行のスクリプトに対する属
性値になります。末尾に改行を一つ加えただけで、最初とはまったく違うダ
イジェストになり、最初の値を持つブラウザーは、二つ目のファイルを拒否
します。

仕様が認めるハッシュ関数は、いずれもSHA-2系のSHA-256、SHA-384、
SHA-512の三つです。執筆時点では、SHA-384を基準として適切な選択肢とし
ています。一つの属性に、空白で区切った複数のダイジェストを並べること
もできます。ブラウザーは、その中で最も強い関数を選び、その関数で作ら
れたいずれかのダイジェストに一致すれば、ファイルを受け入れます。その
ため、ページ上に誤ったダイジェストしかない期間を作らずに、より強いア
ルゴリズムへ移行したり、切り替え中にライブラリーの二つのリリースを受
け入れたりできます。

属性は`script`と`link`で使え、ファイルを先読みする`Link`応答ヘッダー
にも同じ値を載せられます。仕様の現行文書は第2版で、Web
Application Security Working
GroupによるW3C作業草案です。第1版は2016年にW3C勧告になりました。

なぜ重要なのか

コンテンツ配信ネットワーク、またはサイトの運営者が管理していないホス
トからライブラリーを読み込むページは、そのホストにページ上でコードを
実行する権限を渡します。HTTPSは、ネットワーク上の転送中のファイルを
保護しますが、ホストがそもそも何を送ることにしたかについては保証しま
せん。CDNの保存領域が侵害されたり、公開用のアカウントが乗っ取られた
り、見慣れたアドレスのファイルがひそかに差し替えられたりすると、その
ファイルを読み込むすべてのページが、ページの全権限で新しいコードを実
行します。ページ自身のコードには、その違いを見分ける手段がありませ
ん。

SRIは、その判断をページ側へ戻します。サイトの運営者が、自分で読ん
だ、またはビルドしたファイルからダイジェストを計算し、それをサイト自
身のサーバーから送るページ内に含めます。ホストが別の内容を返しても、
そのファイルは実行されずに拒否されます。誰かが確認するまでページの機
能は失われますが、原因が明らかな不具合として表面化し、他人のコードを
ひそかに実行することを避けられます。

ダイジェストは、バージョンも固定します。`/lib/latest.js`のようなアド
レスは、ページ側が知らない間に、いつでも新しいリリースを返すようにな
りますが、ダイジェストはそれに追従しません。運営者が選んでいない更新
は、特定の要素の読み込み拒否になり、エラーイベントで報告されます。

SRIが行わないことも、正確に押さえる必要があります。ファイルをダイ
ジェストと照合するだけで、安全なファイルかどうかを判断するわけではあ
りません。すでに悪意ある一行を含むライブラリーのダイジェストは、その
一行も忠実に保護します。インラインスクリプトは対象外で、それは
Content
Security Policyの役割です。また、ダイジェストを載せたページを信頼す
るため、ページ自体も改ざんされずに届く必要があります。

実際の活用例

このサイトは、自身のスタイルシートにSRIを使っています。セキュリ
ティーページにも、スタイルシートへのSubresource
Integrityの適用を記載しています。サイトのビルド時にバンドルのフィン
ガープリントとハッシュを生成するため、読者のブラウザーは、内容が変わ
らず届いたことを検証できます。実行可能なJavaScriptは公開せず、第三者
へのリクエストもありません。ブラウザーのネットワークパネルでホストを
数えると、サイト自身の一つだけです。

クレジットページは、同じファイルをビルド側の視点で説明しています。ビ
ルド時に連結してフィンガープリントを付けた一つのCSSバンドルを、SRIの
ハッシュとともに配信します。フィンガープリントは、ファイル内容のハッ
シュを名前に含めるものです。変更したスタイルシートには新しいアドレス
が付き、ブラウザーが古いキャッシュを現行版と取り違えることを防ぎま
す。一方、integrityの値によって、そのアドレスの先にあるバイト列をブ
ラウザーが検証できます。ビルドの同じ段階で同じバイト列から両方を生成
するため、どのリリースでもスタイルシートとダイジェストが一緒に配信さ
れます。その結果、次の節で説明する最も一般的な失敗、つまりハッシュ計
算後のファイル変更が入り込む余地は、非常に小さくなります。

問題が起きるところ

ビルドとブラウザーの間でファイルが書き換わる。
スクリプトを縮小するCDN、応答の内容に何かを挿入するプロキシ、ダイ
ジェストの計算後にファイルを書き換えるデプロイ処理は、内容のバイト列
を変えます。攻撃がなくても、ブラウザーは結果を拒否します。内容を変え
ないgzipやBrotliでの再圧縮では、この不一致は起こりません。検証の対象
は、ネットワーク上で送られた圧縮済みのバイト列ではなく、デコードされ
た応答本文だからです。仕様は、内容を変える中継者に義務を課していま
す。配信する内容に合わせてダイジェストも更新するか、元の内容を変えず
に配信しなければなりません。一方、配信元には、ファイルを変更しないよ
う求める`Cache-Control:
no-transform`を送ることが推奨されています。確実な手順は、ブラウザー
が検証するデコード後の内容とまったく同じバイト列から、最後にダイジェ
ストを計算することです。

別オリジンのファイルが、CORSなしで届く。
仕様は、別のオリジンのファイルの完全性を検証するにはCORSを使うことを
要求し、使わずに試みるのは論理上の誤りだとしています。例えば、要素に
`crossorigin="anonymous"`を指定し、ホストはファイルの共有を許すヘッ
ダーで応答する必要があります。`crossorigin="use-credentials"`もCORS
を使いますが、サーバーのヘッダーで、要求元のオリジンと認証情報の利用
を明示的に許可します。CORSリクエストと、それに対応するサーバー側のポ
リシーがなければ、ブラウザーは検証せずに読み込むのではなく、ファイル
をブロックします。この規則は、ほかのサイトを守ります。規則がなけれ
ば、攻撃者は推測したダイジェストで非公開の応答を読み込もうとし、その
成否から、例えば読者がそのサイトにログインしているかどうかを知ること
ができるためです。

ダイジェストが平文のHTTPで届く。
SRIは、ファイル配信ホストの侵害からページを守りますが、ネットワーク
経路上の攻撃者からは守りません。HTTPSを使わずに配信するページでは、
転送中のファイルを書き換えられる者は、ページ内のダイジェストも書き換
えたり削除したりできます。そのため、仕様は、完全性メタデータをセキュ
アコンテキストだけに配信するよう推奨しています。

ブラウザーが無視するハッシュ関数を使う。
仕様が認めるのはSHA-256、SHA-384、SHA-512だけであり、MD5やSHA-1のよ
うに弱いと分かっている関数は、ブラウザーが拒否するよう推奨していま
す。意外なのは、一覧にないトークンの扱いです。ブラウザーはそれを無視
し、無視されるトークンだけの属性は、メタデータがまったくないものとし
て扱われるため、ファイルは検証されずに読み込まれます。Hugoのように、
MD5でフィンガープリントを作れるビルドツールでは、誤ってその状態を配
信しやすくなります。

拒否されたファイルとともに、ページも動かなくなる。
検証が失敗すると、ブラウザーは要素上でエラーイベントを発生させ、スク
リプトやスタイルシートは単に欠けた状態になります。ページの動作に欠か
せないライブラリーなら、仕様は、イベントを捕捉し、遅くても信頼できる
配信元、例えばサイト自身のサーバーから代替コピーを読み込むことを提案
しています。代替がなければ、防御は設計どおりに働いていても、読者には
壊れたページが届きます。

ダイジェストのある要素だけが検証される。
一つのスクリプトにintegrity属性があっても、後から誰かが属性なしで追
加した次のスクリプトについては何も保証しません。integrity属性のある
スクリプトだけをレビューしても、属性を欠くスクリプトは見つかりませ
ん。草案は、これをサーバー側で扱う応答ヘッダーを加えています。
`Integrity-Policy`に`blocked-destinations=(script)`を指定すると、完
全性メタデータなしで届く外部スクリプトをすべてブロックします。
`Integrity-Policy-Report-Only`は、先にその一覧を報告し、ブロックする
前に修正できるようにします。

参考資料

  * Subresource Integrity —
検証アルゴリズム、`Integrity-Policy`ヘッダー、プロキシ、平文HTTP、ク
ロスオリジンの情報漏えいに関する注記を含む、現行の草案です。

  * Subresource Integrity、W3C勧告2016年版 — 草案の基礎となった、確
定した勧告である第1版です。

  * Fetch Standard —
リクエストの完全性メタデータと応答本文を照合する処理、および別オリジ
ンの検証で必要なCORSプロトコルを定めています。

  * Hugo：resources.Fingerprint —
静的サイトジェネレーターがビルド時にファイルのフィンガープリントを作
り、対応するintegrity値を返す仕組みです。

  * FIPS 180-4、Secure Hash Standard —
SHA-256、SHA-384、SHA-512を定義する連邦標準です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/sri/	engineer.company	70
