Issue #820(静的エクスポート環境向けのCSP設定ガイドをドキュメントに追加する)は、2026-05-21 に PR #849「Add static hosting CSP deployment guide」の merge と同時に close された(completed)。ガイドは docs/deployment/static-hosting-csp.md にある。動的 hosting 向けの app 側 CSP header は同じ日に PR #848 で入っており、#820 はその PR の scope 外として残った「静的 export の配信先で何を設定すべきか」の説明を受け持っていた。github-dev-docsより source-codeより
Findings
#848 は dynamic hosting の CSP header 整備で、#820 は scope 外だった
PR #848 web apps に env-aware CSP header を追加 は 2026-05-21 に merge され、Issue #846 を close した。apps/admin と apps/public-viewer に env-aware な Content-Security-Policy header を追加し、共通の helper として apps/shared/csp.ts を新設している。ただし public-viewer の output: export では next.config.ts の headers() が no-op なので、その経路では header を空にし、static export 配信先での CSP 設定ガイド: #820 は scope 外と PR 本文に明記していた。#820 の本文も「Plotly の PNG download が img-src の blob: 不足でブロックされうる」「output: 'export' では headers() が効かないので、静的配信先での CSP 設定ガイドが必要」という整理だった。github-dev-docsより
静的配信先の CSP ガイドは PR #849 で追加された
PR #849(2026-05-21 merge、dca43694)が docs/deployment/static-hosting-csp.md(静的ホスティング向け CSP 設定ガイド)を追加し、README・deployment 系の docs・docs の index からリンクした。ガイドには Azure Static Web Apps(staticwebapp.config.json の globalHeaders)・Cloudflare Pages(_headers)・Nginx(add_header)の設定例と、Plotly の PNG download に必要な img-src blob: が書かれている。GitHub Pages はレスポンスヘッダーを細かく制御できないため、この用途には向かないとしている。#820 は #849 の merge と同時に close された。github-dev-docsより source-codeより
2026-06-01 に scattergl 用の script-src 'unsafe-eval' が追記された
PR #887(2026-06-01 merge)で、Plotly の scattergl(内部の regl が runtime eval を使う)が CSP によって初期化に失敗する問題に合わせて、ガイドの最低限の設定に script-src 'unsafe-eval' が加わった。経緯は issue-887-scattergl-csp-regression-2026-06-01。source-codeより
#818 と #820 は product 側の症状と docs 側の回避策の分担だった
#818(PNG でダウンロードボタンが死んでいる可能性)は Plotly PNG download が CSP によって壊れる product-side の symptom、#820 はそれを static hosting 上でどう回避するかの documentation / operations issue という分担だった。#818 も「dynamic hosting は #848、static hosting は #849 / #820 で解決経路が揃った」として、2026-05-21 に symptom 報告として close された。open-issues-snapshot-2026-05-19より github-dev-docsより
Open Questions
apps/shared/csp.tsを元に、ガイドのstaticwebapp.config.jsonなどの設定例を半自動生成できるか(2026-10-21 時点では、ガイドの例は docs に直接書かれていてcsp.tsとは連動していない)img-src blob:とscript-src 'unsafe-eval'のほかに、Plotly や reporter image の挙動次第でconnect-src/media-srcなども静的配信先ガイドに含めるべきか- static export 用の sample config(
staticwebapp.config.jsonなど)を repo に同梱するか(#820 は docs の追加で close した)
Updates
- 2026-05-21: 初版作成
- 2026-05-21:
PR #848merge とIssue #846close を反映し、dynamic hosting 向け fix が main に入った後も#820は docs gap として残ることを明記 - 2026-10-21: GitHub と main を照合して訂正。#820 は 2026-05-21 に PR #849 で close 済みで、初版が参照した
main@dca43694は #849 の merge commit そのもの(ガイドは既にあった)。#818 の close と #887 の追記を反映し、title・summary・本文・Open Questions を書き直した