静的サイトのセキュリティヘッダー¶
稼働済み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を強制する¶
新フロントの配置と実通信の確認後、共通設定ファイルを編集する。
- 短い初期ポリシーの
add_header Content-Security-Policy ...行を削除する。 - 長い完全なポリシーのヘッダー名を
Content-Security-Policy-Report-OnlyからContent-Security-Policyへ変更する。 - APIの追加許可先を維持し、
nginx -tの成功後にreloadする。 - 前節の動作と応答ヘッダーを再確認する。
強制後は、新機能や外部接続先を追加するときにも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自体の構文検査と実配信ヘッダーの確認は、配置先サーバーで行う。