メインコンテンツへスキップ
見出し画像

CSPはいきなり強制しない。Report-Onlyで違反を集め、段階を分けて制限を強める

    OPERUNの公開記事を、noteでもお読みいただけるよう掲載しました。

    原文・更新情報:CSPはいきなり強制しない。Report-Onlyで違反を集め、段階を分けて制限を強める

    原文公開:2026年11月18日。カバーは架空の人物を描いたAI生成イメージです。

    この記事のポイント

    • 最初は強制せず、Report-Onlyで実際の違反を集めて許可の一覧を作ります。

    • 報告はreport-toと報告先の準備がないと届きません。受け口を先に用意します。

    • スクリプトの制限はnonceを基本にし、unsafe-inlineで逃げない方針を決めます。

    • 強制に切り替えた後も、変更のたびに次の版をReport-Onlyで試してから反映します。

    一次情報から

    CSPで不具合が起きやすい理由

    CSPは、Webサイトからブラウザーへ渡す一連の指示です。どの出どころのスクリプトを実行してよいか、画像やフォントをどこから読み込んでよいか、ほかのサイトに埋め込まれてよいかといった制限を、応答ヘッダーで伝えます。ブラウザーは指示に合わない読み込みを止めるため、攻撃者がページに差し込んだスクリプトが動きにくくなります。

    一方で、止められるのは攻撃者の読み込みだけではありません。自社のサイトが使っている外部の解析タグ、チャットの窓、決済画面の部品、動画の埋め込み、広告のタグなども、許可の一覧に入っていなければ同じように止まります。サイトを長く運用していると、誰がいつ入れたのか分からないタグが残っていることも多く、一覧を机の上で作るだけでは漏れが出ます。

    さらに、ページの中に直接書いたスクリプトや、HTMLの属性に書いたイベント処理も影響を受けます。MDNによると、CSPにdefault-srcかscript-srcがあると、追加の対策をしない限り、ページ内に直接書いたJavaScriptは実行されません。古いテンプレートや管理画面から入れたコードが、ここで一斉に止まることがあります。

    このような性質から、CSPは「正しい値を一度で書く」作業ではなく、「実際に何が読み込まれているかを観察し、許可を絞っていく」作業として進めるほうが安全です。そのための仕組みとして用意されているのが、Report-Onlyのヘッダーです。

    出典:[1]

    一次情報から

    Report-Onlyは「止めずに数える」ためのヘッダー

    MDNは、CSPはreport-onlyモードで導入でき、その場合ポリシーは強制されず、違反が報告先へ送られると説明しています。Content-Security-Policy-Report-Onlyヘッダーに書いたポリシーは、ブラウザーが違反を判定するものの、読み込みは止めません。利用者の画面を壊さずに、強制したら何が止まるかを数えられるわけです。

    Report-Onlyヘッダーは、sandboxを除くすべてのCSPディレクティブを扱えます。つまり、本番で強制したいポリシーとほぼ同じ内容を、そのまま観察用に出せます。観察の段階と強制の段階で書き方を大きく変えずに済むため、集めた結果をそのまま本番のポリシーに移しやすくなります。

    注意したいのは、出し方の制約です。MDNによると、report-onlyのポリシーは、通常のCSPと違い、meta要素では指定できません。HTMLの中に書いて済ませることはできず、Webサーバー、CDN、アプリケーションのいずれかで応答ヘッダーとして返す必要があります。どの層でヘッダーを付けるかは、後の段階の切り替え作業にも関わるため、最初に決めておきます。

    また、同じ応答にContent-Security-Policy-Report-OnlyとContent-Security-Policyの両方がある場合、両方のポリシーが扱われます。強制のほうは強制され、Report-Onlyのほうは報告だけを出します。この性質は、強制に切り替えた後の運用で、次の版を試すときにも使えます。

    出典:[1][2]

    一次情報から

    報告の受け口を先に用意する

    Report-Onlyで最もつまずきやすいのは、報告が届かないことです。MDNのReport-Onlyヘッダーの説明では、報告を送るにはreport-toディレクティブの指定が必要で、ない場合は効果がありません。ヘッダーを出しただけでは、ブラウザーの開発者ツールに警告が出るだけで、運用側には何も集まりません。

    report-toで指定するのは、Reporting-Endpointsヘッダーで定義した報告先の名前です。MDNの例では、報告先の名前と受け取り用のURLをReporting-Endpointsで決め、CSPのreport-toでその名前を指しています。古い指定方法のreport-uriも残っていますが、MDNは置き換えが進んでいるものと位置づけており、対応の差を考えて両方を書く例も示しています。

    受け口は、届いた報告を保存し、後から集計できれば十分です。最初から専用の製品を入れる必要はありませんが、報告には閲覧中のページのアドレスなどが含まれるため、保存先の権限と保存期間は決めておきます。報告の量はアクセスに比例して増えるので、受け口が本体のサービスに負荷をかけない構成にしておくことも大切です。

    報告が届くことを確かめる手順も、作業の一部にします。テスト用のページで意図的に違反を起こし、受け口に記録が残るかを見ます。この確認をせずに観察期間を始めると、数週間たってから「一件も来ていない」と気づき、期間がまるごと無駄になります。

    出典:[2][1]

    編集部の実務提案

    観察の期間で集めること

    観察の期間は、サイトの主要な画面が一通り使われる長さを目安にします。月末にだけ使う請求の画面や、キャンペーンの時期だけ出る埋め込みがあるサイトでは、短い期間では違反が出そろいません。期間の長さより、重要な画面が観察の対象に入ったかを確認の基準にします。

    集めた報告は、違反したディレクティブと、止められるはずだった読み込み先ごとにまとめます。数が多いものから順に、自社が意図して使っているものか、使っていないのに残っているものか、攻撃の疑いがあるものかを分けます。意図して使っているものは許可に加え、使っていないものはタグ自体を外す候補にします。

    ここで、許可を広げすぎないことが重要です。違反をなくすために出どころをまとめて許可したり、ページ内のスクリプトを一括で許したりすると、報告は静かになりますが、CSPの効果も小さくなります。MDNは、unsafe-inlineはCSPの目的の多くを損なうため避けるべきだとしています。違反の数を減らすことと、安全にすることは別の目標だと意識して判断します。

    判断の記録も残します。どの読み込み先を、誰の依頼で、どの画面のために許可したのかを一覧にしておくと、後でタグを整理するときや、担当が替わったときに説明がつきます。CSPの値だけが残り、理由が誰にも分からない状態が、運用で最も困る状態です。

    出典:[1]

    一次情報から

    ご相談:CSPの段階導入を整理したい

    使用中の外部サービスと必要な画面を洗い出し、報告・観測・強制への切り替えを段階に分けて検討できます。

    運用の相談をする


    スクリプトはnonceで許可する

    スクリプトの許可を出どころの一覧だけで管理すると、許可したドメインに置かれた別のスクリプトまで実行できてしまうことがあります。MDNは、scriptとstyleの読み込みを制限する方法として、nonceを推奨しています。サーバーが応答ごとに乱数の値を作り、CSPとscript要素の両方に同じ値を入れ、ブラウザーが一致するものだけを実行する仕組みです。

    この方法が成り立つ条件は、攻撃者に値を推測されないことです。MDNによると、nonceは応答ごとに変わり、予測できないものでなければなりません。同じ値を使い回したり、キャッシュしたHTMLに値が固定で残ったりすると、守りの意味がなくなります。静的なHTMLをそのまま配る構成では使いにくく、テンプレートで値を差し込む仕組みが必要になります。

    静的なページが中心のサイトでは、スクリプトの内容から計算したhashで許可する方法もあります。ただし、スクリプトを変更するたびにhashを計算し直してポリシーに反映する必要があり、更新の手順に組み込まないと、リリースのたびに画面が止まります。

    外部のタグが別のスクリプトを読み込む場合には、strict-dynamicという指定があります。nonceやhashで許可したスクリプトが読み込むスクリプトにも信頼を引き継ぐもので、外部タグの多いサイトでも厳しいCSPを保ちやすくなります。一方でMDNは、strict-dynamicはCSPの安全性を下げる面もあると注意しています。使うかどうかは、外部タグの数と、それぞれの提供元を信頼できるかで判断します。

    出典:[1]

    一次情報から

    スクリプト以外の制限も段階に入れる

    CSPで扱えるのはスクリプトだけではありません。運用で効果が分かりやすいものの一つが、ほかのサイトへの埋め込みを制限するframe-ancestorsです。MDNは、埋め込まれる必要がないサイトでは、frame-ancestorsを'none'にすべきだとしています。画面を透明に重ねて操作させるクリックジャッキングへの対策になり、X-Frame-Optionsより柔軟な指定ができます。

    もう一つは、HTTPSへの移行後に残ったhttpの読み込みを扱うupgrade-insecure-requestsです。この指定があると、ブラウザーは画像やスクリプトなどのhttpの読み込みをhttpsに置き換えて要求します。古い記事の画像のアドレスを一つずつ書き換えられない場合に役立ちますが、HSTSの代わりにはならないとMDNは説明しています。

    これらの指定も、いきなり強制せず、Report-Onlyの段階で影響を見るのが基本です。たとえば、取引先のサイトに自社のページを埋め込んでもらっている場合、frame-ancestorsを'none'にすると、その埋め込みが表示されなくなります。誰がどこで自社のページを使っているかは、自社の中だけでは分からないことがあるため、報告で確かめる意味があります。

    指定を増やすほど、ポリシーは長く読みにくくなります。ディレクティブごとに、何のために入れたのか、どの段階で強制したのかを記録しておくと、後から見直すときに迷いません。

    出典:[1]

    編集部の実務提案

    強制への切り替えと、その後の変更

    観察で集めた違反を整理し、新しい違反がほとんど出なくなったら、同じポリシーをContent-Security-Policyヘッダーで強制に切り替えます。切り替えは利用の少ない時間帯に行い、主要な画面の操作をその場で確かめます。報告の受け口はそのまま残し、強制後に止められた読み込みが増えていないかを数日見ます。

    切り替えの前には、戻し方も決めておきます。どの層でヘッダーを付けているか、外すときは誰が何を操作するか、戻した後に何を確かめるかを手順にしておきます。CSPはHSTSと違い、ヘッダーを外せば次の応答から制限がなくなるため、戻すこと自体は難しくありません。だからこそ、問題が出るたびに外して終わりにせず、原因を報告から特定して許可の一覧に反映する流れにします。

    強制した後も、サイトは変わり続けます。新しい外部サービスを入れる、テンプレートを入れ替える、管理画面から埋め込みを追加する。こうした変更のたびに、次の版のポリシーをReport-Onlyで並べて出し、違反が出ないことを確かめてから強制側に反映します。同じ応答に両方のヘッダーがあると両方が扱われるという性質が、ここで役立ちます。

    外部の開発会社や海外のチームに作業を任せる場合は、この流れを受け入れの条件に入れておきます。新しいタグや埋め込みを追加する変更では、Report-Onlyでの確認結果と、許可の一覧への追記を成果物として求めます。値の変更だけが届き、理由と確認の記録がない状態を避けるためです。

    出典:[1][2]

    編集部の実務提案

    導入前にそろえる確認表

    最後に、導入を始める前に決めておく項目をまとめます。一つ目は範囲で、どのホストとどの画面にヘッダーを出すか、どの層で付けるかです。二つ目は報告で、Reporting-Endpointsとreport-toの設定、受け口の保存先と権限、届くことの確認方法です。三つ目は観察の期間と、強制に進む条件です。

    四つ目は許可の方針で、スクリプトはnonceかhashを基本にすること、unsafe-inlineを使わないこと、strict-dynamicを使う場合の判断基準です。五つ目は記録で、許可した読み込み先と理由、ディレクティブごとの強制の時期を一覧に残すことです。六つ目は変更の手順で、新しいタグを入れるたびにReport-Onlyで試すことを、依頼と受け入れの条件に入れることです。

    これらがそろっていれば、CSPは一度の大きな作業ではなく、毎月少しずつ精度を上げる運用になります。診断で指摘されたから入れる、問題が出たから外す、という往復から抜け出すには、観察と記録の仕組みを先に作ることが近道です。

    出典:[1][2]

    日々のAI管理を、チームへ。

    CSPは、正しく使えば攻撃の被害を大きく減らせる一方、許可の漏れがそのまま利用者の画面の不具合になる仕組みです。最初はReport-Onlyで止めずに数え、報告の受け口を確かめ、nonceを基本に許可を絞り、強制に切り替えた後も変更のたびに次の版を試す。この段階を手順と記録に落としておけば、担当が替わっても、外部のチームに任せても、同じ品質で運用を続けられます。

    参考にした一次情報

    出典確認:2026年11月18日。本文の手順・チェックリストは、編集部の実務提案です。

    1. [1] Content Security Policy (CSP) - HTTP | MDN

    2. [2] Content-Security-Policy-Report-Only header - HTTP | MDN

    原文:CSPはいきなり強制しない。Report-Onlyで違反を集め、段階を分けて制限を強める

     
     
    株式会社VERSAROCが運営するメディア・毎日続々更新中🎉

    あなたへのおすすめ