GitHub Actionsでpnpmの脆弱性アドバイザリをパッチする — Dependabotが直せない推移的依存を、GitHub Appのトークンで

Dependabotはpnpmの推移的依存を更新できません。それをパッチするGitHub Actionを作った話と、認証情報の選択が設計全体を決めた理由。

更新

白いカードに青いロボットの頭部と、その下に小文字のdependabotロゴタイプ。頭部は白いバイザーに丸い目が二つ、短いアンテナと四角い耳を持つ
目次

はじめに

Dependabotがこのブログのリポジトリに対して重大度「High」のセキュリティアドバイザリを4件報告したのですが、なぜセキュリティパッチのプルリクエストを出してくれないのだろうと疑問に思いました。脆弱なパッケージが推移的依存で、Dependabotがバージョンを上げられないからではないかと推測しました。

推測は当たっていて、しかも理由は構造的なものでした。Dependabotはpnpmの推移的依存の更新を一切サポートしていません。npmを使っていれば、この問題自体が起きなかったはずです。放っておけば、アラートは永遠に開いたままになっていました。

Claudeのルーチンを含めていくつかの方法を試しましたが、最後にたどり着いたのはGitHub Appのボットにスケジュール実行でパッチを当てさせる形でした。この記事では、調査の経緯と、最終的な判断がどう決まったかを扱います。

リポジトリのDependabotアラート画面をis:closedで絞り込んだところ。Openが0件、Closedが6件。fast-uriのアドバイザリ4件が前日にfixedとしてクローズされ、さらにnanoidとpath-to-regexpが3週間前にfixedとしてクローズされている。すべての行がHighと表示され、検出元はpnpm-lock.yaml

fast-uriのアドバイザリ4件が前日にfixedとしてクローズされ、さらにnanoidとpath-to-regexpが3週間前にfixedとしてクローズされています。そのすべてがpnpm-lock.yamlで検知されました。

Dependabotがプルリクエストを一度も出さなかった理由

セキュリティアップデートを有効にしていても、Dependabotはpnpmの推移的依存にパッチを当てられません。

ターミナルウィンドウ
入力
gh api repos/oharu121/<repo-name>/automated-security-fixes
出力
{"enabled":true,"paused":false}

このコマンドで、セキュリティ機能自体は有効だと確認できます。それにもかかわらず、Dependabotが出したセキュリティ用のプルリクエストはゼロ件でした。過去にあった2件の推移的依存のアラート、nanoidとpath-to-regexpは、どちらも手動でパッチを当てていました。

原因はpnpmであって、推移的依存そのものではありません。dependabot-core#13177はオープンなままで、Dependabotはpnpmの推移的依存の更新をサポートしていないというエラーを出します。その裏ではpnpm#12744が、pnpm update <dep>@<version>が推移的依存に対してはno-opであることを記録しており、これはDependabotのアップデーターが実行しているまさにそのコマンドです。

同じ更新が npm では届き、pnpm では止まる1 つの Dependabot セキュリティ更新が 2 つの列に分かれます。npm の列では修正版を許容する親のバージョンを探し、親と子をまとめて更新してプルリクエストを作成します。pnpm の列では pnpm update dep@version を実行しますが、推移的依存に対しては何も起きないため、アラートは開いたままでプルリクエストは作成されません。Dependabot のセキュリティ更新npm修正版を許容する親のバージョンを探す親と子をまとめて更新プルリクエストが作成される修正済みpnpmpnpm updatedep@version を実行推移的依存には無効アラートは開いたまま届かない
npmでは、Dependabotは修正済みの子パッケージに届くよう親のバージョンを上げます。pnpmの経路はアップデーター自身のコマンドで止まり、何も起きません。

リポジトリにはすでに直し方があった

pnpm updateは推移的依存に対してno-opなので、これでは直らないことが分かりました。このリポジトリが以前に採用していた直し方は、オーバーライドでした。

pnpm-workspace.yaml
overrides:
nanoid@<3.3.18: ^3.3.18
path-to-regexp@<6.3.0: ^6.3.0

オーバーライドはpnpm-workspace.yamlの中にあります。ここで意味を持つのはすべてコロンの左側で、2つの書き方は正反対にふるまいます。

