---
title: "依存関係とサプライチェーンの管理"
description: "npm 11.11.0でlockfileからSBOMを作る最小例と結果の読み方を示します。脆弱性検査との使い分け、PyTorchの依存関係インシデント、配布版に結び付ける記録を説明します。"
canonical: https://knowledge.uniquex.co.jp/security/managing-dependencies-and-supply-chains
type: "解説"
kind: "guide"
answer: "依存関係は、部品名と版だけでなく取得元と配布版を結び付けて管理します。npmのSBOM生成は構成一覧、npm auditは既知の脆弱性、Dependency Review ActionはPRで増える依存の確認に使い分けます。ローカル例ではlockfileから部品一覧を生成し、期待する版との不一致を検出します。どの検査も単独では、悪意ある部品の不在や業務上の安全を保証しません。"
definitions: [{"term":"依存関係（dependency）","definition":"ソフトウェアが利用する別の部品との関係です。"},{"term":"直接依存","definition":"アプリが直接指定した部品への依存です。"},{"term":"間接依存","definition":"直接依存した部品の先で必要になる部品への依存です。"},{"term":"ソフトウェアサプライチェーン","definition":"依存する部品の開発、配布、取り込み、更新の経路です。"}]
domain: "security"
chapter: 7
section: "7.2"
keywords: ["依存関係","ソフトウェアサプライチェーン","SBOM","署名","パッケージハルシネーション"]
aliases: ["software supply chain","dependency management"]
entities: []
tags: ["supply-chain"]
sources: [{"title":"Secure Software Development Framework (SSDF) Version 1.1","author":"Murugiah Souppaya、Karen Scarfone、Donna Dodson","year":"2022","publisher":"NIST","version":"SP 800-218、2022年2月、PS.2・PS.3・PW.4.1・PW.4.4","url":"https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-218.pdf","accessed":"2026-10-09"},{"title":"SLSA Build: Verifying artifacts","author":"SLSA project","publisher":"SLSA / The Linux Foundation","version":"v1.2、Approved、How to verify の Step 1・Step 2","url":"https://slsa.dev/spec/v1.2/verifying-artifacts","accessed":"2026-10-09"},{"title":"We Have a Package for You! A Comprehensive Analysis of Package Hallucinations by Code Generating LLMs","author":"Joseph Spracklen、Raveen Wijewickrama、A H M Nazmus Sakib、Anindya Maiti、Bimal Viswanath、Murtuza Jadliwala","year":"2025","publisher":"USENIX Association","version":"34th USENIX Security Symposium、Abstract・Section 1 の定義・Section 7 の研究上の限界","url":"https://www.usenix.org/system/files/usenixsecurity25-spracklen.pdf","accessed":"2026-10-09"},{"title":"npm sbom","publisher":"npm CLI maintainers","version":"npm CLI v11.11.0固定タグ、Description・Package lock only mode","url":"https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-sbom.md","accessed":"2026-10-09"},{"title":"npm audit","publisher":"npm CLI maintainers","version":"npm CLI v11.11.0固定タグ、Description・Audit Signatures・Audit Endpoints・Exit Code","url":"https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-audit.md","accessed":"2026-10-09"},{"title":"Configuring the dependency review action","publisher":"GitHub Docs","version":"2026-10-09取得の更新型文書、導入条件・設定例、本文にdependency-review-action v4を表示","url":"https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configure-dependency-review-action","accessed":"2026-10-09"},{"title":"Compromised PyTorch-nightly dependency chain between December 25th and December 30th, 2022.","year":"2022","publisher":"PyTorch Foundation","version":"2022-12-31公表、対象期間・The Background・Steps taken towards mitigation","url":"https://pytorch.org/blog/compromised-nightly-dependency/","accessed":"2026-10-09"}]
author: "UNIQUEX 編集部"
reviewer: ""
published: 2026-10-09
updated: 2026-11-05
verified: 2026-10-09
---

# 依存関係とサプライチェーンの管理

