Trusted Types
なぜ大切か CSP がブロックするのは注入された スクリプトのタグ です。でも現代のバグの多くは、あなた自身の JavaScript の中にあります。box.innerHTML = comment のような 1 行は、訪問者からのテキストを生きた HTML に変えてしまいます。それがモジュール 10(レッスン 59)の DOM ベースの注入で、ページが読み込まれた後に起こります。Trusted Types は、値があなたの書いた確認を通っていない限り、そうした危険な行をブラウザに拒ませます。
検査の印のある部品だけが組み立てラインに載れる工場を想像してください。駐車場で見つけた適当な部品を、うっかりでさえ取り付けることはできません。Trusted Types は、あなたのコードが危険な場所へ流し込む文字列に、その印を加えます。
DOM:Document Object Model の略で、ブラウザがページから作る生きた要素の木です。JavaScript はそれを読んだり変えたりできます。
シンク:文字列がコードやマークアップになる DOM の中の場所です。例:element.innerHTML、outerHTML、insertAdjacentHTML、document.write、iframe.srcdoc、eval と setTimeout への文字列の引数、そして script.src。
Trusted Types:CSP でオンにするブラウザの機能で、そのもとでは、それらのシンクは ポリシー(あなたが書いて名前を付ける小さな関数)が作った特別なオブジェクト(TrustedHTML、TrustedScript、TrustedScriptURL)だけを受け付けます。シンクに代入されたただの文字列は、動く代わりにエラーを投げます。
オンにする
Content-Security-Policy: require-trusted-types-for 'script'; trusted-types commentsrequire-trusted-types-for 'script':スクリプトに関わるすべてのシンクにそれを守らせます。trusted-types comments:あなたのコードが作ってよい唯一のポリシーの名前です。注入されたスクリプトは、別の名前で自分のポリシーを登録できません。trusted-types 'none'はひとつも作ることを禁じます。
コードで使う
// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
createHTML: (text) => escapeHtml(text), // or a well-tested sanitiser
});
box.innerHTML = comment; // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment); // allowed, escaped
box.textContent = comment; // not a sink at all: always fine大きな利点はレビューする人にあります。大きなコードベースのすべての innerHTML を探し回る代わりに、少しのポリシーの関数をレビューします。それが安全なら、ほかのすべてがそれを通ることはブラウザが守らせます。
default という名前のポリシーは特別です。ただの文字列がシンクに届くたびに、ブラウザが自動でそれを呼びます。古いコードを移行する間は役に立ちますが、間違いが隠れる場所でもあるので、厳しく保ち、通るものを記録してください。
対応状況と導入
Trusted Types は主要なすべてのエンジンで対応しています。Chromium 系のブラウザ、Safari 26、Firefox 148 です(2026 年 10 月確認)。古いブラウザの訪問者は単に追加の確認を受けないだけなので、エスケープとノンスに基づく CSP は保ってください。コードは if (window.trustedTypes) でそれを確かめられます。
ほかのポリシーと同じように導入します。まず Content-Security-Policy-Report-Only ヘッダーで require-trusted-types-for 'script' を送ります。シンクに届くすべての文字列が報告され、どの行にポリシーが必要か、あるいは、もっと良いのは textContent への切り替えが必要かを、正確に示してくれます。
よくある誤解:「Trusted Types が HTML を消毒してくれる」。何も掃除しません。文字列に あなたの ポリシーを通らせるだけです。入力をそのまま返すポリシー(createHTML: s => s)は確認に合格しますが、何も守りません。
まとめ
- DOM の注入は、
innerHTMLのようなシンクで、あなた自身の JavaScript の中で起こります。スクリプトのタグの規則だけではそれを捕まえられません。 require-trusted-types-for 'script'はシンクにただの文字列を拒ませ、trusted-types NAMEはどのポリシーが存在してよいかを限ります。- すべてのシンクではなく少しのポリシーの関数をレビューし、できる所では
textContentを選びます。 - 主要なすべてのエンジンで対応しています(2026 年 10 月確認)。まずレポート専用で導入しましょう。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。