書き方何にマッチするか寿命
nanoid@<3.3.18: ^3.3.183.3.18より下の解決結果だけツリーが3.3.18を超えると無効になる
nanoid: ^3.3.18ツリー内のすべてのnanoid、永久に永続

キーは名前ではなくセレクタです。範囲をキーにした形は、パッチ済みバージョンより下に解決されるものが残っている間だけ効き、その後は自然に効力を失います。一方、名前だけの形は依存を永久にピン留めするので、正当な理由でnanoid 4.xを必要とするパッケージが現れた日に、それが3.xへ引き戻されて壊れます。

最初の試み: Claudeクラウドセッションのスケジュール実行

クラウドルーチンの編集ダイアログ。名前は「pnpm transitive advisory patcher」。指示には、Dependabotが修正できない推移的依存のアドバイザリを探し、それらにパッチを当てるプルリクエストを開くよう書かれており、背景としてdependabot-core#13177が引用され、直接依存は無視するよう指示されている。対象リポジトリはoharu121/oharu-tech-blog、モデルはSonnet 5で、毎日10:07 JSTに実行される設定になっている

設定された状態の最初の試み。日次で動くクラウドセッションに、調査手順のすべてを散文で書き下したもの。

動作自体はうまくいきました。最初の実行で、範囲をキーとした正しいオーバーライドと、既存のファイルのスタイルに合わせたコメントブロック、そして調査結果を正確に書き写した本文を持つプルリクエストが出ました。かかった時間はおよそ15分でした。

ただ、ひとつ気になることがありました。インストールのたびに、こう表示するのです。

[WARN] Unsupported engine: wanted: {"node":">=24"} (current: {"node":"v22.22.2","pnpm":"11.3.0"})

クラウドの環境はNode 22で動いており、リポジトリが要求しているのは>=24です。つまり、そこでpnpm checkとpnpm buildが緑になっても、それは本番とは別のランタイムでの結果にすぎず、CIが同じコマンドを再実行するまでは、その検証自体を信用できませんでした。

そして、私は設計を変えることになる問いを投げました。本当にAIが必要なのか、それとも完全に機械的にできるのか?

ステップ人間の判断が必要か
pnpm audit --jsonを実行する不要
package.jsonに宣言済みのパッケージをスキップする不要、単なる参照
アドバイザリからpkg@<X: ^Xを導く不要、バージョンはJSONの1フィールド
オーバーライドを書き、install、check、buildする不要
プルリクエストの本文を書く不要、audit結果をそのまま書き写すだけ
ランタイムのオーバーライドに経路検証が必要かどうかを判断する必要
解決しないオーバーライドを診断する必要

判断が必要な2つは稀にしか起きず、この設計はそもそもエージェントがどちらにも直接手を出すことを許していませんでした。つまり、めったに来ない例外に備えて待機するためだけに、エージェントは毎日事務的な作業をこなしていたことになります。しかも、その例外が来たとしても結局エスカレーションしていたはずです。

ワークフローの動き

上の表の「不要」の行はすべてadvisory-patch.ymlのステップになり、「必要」の2行はエスカレーションになりました。

  1. 依存をインストールする。リポジトリが実際に解決するツリーに対してauditを走らせるためです。
  2. 検出して適用する。advisory-patch.tsがpnpm audit --jsonを読み、package.jsonに宣言済みのものをスキップし、アドバイザリからpkg@<X: ^Xを導いてpnpm-workspace.yamlに書き込み、installします。
  3. 判断が必要なものをエスカレーションする。プルリクエストではなくIssueとして起票します。これが「必要」の2行、つまりランタイムスコープのアドバイザリと、解決しない、あるいはアドバイザリをもうカバーしていないオーバーライドです。
  4. パッチを検証する。再度auditを実行し、オーバーライドが効いたことを確認します。
  5. プルリクエストを開く。本文はauditのフィールドをそのまま書き写したものです。

検出ステップと検証ステップはどちらも同じclassify()という関数を呼んでおり、機械的な判断はすべてこの関数の中で行われます。この関数は監査対象の各パッケージを4つの判定に順番に通し、パッチする・エスカレーションする・何もしない、の3つのいずれかに振り分けます。