> 依存関係は、部品名と版だけでなく取得元と配布版を結び付けて管理します。npmのSBOM生成は構成一覧、npm auditは既知の脆弱性、Dependency Review ActionはPRで増える依存の確認に使い分けます。ローカル例ではlockfileから部品一覧を生成し、期待する版との不一致を検出します。どの検査も単独では、悪意ある部品の不在や業務上の安全を保証しません。

## 定義

- **依存関係（dependency）**: ソフトウェアが利用する別の部品との関係です。
- **直接依存**: アプリが直接指定した部品への依存です。
- **間接依存**: 直接依存した部品の先で必要になる部品への依存です。
- **ソフトウェアサプライチェーン**: 依存する部品の開発、配布、取り込み、更新の経路です。

依存関係（dependency）は、ソフトウェアが利用する別の部品との関係です。たとえばNode.jsのアプリがデータ処理ライブラリを使い、そのライブラリがさらに別の部品を使います。アプリが直接指定したものが直接依存、その先で必要になるものが間接依存です。これらの開発・配布・取り込み・更新の経路をソフトウェアサプライチェーンと呼びます。

確認したいのは「同じ名前の部品があるか」だけではありません。どの版を、どこから取得し、どの配布物に含めたかを追える必要があります。以下のnpm例は、この確認のうち構成一覧の作成を学ぶための架空の入力です。所有者または管理者の許可を得たローカルの使い捨てディレクトリだけで実行し、実アプリの依存や秘密情報を持ち込みません。

## 調べる対象によるツールの使い分け [#調べる対象によるツールの使い分け]

構成一覧、既知の脆弱性、更新差分は別の問いです。npmを使うNode.jsプロジェクトを想定すると、次のように検査を分けられます。SBOM（Software Bill of Materials）は、部品と版などをまとめた構成一覧です。

| 手段と確認版 | 選ぶ理由と入力 | 結果の読み方と限界 |
|---|---|---|
| `npm sbom` 11.11.0 | npmのlockfileを使って構成を一覧化したい場合。今回の実測対象 | CycloneDXまたはSPDX形式の部品一覧。脆弱性の有無を判定する出力ではない |
| `npm audit` 11.11.0の公式文書 | lockfileに含まれる依存を、レジストリの既知の脆弱性情報と照合したい場合 | 問題の報告と終了コード。データベースに登録されていない問題や、業務での悪用可能性までは確定しない。今回は未実行 |
| GitHub Dependency Review Action、公式例のv4 | GitHubのPRで新しく入る依存を取り込み前に確認したい場合 | 依存差分や指定した深刻度・ライセンス条件によるcheck。既存の全依存を検査した結果ではない。今回は文書確認のみ |

npm標準のSBOM生成を選ぶ理由は、今回の入力がnpmのlockfileであり、追加のスキャナやサーバを導入せずに一覧を作れるからです。GitHubのActionはPRを起点に差分を見る用途に合います。実際に導入する場合は対象repositoryでdependency graphと利用可能な機能を確認し、Actionの固定版と必要な権限を別途決めます。この比較のためにrepository設定は変更していません（[npm sbom v11.11.0](https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-sbom.md)、[GitHub公式設定例](https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configure-dependency-review-action)）。

## lockfileだけで試す最小例 [#lockfileだけで試す最小例]

この実測は2026年10月9日、macOS arm64、Node.js 24.14.1、npm 11.11.0で行いました。`lodash@4.17.21`はnpm公式SBOM文書にも登場するライブラリの版ですが、ここでは入力を固定するための教材データです。この版の現在の採用を推奨するものではありません。ライブラリのダウンロードや実行、脆弱性データベースへの問い合わせは行いません。

空の作業ディレクトリに、次の二つのファイルを置きます。`package.json`は直接使いたい部品、`package-lock.json`は確定した依存の構成を表します。今回のlockfileは説明用に手で作った最小入力で、実際のインストール結果ではありません。

`package.json`:

```json
{
  "name": "kc-sbom-demo",
  "version": "1.0.0",
  "private": true,
  "dependencies": { "lodash": "4.17.21" }
}
```

`package-lock.json`:

