Skip to content

ci(deploy): トークンを持つジョブが品質ゲートの成果物とキャッシュを信頼しないようにする - #35

Merged
kryota-dev merged 5 commits into
mainfrom
fix/33-deploy-trust-boundary
Oct 14, 2026
Merged

kryota-dev merged 5 commits into
mainfrom
fix/33-deploy-trust-boundary

Conversation

@kryota-dev

@kryota-dev kryota-dev commented Oct 14, 2026 •

Copy link
Copy Markdown
Owner

概要

品質ゲート(依存のコードが動く)の成果物とキャッシュを、Cloudflare のトークンを持つジョブが信頼しないようにする。

#33 はキャッシュの汚染を検討する issue だったが、調査でより手前の経路が見つかった。成果物の Wrangler の設定に build.command があると、wrangler deploy がそれをトークンのある環境で実行する。方針と方式は #33 の調査とレビューの中で決めたので、着手前の確認は省いた。

closes #33

調査で分かったこと

  • 成果物の設定の経路(成り立つ): deploy / preview は、品質ゲートが上げた .wrangler/deploy/config.json と、それが指す dist/client/wrangler.json をそのまま使っていた。生成された設定に build.command を書くと、wrangler deploy が実行した(wrangler 4.148.0、--dry-run、トークンなし、無害な echo で手元で再現)
  • .env の経路(成り立たない): wrangler は .env をカレントディレクトリから読む。成果物からは置けない
  • キャッシュの経路(条件付きで成り立つ): setup-node は、キーが一致した run では保存しない(src/cache-save.ts:57)。lockfile が変わった run では、品質ゲートが保存したストアを、トークンを持つジョブが復元していた

変更内容

  • 成果物の設定を使わない: Wrangler には、リポジトリの wrangler.deploy.json(main なし、assets.directory: ./dist/client、previews: {})を --config で渡す。--config を明示すると、Wrangler はビルドが書いた redirect を使わない
  • 成果物は静的なファイルだけ: artifact は dist/client/ だけにした。runner.temp に展開してから dist/client にコピーするので、checkout したファイルを上書きされない。通常のファイルとディレクトリ以外(シンボリックリンクなど)があれば止める(Wrangler はアセットのシンボリックリンクをたどって読むため。cli.js:163142)
  • キャッシュ: .github/actions/setup に cache の入力を足した(既定は無効)。品質ゲートだけが有効にする。install-scripts と合わせて、true / false 以外の値は失敗させる
  • ずれの検出: tests/deploy-config.spec.ts が、Wrangler 自身の読み込み関数で設定を読み、wrangler.deploy.json が wrangler.jsonc の値(assets の directory・binding 以外を含む)を欠いていないこと、持っている値が生成された設定と同じであること、同じディレクトリを配信すること、ビルドが生成する設定に main / site が現れないことを確かめる
  • docs/deployment.md と AGENTS.md に、信頼の境界と限界(成果物の中身の改ざんは防げない)を書いた

方式を変えた経緯

最初は成果物の設定を拒否リストで検査した(ff87fba)。レビューで、__proto__ によるパーサの違い(検査側の JSON.parse と Wrangler の JSONC パーサ)と、site の entry-point ですり抜けられることが分かった(wrangler のソースと Node で裏取り済み)。Wrangler と同じように設定を解釈しない限り残る穴なので、検査をやめ、成果物の設定を使わない方式にした(3d615fc)。

確認したこと

  • pnpm lint / pnpm format:check / pnpm check が通る(ローカル)
  • CI の全項目が通る
  • Preview が新しい方式で作られ、配信後のヘッダーの検査が通る。/・/privacy/・/robots.txt は 200、生成された wrangler.json・.assetsignore・.dev.vars は 404
  • キャッシュ: preview ジョブは setup-node のキャッシュを使っていない(ログで確認)。setup の所要時間は 13 秒で、キャッシュありの前回(18 秒)から増えていない
  • マージ後: main で本番デプロイとヘッダーの検査が通る

手動の a11y チェック(画面に影響する変更のとき)

画面に影響しないので該当しない。

関連

