DigiRiseセキュリティ診断無料で診断する
CSP Report-Only導入手順 違反報告で許可リストを作り本番へ

セキュリティ診断

CSP Report-Only導入手順 違反報告で許可リストを作り本番へ

CSP(コンテンツセキュリティポリシー)は、このサイトがどこから読み込んだものを実行してよいかをブラウザーに伝える仕組みです。ただしいきなり有効にすると、外部の計測タグや埋め込みフォームが止まってしまうことがあります。そこで使うのが、ブロックはせずに違反の報告だけを集めるReport-Onlyモードです。この記事では、報告を集めて許可する読み込み元の一覧を作り、本番に切り替えるまでの流れを説明します。違反報告の読み方と制作会社への頼み方もあわせて整理します。

この記事は、末尾の出典(公的機関・標準化団体などの資料)をもとにデジライズ セキュリティ診断の編集部がAIを使って作成し、出典との照合と表現のチェックを通してから公開しています。

CSPとReport-Onlyモードの基本

CSPは、ウェブサイトからブラウザーへ送る一連の指示で、ページ上のコードができることを制限するための機能です。主な用途は、ページが読み込んでよいリソース、とくにJavaScriptを制御することです。攻撃者がサイトに悪意のあるコードを差し込むクロスサイトスクリプティング(XSS)への防御として使われるほか、クリックジャッキング(見えない画面を重ねて意図しない操作をさせる攻撃)への対策や、ページをHTTPSで読み込ませる目的にも使えます。[1]

ポリシーは、ディレクティブ(どの種類のリソースをどこから許可するかを決める個々の指示)をセミコロンで区切って並べたものです。たとえばdefault-srcに'self'を指定すると、より具体的な指示がない限り、ページと同じオリジン(同じ配信元)のリソースだけが読み込まれます。画像だけ別の配信元を許したいときは、img-srcに追加で書きます。[1]

Report-Onlyモードでは、ポリシーに反する読み込みがあってもブロックは行われず、違反の内容が指定した送信先へ報告されます。MDNは、本番環境への適用をスムーズにするためや、新しいポリシーを本番に適用する前に試験運用するためにこのモードを使えると説明しています。[1]

よくある誤解

  • CSPを入れればXSS対策は終わる
  • Report-Onlyでも一部の読み込みは止まる
  • 手軽にmeta要素で試せる

実際

  • CSPは入力の無害化を補う多層防御で代わりにはならない
  • Report-Onlyではブロックせず報告だけを行う
  • 報告のみのポリシーはmeta要素では配信できずHTTPヘッダーで送る
[1]

導入前に読み込み元と配信方法を確かめる

Report-Onlyを始める前に、サイトが今どこから何を読み込んでいるかを分かる範囲で書き出しておきます。報告が届いたときに「これは自社で入れたものか」をすぐ判断できるようになり、突き合わせの手間が大きく減ります。

  • アクセス解析や広告の計測タグ
  • 問い合わせフォームや予約フォームの埋め込み
  • チャットや地図などの外部ウィジェット
  • 外部から読み込んでいるフォントや画像の配信元
  • ページ内に直接書かれたスクリプトやonclickなどのイベント属性
  • それぞれを導入した部署や制作会社の担当者

CSPはContent-Security-Policyというレスポンスヘッダーでブラウザーに届けます。MDNは、メインのページだけでなくすべてのリクエストに対するレスポンスに設定する必要があるとしています。ページ内のmeta要素で指定する方法もありますが、すべての機能には対応しておらず、Report-Onlyのポリシーはmeta要素では配信できません。そのため、自社のサーバーやホスティングの設定でレスポンスヘッダーを追加できるかを最初に確認します。[1]

レスポンスヘッダーで安全性を高める設定はCSPのほかにもあります。OWASPのSecure Headers Projectは、ブラウザーが防ぎやすい脆弱性に陥らないよう制限できるHTTPレスポンスヘッダーを解説し、その利用を広めることを目的にしています。ヘッダーを見直す機会にあわせて確認しておくと効率的です。[2]

