Que fait Assistant d’Audit de Dépendances ?
Ce skill permet d’auditer les dépendances d’un projet à la recherche de vulnérabilités de sécurité, de paquets obsolètes et de problèmes de conformité des licences.
Quand Utiliser Ce Skill
- L’utilisateur demande un audit de dépendances ou une vérification de sécurité
- Avant des mises en production ou déploiements majeurs
- L’utilisateur s’interroge sur des paquets obsolètes ou des vulnérabilités
- Une revue de conformité des licences est nécessaire
- L’utilisateur mentionne « npm audit », « sécurité », « dépendances » ou « vulnérabilités »
Instructions
1. Détecter le Gestionnaire de Paquets
Identifier le(s) gestionnaire(s) de paquets utilisé(s) par le projet :
JavaScript/Node.js :
- npm :
package.json+package-lock.json - Yarn :
package.json+yarn.lock - pnpm :
package.json+pnpm-lock.yaml
Python :
- pip :
requirements.txtousetup.py - Poetry :
pyproject.toml+poetry.lock - Pipenv :
Pipfile+Pipfile.lock
Ruby :
- Bundler :
Gemfile+Gemfile.lock
Java :
- Maven :
pom.xml - Gradle :
build.gradleoubuild.gradle.kts
Go :
- Modules Go :
go.mod+go.sum
Rust :
- Cargo :
Cargo.toml+Cargo.lock
PHP :
- Composer :
composer.json+composer.lock
Utiliser Glob pour trouver ces fichiers.
2. Exécuter l’Audit de Sécurité
Lancer la commande d’audit appropriée selon le gestionnaire de paquets :
npm : npm audit --json ou npm audit
Yarn : yarn audit --json ou yarn audit
pnpm : pnpm audit --json
pip : pip-audit ou 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
Analyser la sortie pour identifier :
- Nombre de vulnérabilités par sévérité (critique, élevée, modérée, faible)
- Paquets et versions affectés
- Correctifs disponibles (mises à jour ou correctifs)
- Identifiants CVE
3. Vérifier les Paquets Obsolètes
Identifier les paquets ayant des versions plus récentes :
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
Catégoriser les mises à jour :
- Mise à jour de correctif (1.0.0 → 1.0.1) : Corrections de bugs, sans risque
- Mise à jour mineure (1.0.0 → 1.1.0) : Nouvelles fonctionnalités, généralement sans risque
- Mise à jour majeure (1.0.0 → 2.0.0) : Changements cassants, nécessite des tests
4. Vérification de la Conformité des Licences
Examiner les licences de toutes les dépendances :
Étapes :
- Extraire les licences des métadonnées des paquets
- Identifier les types de licences (MIT, Apache-2.0, GPL, etc.)
- Signaler les licences potentiellement problématiques (GPL, AGPL dans les projets commerciaux)
- Vérifier les licences manquantes ou inconnues
- Consulter la matrice de compatibilité des licences dans
reference/licenses.md
Outils :
- npm :
npx license-checker --jsonounpm-license-crawler - Python :
pip-licenses - Ruby :
license_finder - Go :
go-licenses
Catégories de licences :
- Permissives : MIT, Apache-2.0, BSD – Généralement sans risque
- Copyleft faible : LGPL, MPL – Nécessite une revue
- Copyleft fort : GPL, AGPL – Peut restreindre l’usage commercial
- Inconnues : Licences manquantes ou personnalisées – Nécessite une investigation
5. Analyser l’Arbre des Dépendances
Comprendre la structure des dépendances :
Directes vs Transitives :
- Directes : Listées dans package.json/requirements.txt
- Transitives : Dépendances des dépendances
Identifier les problèmes :
- Paquets en double à différentes versions
- Arbres de dépendances profonds (risque de conflits)
- Paquets abandonnés (pas de mise à jour depuis >2 ans)
- Dépendances transitives à haut risque
Commandes :
- npm :
npm ls --all - Yarn :
yarn why <paquet> - pip :
pipdeptree - Maven :
mvn dependency:tree
6. Prioriser les Vulnérabilités
Prioriser les vulnérabilités en fonction de :
Niveaux de sévérité :
- Critique : Exécution de code à distance, élévation de privilèges
- Élevée : Injection SQL, XSS, contournement d’authentification
- Modérée : Déni de service, divulgation d’informations
- Faible : Problèmes mineurs, cas particuliers
Exploitabilité :
- Exploits connus en production
- Preuve de concept (PoC) disponible
- Nécessite des conditions particulières
Exposition :
- Dépendances de production vs dépendances de développement
- Dépendances directes vs transitives profondes
- Chemins de code réellement utilisés dans l’application
7. Générer des Recommandations
Pour chaque problème trouvé, fournir :
Vulnérabilités :
Paquet : [email protected]
Sévérité : Élevée
CVE : CVE-2020-8203
Problème : Pollution du prototype
Recommandation : Mettre à niveau vers [email protected] ou supérieur
Commande : npm install [email protected]
Paquets obsolètes :
Paquet : [email protected]
Actuel : 16.14.0
Dernier : 18.2.0
Type : Mise à jour majeure
Recommandation : Tester minutieusement avant la mise à niveau (changements cassants)
Notes : Consulter le guide de migration à https://react.dev/blog/2022/03/08/react-18-upgrade-guide
Problèmes de licence :
Paquet : [email protected]
Licence : GPL-3.0
Problème : La licence GPL peut entrer en conflit avec du code propriétaire
Recommandation : Trouver une alternative avec une licence permissive ou consulter un juriste
Alternatives : [liste de paquets similaires avec licences MIT/Apache]
8. Stratégie de Mise à Jour
Suggérer une approche de mise à jour :
Mises à jour sûres (automatiques) :
- Mises à jour de correctif sans changements cassants
- Correctifs de sécurité pour les vulnérabilités
- Commande :
npm updateounpm audit fix
Mises à jour prudentes (tests manuels) :
- Incrémentations de version mineure
- Mises à jour majeures de paquets bien maintenus
- Mettre à jour individuellement et tester
Recherche nécessaire :
- Changements cassants majeurs
- Paquets abandonnés (trouver des alternatives)
- Conflits de licences
9. Générer un Rapport de Synthèse
Fournir un résumé d’audit complet :
Rapport d’Audit des Dépendances
===============================
Vue d’ensemble :
- Total des dépendances : 150 (120 directes, 30 transitives)
- Vulnérabilités : 5 (1 élevée, 3 modérées, 1 faible)
- Paquets obsolètes : 23
- Problèmes de licence : 2
Vulnérabilités de sécurité :
[Liste par sévérité avec recommandations de correction]
Paquets obsolètes :
[Catégorisés par type de mise à jour : correctif/mineur/majeur]
Conformité des licences :
[Liste des licences avec points d’attention]
Actions recommandées :
1. [Immédiat] Corriger les vulnérabilités de sévérité élevée
2. [Bientôt] Mettre à jour les paquets avec des vulnérabilités modérées
3. [Réviser] Traiter les problèmes de conformité des licences
4. [Optionnel] Mettre à jour les paquets obsolètes vers la dernière version
Commandes à exécuter :
npm audit fix # Corriger automatiquement les vulnérabilités
npm update # Mettre à jour vers les dernières versions compatibles
10. Surveillance Continue
Suggérer des pratiques de suivi :
- Audits automatisés : Lancer dans le pipeline CI/CD
- Dependabot/Renovate : Créer automatiquement des PR pour les mises à jour
- Revues régulières : Audits mensuels ou trimestriels
- Alertes de sécurité : Activer les alertes de sécurité GitHub/GitLab
- Fichiers de verrouillage : Commiter les lock files pour des builds reproductibles
Bonnes Pratiques
- Corriger rapidement les vulnérabilités : Surtout celles de sévérité élevée/critique
- Tester les mises à jour : Même les correctifs peuvent causer des problèmes
- Lire les changelogs : Comprendre ce qui a changé avant de mettre à jour
- Utiliser les lock files : Garantir des installations cohérentes entre les environnements
- Minimiser les dépendances : Moins de dépendances = surface d’attaque réduite
- Vérifier les nouveaux ajouts : Auditer avant d’ajouter de nouvelles dépendances
- Rester à jour : Les mises à jour régulières sont plus faciles que les grands sauts
- Documenter les décisions : Pourquoi certains paquets sont épinglés ou non mis à jour
Bonnes Pratiques de Sécurité
- Ne jamais commettre de secrets dans les dépendances ou les fichiers d’environnement
- Examiner le code source des dépendances pour les paquets populaires/critiques
- Utiliser des registres privés pour les paquets internes
- Activer l’authentification à deux facteurs (2FA) sur les comptes de registre de paquets
- Utiliser SRI (Subresource Integrity) pour les ressources CDN
- Scanner les images conteneur si Docker est utilisé
Fichiers d’Appui
scripts/check-licenses.sh: Extraire et vérifier les informations de licencereference/licenses.md: Matrice de compatibilité des licencesreference/common-vulnerabilities.md: Modèles de vulnérabilités courantes
Référence des Commandes Courantes
npm :
npm audit # Afficher les vulnérabilités
npm audit fix # Corriger automatiquement les vulnérabilités
npm audit fix --force # Forcer les mises à jour majeures
npm outdated # Vérifier les paquets obsolètes
npm update # Mettre à jour vers la dernière version compatible
Yarn :
yarn audit # Afficher les vulnérabilités
yarn upgrade-interactive # Mise à jour interactive
yarn outdated # Vérifier les paquets obsolètes
pip :
pip-audit # Auditer les vulnérabilités
pip list --outdated # Vérifier les paquets obsolètes
pip install --upgrade # Mettre à jour un paquet
Poetry :
poetry check # Vérifier le fichier de verrouillage
poetry show --outdated # Afficher les paquets obsolètes
poetry update # Mettre à jour les paquets
Cargo :
cargo audit # Auditer les vulnérabilités
cargo outdated # Vérifier les paquets obsolètes
cargo update # Mettre à jour les paquets