公開 文責 Webaff 編集部
AstroのSSRページにnetlify.tomlのヘッダが付かなかった
- Astro
- Netlify
- セキュリティ
このブログ(Astro + Netlify)で、セキュリティヘッダを netlify.toml に書いたのに、トップページ / にだけ付いていないことが分かりました。/about/ などの静的ページには付いていたので、設定ミスではなく仕様でした。原因の確認、修正前の応答の再現、直し方、再発を防ぐ検査の順に残します。
起きていたこと
当時の netlify.toml には、/* を対象にした [[headers]] が3つのヘッダ(X-Frame-Options・X-Content-Type-Options・Referrer-Policy)を書いてありました。ところが本番では、/about/ などの静的ページには付き、/ には X-Frame-Options と Referrer-Policy が付いていませんでした(X-Content-Type-Options の有無は記録していません)。この本番での観測は、修正した PR とドキュメントに残した記録によるもので、この記事を書くために再度測ったものではありません。
/ だけ違う理由は、人気記事の並びを Netlify Blobs の累計 PV から作る(仕組みと費用の対策)ため、このページだけ prerender = false(SSR)にしているからです。静的ファイルではなく Netlify Function の応答になります。
付かない理由は公式の仕様
Netlify のドキュメントには、カスタムヘッダの制限が書かれています。要点は次のとおりです。
- カスタムヘッダは、Netlify が自前のストレージから配信するファイルにだけ適用される
- Function や Edge Function が処理する URL(SSR のページを含む)には適用されない
- その場合は、Function 側が必要なヘッダを返す
出典は Netlify Docs の Headers の Limitations です。つまり netlify.toml にいくら書いても、SSR ページには効きません。
修正前の応答を再現した
本番の当時の応答は取り直せなかったので、修正前のコミットをローカルでビルドし、生成された SSR 関数に直接リクエストを渡して応答ヘッダを見ました。Netlify のデプロイごとの固定 URL も試しましたが、認証(401)で見られませんでした。
// 修正前(12fd3e0)をビルドしたあとで、SSR 関数を直接呼ぶ
const { default: handler } = await import('./.netlify/v1/functions/ssr/ssr.mjs');
const res = await handler(new Request('https://webaff.net/'), context);
console.log(res.headers.get('x-frame-options') ?? '(なし)');
context は呼び出しに必要な最小限のダミーを渡しています。結果は次のとおりです。
| ヘッダ | 修正前の SSR 応答 | 修正後の SSR 応答 |
|---|---|---|
| X-Frame-Options | なし | DENY |
| X-Content-Type-Options | なし | nosniff |
| Referrer-Policy | なし | strict-origin-when-cross-origin |
| Strict-Transport-Security | なし | max-age=31536000; includeSubDomains |
| Permissions-Policy | なし | camera=(), microphone=(), … |
| Cross-Origin-Opener-Policy | なし | same-origin-allow-popups |
| Content-Security-Policy | なし | base-uri ‘self’; object-src ‘none’; … |
修正前は、SSR 関数自身がセキュリティヘッダを1つも返していません。静的ページ側の3つは netlify.toml から付くので、/ だけ差が出ていた説明がつきます。CDN 向けの Netlify-CDN-Cache-Control は、修正前後とも関数が返していました。Strict-Transport-Security は、修正前も本番の / では Netlify 自身が付けていたと記録しています。表の「なし」は、あくまで SSR 関数が返す応答の話です。
なお、この再現は関数の応答そのものです。CDN を通ったあとの本番の応答を、修正前の状態で取り直したわけではありません。
直し方: 定義を1か所にして、SSR 側でも付ける
ヘッダの値を src/utils/security-headers.js にまとめ、SSR のページが自分で付けるようにしました。
// src/utils/security-headers.js
export const SECURITY_HEADERS = {
'X-Frame-Options': 'DENY',
'X-Content-Type-Options': 'nosniff',
'Referrer-Policy': 'strict-origin-when-cross-origin',
// ほか4つ
};
---
// src/pages/index.astro
import { SECURITY_HEADERS } from '../utils/security-headers.js';
export const prerender = false;
for (const [name, value] of Object.entries(SECURITY_HEADERS)) {
Astro.response.headers.set(name, value);
}
---
Astro.response.headers は、Astro の公式ドキュメントにある応答ヘッダの設定方法です。ファイルを .ts ではなく .js にしたのは、Astro(Vite)と、素の Node で走る検査スクリプトの両方から同じファイルを読むためです。
静的ファイル向けの netlify.toml にも、同じ値を残しています。つまり同じ値が2か所にある状態です。
二重管理を CI で見張る
2か所に同じ値を書くと、片方だけ直す事故が起きます。npm run check:env が、netlify.toml と security-headers.js の一致を検査します。
わざと netlify.toml の X-Frame-Options だけを SAMEORIGIN に変えて実行した出力が次のとおりです(確認後に戻しました)。
Security headers: netlify.toml vs src/utils/security-headers.js
OK Content-Security-Policy
OK Cross-Origin-Opener-Policy
OK Permissions-Policy
OK Referrer-Policy
OK Strict-Transport-Security
OK X-Content-Type-Options
NG X-Frame-Options 値が不一致
toml: SAMEORIGIN
js : DENY
--strict を付けると終了コードが 1 になり、CI が落ちます。
本番の確認も、同じ理由で2種類のページを見ます。--live は / と /about/ の両方に、実際にヘッダが付いているかを確認します。片方だけ通っても、SSR と静的でヘッダの出どころが違うので意味がないためです。デプロイ直後の一時的な失敗で、この検査が誤って落ちた話は、Netlifyのデプロイ失敗と本番チェックの誤検知を切り分けた記録にあります。いま本番の / と /about/ には、どちらも7つのヘッダが付いています。
Edge Function でまとめる案は採らなかった
/* に Edge Function を割り当てれば、全ページのヘッダを1か所で付けられます。ただし、静的ファイルの配信にも関数が挟まります。実行回数と遅延が増えると考え、採用しませんでした。ここは、実際に計測した結論ではなく、当サイトの判断です。
CSP は安価な指示だけにした
Content-Security-Policy には、script-src を入れていません。入れたのは次の4つです。
base-uri 'self'; object-src 'none'; frame-ancestors 'none'; form-action 'self'
base-uri・form-action・frame-ancestors は、default-src にフォールバックしない指示です(MDN の CSP)。単独で書いても効きます。object-src は default-src にフォールバックするので、default-src を持たない当サイトでは 'none' を明示しています。
script-src を入れない理由は2つです。1つは、将来広告のスクリプトを許可し損ねると、広告が黙ってブロックされるからです。もう1つは、出力にインラインの <script> があり、静的ページでは nonce が使えない(nonce は応答ごとに違う値が必要なので、サーバーが生成する必要があります)ためです。
選択肢はほかにもあります。MDN のハッシュ方式は、許可するインラインスクリプトの内容のハッシュを script-src に書く方法で、ページもポリシーも静的なまま使えます。欠点は、スクリプトの内容が変わるたびにハッシュを計算し直す必要があることです。当サイトでは、Astro が生成するスクリプトの内容がビルドごとに変わり、運用が壊れやすいと判断してハッシュ方式も見送っています(この点は今回の記事のために再検証していません)。
つまり、インラインスクリプトを外部ファイルへ出すことは必須ではなく、当サイトが選んだ進め方です。ハッシュ方式で script-src を入れる道もあります。
X-Frame-Options と frame-ancestors は両方付けています。MDN は frame-ancestors を、より細かい指定ができる方法として案内しています。両方を送ったときの優先関係までは、MDN に書かれておらず、確認していません。
確認できていないこと
- 修正前の本番の応答は、この記事のために取り直していません。再現は、ローカルでビルドした SSR 関数の応答です
- ヘッダを付けただけでは、攻撃を防げたとは言えません。このサイトで、実際に悪用された事例も確認していません
script-srcがないので、スクリプトの注入に対する CSP の防御は効いていません- Netlify の仕様は変わることがあります。ここでの内容は、2026年10月時点の公式ドキュメントに基づきます
関連記事
記事タイトルの閉じタグでJSON-LDが壊れた件を再現した
JSON-LDを JSON.stringify のまま script に埋めると、タイトルに入った閉じタグで script が途中で終わります。修正前後のHTMLをブラウザで比べ、エスケープ方法と確認の限界を記録します。
- Astro
- セキュリティ
Netlifyのデプロイ失敗と本番チェックの誤検知を切り分けた記録
PRのプレビューと本番デプロイがNetlify側の内部エラーで失敗し、GitHub Actionsのliveチェックまで誤って落ちました。ログの見方、APIでは取れない情報、再試行を入れた修正の記録です。
- Netlify
- 運用
- Astro
Netlify BlobsでPVを数える設計とコスト対策
静的サイトの人気記事順を自前のPVで並べるために、Edge FunctionとNetlify Blobsで閲覧数を数えた記録。書き込み上限、毎時の集約、二重起動の防ぎ方、止まったときの気づき方まで。
- Netlify
- Astro
- 運用