1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

個人開発で回せる依存パッケージの脆弱性対策(pnpm + Dependabot)

1
Posted at

はじめに

個人開発しているアプリ(pnpm のモノレポ・Next.js)で、何も対策しないまま pnpm audit を回したらこうなりました。

$ pnpm audit
...
204 vulnerabilities found
Severity: 17 low | 89 moderate | 85 high | 13 critical

ここから high 以上を 0 件にして、新しい脆弱性が出たら気づける状態まで持っていきました。この記事は、その設定と判断基準を 自分のリポジトリにそのまま取り入れられる形 でまとめたものです。

想定している読者と前提

  • GitHub で個人開発していて、依存の脆弱性を1人で管理したい人
  • パッケージマネージャーは pnpm 10.27 以降(1章の設定は pnpm だけのものです)
  • npm・yarn を使っている人も、3章(監査の CI)・4章(Dependabot)・5〜6章(例外の判断)の考え方はそのまま使えます

全体像:4つの役割に分けて考える

役割 やること 使うもの 章
予防 怪しい版を入れない pnpm の設定・版の固定 1
検知 high 以上が入ったら止める pnpm audit の CI 3
更新 直った版を取り込む Dependabot 4
例外 上げられない・直せないものを記録して見逃す dependabot.yml の ignore・auditConfig.ignoreGhsas 5・6

導入する順番

  1. 予防の設定を入れる(1章)
  2. 今ある脆弱性を減らす(2章)
  3. 監査の CI を入れる(3章)
  4. Dependabot を入れる(4章)

監査の CI を先に入れると、すべての PR が落ちます。 今ある脆弱性を減らしてから CI を入れるのがおすすめです。


1. 予防:pnpm の設定で怪しい版を入れない

設定例

pnpm-workspace.yaml(例)
minimumReleaseAge: 4320   # 公開から3日(分単位)たっていない版は入れない
trustPolicy: no-downgrade # 前の版より信頼度が下がった版(来歴の情報が消えたなど)は入れない
blockExoticSubdeps: true  # 配下の依存が git や tarball の URL から入るのを止める
savePrefix: ""            # pnpm add のとき ^ を付けない

minimumReleaseAge は、乗っ取られたパッケージの悪意ある版が公開されてから見つかって消されるまでの時間を稼ぐための設定です。

実際に起きた例:axios

2026年3月31日、axios の乗っ取りが起きました。

項目 内容
何が起きたか メンテナーの npm アカウントが乗っ取られ、悪意ある版が公開された
悪意ある版 1.14.1・0.30.4
中身 新しく足された依存 plain-crypto-js の postinstall スクリプトが、遠隔操作のマルウェアを入れる
消されるまで 約3時間

悪意ある版は、公開から数時間で見つかって消されています。被害にあったのは、その数時間のあいだにインストールした人です。

minimumReleaseAge を3日にしていれば、pnpm add axios や pnpm update を実行しても、公開されたばかりの 1.14.1 は選ばれません。その前の 1.14.0 が入るので、悪意ある版を避けられます。Dependabot の cooldown(4章)も同じ理由で、公開直後の版で PR を作らないようにしています。

axios の件では、悪意ある版で新しく足された依存の postinstall スクリプトがマルウェアを入れました。pnpm 10 以降は、依存の install スクリプトを初期設定で実行しません(許可したものだけ実行する)。minimumReleaseAge と合わせて二重の守りになります。

pnpm の版を確かめる

設定によって、使える pnpm の版が違います。

設定 使える版
minimumReleaseAge / minimumReleaseAgeExclude 10.16 / 10.19〜
trustPolicy / trustPolicyExclude 10.21〜
blockExoticSubdeps 10.26〜
trustPolicyIgnoreAfter 10.27〜

私の環境は pnpm 10.7.0 でした。古い pnpm では、これらの設定がエラーにならず黙って無視されるおそれがあります。 設定を書く前に pnpm --version を確かめ、package.json の packageManager で版を固定しておきましょう。

pnpm 11 以降は、これらの設定の多くが最初から有効になっています。

版の書き方のルール