品質ゲートでは依存のコードが動くので、そこで保存されたストアの
キャッシュは、トークンを持つジョブから見ると信頼できない。lockfile が
変わった run では、品質ゲートが保存したストアを、preview・deploy・
preview-cleanup が復元していた。

composite に cache の入力を足し、既定では使わない。品質ゲートだけが
"true" にする。setup-node の package-manager-cache も明示的に切る。
install-scripts と合わせて、true / false 以外の値は失敗させる。

Refs #33
成果物の Wrangler の設定に build.command があると、wrangler deploy が
それをトークンのある環境で実行する(--dry-run・トークンなしで再現)。
成果物は依存のコードが動く品質ゲートで作られるので、preview と deploy
は Wrangler を動かす前に scripts/check-deploy-config.mjs で検査する。

- redirect が dist/client/wrangler.json 以外を指す、知らないキーや
  auxiliaryWorkers を持つなら止める
- 生成された設定のトップレベルか env.<名前> に build・containers・
  main があれば止める

Wrangler は 51 個のキーを書き出し、版ごとに変わるので、許可リストでは
なく拒否リストにする。

Refs #33
@kryota-dev kryota-dev self-assigned this Oct 14, 2026
@kryota-dev
kryota-dev marked this pull request as ready for review October 14, 2026 07:06
@github-actions

github-actions Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

@kryota-dev kryota-dev left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Multi-Review 統合レビュー結果

総合評価

カテゴリ general(Codex, xhigh) typescript(Codex) test(Codex) security(subagent)
MUST 1 1 0 2
SHOULD 3 2 7 2
NITS 2 0 0 3
GOOD 1 2 2 5

leg ごとの件数で、重複を含む。統合後は MUST 2・SHOULD 5・NITS 4。

