第 7 章 開発工程への組み込み7.2

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

npm 11.11.0でlockfileからSBOMを作る最小例と結果の読み方を示します。脆弱性検査との使い分け、PyTorchの依存関係インシデント、配布版に結び付ける記録を説明します。

要点

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

定義

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

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

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

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

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

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

npm標準のSBOM生成を選ぶ理由は、今回の入力がnpmのlockfileであり、追加のスキャナやサーバを導入せずに一覧を作れるからです。GitHubのActionはPRを起点に差分を見る用途に合います。実際に導入する場合は対象repositoryでdependency graphと利用可能な機能を確認し、Actionの固定版と必要な権限を別途決めます。この比較のためにrepository設定は変更していません(npm sbom v11.11.0、GitHub公式設定例)。

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:

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

package-lock.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のネットワーク利用を止めます。既存プロジェクトの設定ファイルを空にする操作ではありません。

: > 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として保存すると、この教材で期待する部品一つと、その依存関係を検査できます。件数一つという条件はこの入力専用で、通常のアプリへそのまま適用しません。

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('構成一覧の期待値と一致');
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 から構成一覧を作り、期待する部品と照合して、一致しなければ受入を未完とする流れはいいいえ二つのファイルを置くnpm sbomで一覧を作る期待値と照合する期待値と一致するか検査は成功受入は未完
図 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)。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

自社での取り組みについて相談する

AI システムの権限・承認設計やセキュリティ対策について、株式会社UNIQUEX にご相談いただけます。

記事のタイトルと URL をお問い合わせフォームへ引き継ぎます。実現したいこと・困っていることをお書きください。

UNIQUEX に相談する