Report-Onlyで違反報告を集める手順

  1. 報告の受け口を用意

    違反報告を受け取るエンドポイント(報告を受け付けるアドレス)を用意します。報告はJSON形式でPOST送信されるため、受け取って保存できるようサーバー側を設定します。

  2. 受け口をヘッダーで宣言

    Reporting-Endpointsヘッダーで受け口に名前を付けて宣言し、ポリシー内のreport-toディレクティブでその名前を指定します。

  3. 仮ポリシーを報告専用で配信

    自社の配信元だけを許可する仮のポリシー(たとえばdefault-src 'self')をContent-Security-Policy-Report-Onlyヘッダーで配信します。この段階では何もブロックされません。

  4. 普段どおり運用して集める

    フォーム送信や計測タグの動作など普段の操作が一通り行われるまで報告をためます。担当者自身も主要なページとフォームを操作しておくと漏れが減ります。

[1]

MDNによると、推奨される報告方法はReporting APIを使うreport-toです。古い方式のreport-uriは非推奨とされていますが、report-toがすべてのブラウザーで対応されるまでは両方を宣言しておく必要があるとされています。report-uriで届く報告は形式が少し異なり、Content-Typeもapplication/csp-reportになるため、受け口は両方の形式を受け取れるようにしておきます。[1]

報告には違反が起きたページのアドレスや参照元、ブラウザーの情報などが含まれます。保存先と社内で閲覧できる人をあらかじめ決めておくと、あとで扱いに迷いません。[1]

違反報告の読み方と見るべき項目

report-toで送られる報告は、typeがcsp-violationとなったJSONのデータです。その中のbodyに違反の詳細が入っています。項目は多く見えますが、最初は次のものを押さえれば、何がどこで引っかかったかをつかめます。[1]

  • blockedURL:ポリシーに反した読み込み元。ページ内に直接書かれたスクリプトの場合はinlineと記録されます
  • effectiveDirective:違反になったディレクティブ。MDNの例ではscript-src-elemで、スクリプトの読み込みに関する違反だと分かります
  • documentURL:違反が起きたページのアドレス
  • sourceFileとlineNumberとcolumnNumber:原因になったコードの場所
  • sample:違反したコードの一部
  • originalPolicy:そのとき配信されていたポリシーの全文
[1]

一覧に加える候補

  • 社内で導入を把握している計測タグの配信元
  • 制作会社が組み込んだフォームやウィジェットの配信元
  • 自社の画像やフォントを配信しているサブドメイン

すぐには許可しない報告

  • 誰も心当たりのない外部ドメインからのスクリプト
  • blockedURLがinlineになっているもの
  • 特定のページで一度だけ出て再現しないもの

inlineの違反が多いからといってunsafe-inlineを加えるのは避けます。MDNは、unsafe-inlineはCSPを使う目的の大半を無効にしてしまうと警告しています。インラインのスクリプトはノンス(レスポンスごとに変わる推測できない値)やハッシュで許可するか、インラインのイベント属性をaddEventListenerに置き換えるなどの書き直しで対応するのが基本です。unsafe-evalも同じ理由で避けるべきとされています。[1]

許可リストを固めて本番に切り替える

  1. 報告を配信元ごとに整理

    集めた報告をblockedURLとeffectiveDirectiveで分け、配信元ごとに用途と担当者を書き添えた一覧を作ります。

  2. 更新して再び観察

    必要な配信元を該当するディレクティブに加えたポリシーをReport-Onlyで配信し直し、想定外の報告が残っていないかを確かめます。

  3. 本番ヘッダーに切り替え

    新しい種類の報告が出なくなったら、同じポリシーをContent-Security-Policyヘッダーで配信してブロックを有効にします。

  4. 切り替え後も報告を見る

    本番のポリシーにもreport-toを残し、タグの追加やサイト改修で新たに起きる違反に気づけるようにします。

[1]

同じレスポンスにContent-Security-PolicyとContent-Security-Policy-Report-Onlyの両方があると、どちらのポリシーも考慮されます。前者はブロックが行われ、後者は報告だけが行われます。これを使えば、今の本番ポリシーで守りながら、より厳しくした次のポリシーを報告専用で試すという段階的な進め方ができます。[1]

なお、読み込み元を並べる許可リスト型のCSPには限界もあります。MDNは、許可リストは正しく設定するのが難しく、安全でないドメインを誤って許可してしまうことが多いと指摘しています。また大規模になりやすく、ある記事ではGoogle Analyticsを組み込むためだけに187件のGoogleドメインを許可リストに加えるよう求められた例が紹介されています。そのうえでMDNは、スクリプトの制御にはノンスやハッシュを使う厳格なCSPを推奨しています。[1]

