静的サイトのセキュリティヘッダー

稼働済みNGINXのHTTPSサイトへ、セキュリティヘッダーを差分追加する。サイトの公開ファイルはCI/CDで更新し、ヘッダーの設定は公開ディレクトリの外で管理する。バックエンドの更新は不要である。設定例を置いただけでは本番へ反映されない。

基本ヘッダーと埋め込み禁止等は最初から適用する。スクリプト・画像・通信先を制限する完全なCSPは、Report-Onlyで確認してから強制へ切り替える。

ヘッダーとフロントの変更

ヘッダー 初期設定・役割
Strict-Transport-Security max-age=300。信頼できるHTTPSで受信したブラウザーに、以後のHTTPS利用を指示する
X-Content-Type-Options nosniff。宣言されたContent-Typeに従わせる
X-Frame-Options DENY。iframe埋め込みを禁止する
Referrer-Policy strict-origin-when-cross-origin。外部へ渡すRefererをオリジンに限定する
Content-Security-Policy 初期はframe-ancestors 'none'; base-uri 'none'; object-src 'none'; form-action 'none'を強制する
Content-Security-Policy-Report-Only 外部接続先を含む完全なポリシーを、拒否せずに検査する

frame-ancestorsはこのサイト自体を埋め込ませないための指定である。GoogleマップやTurnstileをこのサイトに埋め込む許可はframe-srcで指定する。問い合わせAPIの送信はfetch()なので、ブラウザー標準のフォーム遷移を禁止するform-action 'none'の影響を受けない。

今回、テーマとGAの初期化を外部JSへ移し、Astroによる小さいスクリプトの自動インライン化も無効にした。ファイル名はビルド時にハッシュ付きで生成する。テーマ初期化は描画前に動く通常の外部スクリプトを維持し、GAは本番オリジンだけで起動する。フォームのインラインonsubmitは削除し、既存のイベントリスナーで制御する。地図iframeの個別のReferrer-Policyもヘッダーと同じ値にそろえた。

スクリプトの'unsafe-inline'・'unsafe-eval'は許可しない。スタイルはAstroの生成CSSやウィジェットの指定との互換性のため、style-src 'self' 'unsafe-inline'とする。CSSのインライン指定まで禁止する変更は今回には含めない。

許可する接続先

用途 CSPの主な指定先
GAのスクリプト script-src https://www.googletagmanager.com
GAの計測通信 connect-src https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com
GAの画像通信 img-src https://www.googletagmanager.com https://*.google-analytics.com
Turnstile script-src・frame-src・connect-srcにhttps://challenges.cloudflare.com
Googleマップ frame-src https://maps.google.com https://www.google.com
同じオリジンの問い合わせAPI・検索JSON connect-src 'self'

外部リンクの移動先をすべてconnect-srcへ追加する必要はない。iframe内で読み込む地図の画像等にも、親ページのimg-srcは適用されない。

AWS API等、問い合わせAPIが別オリジンなら、connect-srcへその正確なオリジンを追加する。例えばhttps://API-ID.execute-api.ap-northeast-1.amazonaws.com/contactなら、許可先はhttps://API-ID.execute-api.ap-northeast-1.amazonaws.comとなる。APIを切り替える際はフロント設定とCSPの両方を確認する。HTTPの内部APIはブラウザーから直接呼ばず、NGINXのHTTPS経由を使う。

GAのGoogleシグナル・広告機能・Tag Assistant等を追加する場合は、その機能の公式要件と実通信を確認して別途許可先を検討する。今回の一覧は現在のGA4計測を対象とする。

1. 既存設定を保存する