classify() が監査対象のパッケージを振り分ける流れアドバイザリを持つパッケージが、4 つの判定を順番に通ります。直接依存は Dependabot の担当としてスキップされます。override に既に名前があるのにアドバイザリが残っているパッケージは、override の範囲が古くて解消できていないので、人間向けの Issue になります。patched の範囲を解釈できないアドバイザリは、人間向けの Issue になります。ランタイムコードに届くパッケージも、人間向けの Issue になります。残ったものが、範囲でキー付けした override を書くという計画になります。--verify を付けて実行すると override の判定だけが無効になり、残る 3 つの判定はそのまま働きます。対象は、その実行でパッチを当てたパッケージだけです。pnpm audit --jsonアドバイザリを持つパッケージ直接依存か?スキップDependabot の担当既に override があるか?Issueoverride の範囲が古いpatched 範囲が読めないか?Issue人間の判断が必要ランタイムに届くか?Issueランタイムスコープ--verifyはこの判定を飛ばす計画pkg@<X: ^X を書く
順番が意味を持ちます。直接依存はオーバーライドの判定まで届かず、読み取れないpatched範囲はランタイムスコープの判定まで届きません。

fast-uriのように1つのパッケージが4件のアドバイザリを抱えている場合、オーバーライドは4件すべてを一度に解消しなければならないので、classify()はグループ内で最初に読んだものではなく最も高いパッチ済みバージョンを採用します。

判定の並びを変えて呼び出すのはステップ4だけで、その理由はオーバーライドの判定にあります。

ステップ4が走る時点で、ステップ2はすでにこのパッケージをpnpm-workspace.yamlに書き込んでいます。そのため、この判定はステップ4がまさに問い合わせているパッケージを取り除いてしまい、pnpm installが実際に何を解決したかに関わらず、ステップ4は「異常なし」と報告します。

スクリプトを--verifyで実行するとオーバーライドの判定だけが無効になり、残る3つはそのまま働きます。さらにこのモードでは検出ステップのレポートを読み、そのステップがパッチしたパッケージだけをチェックします。

ワークフローを動かす認証情報が重要になる理由

ここではGitHub Actionのほうが明らかにClaudeのクラウドセッションより優れています。CIと同じNODE_VERSION: "24"で動くので検証結果をそのまま信用でき、数秒で終わり、ロジックはpnpm checkが型チェックする.tsファイルの中にあるので誰でもローカルで実行できます。

CIがチェックする対象のプルリクエストは、このワークフロー自身が開かなければなりません。そして GITHUB_TOKENによるpushはワークフロー実行を一切トリガーしません。プルリクエスト自体は開きますが、チェックの実行は始まりません。GitHubがこれを止めているのは、pushで起動するワークフローが自分自身を再トリガーしてループしないようにするためです。

このリポジトリの自動マージのワークフローはすでにGITHUB_TOKENで動いていますが、この問題は起きません。CIの上流ではなく下流にいるからです。

作る側には固有の ID が要り、受け取る側には要らない左から右へ、プルリクエスト、CI 実行、判定、マージと並ぶ流れです。アドバイザリ修正ボットはプルリクエストより上流にあり、そのイベント自体を作る必要があります。ここで GITHUB_TOKEN を使うとチェックが一切走りません。自動マージは判定より下流にあり、結果を受け取るだけなので、GITHUB_TOKEN による push は無害です。プルリクエストCI 実行判定マージアドバイザリ修正ボットイベントを作る側上流自動マージ判定を受け取る側下流ここで GITHUB_TOKEN:チェックが一切走らないここで GITHUB_TOKEN:無害、作業は完了済み
自動マージはCIがすでに出した判定を受け取るだけなので、自分のpushがワークフローを起動しなくても困りません。アドバイザリ修正ボットは上流にいて、CIが反応するイベントそのものを作らなければなりません。

DependabotはGITHUB_TOKENではなく独立したアプリのIDを持つため、この再帰防止のガードから除外されています。だからこそDependabotのプルリクエストにはチェックが走ります。ここで踏襲すべきなのは、まさにこのパターンです。

個人アクセストークン(PAT)は私自身のIDを借りるため、author.loginでは自動化と私自身を区別できず、自動マージのゲートは誰でも入力できるブランチ名の一致に頼るしかありませんでした。

