flawopen.com/リファレンス/Dependency Confusion

Dependency Confusion：パッケージ取得元の混同が起きる仕組み

Dependency Confusionの発生メカニズム

挙動はパッケージマネージャーと設定によって異なります。pipの公式文書は、プライベートな--index-urlと公開の--extra-index-urlの併用により、同名の公開パッケージが選ばれる可能性を警告しています。npmはscopeまたは既定設定でレジストリを選択し、常に公開版と非公開版を比較して大きい方を選ぶわけではありません。共通の原因は取得元方針の曖昧さです。スクリプトが有効なら、ビルドジョブの権限で実行されます。

[global]
index-url = https://packages.example.internal/simple
extra-index-url = https://pypi.org/simple

corp-auth-utils

@corp:registry=https://packages.example.internal/repository/npm/

{
  "dependencies": {
    "@corp/billing-engine": "1.2.0"
  }
}

Dependency Confusionの発生経路

• 1内部パッケージ名または名前空間が組織外に知られる。
• 2公開レジストリに同名のscopeなしパッケージが存在するか、そのレジストリが依存関係の取得元として許可されている。
• 3リゾルバーが意図しない取得元を選ぶ。ロックファイルがない、再生成される、または未審査で承認される場合、レビューで置換を見逃すことがあります。
• 4インストールやビルドのスクリプトが有効なら、パッケージコードはジョブの権限で実行されます。影響は認証情報、ネットワーク、隔離に左右され、root実行が必須というわけではありません。

エンジニアリング上の防御策

• ✓取得元方針を明確にする：組織所有のscopeや名前空間を使い、指定レジストリへルーティングし、非公開名が公開ソースへフォールバックしないようにします。Pythonでは非公開パッケージに--extra-index-urlを併用せず、管理されたプロキシまたは単一の権威ある索引を使います。
• ✓名前空間の所有権を管理する：レジストリが対応する場合は組織名を確保します。ただし名前の確保を解決方針の代わりにしてはいけません。内部名を一覧化し、公開レジストリでの衝突を監視します。
• ✓ロックファイルを審査して強制する：ロックファイルを管理し、CI向け固定インストールを使います（npmではnpm ci）。パッケージ名、レジストリURL、バージョン、integrity値の変更を確認してください。ロックファイルは再現性を高めますが、取得元が正規発行元である証明にはなりません。
• ✓ビルド実行を制限する：不要なら依存パッケージのスクリプトを無効にし、例外を審査します。短期間で最小権限の認証情報を使い、本番シークレットからビルドを隔離し、外向き通信を制限します。

参考資料

• pip install — package index and dependency-confusion warning
• npm docs — scopes and registry selection
• npm docs — npm ci
• npm docs — lifecycle scripts
• CWE-829 — Inclusion of Functionality from Untrusted Control Sphere
• CWE-1395 — Dependency on Vulnerable Third-Party Component