セキュリティ

  • 総合リスクレベル: High / 悪用できる経路: 2 件(どちらも、品質ゲートの依存が侵害されていることが前提。#33 と同じ)
  • キャッシュの停止は確実に効いている(pnpm/action-setup の cache は既定で false、setup-node の package-manager-cache: false)

[MUST]

  • scripts/check-deploy-config.mjs:68,76(4 leg すべて): __proto__ で拒否リストをすり抜けられる。検査側の JSON.parse は "__proto__" を普通のキーとして作るので、config.build は undefined に見える。一方 wrangler 4.148.0 の JSONC パーサは currentParent[currentProperty] = value(cli.js:2341)で代入するので、プロトタイプが差し替わる。その結果、rawEnv.build(cli.js:21127)が継承した build を拾い、custom build が動く。Node でこの違いを再現して確かめた(JSON.parse → build は undefined、代入 → build が見える)。containers と main も同じ方法ですり抜けられる
  • scripts/check-deploy-config.mjs:28(security・general): site で main の拒否を回避できる。getEntry は main が無くても site["entry-point"] をエントリにする(cli.js:199263)。トークンは盗めないが、「コードを持たない Worker」という前提が崩れる

[SHOULD]

  • .github/workflows/main.yml:37-40・pull-request.yml:53-56(security): download-artifact がワークスペースの直下に展開するので、artifact を差し替えられると、scripts/check-deploy-config.mjs 自体や node_modules も上書きできる(artifact を差し替える手順は未確認)。一時ディレクトリに展開し、必要なものだけを取り出す
  • scripts/check-deploy-config.mjs:86(general・test): prerender の設定を検査するかどうかが、redirect の prerenderWorkerConfigPath に左右される(ただし、このキーは deploy / preview では読まれない。security の確認)
  • scripts/check-deploy-config.mjs:56,75(general・typescript): JSON の型を検証していない。設定が [] や文字列でも、問題なしとして通る
  • 拒否リストは、wrangler の更新で漏れやすい(security)。name・routes・assets.directory などで、別の Worker やゾーンへの配信もできる
  • tests/deploy-config.spec.ts:45,123,129(3 leg): spawnSync にタイムアウトが無い。status === null も not.toBe(0) を満たしてしまう。既存の tests/static-checks.spec.ts の run に合わせる。攻撃の形(__proto__ を含む生の文字列、site、CLI の終了状態での redirect の拒否)と、composite の入力の検証のテストも足す

[NITS]

  • docs/deployment.md:33(general): 「auxiliaryWorkers を持つ」は「空でない」の誤り。null を許すことも書かれていない。14 行目の「エントリはアダプタのもの」とも食い違う
  • scripts/check-deployed-headers.mjs:13(security・範囲外): 期待値を成果物の _headers から読むので、侵害された成果物はヘッダーを弱めても検査を通る。spec でスコープ外とした「中身の改ざん」の一部。限界として文書に書く
  • preview environment に制限が無い(security・既存)

[GOOD]

  • キャッシュの停止と入力の検証の順序は、spec どおり(4 leg)
  • redirect のファイルは許可リストで検査し、パスも完全一致で比べている(security)
  • .env・API の送り先・prerenderWorkerConfigPath・auxiliaryWorkers は、成果物からは悪用できない(security が wrangler のソースで確認)
  • 一時ディレクトリの分離と後始末、今のビルドの出力での確認(test)

事実検証で棄却した指摘

なし。MUST の 2 件は、wrangler 4.148.0 のソース(cli.js:2341, 21127, 199263)と Node での再現で確かめた。

既存指摘との重複

既存のレビューは無い。除外は 0 件。

この後

拒否リストの方式は、wrangler と同じように設定を解釈できなければ成り立たない。そのため、方式を見直す(作者と相談する)。

Comment thread scripts/check-deploy-config.mjs Resolved
Comment thread scripts/check-deploy-config.mjs Resolved
Comment thread .github/workflows/main.yml Resolved
Comment thread tests/deploy-config.spec.ts Resolved
Comment thread .github/actions/setup/action.yml Resolved
拒否リストの検査は、検査側の JSON.parse と Wrangler の JSONC パーサで
"__proto__" の解釈が分かれるため、build.command を隠したまま通せた。
site の entry-point でも main の拒否を回避できた。どちらも Wrangler と
同じように設定を解釈しない限り残る穴なので、検査をやめる。

- Wrangler には wrangler.deploy.json(main なし、assets.directory は
  ./dist/client)を --config で渡す。--config を明示すると redirect は
  使われない
- 成果物は dist/client/ だけにし、runner.temp に展開してからコピーする。
  checkout したファイルを上書きされない
- wrangler.deploy.json と wrangler.jsonc のずれと、生成された設定に
  main / site が現れたことを tests/deploy-config.spec.ts で検出する

Refs #33
previews のブロックは wrangler.jsonc には無く、アダプタが生成する設定に
だけ入っていたので、wrangler preview が失敗した。

配信用の設定が持つ値が、生成された設定と同じであることもテストで
確かめる。生成された設定にだけあるキーが新たに必要になった場合は
このテストでは分からないので、そのことを文書に書く。

Refs #33
@kryota-dev

Copy link
Copy Markdown
Owner Author

review body にだけある指摘への対応です( 3d615fc 、 95089b5 )。

  • prerender の設定・JSON の型の検証・拒否リストの漏れ(name・routes・assets.directory など): 対応しました。成果物の設定を使わない方式に変えたので、どれも対象がなくなりました。name・routes などは、リポジトリの wrangler.deploy.json の値で配信されます。
  • 文書と実装の食い違い(docs/deployment.md): 対応しました。新しい方式に合わせて書き直しました。
  • 期待値を成果物の _headers から読む件: 対応しました(文書のみ)。成果物の中身の改ざんはこの方式でも防げないことを、限界として docs/deployment.md に書きました。
  • preview environment の制限: 対応不要と判断しました。この PR より前からある性質で、範囲外です。
  • 方式を変えた後の Preview でも、ページは 200、生成された wrangler.json・.assetsignore・.dev.vars は 404 になることを確かめました。

Wrangler はアセットを読むときにシンボリックリンクをたどる(stat の結果で
isSymbolicLink を見ているので、判定が常に偽になる)。成果物にリンクが
あれば、ランナーの上のファイルを公開されうるので、通常のファイルと
ディレクトリ以外があれば止める。

ずれの検出のテストは、Wrangler 自身の読み込み関数で設定を読み、assets
の設定も directory と binding 以外を比べる。配信するディレクトリが、
生成された設定と同じ場所を指すことも確かめる。

Refs #33

@kryota-dev kryota-dev left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Multi-Review 統合レビュー結果(2 ラウンド目)

方式を「成果物の設定を使わない」に変えた後の、3d615fc・95089b5 に対するレビュー。

総合評価

カテゴリ general(Codex, xhigh) security(subagent)
MUST 0 0
SHOULD 2 2
NITS 2 3
GOOD 3 2

セキュリティ

  • 総合リスクレベル: Low / 悪用できる経路: 0 件
  • --config を明示すると redirect と dist/client/wrangler.json の自動検出は使われず(cli.js:3524-3535)、main も site も無いので、成果物から Worker のコードを動かす経路は無い。_headers・_redirects は中身をそのまま API に送るだけで、手元では解析しない

[SHOULD]

  • .github/workflows/main.yml・pull-request.yml の「Take the static files」(security): Wrangler はアセットを読むときにシンボリックリンクをたどる。buildAssetManifest は fs.stat(リンクをたどる)の結果で isSymbolicLink() を見ているので、判定が常に偽になる(cli.js:163142 で確認)。今は artifact の展開でリンクが生まれないので悪用できないが、その一点に頼っている。コピーの前に、通常のファイルとディレクトリ以外を拒否する
  • tests/deploy-config.spec.ts(general): assets 全体を比較から外しているので、wrangler.jsonc に html_handling などを足しても、配信用の設定のずれを検出できない
  • tests/deploy-config.spec.ts:20(general): JSONC の簡易な読み方(行頭のコメントだけ除き、末尾のカンマを正規表現で消す)は、文字列の中の ,} を書き換え、行末やブロックのコメントで構文エラーになる
  • scripts/check-deployed-headers.mjs(security・範囲外): 期待値を成果物の _headers から読むので、ヘッダーの改ざんも通る(文書化済み)