最終的に落ち着いた形: GitHub App

GitHub Appはそれ自身のIDを持つことでこれを解決します。インストール用のトークンは実行ごとに発行され、ジョブが終わると失効するので、マージのゲートは再び本来の権限確認になります。

GitHub Appの公開ページ。名前はOharu Advisory Patcher。pnpmでDependabotがパッチできない推移的依存のアドバイザリに対してプルリクエストを開く、という説明と、このAppを取り消すと自動化が止まるという注記が書かれている

この説明は半年後にこのページを見つける人に向けて書かれています。取り消したときに何が止まるのかという一文も含めて。

セットアップのほとんどは、GitHubの設定画面で行います。

  1. Appを登録する。Settings → Developer settings → GitHub Appsから、Contents・Pull requests・Issuesの書き込み権限を付与します。
  2. 秘密鍵を生成する。.pemファイルがダウンロードされ、手に入るのは1部だけです。
  3. リポジトリにインストールする。登録とインストールは別の行為で、登録済みでもインストールされていないAppは最初のAPI呼び出しで失敗します。
  4. リポジトリシークレットを2つ追加する。AppのClient IDと、ヘッダー行・フッター行を含む.pem全体です。

Oharu Advisory PatcherのGitHub Appインストールページ。アカウントoharu121に対して、グレーアウトしたInstalledボタンと設定用の歯車が表示されている

リポジトリへのインストール。グレーアウトしたInstalledボタンは、このAppが単に存在するだけでなく、このリポジトリに対して動ける状態になったことを示しています。

この2つのシークレットをワークフローが使うのは、後続のすべてのステップが使うトークンを発行する1つのステップだけです。

.github/workflows/advisory-patch.yml
permissions:
contents: read
jobs:
patch:
runs-on: ubuntu-latest
steps:
- uses: actions/create-github-app-token@v3.2.0
id: app-token
with:
client-id: ${{ secrets.ADVISORY_APP_CLIENT_ID }}
private-key: ${{ secrets.ADVISORY_APP_PRIVATE_KEY }}
permission-contents: write
permission-pull-requests: write
permission-issues: write
- uses: actions/checkout@v7
with:
token: ${{ steps.app-token.outputs.token }}

このスニペットで間違えやすい点は次のとおりです。

  1. app-idではなく client-id です。v3では古い入力が非推奨とされています。
  2. ワークフローレベルのpermissionsはcontents: readのままにします。書き込みスコープはAppのトークン側に属するからです。ここに書けば、どのステップも使わないGITHUB_TOKENに権限を与えてしまいます。
  3. checkoutにはトークンを明示的に渡さなければなりません。デフォルトはGITHUB_TOKENだからです。デフォルトのままにすると、後続のpushがCIの実行をトリガーしません。

出荷したもの

このワークフローは毎日10:17 JSTに動きます。何もない日はinstallとauditを実行し、何も見つからなければ1分ほどで終了します。

2026年9月5日、この記事の冒頭と同じfast-uriのアドバイザリを検出し、オーバーライドを書き、Node 24で検証し、プルリクエストを開きました。自動マージがそれを受け入れてsquashし、誰もリポジトリに触れていません。

「fix(deps): patch fast-uri advisory」というタイトルのプルリクエスト272。Mergedと表示され、github-actions botがブランチfix/advisory-dev-fast-uriからmainへマージしている。コメントの投稿者はoharu-advisory-patcherで、Botのラベルが付いている

作成者はAppで、マージしたのは自動マージのワークフローです。この2つのIDを分けることこそ、認証情報を選んだ目的でした。

最初のエスカレーションで見えたこと

2026年10月3日、このワークフローはプルリクエストではなく初めてIssueを起票しました。対象はhttp-cache-semantics(GHSA-ch52-4w7c-c8xp)で、あるユーザーのキャッシュされたレスポンスを別のユーザーに漏らしうるキャッシュの脆弱性です。

GitHubのIssue 338。タイトルは「chore(deps): transitive advisories needing review」で、oharu-advisory-patcherが起票し、botのバッジが付いている。本文には、scripts/advisory-patch.tsが自動ではパッチしないアドバイザリを見つけたと書かれている。続いてhttp-cache-semantics, runtime-scopedという見出しの下に、本番コードで新しいバージョンを強制するのは挙動の変更だという説明と、すべてastroを経由する4つの解決経路が並んでいる

