SRI（サブリソース完全性）

ハッシュは、ファイルの内容から計算する要約値です。ページは、確認した内容のハッシュをintegrity属性に指定しています。両モードでSRIを使い、別オリジンの取得に必要なCORSの条件も満たしています。

integrity属性は、アルゴリズム名とBase64形式のハッシュを組み合わせます。この例はSHA-384です。SHA-256・SHA-384・SHA-512が使われます。この図のハッシュは、表示用の本文から実際に計算した値です。[S01 §3.1–3.2]

<p id="notice">お知らせ</p>
<script
  src="https://cdn.example/hello.js"
  integrity="sha384-fkahY7fXJ9Jd29SgWuIYXvpGpfUr2SldwEB1uIWSvEgKevRuEsgvzSTPWvMIvAUR"
  crossorigin="anonymous"></script>

CSSのスタイルシートを読む<link rel="stylesheet">にもintegrityを指定でき、不一致ならそのCSSを適用しません。CSSには、そのCSS本文から計算した期待ハッシュを使います。JavaScriptのハッシュを流用しません。[S01 §3.8.1]

ハッシュはファイル内容のバイト列を対象にするので、空白・改行等の違いも照合に影響します。URLやファイル名だけから作る値ではありません。SHA-384の計算内部・複数ハッシュの優先順位・moduleの依存グラフは、この教材では扱いません。

別オリジンからSRI付きの外部scriptを取得するには、CORSの条件も満たす必要があります。この例ではHTMLのcrossorigin="anonymous"でCORSを使い、CDNがHTTP応答にAccess-Control-Allow-Origin: *を付けます。[S01 §3.3.2・S02・S03]

図の取得条件は両モード共通で、HTTP 200、Content-Type: text/javascript、Access-Control-Allow-Origin: *です。CORSが成功したうえで、SRIの一致・不一致を比較しています。

anonymousは、この別オリジンへの要求でCookie等の認証情報を送らない設定です。通信を匿名化する機能ではありません。crossorigin属性だけでは、配信先のCORS許可を代わりに設定できません。

別オリジンの普通のscriptは、SRIなし・crossoriginなしで読み込める場合があります。それはSRI付きの取得条件とは別で、CORS教材のfetchによる応答読み取りとも対象が異なります。SOPが別オリジンの通信・資源の利用をすべて禁止する、という意味ではありません。[S03・S06]

同一オリジンの外部ファイルにもSRIを使えます。SRIは外部APIやCDN専用の仕組みではありません。[S01 §3.3.2]

HTTPSを使っていても、配信サーバー上のファイルが変われば、その変更された内容が届くことがあります。SRIでは、期待値が変わっていない条件で、その内容の違いを検知できます。HTTPSは通信の保護、SRIは期待する内容との照合を担い、組み合わせて使います。[S01 §1・§5.1]

既存のCSP教材では、nonceという許可条件に基づくscriptの実行制限を学びました。今回のSRIは、外部ファイルの本文から計算した値をintegrityと照合します。CSPにはハッシュを使う機能等もあるため、「CSPは内容を確認しない仕組み」と一般化せず、学んだ場面を区別します。

SRIの照合を通っても、別のCSPや読み込み条件が実行を止める場合があります。主図は、それらの追加条件で止まらない例です。[S02 §4.1・S03]

• CORSの仕組み
• Content Security Policy（CSP）

同じURLでも、取得した本文が変わると、この例では期待ハッシュと一致しなくなります。この例では、照合を通過したJavaScriptは実行され、ページに「ようこそ」と表示されます。不一致のファイルは実行されず、ページに「お知らせ」と表示されます。SRIは期待した内容との一致を確認する仕組みなので、確認する内容の選定と、更新時の確認も必要です。

SRIはコードの悪意・脆弱性や作者の本人性を判定しません。信頼して採用する内容を選び、その内容から期待ハッシュを用意する必要があります。ハッシュを指定しただけで、脆弱なライブラリが安全になるわけではありません。[S04]

正規更新でも本文が変われば、期待値と不一致になる場合があります。利用する版と内容を確認し、srcとintegrityを整合させて更新します。不一致を直すために、届いたファイルを無条件に期待値へ取り込み続ける運用にはしません。[S04・S05]

HTMLを配信する側まで侵害され、integrityを書き換えられたり削除されたりすると、この基準を守れません。SRIはサイト本体の保護や依存関係の管理を代替しない仕組みです。[S01 §5.1・S05]