[NITS]

  • main.yml:52(security): コメントの routes in wrangler.jsonc が古い
  • docs/deployment.md:35(general): 「.assetsignore にはアップロードから外すファイルしか書けない」は不正確(否定パターンで既定の除外を取り消せる)
  • spec の AC-003 に previews の例外が無い(general)
  • 品質ゲートのキャッシュに、侵害が残り続けうる(security・範囲外)
  • 成果物の .assetsignore で、生成された wrangler.json を公開できる(security。秘密は含まれない)

[GOOD]

  • 成果物の設定からコマンドを実行する経路は、切り離されている(general・security)
  • 配信するディレクトリと .assetsignore の扱いは、以前と同じ場所を指す(general)
  • トークンを持つ 3 つのジョブは、キャッシュを使っていない(general・security)

事実検証で棄却した指摘

なし。シンボリックリンクの指摘は cli.js:163142 で確かめた。

既存指摘との重複

1 ラウンド目の指摘は対応済みで、重複は 0 件。

@kryota-dev

Copy link
Copy Markdown
Owner Author

2 ラウンド目の指摘への対応です( b0d80ea )。

  • シンボリックリンク: 対応しました。コピーの前に find ! -type f ! -type d で、通常のファイルとディレクトリ以外があれば止めます。理由を docs/deployment.md に書きました。
  • assets のずれ: 対応しました。assets の設定も directory と binding 以外を比べ、配信するディレクトリが生成された設定と同じ場所を指すことも確かめます。
  • JSONC の読み方: 対応しました。Wrangler 自身の読み込み関数(experimental_readRawConfig)で読みます。依存を足さず、Wrangler と同じ解釈になります。
  • main.yml のコメント・.assetsignore の説明・spec の previews: 対応しました。
  • _headers を期待値にする件・品質ゲートのキャッシュに侵害が残る件・成果物の .assetsignore: 対応不要と判断しました。どれもコードの実行やトークンには届かず、成果物の中身の改ざんは範囲外として docs/deployment.md に書いてあります。

@kryota-dev
kryota-dev merged commit d8e9d3a into main Oct 14, 2026
6 checks passed
@kryota-dev
kryota-dev deleted the fix/33-deploy-trust-boundary branch October 14, 2026 08:06

This branch was successfully deployed

1 active deployment
preview — b0d80ea9 Deployed Oct 14, 2026 by kryota-dev via Delete the Preview #17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ci(deploy): トークンを持つジョブが pnpm のキャッシュを ci ジョブと共有しないようにするか検討する

1 participant