どの経路も本番の依存であるastroを経由しています。ワークフローがこれをランタイムスコープと判定したのはそのためです。

ランタイムの判定が見ているのは、コードではなく依存グラフです。astroの中でhttp-cache-semanticsをimportしているファイルはassets/build/remote.jsだけで、これはastro buildの間にリモート画像をキャッシュするものです。ビルドには、レスポンスが漏れる先となる2人目のユーザーがいません。パッチ済みのリリースも存在しないため、Dependabotのアラートは許容できるリスクとして却下し、その理由を書いてIssueを閉じました。

同じ実行には、Issueまで届かなかった2つ目のアドバイザリもありました。fast-uriに新しいアドバイザリGHSA-hrr3-gc8f-f4qjが出ており、3.1.8で修正されています。2026年9月5日にワークフローが書いたオーバーライドはfast-uri@<3.1.6: ^3.1.6で、インストール済みの3.1.7はすでにこれを満たしていました。そしてオーバーライドの判定は、このパッケージを名前だけでスキップしていました。

skip fast-uri: already carries an override
ESCALATE http-cache-semantics: runtime-scoped

オーバーライド済みのパッケージにアドバイザリが残っているなら、そのオーバーライドは低すぎます。pnpm auditはインストール済みのツリーを読むので、オーバーライドがアドバイザリをカバーしていれば、そのアドバイザリはレポートから消えているはずです。

この判定はスキップせずにエスカレーションするように変え、fast-uriのオーバーライドは手動で^3.1.8に引き上げました。ランタイムの判定は引き続き効くので、アドバイザリが本番コードに届くオーバーライド済みパッケージは、Issueでもその警告を保ちます。

scripts/advisory-patch.ts
if (overridden.has(name) && !ignoreOverridden) {
skipped.push(`${name}: already carries an override`);
const runtime = !group.flatMap((a) => a.findings).every((f) => f.dev === true);
escalations.push({
name,
reason: runtime
? "existing override does not clear it, runtime-scoped"
: "existing override does not clear it",
detail, // 各アドバイザリのpatched範囲と解決パス
});
continue;
}

検証ステップにも、反対側から同じ死角がありました。--verifyはすべてのパッケージについてオーバーライドの判定を無効にしていたので、どこかに古いオーバーライドが1つあるだけで、別のものをパッチしたばかりの実行が失敗します。しかも、効かなかったパッケージとしてその古いパッケージの名前を挙げてしまいます。

現在は、検出ステップがすでに書き出しているレポートを読み、その実行自身がパッチしたパッケージだけをチェックします。

.github/workflows/advisory-patch.yml
node scripts/advisory-patch.ts --verify --out "$RUNNER_TEMP/after.json"
node scripts/advisory-patch.ts --verify "$RUNNER_TEMP/advisory.json" --out "$RUNNER_TEMP/after.json"
scripts/advisory-patch.ts
const report = JSON.parse(readFileSync(reportFile, "utf8")) as Report;
verifyNames = new Set(report.patched.map((p) => p.name));
const advisories = Object.values(readAudit()).filter(
(a) => verifyNames === null || verifyNames.has(a.module_name),
);

まとめ

Dependabotはpnpmの推移的依存の更新を一切サポートしていない、ということが分かりました。だからDependabotは私のリポジトリでセキュリティ用のプルリクエストを一度も出さなかったのです。

GITHUB_TOKENによるpushはワークフロー実行をトリガーしません。だからワークフローを起動するには、GITHUB_TOKENとは別の認証情報が必要になります。

最初のエスカレーションでは、ワークフロー自体の穴が2つ見つかりました。オーバーライド済みのパッケージを、オーバーライドが低すぎると報告せずにスキップしていた判定と、実際に動くコードではなく依存グラフをたどるランタイムの判定です。

GitHub Appは、このケースに合う認証情報でした。自分自身のIDを持ち、トークンは実行ごとに発行されます。GitHub Appを作ったのは初めてで、今後もっと掘ってみたいと思っています。

参考リンク

この記事をシェア