```json
{
  "name": "kc-sbom-demo",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "kc-sbom-demo",
      "version": "1.0.0",
      "dependencies": { "lodash": "4.17.21" }
    },
    "node_modules/lodash": { "version": "4.17.21" }
  }
}
```

次のコマンドは同じ作業ディレクトリ内で実行します。設定ファイルとcacheの保存先もこの例専用にし、`--offline`でnpmのネットワーク利用を止めます。既存プロジェクトの設定ファイルを空にする操作ではありません。

```sh
: > user.npmrc
: > global.npmrc
npm sbom --sbom-format=cyclonedx --package-lock-only \
  --offline --ignore-scripts --cache .npm-cache \
  --userconfig ./user.npmrc --globalconfig ./global.npmrc > sbom.json
```

実測では終了コードは0でした。出力の`components`には`name: "lodash"`、`version: "4.17.21"`、`purl: "pkg:npm/lodash@4.17.21"`が入り、`dependencies`にはアプリからこの部品への参照が入りました。purlはパッケージの種類・名前・版を表す識別子です。生成日時や文書の識別子は実行ごとに変わり得るため、JSON全体の文字列一致を合否にしません。

ここで確かめたのは、入力の部品と版が構成一覧へ移ったことです。`--package-lock-only`は`node_modules`を調べず、lockfileの情報だけを使います。入力に書かれていない実ファイルの情報や、実配布物との一致をこの結果から補うことはできません。実アプリでは、配布に使ったlockfileと配布物を別途対応付けます（npm sbom v11.11.0、Package lock only mode）。

## 結果の不一致を失敗として扱う [#結果の不一致を失敗として扱う]

生成コマンドが成功しても、欲しい部品が含まれなければ受入は未完です。次を`verify-sbom.cjs`として保存すると、この教材で期待する部品一つと、その依存関係を検査できます。件数一つという条件はこの入力専用で、通常のアプリへそのまま適用しません。

```js
const assert = require('node:assert/strict');
const fs = require('node:fs');
const bom = JSON.parse(fs.readFileSync('sbom.json', 'utf8'));
assert.equal(bom.bomFormat, 'CycloneDX');
assert.equal(bom.components.length, 1);
const dependency = bom.components[0];
assert.equal(dependency.name, 'lodash');
assert.equal(dependency.version, '4.17.21');
const root = bom.dependencies.find(x => x.ref === 'kc-sbom-demo@1.0.0');
assert.deepEqual(root.dependsOn, [dependency['bom-ref']]);
console.log('構成一覧の期待値と一致');
```

```sh
node verify-sbom.cjs
```

正常な出力では「構成一覧の期待値と一致」と表示され、終了コードは0になります。保存した`sbom.json`の`components[0].version`だけを`0.0.0-fixture`へ変えた教材上の失敗例では、この検査は非0で終了しました。これは期待する版の不一致を見つける実測であり、悪意ある部品を検出した実験ではありません。JSONが壊れている場合や部品情報が欠けている場合も、検査失敗を「問題なし」と読み替えません。

図 7.2.1 構成一覧を作って確かめる流れでは、最小例の順序を示します。空の作業ディレクトリに package.json と package-lock.json を置き、npm sbom で構成一覧を作り、verify-sbom.cjs で期待する部品と版、依存関係に一致するか照合します。一致すれば検査は成功で、生成コマンドが成功しても一致しなければ受入は未完です。

