依存関係監査アシスタント
このスキルは、プロジェクトの依存関係について、セキュリティ脆弱性、古いパッケージ、ライセンス準拠の問題を監査するのに役立ちます。
このスキルを使用するタイミング
- ユーザーが依存関係の監査やセキュリティチェックを依頼した場合
- メジャーリリースやデプロイ前
- ユーザーが古いパッケージや脆弱性について尋ねた場合
- ライセンス準拠のレビューが必要な場合
- ユーザーが「npm audit」「security」「dependencies」「vulnerabilities」に言及した場合
手順
1. パッケージマネージャーの検出
プロジェクトが使用しているパッケージマネージャーを特定します。
JavaScript/Node.js:
- npm:
package.json+package-lock.json - Yarn:
package.json+yarn.lock - pnpm:
package.json+pnpm-lock.yaml
Python:
- pip:
requirements.txtまたはsetup.py - Poetry:
pyproject.toml+poetry.lock - Pipenv:
Pipfile+Pipfile.lock
Ruby:
- Bundler:
Gemfile+Gemfile.lock
Java:
- Maven:
pom.xml - Gradle:
build.gradleまたはbuild.gradle.kts
Go:
- Go modules:
go.mod+go.sum
Rust:
- Cargo:
Cargo.toml+Cargo.lock
PHP:
- Composer:
composer.json+composer.lock
これらのファイルを検索するには Glob を使用します。
2. セキュリティ監査の実行
パッケージマネージャーに応じて、適切な監査コマンドを実行します。
npm: npm audit --json または npm audit
Yarn: yarn audit --json または yarn audit
pnpm: pnpm audit --json
pip: pip-audit または safety check
Poetry: poetry check
Bundler: bundle audit check --update
Maven: mvn dependency:tree + OWASP Dependency Check
Go: go list -m all + govulncheck
Cargo: cargo audit
Composer: composer audit
出力を解析して、以下を特定します。
- 深刻度別の脆弱性の数(クリティカル、高、中、低)
- 影響を受けるパッケージとバージョン
- 利用可能な修正(アップデートまたはパッチ)
- CVE 識別子
3. 古いパッケージの確認
新しいバージョンが利用可能なパッケージを特定します。
npm: npm outdated --json
Yarn: yarn outdated --json
pip: pip list --outdated
Poetry: poetry show --outdated
Bundler: bundle outdated
Cargo: cargo outdated
Go: go list -u -m all
アップデートを分類します。
- パッチアップデート (1.0.0 → 1.0.1): バグ修正、安全に更新可能
- マイナーバージョンアップ (1.0.0 → 1.1.0): 新機能、通常は安全
- メジャーバージョンアップ (1.0.0 → 2.0.0): 互換性のない変更、テストが必要
4. ライセンス準拠のチェック
すべての依存関係のライセンスをレビューします。
手順:
- パッケージメタデータからライセンスを抽出
- ライセンスタイプを識別(MIT、Apache-2.0、GPL など)
- 問題の可能性があるライセンスをフラグ付け(商用プロジェクトにおける GPL、AGPL)
- 無ライセンスまたは不明なライセンスをチェック
reference/licenses.mdのライセンス互換性マトリックスを参照
ツール:
- npm:
npx license-checker --jsonまたはnpm-license-crawler - Python:
pip-licenses - Ruby:
license_finder - Go:
go-licenses
ライセンスカテゴリ:
- 寛容型: MIT、Apache-2.0、BSD - 通常は安全
- 弱いコピーレフト: LGPL、MPL - レビューが必要
- 強いコピーレフト: GPL、AGPL - 商用利用を制限する可能性あり
- 不明: ライセンスなし、またはカスタムライセンス - 調査が必要
5. 依存関係ツリーの分析
依存関係の構造を理解します。
直接依存 vs 推移的依存:
- 直接: package.json/requirements.txt にリストされている
- 推移的: 依存関係の依存関係
問題の特定:
- 異なるバージョンで重複しているパッケージ
- 深い依存関係ツリー(競合の可能性)
- 放置されたパッケージ(2年以上更新がない)
- リスクの高い推移的依存関係
コマンド:
- npm:
npm ls --all - Yarn:
yarn why <package> - pip:
pipdeptree - Maven:
mvn dependency:tree
6. 脆弱性の優先順位付け
以下に基づいて脆弱性の優先順位を付けます。
深刻度レベル:
- クリティカル: リモートコード実行、権限昇格
- 高: SQL インジェクション、XSS、認証バイパス
- 中: DoS、情報漏洩
- 低: 軽微な問題、エッジケース
悪用可能性:
- 既知の悪用が実際に行われている
- PoC(概念実証)が利用可能
- 特別な条件が必要
露出:
- 本番依存関係 vs 開発依存関係
- 直接依存関係 vs 深い推移的依存関係
- アプリケーションで実際に使用されているコードパス
7. 推奨事項の生成
見つかった各問題に対して、以下を提供します。
脆弱性:
パッケージ: [email protected]
深刻度: 高
CVE: CVE-2020-8203
問題: プロトタイプ汚染
推奨: [email protected] 以上にアップグレード
コマンド: npm install [email protected]
古いパッケージ:
パッケージ: [email protected]
現在: 16.14.0
最新: 18.2.0
タイプ: メジャーアップデート
推奨: アップグレード前に十分テストしてください(互換性のない変更あり)
注意: マイグレーションガイドは https://react.dev/blog/2022/03/08/react-18-upgrade-guide を参照
ライセンス問題:
パッケージ: [email protected]
ライセンス: GPL-3.0
問題: GPL ライセンスがプロプライエタリコードと競合する可能性があります
推奨: 寛容型ライセンスの代替品を探すか、法務に相談してください
代替案: [MIT/Apache ライセンスの類似パッケージリスト]
8. アップデート戦略
アップデートアプローチを提案します。
安全なアップデート(自動化):
- 互換性のない変更のないパッチアップデート
- 脆弱性に対するセキュリティ修正
- アップデート:
npm updateまたはnpm audit fix
注意が必要なアップデート(手動テスト):
- マイナーバージョンアップ
- 十分にメンテナンスされているパッケージへのメジャーアップデート
- 個別にアップデートしてテスト
調査が必要:
- メジャーな互換性のない変更
- 放棄されたパッケージ(代替品を探す)
- ライセンスの競合
9. サマリーレポートの生成
包括的な監査サマリーを提供します。
依存関係監査レポート
=======================
概要:
- 依存関係の総数: 150 (120 直接, 30 推移的)
- 脆弱性: 5 (高 1, 中 3, 低 1)
- 古いパッケージ: 23
- ライセンス問題: 2
セキュリティ脆弱性:
[深刻度順に修正推奨事項をリスト]
古いパッケージ:
[アップデートタイプ別に分類: パッチ/マイナー/メジャー]
ライセンス準拠:
[懸念事項とともにライセンスをリスト]
推奨アクション:
1. [即時] 高深刻度の脆弱性を修正
2. [近日中] 中程度の脆弱性があるパッケージを更新
3. [レビュー] ライセンス準拠の問題に対処
4. [任意] 古いパッケージを最新に更新
実行するコマンド:
npm audit fix # 脆弱性を自動修正
npm update # 互換性のある最新バージョンに更新
10. 継続的モニタリング
継続的なプラクティスを提案します。
- 自動監査: CI/CD パイプラインで実行
- Dependabot/Renovate: アップデートの PR を自動作成
- 定期的なレビュー: 月次または四半期ごとの監査
- セキュリティアラート: GitHub/GitLab のセキュリティアラートを有効化
- ロックファイル: 再現可能なビルドのためにロックファイルをコミット
ベストプラクティス
- 脆弱性は迅速に修正: 特に高/クリティカルな深刻度のもの
- アップデートをテスト: パッチアップデートでも問題が発生する可能性あり
- チェンジログを読む: アップデート前に変更内容を理解する
- ロックファイルを使用: 環境間で一貫したインストールを保証
- 依存関係を最小限に: 依存関係が少ないほど攻撃対象領域が小さい
- 新しい追加をレビュー: 新しい依存関係を追加する前に監査
- 最新を保つ: 定期的なアップデートは大規模なジャンプより簡単
- 決定事項を文書化: 特定のパッケージを固定または更新しない理由
セキュリティのベストプラクティス
- 依存関係や環境ファイルにシークレットをコミットしない
- 人気/クリティカルなパッケージの依存関係ソースコードをレビュー
- 内部パッケージにはプライベートレジストリを使用
- パッケージレジストリアカウントで 2FA を有効化
- CDN リソースには SRI(Subresource Integrity)を使用
- Docker を使用している場合はコンテナイメージをスキャン
サポートファイル
scripts/check-licenses.sh: ライセンス情報を抽出して確認reference/licenses.md: ライセンス互換性マトリックスreference/common-vulnerabilities.md: 一般的な脆弱性パターン
一般的なコマンドリファレンス
npm:
npm audit # 脆弱性を表示
npm audit fix # 脆弱性を自動修正
npm audit fix --force # メジャーアップデートを強制
npm outdated # 古いパッケージを確認
npm update # 互換性のある最新バージョンに更新
Yarn:
yarn audit # 脆弱性を表示
yarn upgrade-interactive # 対話形式でアップグレード
yarn outdated # 古いパッケージを確認
pip:
pip-audit # 脆弱性を監査
pip list --outdated # 古いパッケージを確認
pip install --upgrade # パッケージを更新
Poetry:
poetry check # ロックファイルをチェック
poetry show --outdated # 古いパッケージを表示
poetry update # パッケージを更新
Cargo:
cargo audit # 脆弱性を監査
cargo outdated # 古いパッケージを確認
cargo update # パッケージを更新