Content Security Policy

どのようなものか

Content Security
Policyは、ページが何を実行し、取得し、送信できるかについて、ウェブサ
イトからブラウザーへ渡す規則です。ブラウザーが、サイトに代わってその
規則を適用します。ほぼ常にCSPと略します。サイトは、
`Content-Security-Policy`応答ヘッダーで規則を送るか、ページの`meta`
要素に書き込みます。その時点から、許可されていないスクリプト、スタイ
ルシート、画像、フォント、フレーム、接続は、読み込み前に拒否します。

ポリシーは、セミコロンで区切るディレクティブを並べた、短い文字列で
す。各ディレクティブは、リソースまたは振る舞いの一種類と、受け入れる
出所を定めます。厳格なポリシーは、次のようになります。読みやすいよう
に一行に一つずつ示しますが、通信時には、一つのヘッダーの値です。

```text
default-src 'self';
script-src 'nonce-q8Zt3VwR1mKx7NpL2cYfJA==' 'strict-dynamic';
object-src 'none';
base-uri 'none';
form-action 'self';
frame-ancestors 'none'
```

使う語彙は少数です。`'self'`は、ページ自身のオリジンを指します。
`https://static.example.com`のようなホストや、`https:`のようなスキー
ムを指定すると、許可する範囲が広がります。`'none'`は、何も許可しませ
ん。nonceは、サーバーが一つの応答のために生成する乱数値で、ポリシー
と、その応答で信頼を保証する各スクリプト要素の両方に書きます。ハッ
シュは、インラインスクリプトの正確なテキストから計算するダイジェスト
です。そのスクリプトだけを実行し、それ以外は実行させません。
`'unsafe-inline'`と`'unsafe-eval'`という二つのキーワードは、保護を再
び無効にします。その名前自体が、十分な注意喚起です。

`default-src`は、ポリシーが省略した取得用ディレクティブの代わりにな
ります。`script-src`、`style-src`、`img-src`、`connect-src`などが対
象です。代わりになるのは、取得用ディレクティブに限られます。取得では
なく振る舞いを制御する`base-uri`、`form-action`、`frame-ancestors`な
どは、明記しなければ無制限のままです。

監視だけを行うモードでも使えます。
`Content-Security-Policy-Report-Only`として送ると、何も遮断せず、代
わりに違反の一件ごとに、`report-to`で指定したエンドポイントへ報告し
ます。ブラウザーのReporting
APIを使う仕組みです。古い`report-uri`ディレクティブは非推奨で、代わ
りにこの仕組みが推奨されています。現在の規格本文は、Web
Application Security Working GroupによるW3C作業草案、Content
Security Policy
Level 3です。

なぜ重要なのか

CSPは、クロスサイトスクリプティングに対抗するために作られました。コ
メント欄、HTMLに表示し直す検索語、侵害された依存先などを通して、誰か
が自分の選んだテキストをページへ入れます。ブラウザーは、それを、サイ
ト自身のコードと同じ権限を持つスクリプトとして実行します。ページを読
み、ログインした利用者になり代わって操作し、見つけたものをどこへでも
送れます。第一の防御は、出力を正しくエスケープすることです。すべての
テンプレートのすべての行で、毎回、正しい必要があります。CSPは第二の
防御です。エスケープの誤りがすり抜けても、注入されたスクリプトは、ポ
リシーも通過しなければなりません。その応答のnonceを持つスクリプトだ
けを実行するポリシーなら、拒否できます。

実行を認めたスクリプトの到達先も制限します。`connect-src`は、スクリ
プトが通信できるホストを決め、窃取用スクリプトが収集した情報を送れる
先を絞ります。`frame-ancestors`は、どのサイトがページをフレーム内に
表示できるかを決めます。別のページの上にページを重ね、利用者の意図し
ない場所へクリックを届ける、クリックジャッキングへの標準的な対策で
す。`form-action`は、フォームが送信できる先を決めます。`base-uri`
は、注入された`base`要素が、ページ内のすべての相対アドレスを、気付か
れないまま別の先へ向けるのを防ぎます。

CSPが誰を守るかも、正確に捉える必要があります。ブラウザー内で動くた
め、ページを読む人を、攻撃者が仕込んだコンテンツから守ります。一方、
その同じ人からサーバーを守ることはありません。自分のブラウザーなら、
数秒でヘッダーを編集したり、取り除いたりできるためです。ポリシーは、
ページを信用する範囲を狭める理由にはなりますが、リクエストをより信用
する理由にはなりません。

主なコストは、使っているものの洗い出しです。ポリシーを設けるには、
ページがリソースを読み込む元となるすべてのオリジン、すべてのインライ
ンスクリプト、属性として書いたすべてのイベントハンドラーを、チームが
把握する必要があります。新しいサイトなら、最初のコミットから厳格なポ
リシーに合わせて作るコストは、わずかです。インラインハンドラー、タグ
マネージャー、複数のウィジェットを持つ古いサイトでは、先に整理のコス
トを払います。通常、本当のプロジェクトになるのは、その整理です。

実際の活用例

