Repository navigation
ci(deploy): トークンを持つジョブが品質ゲートの成果物とキャッシュを信頼しないようにする - #35
Merged
Merged
Conversation
品質ゲートでは依存のコードが動くので、そこで保存されたストアの キャッシュは、トークンを持つジョブから見ると信頼できない。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
commented
Oct 14, 2026
kryota-dev
left a comment
Owner
Author
There was a problem hiding this comment.
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 と同じように設定を解釈できなければ成り立たない。そのため、方式を見直す(作者と相談する)。
拒否リストの検査は、検査側の 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
Owner
Author
|
review body にだけある指摘への対応です( 3d615fc 、 95089b5 )。
|
Wrangler はアセットを読むときにシンボリックリンクをたどる(stat の結果で isSymbolicLink を見ているので、判定が常に偽になる)。成果物にリンクが あれば、ランナーの上のファイルを公開されうるので、通常のファイルと ディレクトリ以外があれば止める。 ずれの検出のテストは、Wrangler 自身の読み込み関数で設定を読み、assets の設定も directory と binding 以外を比べる。配信するディレクトリが、 生成された設定と同じ場所を指すことも確かめる。 Refs #33
kryota-dev
commented
Oct 14, 2026
kryota-dev
left a comment
Owner
Author
There was a problem hiding this comment.
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 件。
Owner
Author
|
2 ラウンド目の指摘への対応です( b0d80ea )。
|
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
品質ゲート(依存のコードが動く)の成果物とキャッシュを、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をカレントディレクトリから読む。成果物からは置けないsrc/cache-save.ts:57)。lockfile が変わった run では、品質ゲートが保存したストアを、トークンを持つジョブが復元していた変更内容
wrangler.deploy.json(mainなし、assets.directory: ./dist/client、previews: {})を--configで渡す。--configを明示すると、Wrangler はビルドが書いた redirect を使わない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が現れないことを確かめる方式を変えた経緯
最初は成果物の設定を拒否リストで検査した(
ff87fba)。レビューで、__proto__によるパーサの違い(検査側のJSON.parseと Wrangler の JSONC パーサ)と、siteのentry-pointですり抜けられることが分かった(wrangler のソースと Node で裏取り済み)。Wrangler と同じように設定を解釈しない限り残る穴なので、検査をやめ、成果物の設定を使わない方式にした(3d615fc)。確認したこと
pnpm lint/pnpm format:check/pnpm checkが通る(ローカル)/・/privacy/・/robots.txtは 200、生成されたwrangler.json・.assetsignore・.dev.varsは 404previewジョブは setup-node のキャッシュを使っていない(ログで確認)。setup の所要時間は 13 秒で、キャッシュありの前回(18 秒)から増えていない手動の a11y チェック(画面に影響する変更のとき)
画面に影響しないので該当しない。
関連