NGINXサーバーでsudo nginx -Tを確認し、対象HTTPSサイトと、add_headerを持つlocationを特定する。バックアップはsites-enabled/*等で読み込まれない場所へ保存する。NGINX差分更新手順の確認・保存方法を使える。

この設定は企業サイト専用のHTTPSホストを想定する。同じホストでRedmine等も配信している場合は、form-action等がそちらの機能を制限するため、静的サイトとそのエラーページのlocationへ適用範囲を限定する。

2. 共通設定を配置する

NGINXサーバーの対象版のリポジトリから実行する。既存の同名ファイルがある場合は保存し、既存の許可先・HSTS設定を確認してから更新する。

sudo install -d -o root -g root -m 755 /etc/nginx/snippets
sudo install -o root -g root -m 644 \
  infra/nginx/security-headers.conf.example \
  /etc/nginx/snippets/tectas-security-headers.conf
sudoedit /etc/nginx/snippets/tectas-security-headers.conf

設定例は同じオリジンの/api/contactを想定している。別オリジンのAPIは、ここでconnect-srcへ追加する。設定ファイルはCI/CDのcurrentやreleasesの外に置き、公開ファイルの置き換えと独立して維持する。

3. HTTPS側へincludeする

企業サイト専用の既存HTTPS用serverへ、次の1行を追加する。共有領域を定義するhttpブロックや、301転送だけを行うHTTP用serverへの追加ではない。

include /etc/nginx/snippets/tectas-security-headers.conf;

NGINXの標準の継承規則では、下位のlocationに1つでもadd_headerがあると、上位のadd_header一式を継承しなくなる。その場合は、そのlocationにも同じincludeを追加する。新しいNGINXだけで使えるadd_header_inherit mergeには依存しない。

例えば、既存のデプロイ識別ファイルにadd_header Cache-Controlがある場合は次とする。現在のIP制限等は維持する。

location = /deploy-version.txt {
    include /etc/nginx/snippets/tectas-security-headers.conf;
    add_header Cache-Control "no-store" always;
    open_file_cache off;
    # 既存のループバック限定のアクセス制限は維持
}

add_headerを持たないlocationは上位から継承するため、重複includeは不要である。404・301・静的アセットの個別設定も確認する。ヘッダーはalwaysでエラー応答にも適用する。

4. 基本ヘッダーとReport-Onlyを反映する

sudo nginx -t && sudo systemctl reload nginx

初期の強制CSPは埋め込み・base・object・標準フォーム遷移の制限だけで、既存のインラインスクリプトは止めない。完全なポリシーはReport-Onlyなので、旧フロントが残っていても、そのスクリプト制限によって表示や送信が止まることはない。

続いて今回のフロント修正をCI/CDで配置する。Vite等の開発用通信は本番成果物と異なるため、本番用CSPは開発サーバーではなくビルド成果物で検証する。

5. 配置後の確認

次はNGINXが192.168.200.1で、本番ドメイン用のHTTPS設定・有効な証明書を持つ場合の例である。既存のホスト名・IPに合わせ、TLS検証を省略しない。--resolveはDNSの公開先を変えず、今回の確認だけ接続先を指定する。

curl --noproxy '*' --resolve www.tectas.co.jp:443:192.168.200.1 \
  -sS -D - -o /dev/null https://www.tectas.co.jp/

curl --noproxy '*' --resolve www.tectas.co.jp:443:192.168.200.1 \
  -sS -D - -o /dev/null https://www.tectas.co.jp/__header-check-not-found__

200・404の両方に基本ヘッダーとCSPが付くことを確認する。/deploy-version.txtはループバック限定のアクセスを維持したまま、デプロイ手順と同じ接続方法で確認する。HTTPからHTTPSへの転送も確認する。

ブラウザーの開発者ツールでNetworkの応答ヘッダーとConsoleを開き、次を確認する。拡張機能の通信はサイト自身の違反と区別する。

  • テーマの切り替え・保存、モバイルメニュー、スライダーが動く。
  • 検索ページでJSONを読み込んで検索できる。
  • 問い合わせの確認・修正・実Turnstile認証・API送信が動く。
  • 会社概要のGoogleマップが表示される。
  • 本番サイトでGAのスクリプト・計測通信が成功する。
  • Consoleにサイト自身のCSP違反が残らない。

Report-Onlyの違反はConsoleに表示される。レポート収集用APIは追加しておらず、Slackへの自動通知も行わない。実サービスの通信先は条件によって変わるため、ローカルのモック試験に加え、実Turnstile・GA・地図を環境上で確認する。

6. 完全なCSPを強制する

新フロントの配置と実通信の確認後、共通設定ファイルを編集する。

  1. 短い初期ポリシーのadd_header Content-Security-Policy ...行を削除する。
  2. 長い完全なポリシーのヘッダー名をContent-Security-Policy-Report-OnlyからContent-Security-Policyへ変更する。
  3. APIの追加許可先を維持し、nginx -tの成功後にreloadする。
  4. 前節の動作と応答ヘッダーを再確認する。

強制後は、新機能や外部接続先を追加するときにもCSPを確認する。旧フロントへ切り戻す場合は、インラインスクリプトが再び含まれる可能性があるため、先に完全なポリシーをReport-Onlyへ戻し、初期の強制ポリシーを復元してから切り戻す。

HSTSの延長と切り戻し

初期のmax-age=300は5分である。HTTPSと証明書更新・サブページ・転送を確認し、問題がなければ86400、運用確認後に31536000などへ段階的に延長する。includeSubDomainsとpreloadは追加していない。全サブドメインのHTTPS運用を確認していない段階では付けない。

HSTSはブラウザーに期限まで保存されるため、設定行を消すだけでは解除されない。解除には、有効なHTTPSでmax-age=0を返してブラウザーに受信させる必要がある。バックアップから戻す場合も、この性質を考慮する。

自動検証

npm run check
npm run build
npm run qa:security

全ビルド済みHTMLに実行用インラインスクリプト・イベント属性がないことと、完全なCSPを強制したブラウザーでテーマ・メニュー・検索・問い合わせが動くことを確認する。GA・Turnstile・Googleマップは代替応答を使い、実通信・実メール送信は行わない。注入したインラインスクリプトの拒否と、404にもヘッダーが付くことも確認する。GitLab CIのQAジョブにも追加している。

NGINX自体の構文検査と実配信ヘッダーの確認は、配置先サーバーで行う。

公式資料