ルール 理由
>= は使わない メジャー版まで範囲に入る
^ も付けずに固定する 版が変わるのを、Dependabot の PR か手作業のときだけにする
beta 版は特に固定する beta 同士でも壊れる変更が入る
例外:peerDependencies は範囲のまま(react: ^19) 使う側に版を選ばせるため

savePrefix: "" は 新しく足す依存にしか効きません。また pnpm update は、もともと書かれていた ^ を残したまま版を書き換えます。今ある ^ は手で外しましょう。


2. 今ある脆弱性を減らす

内訳を見る

pnpm audit の件数は「脆弱性の数 × 届く経路の数」です。同じ脆弱性でも経路が多いと件数が増えて見えるので、どのパッケージから来ているか で見ると全体がつかみやすくなります。

私の場合、204 件のほとんどは数個のパッケージから来ていました。

  • next 41 件
  • undici 32 件(jsdom の配下)
  • brace-expansion・minimatch・picomatch で約 25 件(ESLint まわりの配下)
  • vite・vitest で約 14 件
  • next-auth・@auth/core で 7 件(critical 3 件を含む)

どれも今のメジャー版のまま直る版が出ていたので、メジャー更新をせずに済みました。

直す順番

  1. 直接依存を上げる:まず今のメジャー版の中で最新に。これだけで 204 件 → 70 件になりました
  2. 配下の依存を上げる:pnpm update -r
  3. それでも上がらない配下の依存は overrides で版を指定する
pnpm-workspace.yaml
overrides:
  "vite@7": 7.3.7  # vitest の配下の Vite 7.3.1 に脆弱性。pnpm update では上がらなかった

"vite@7" のように対象をメジャー版で絞ると、意図しないメジャー版まで書き換えずに済みます。overrides は、元の依存が直ったら外します。

認証ライブラリ(next-auth など)を上げたときは、テストに加えて実際にログインして確かめました。

この時点で 2 件(どちらも moderate・開発用の依存)まで減りました。


3. 検知:監査の CI を入れる

方針

項目 決めたこと 理由
CI を落とす重大度 high 以上 moderate 以上にすると例外が増えすぎて、管理が形だけになるおそれ
moderate・low CI は落とさない Dependabot のセキュリティ更新の PR で片付ける
--prod 付けない 開発用の依存も、サプライチェーン攻撃の入り口になる
pnpm install しない pnpm audit は lockfile だけを読む。install スクリプトを実行せずに済む
回すタイミング 依存を変える PR・毎日・手動 新しく公開された脆弱性は、毎日の実行が拾う

重大度は一般的な深刻さで、自分のプロジェクトでの危なさとは別物です。
たとえば開発用の依存の high より、本番で使う依存の moderate のほうが実害を被る可能性が高いと考えられます。
本番に載る依存の脆弱性は、moderate以下でCIは通ったとしても、Dependabotを使って早めにマージしたほうがいいでしょう。

ワークフロー例

.github/workflows/dependencies-audit.yml(例)
name: dependencies-audit

on:
  pull_request:
  schedule:
    - cron: "0 19 * * *" # 毎日 UTC 19:00(JST 4:00)
  workflow_dispatch:

permissions:
  contents: read