まずは許可リストで外部タグを止めずに運用を始め、その後に厳格なCSPへ移れるかを制作会社と相談する順番が現実的です。外部スクリプトがさらに別のスクリプトを読み込む場合に使うstrict-dynamicというキーワードもありますが、MDNは使うとCSPの安全性が下がる面があるとしているため、採用するかどうかは理由を聞いてから判断します。[1]

制作会社への頼み方と依頼チェックリスト

CSPの設定はサーバーやサイトのコードに関わるため、多くの場合は制作会社や保守会社への依頼になります。「CSPを入れてください」とだけ伝えると、いきなり本番で有効にされて外部タグが止まることもあり得ます。段階と範囲と戻し方をはっきり伝えるのがポイントです。

チェックリスト

  • 最初はContent-Security-Policy-Report-Onlyヘッダーで配信しブロックはしないこと
  • メインのページだけでなくすべてのレスポンスにヘッダーを付けること
  • 違反報告の受け口を用意しreport-toとreport-uriの両方を宣言すること
  • 報告の保存先と社内で報告を確認する方法を決めること
  • 集めた報告から読み込み元の一覧を作り用途とあわせて共有すること
  • unsafe-inlineやunsafe-evalを加える場合は理由と代わりの方法を説明すること
  • 他サイトへの埋め込みが不要ならframe-ancestorsを'none'にすること
  • 本番切り替えの日程と問題が出たときの戻し方を事前に決めること
[1]

依頼とあわせて、CSPだけに頼らない考え方も共有しておきましょう。IPAの「安全なウェブサイトの作り方」は、クロスサイト・スクリプティングやクリックジャッキングなどの脆弱性について、原因そのものをなくす根本的な解決策と、攻撃による影響の低減を期待できる対策を分けて示しています。巻末にはセキュリティ実装の状況を確かめるチェックリストも付いているため、制作会社との打ち合わせで共通の資料として使えます。[3]

まとめ

  • CSPはいきなり有効にせずReport-Onlyモードで違反の報告だけを集めてから切り替える
  • Report-OnlyのポリシーはHTTPヘッダーで配信しmeta要素では使えないので配信方法を先に確かめる
  • 報告はblockedURLとeffectiveDirectiveを軸に読み許可する読み込み元の一覧にまとめる
  • inlineの違反はunsafe-inlineで逃げずノンスやハッシュやコードの書き直しで対応する
  • 制作会社には段階と範囲と戻し方をチェックリストで具体的に伝える

よくある質問

QReport-Onlyモードにするとサイトの表示や動作に影響はありますか

AReport-Onlyモードでは、ポリシーに反する読み込みがあってもブロックは行われず、違反の内容が報告されるだけです。そのため外部タグやフォームを止めずに影響を調べられます。ただし報告を受け取って保存する仕組みは別に用意する必要があります。[1]

Qmeta要素でReport-Onlyを設定できますか

Aできません。通常のCSPはmeta要素でも指定できますが、報告のみのポリシーはmeta要素では配信できないとされています。Content-Security-Policy-Report-OnlyというHTTPレスポンスヘッダーで送る必要があるため、サーバーやホスティングで設定できるかを制作会社に確認してください。[1]

Qreport-toとreport-uriはどちらを使えばよいですか

A推奨されるのは、Reporting-Endpointsヘッダーで受け口を宣言しreport-toで指定する方法です。report-uriは非推奨ですが、report-toがすべてのブラウザーで対応されるまでは両方を宣言しておく必要があるとされています。受け口は両方の形式を受け取れるようにしておきましょう。[1]

Q本番に切り替えた後も報告は集めたほうがよいですか

A続けるのがおすすめです。Content-Security-PolicyとReport-Onlyの両方のヘッダーは同じレスポンスで使え、前者はブロック、後者は報告だけを行います。本番のポリシーで守りながら、次に厳しくしたいポリシーを報告専用で試すことができます。[1]

出典

  1. コンテンツセキュリティポリシー (CSP) - HTTP | MDN(MDN Web Docs)
  2. OWASP Secure Headers Project(OWASP Foundation)
  3. 安全なウェブサイトの作り方(IPA 独立行政法人 情報処理推進機構)