このサイトも、ポリシーを適用しています。セキュリティページには、ペー
ジ自体に宣言する厳格なContent Security
Policyを記載しています。フォームをどこにも送信しないため、
`form-action
'none'`を使います。すべてのHTMLページが、`script-src
'none'`を明記します。実行可能なJavaScriptも、サービスワーカーも動き
ません。第三者へのリクエストはなく、ページに必要なものは、すべて自身
のホストから届くため、許可するものはごくわずかです。

ログインする利用者を持つアプリケーションには、短い許可リスト以上のも
のが必要です。職業や組織に関するデータを扱うプラットフォームでは、
HSTSやSameSite
Cookieとともに、Next.jsのプロキシミドルウェアが、リクエストごとの
nonceと`strict-dynamic`を使うContent-Security-Policyを設定します。応
答ごとに新しいnonceを使えば、その応答でサーバーが印を付けたスクリプ
ト要素だけを実行します。ポリシーに`strict-dynamic`があれば、nonceに
よって信頼するスクリプトは、さらに別のスクリプトを読み込めます。その
ため、バンドルが分割されたコードを取得するすべてのホストを、ポリシー
で列挙する必要はありません。このプラットフォームは、クライアントが悪
意を持つという前提で動きます。そのため、各リクエストの権限はサーバー
で改めて確認し、フロントエンドの制御は、利用体験のためだけに使いま
す。CSPは、注入されたコードから利用者を守る、複数ある層の一つです。
認可は、別の場所で決めます。

問題が起きるところ

ポリシーを有効にすると、サイトの半分が動かなくなります。
厳格なポリシーをいきなり強制すると、誰も覚えていなかったインラインス
クリプトや、誰かが二年前に追加した追跡タグを遮断します。まず、
`Content-Security-Policy-Report-Only`として配信します。報告が落ち着
くまで読み、挙がった出所を一つずつ許可するか取り除き、その後で強制し
ます。報告専用ヘッダーは、実際のHTTPヘッダーでなければなりません。仕
様は、`meta`要素での指定を認めていません。

許可リストが、ホスト全体を信用します。 `script-src
https://cdn.example.com`は、そのホストのすべてのファイルを許可しま
す。古いバージョンのライブラリーや、呼び出し元の入力をスクリプトとし
て返すエンドポイントも含みます。仕様自体が、クロスサイトスクリプティ
ングに有効なポリシーの導入は難しいと述べ、Strict
CSPと呼ぶ構成を推奨しています。nonceかハッシュと`'strict-dynamic'`で
`script-src`を構成し、`base-uri`を`'self'`か`'none'`にします。

`'unsafe-inline'`が、すべてのインラインスクリプトを許すと思ってしま
います。
同じソースリストにnonceかハッシュが現れると、それらを理解するブラウ
ザーは、`'unsafe-inline'`を無視します。この規則によって、nonceを知ら
ない古いブラウザー向けには、代替として`'unsafe-inline'`を残し、現在
のブラウザーには、厳格な一覧を適用できます。一つのスクリプトへnonce
を加えた途端、ほかのインラインスクリプトが遮断されるため、チームを驚
かせる場合があります。

nonceが、秘密ではなくなります。
仕様は、ポリシーを送るたびに新しい値を使うことを必須とし、暗号学的に
安全な生成器による128ビット以上の値を推奨しています。テンプレートへ
固定値を書き込んだり、nonceを含むページ全体を共有キャッシュへ保存
し、全員に配信したりすると、攻撃者に、自分のスクリプトへ付けるための
値を渡してしまいます。

`meta`要素内のポリシーでは、同じポリシーをヘッダーで送る場合より、で
きることが減ります。
この方法で届く`frame-ancestors`、`report-uri`、`sandbox`は、ブラウ
ザーが無視します。文書内でその要素より後だけにポリシーを適用するた
め、head内でそれより上にあるものは、検査されずに読み込まれます。応答
ヘッダーを変更できないサイトでも、headの可能な限り早い位置へ`meta`ポ
リシーを置けば、実際に保護できます。ただし、フレームへの埋め込みを防
ぐには、ヘッダーが必要です。

二つ目のポリシーは、緩和せず、制限を強めます。
一つの応答には、フレームワーク、プロキシ、CDNからの複数のポリシーを
載せられます。リソースは、そのすべてを通過する必要があります。ポリ
シーを追加してできるのは、制限を強めることだけです。遮断されたリクエ
ストを直すため、後段で緩いヘッダーを追加しても、効果はありません。遮
断した側のポリシーを直す必要があります。

参考資料

  * Content Security Policy Level 3 — 規格そのものです。Strict
CSPの推奨と、nonceが盗まれる仕組みを説明する節を含みます。

  * HTML標準：meta要素 —
ページ内で宣言するポリシーを適用するプラグマ、無視するディレクティ
ブ、それより前に取得したリソースが保護をすり抜ける理由を説明します。

  * Reporting API — 強制する前に違反を調べるための、`report-to`の背
後にあるエンドポイントの仕組みです。

  * Trusted Types —
`require-trusted-types-for`ディレクティブで有効にする関連規格です。
DOMを通して注入されるスクリプトを対象にします。

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