![lockfile から構成一覧を作り、期待する部品と照合して、一致しなければ受入を未完とする流れ](https://knowledge.uniquex.co.jp/figures/sec-m-sbom-verify-flow.svg "図 7.2.1 構成一覧を作って確かめる流れ")

図 7.2.1 構成一覧を作って確かめる流れ

## 既知の脆弱性と出所の確認 [#既知の脆弱性と出所の確認]

構成一覧を作った後、通信先と送信する依存情報を確認してから、必要な検査を追加します。`npm audit --json --audit-level=high`は設定したレジストリへの通信を伴うコマンド例で、今回のローカル実測には含めません。`--audit-level=high`は終了コードを非0にする深刻度の下限を指定し、報告からlowやmoderateを消す指定ではありません。通信失敗と脆弱性検出は、終了コードだけでなくエラーやJSONの内容を読んで区別します（[npm audit v11.11.0、Description・Audit Endpoints・Exit Code](https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-audit.md)）。

署名の検証も別の確認です。npmの`audit signatures`は対応するレジストリの署名やprovenanceを検証します。provenanceは部品がどのソースや作成工程から得られたかをたどる情報です。今回このコマンドは実行していません。署名が有効でも、署名者を信用してよいか、部品の処理が業務に適切かという判断は残ります。

SLSA v1.2の検証ガイドは、署名に加え、対象ファイル、作成基盤、想定したソースや作成条件との照合を扱います。SBOMは構成の把握、署名とprovenanceは受け取った物や出所の確認に用い、どれか一つを全体の安全判定にしません（[SLSA v1.2、Verifying artifacts](https://slsa.dev/spec/v1.2/verifying-artifacts)）。

## 実インシデントから確認対象を決める [#実インシデントから確認対象を決める]

PyTorch Foundationは2022年12月31日、同月25日から30日にLinux上でpipからPyTorch-nightlyを導入した場合の依存関係インシデントを公表しました。公式説明では、nightly側で使っていた`torchtriton`と同名の部品がPyPIに置かれ、意図した提供元とは異なる物が取り込まれました。安定版PyTorchの利用者はこの事象の対象外とされています（[PyTorch公式報告、対象期間・The Background](https://pytorch.org/blog/compromised-nightly-dependency/)）。

報告された対応には、nightlyの依存を`pytorch-triton`へ置き換えること、同名を第三者に使われないための登録、影響を受けるnightly配布物の削除が含まれます。これは当事者が公表した対応であり、当サイトが環境を検査した結果や、被害が全件解消したとの確認ではありません。

この事例から依存管理に生かせる点は、名前と版の一覧に取得元を組み合わせることです。SBOMだけを見て同じ名前があると判断しても、意図した配布場所から得た証拠にはなりません。また「既知の脆弱性が0件」という出力も、取得元の取り違えや未知の悪意を否定する証拠にはなりません。公開された被害コードを再実行せず、対象期間、導入方法、配布元、当事者の対応を自分の管理記録と照合します。

## 採用から更新まで残す記録 [#採用から更新まで残す記録]

AIが提案したライブラリも、公式の文書と配布情報で実在・提供元・版・必要な機能を照合します。生成コードに存在しないパッケージが現れる問題は研究でも報告されていますが、研究対象外の現在のモデルに同じ発生率があるとは言えません。AIへ聞き直した返答だけを実在確認に使わず、見つからない名前を似た名前の部品へ自動置換しません（[Spracklenら、2025、Section 1・7](https://www.usenix.org/system/files/usenixsecurity25-spracklen.pdf)）。

実務の記録では、次を一組にします。これはNIST SSDF 1.1の部品評価・継続確認と配布物保存の観点に対応付けた独自の例です。一律の規格様式ではありません（[NIST SP 800-218、PW.4・PS.3](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-218.pdf)）。

| 記録 | 判断への使い方 |
|---|---|
| 部品名、固定版、公式の取得先、採用理由 | 同名の別部品や不要な追加を識別する |
| lockfileと配布物を識別する値、生成したSBOM | 調べた構成がどの配布版のものか対応付ける |
| 検査ツールの版、入力、日時、出力、未確認事項 | 検査失敗・問題の検出・検査していない範囲を分ける |
| 更新担当、変更理由、更新前後の試験結果 | 自動更新の提案を、用途への影響とともに判断する |

更新時は、部品が動くかだけでなく、入力処理、必要権限、失敗時の動作が変わっていないかを自分のアプリの試験で確認します。今回のSBOM教材の成功を、その試験や本番の検査に置き換えることはできません。

## 構成一覧と採用記録の差分を判断する [#構成一覧と採用記録の差分を判断する]

最小例の検査は部品一つの教材専用です。実アプリでは、生成した構成一覧を「採用から更新まで残す記録」の部品名と固定版に突き合わせ、差分の種類ごとに扱いを決めます。以下は運用例で、分類や扱いは一律の基準ではありません。

| 差分の種類 | 架空の例 | 判断の例 | 記録すること |
|---|---|---|---|
| 記録にない部品が一覧にある | 直接依存の更新で間接依存が増えた | 取得先と採用理由を確かめるまで受入を保留 | どの更新で入ったか |
| 記録にある部品が一覧にない | 削除した部品の記録が残っている | 記録の更新漏れか、lockfileの取り違えかを分ける | 照合したlockfileの識別値 |
| 名前は同じで版が違う | 固定版と一覧の版が異なる | 更新の判断記録と更新前後の試験結果を確認し、採用記録の固定版を更新して受入。不足があれば保留 | 更新担当、変更理由、更新後の固定版、試験結果 |
| 名前は同じで取得先が記録と違う | 社内の配布場所と公開レジストリが混在 | 同名の別部品の可能性として保留 | 照合した取得先と確認者 |

最後の行は、PyTorchの事例のように名前だけでは区別できない差分です。取得先をどの情報から読み取れるかは道具と入力によって異なるため、照合に使った情報源も記録します。保留が一件でも残る配布版は、「検査済み」として扱いません。


## 参考文献

- Murugiah Souppaya、Karen Scarfone、Donna Dodson. Secure Software Development Framework (SSDF) Version 1.1 (2022). NIST、SP 800-218、2022年2月、PS.2・PS.3・PW.4.1・PW.4.4. https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-218.pdf（参照日 2026-10-09）
- SLSA project. SLSA Build: Verifying artifacts. SLSA / The Linux Foundation、v1.2、Approved、How to verify の Step 1・Step 2. https://slsa.dev/spec/v1.2/verifying-artifacts（参照日 2026-10-09）
- Joseph Spracklen、Raveen Wijewickrama、A H M Nazmus Sakib、Anindya Maiti、Bimal Viswanath、Murtuza Jadliwala. We Have a Package for You! A Comprehensive Analysis of Package Hallucinations by Code Generating LLMs (2025). USENIX Association、34th USENIX Security Symposium、Abstract・Section 1 の定義・Section 7 の研究上の限界. https://www.usenix.org/system/files/usenixsecurity25-spracklen.pdf（参照日 2026-10-09）
- npm sbom. npm CLI maintainers、npm CLI v11.11.0固定タグ、Description・Package lock only mode. https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-sbom.md（参照日 2026-10-09）
- npm audit. npm CLI maintainers、npm CLI v11.11.0固定タグ、Description・Audit Signatures・Audit Endpoints・Exit Code. https://github.com/npm/cli/blob/v11.11.0/docs/lib/content/commands/npm-audit.md（参照日 2026-10-09）
- Configuring the dependency review action. GitHub Docs、2026-10-09取得の更新型文書、導入条件・設定例、本文にdependency-review-action v4を表示. https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configure-dependency-review-action（参照日 2026-10-09）
- Compromised PyTorch-nightly dependency chain between December 25th and December 30th, 2022. (2022). PyTorch Foundation、2022-12-31公表、対象期間・The Background・Steps taken towards mitigation. https://pytorch.org/blog/compromised-nightly-dependency/（参照日 2026-10-09）

## 更新履歴

- 2026-10-09: 初版。業務例と確認表は架空。実システム検査は行っていない。
- 2026-10-09: npm 11.11.0のローカルfixture、検査の使い分け、2022年PyTorch公式インシデント記録を追加。fixture以外の実環境・通信を伴う検査は行っていない。
- 2026-10-13: 用語集に定義を追加
- 2026-10-27: 実行環境の説明を整理。
- 2026-10-27: 日本語表現を校正し、助詞・語順・主語と述語の対応を改善
- 2026-10-28: 具体的な確認対象、判断の分岐、残す記録の例を追加。
- 2026-11-05: 本文と更新履歴の説明を簡潔化