jobs:
  changes:
    if: github.event_name == 'pull_request'
    runs-on: ubuntu-latest
    outputs:
      deps: ${{ steps.diff.outputs.deps }}
    steps:
      - uses: actions/checkout@<SHA> # vX.Y.Z
        with:
          fetch-depth: 2
      - id: diff
        run: |
          if git diff --name-only HEAD^1 HEAD | grep -qE '(^|/)(pnpm-lock\.yaml|pnpm-workspace\.yaml|package\.json)$|dependencies-audit\.yml$'; then
            echo "deps=true" >> "$GITHUB_OUTPUT"
          else
            echo "deps=false" >> "$GITHUB_OUTPUT"
          fi

  audit:
    name: pnpm audit # 必須チェックの名前になる。変えると「待ち」のまま止まる
    needs: changes
    if: ${{ !cancelled() && (github.event_name != 'pull_request' || needs.changes.outputs.deps == 'true') }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@<SHA> # vX.Y.Z
      - uses: pnpm/action-setup@<SHA> # vX.Y.Z(version は書かず packageManager を読ませる)
      - uses: actions/setup-node@<SHA> # vX.Y.Z(cache: pnpm は付けない)
      - run: pnpm audit --audit-level=high

ハマりどころ

① PR を依存の変更だけで絞るなら、paths ではなく if: を使う

on.pull_request.paths で絞ると、ワークフローが走らなかった PR では報告が無く、必須チェックが「Expected — Waiting」のまま残ります。依存と関係ない PR までマージできなくなります。

if: でスキップされたジョブは、必須チェックを満たします。 そのため、前段の changes ジョブで依存のファイルが変わったかを判定し、audit ジョブを if: でスキップしています。

かといって毎回回すと、新しい high が公開された日に、依存と関係ない急ぎの修正まで止まります。

② !cancelled() を忘れない

定期実行では changes がスキップされます。!cancelled() が無いと、needs でつながった audit まで一緒にスキップされます。

③ fetch-depth: 2 で足りる

PR では refs/pull/N/merge がチェックアウトされ、1つ目の親が main の先端です。HEAD^1 と比べれば PR の差分が分かります。

④ その他

  • pnpm/action-setup に version: を書かない。packageManager と2か所になり、食い違うと止まる
  • schedule はデフォルトブランチの上でしか動かない
  • ブランチ保護(ルールセット)の必須チェックに pnpm audit を足すのを忘れずに。足さないと「high を入れる PR はマージできない」が仕組みとして効かない

GitHub Actions はコミットの SHA で固定する

タグは付け替えられます(2025 年の tj-actions/changed-files の件 - 参考)。action もサプライチェーン攻撃の入り口なので、SHA で固定しておきます。

# タグから SHA を引く(注釈付きのタグでもコミットまでたどれる)
gh api repos/actions/checkout/commits/<タグ> --jq .sha
- uses: actions/checkout@<40桁のSHA> # vX.Y.Z

# vX.Y.Z のコメントは必須ではありませんが、SHA だと人間が判別しづらいため書いておくのがオススメです。Dependabot が SHA と # vX.Y.Z のコメントを一緒に更新してくれるので保守の手間もかかりません。ただし、タグから SHA への書き換えはしてくれない ので、最初は手作業が必要です。


4. 更新:Dependabot で直った版を取り込む

設定例

.github/dependabot.yml(例)
version: 2
updates:
  - package-ecosystem: npm
    directory: "/"
    schedule:
      interval: weekly
    cooldown:
      default-days: 3 # pnpm の minimumReleaseAge とそろえる
    groups:
      production-dependencies:
        dependency-type: production
        update-types: [minor, patch]
      development-dependencies:
        dependency-type: development
        update-types: [minor, patch]

  - package-ecosystem: github-actions
    directory: "/"
    schedule:
      interval: weekly
    cooldown:
      default-days: 3

ポイント

設定 決めたこと 理由
cooldown pnpm の minimumReleaseAge と同じ日数 Dependabot は pnpm の設定を見ない。そろえないと、公開直後の版で PR を作って install で失敗する
interval weekly 脆弱性の修正はセキュリティ更新がすぐ PR にしてくれる。版を固定しているとパッチ版ごとに PR が来るので、週1回で十分
groups 本番用・開発用ごとに、マイナー・パッチをまとめる PR の数を減らす
メジャー版 グループに入れず1つずつ 壊れたときに原因を切り分けやすい

セキュリティ更新は Settings で有効にする

脆弱性を直す PR(Dependabot security updates)は dependabot.yml ではなく、リポジトリの Settings → Advanced Security → Dependabot security updates で有効にします。yml だけ書いて満足しないように注意です。

ハマりどころ

① 公開から3日以内の修正版は install で止まる

Dependabot の cooldown はセキュリティ更新には効きませんが、pnpm の minimumReleaseAge は効きます。急いで入れたいときは minimumReleaseAgeExclude に 名前@版 で載せます。

pnpm-workspace.yaml(例)
minimumReleaseAgeExclude:
  - "<パッケージ名>@<版>" # 理由と、外す時期をコメントで書いておく

② 組で版をそろえるパッケージのメジャー版は、単独でマージしない

@mantine/notifications だけが 9 系になる PR が来て、テストがこう落ちました。

The requested module '@mantine/hooks' does not provide an export named 'useDrag'

@mantine/hooks・@mantine/core が 8 系のまま残ったためです。メジャー版を1つずつ PR にすると、組で上げるべきパッケージがばらけます。こういう PR は単独でマージせず、一式まとめて移行します(5章)。


5. 運用:メジャー版の PR を見送るとき

すぐには上げられない、または上げるべきでないメジャー版の PR も来ます。私の場合は次の3つでした。

  • TypeScript 5.9 → 7.0:依存するツールがまだ対応していない
  • @types/node 24 → 26:実行する Node(24)と合わない
  • Mantine 8 → 9:組で版をそろえるパッケージなので、1つだけ上げられない(4章の②)

除外は PR のコメントではなく dependabot.yml に書く

@dependabot ignore this major version とコメントしても除外できます。ただ、この除外は Dependabot の中にしか残らず、リポジトリからは見えません。半年後の自分が「なんでこの PR が来ないんだっけ?」とならないように、ファイルに 理由と外す条件 を書きます。

.github/dependabot.yml(例)
    ignore:
      # 実行する Node のメジャー版に合わせる。Node を上げるときに一緒に外す
      - dependency-name: "@types/node"
        update-types: ["version-update:semver-major"]
      # 7 は依存するツールがまだ対応していない。6.x は 7 への橋渡しなので受け取る
      - dependency-name: "typescript"
        versions: [">=7"]

update-types と versions を使い分ける

書き方 除外されるもの 向いている場面
update-types: ["version-update:semver-major"] すべての メジャー版 ずっと続くルール(@types/node を実行する Node に合わせる、など)
versions: [">=7"] 指定した範囲だけ 特定の版だけ避けたい(6.x は受け取りたい、など)

TypeScript を semver-major で除外すると、6.x の PR も来なくなります。

組で上げるパッケージは、まとめて除外してまとめて移行する

Mantine のように、パッケージ同士が 同じ版を peer に求める ものがあります。

パッケージ 9 系が peer に求めるもの
@mantine/core 同じ版の @mantine/hooks
@mantine/notifications 同じ版の @mantine/core・@mantine/hooks

Dependabot はメジャー版を1つずつ PR にするので、どの PR も単独では通りません。来るたびに閉じるのも手間なので、ワイルドカードで一式まとめて除外します。

.github/dependabot.yml(例)
    ignore:
      # core・hooks・notifications は同じ版を peer に求めるので、1つだけ上げられない。
      # 9 系へはまとめて手で移行する。移行したら外す
      - dependency-name: "@mantine/*"
        update-types: ["version-update:semver-major"]

移行するときは、手でまとめて上げます。

  1. 移行ガイドを読み、使っている API への影響を洗い出す
  2. 一式を 同じ版 に上げる(モノレポなら、pnpm の catalog で版を1か所にまとめておくと楽です)
  3. lint・型チェック・テストを通す
  4. 画面の見た目と操作を確かめる(UI ライブラリはテストだけでは気づきにくい)
  5. dependabot.yml の ignore から除外を外す

最後の手順を忘れると、次のメジャー版が出ても PR が来なくなります。移行の手順の中に入れておきましょう。

見送ってよいかの判断

見送る前に「古いままで危なくないか」を確かめます。見るのは次の2点です。

確認すること 見送りやすい 見送るなら注意
今の版に既知の脆弱性があるか 無い ある(セキュリティ更新が来るか、修正が今のメジャー版にも出るかを確かめる)
本番で外からの入力を処理するか しない(開発時だけ動くツールなど) する

TypeScript の場合は、tsc は開発時にしか動きません。型は実行前に消えますし、読むのも自分のコードだけです。なので、古いままにしても実質的なリスクは小さいと判断しました。

Mantine は本番で動く UI ライブラリですが、8 系に既知の脆弱性はありません。今のメジャー版のマイナー・パッチ版は Dependabot が引き続き PR にしてくれるので、メジャー版の移行は急がないと判断しました。

開発用のツールで気をつけるのは、版の古さよりもサプライチェーン攻撃です。これには 1章の minimumReleaseAge と 4章の cooldown で備えています。


6. 運用:修正版の無い high が出たとき

ある日、Dependabot の PR で pnpm audit が落ちました。同じ日の main の定期監査も落ちていました。原因は GHSA-fc5q-39xc-vjpf(picomatch <=4.0.7 の ReDoS)で、修正版はまだ出ていませんでした。

手順

1. PR が原因かを切り分ける

# main をチェックアウトした手元で
pnpm audit --audit-level=high

# 定期監査がいつから落ちているか
gh run list --workflow dependencies-audit.yml --event schedule

main でも落ちるなら、PR ではなく main の問題です。直す場所は main になります。

2. 脆弱性の中身を調べる

pnpm audit --json              # パッケージ・版・経路
gh api /advisories/<GHSA-ID>   # first_patched_version(修正版)と description(悪用の条件)
npm view <パッケージ> versions # 最新版が修正の範囲に入っていないか
  • Patched versions が <0.0.0 と出るのは「修正版が無い」という意味です
  • 「2 high」と出ても、同じアドバイザリが2つの経路で数えられているだけのことがあります

3. 自分のプロジェクトで悪用されうるかを評価する

確認すること 例外にしてよい 例外にしない
どこで動くか 開発用(lint・テスト・ビルド) 本番
攻撃者が入力を渡せるか 自分で書いた設定・コードからしか渡らない ユーザーの入力が届く

今回は lint の配下にしかなく、glob パターンも自分の設定からしか渡らないので、例外にしました。本番でユーザーの入力が届くなら、例外にせず、入力を制限するかライブラリを差し替えます。

4. main から切ったブランチで例外を載せる

Dependabot のブランチには直接コミットしません。

  • main の定期監査も落ちているので、直す場所は main
  • 手でコミットを足すと、Dependabot がそのブランチを更新しなくなる
pnpm-workspace.yaml
# pnpm audit で high 以上でも直せないものだけを GHSA の ID で載せ、理由・解消の条件・見直しの期限をコメントで書く
auditConfig:
  ignoreGhsas:
    # picomatch <=4.0.7 の ReDoS(細工した extglob で処理が極端に遅くなる)。修正版が無い(2026-11-18 時点で最新が 4.0.7)。
    # eslint-config-next の配下(開発用の lint)にしかなく、glob パターンは自分で書いた設定からしか渡らないため悪用されない。
    # 解消の条件: picomatch の修正版が出て、配下まで上がったら外す。見直しの期限: 2026-12-18
    - GHSA-fc5q-39xc-vjpf
  • パッケージ名ではなく GHSA の ID で載せる:同じパッケージの別の脆弱性まで一緒に見逃さないため
  • 理由・解消の条件・期限は行のコメントに書く:例外を外すときに、説明も一緒に消える
  • pnpm 11.15 以降は auditConfig.ignoreGhsas が audit.ignore に改名されています(旧名も次のメジャー版までは読まれます)

5. 手元で確かめる

  • pnpm audit --audit-level=high → 2 high (1 ignored) と出て、終了コードが 0
  • pnpm install --frozen-lockfile → lockfile は変わらない(auditConfig は lockfile に影響しない)

6. マージして、元の PR を回し直す

  1. 例外の PR を出す。pnpm-workspace.yaml を変えるので、この PR でも監査が走り、例外が効くことを確かめられる
  2. マージする
  3. 元の Dependabot の PR に @dependabot rebase とコメントして作り直させる

7. 期限の日に見直す

修正版が出ていれば上げて、ignoreGhsas から外します。修正版が出れば、Dependabot のセキュリティ更新でも気づけます。


まとめ

  • 対策は「予防・検知・更新・例外」の4つに分けて考えると、抜けが見つけやすい
  • pnpm の設定はバージョンによってまちまちなので、まず pnpm の現在の版を確かめる
  • Dependabot の cooldown と pnpm の minimumReleaseAge は日数をそろえる
  • 監査は high 以上で落とす。--prod は付けず、install もしない
  • 必須チェックにするなら、paths ではなく if: でジョブをスキップする
  • 例外は、リポジトリのファイルに、理由・外す条件・期限と一緒に書く
  • 直せない high は「どこで動くか」と「攻撃者が入力を渡せるか」で評価する

一度仕組みを作ってしまえば、ふだんは週1回 Dependabot の PR を見てマージするだけです。例外を判断するのも、たまにで済んでいます。audit の件数を見て固まってしまった人の参考になればうれしいです。

参考リンク

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?