đ đ GuardDog est un outil CLI pour identifier les paquets PyPI et npm malveillants.
GuardDog est un outil en ligne de commande qui identifie les paquets PyPI et npm malveillants, les modules Go, les crates Rust, les gems RubyGems, les actions GitHub ou les extensions VSCode. Il exécute une analyse statique sur le code source des paquets (via des rÚgles YARA) et analyse les métadonnées des paquets pour détecter les attaques de la chaßne d'approvisionnement.
Ce qui rend GuardDog diffĂ©rent : au lieu de simplement lister des motifs suspects, GuardDog corrĂšle les rĂ©sultats pour identifier les risques rĂ©els basĂ©s sur les chaĂźnes d'attaque. Un paquet doit possĂ©der Ă la fois la capacitĂ© d'effectuer une action (par exemple, l'accĂšs rĂ©seau) et un indicateur de menace (par exemple, un domaine suspect) dans le mĂȘme fichier pour ĂȘtre signalĂ© comme Ă haut risque.
Il télécharge et analyse le code de :

GuardDog utilise un modÚle de détection basé sur les risques qui corrÚle les capacités du code avec les indicateurs de menace :
Les outils SAST traditionnels signalent chaque motif suspect indépendamment, ce qui entraßne une fatigue d'alerte. GuardDog comprend que :
Les paquets reçoivent un score de 0-10 basé sur quatre facteurs :
| Facteur | Pondération | Description |
|---|---|---|
| Sévérité | 30 % | Résultat le plus sévÚre (faible/moyen/élevé) |
| ChaĂźne d'attaque | 20 % | PrĂ©sence d'Ă©tapes d'attaque complĂštes (prĂ©coce â intermĂ©diaire/tardive) |
| Spécificité | 30 % | Degré de spécificité des motifs aux logiciels malveillants par rapport au code légitime |
| Sophistication | 20 % | Niveau d'avancement des techniques |
Ătiquettes de score :
Ătapes de la chaĂźne d'attaque (basĂ©es sur MITRE ATT&CK) :
Le moyen le plus simple d'exécuter GuardDog est d'utiliser uvx :
uvx guarddog pypi scan requests
Pour l'installer localement :
uv tool install guarddog
# ou
pip install guarddog
Ou utilisez l'image Docker :
docker pull ghcr.io/datadog/guarddog
alias guarddog='docker run --rm ghcr.io/datadog/guarddog'
Remarque : Sous Windows, la seule méthode d'installation prise en charge est Docker.
# Analyse la version la plus récente du paquet 'requests'
guarddog pypi scan requests
# Analyse une version spécifique du paquet 'requests'
guarddog pypi scan requests --version 2.28.1
# Analyse le paquet 'request' en utilisant 2 heuristiques spécifiques
guarddog pypi scan requests --rules exec-base64 --rules code-execution
# Analyse le paquet 'requests' en utilisant toutes les rĂšgles sauf une
guarddog pypi scan requests --exclude-rules exec-base64
# Analyse une archive locale de paquet
guarddog pypi scan /tmp/triage.tar.gz
# Analyse un répertoire local de paquet
guarddog pypi scan /tmp/triage/
# Analyse un paquet stocké dans S3 (un dossier/préfixe ou un objet archive unique)
guarddog pypi scan s3://my-bucket/path/to/package/
guarddog pypi scan s3://my-bucket/path/to/package.tar.gz
# Analyse chaque paquet référencé dans un fichier requirements.txt d'un dossier local
guarddog pypi verify workspace/guarddog/requirements.txt
# Analyse chaque paquet référencé dans un fichier requirements.txt et génÚre un fichier sarif - fonctionne uniquement pour verify
guarddog pypi verify --output-format=sarif workspace/guarddog/requirements.txt
# Sortie JSON sur la sortie standard - fonctionne pour chaque commande
guarddog pypi scan requests --output-format=json
# Toutes les commandes fonctionnent également sur npm, go, crates, rubygems
guarddog npm scan express
guarddog go scan github.com/DataDog/dd-trace-go
guarddog go verify /tmp/repo/go.mod
# Analyse les crates Rust
guarddog crates scan serde
guarddog crates verify /tmp/repo/Cargo.lock
# Analyse les paquets RubyGems
guarddog rubygems scan rails
guarddog rubygems verify /tmp/repo/Gemfile.lock
# Peut également prendre en charge l'analyse des actions GitHub implémentées en JavaScript
guarddog github_action scan DataDog/synthetics-ci-github-action
guarddog github_action verify /tmp/repo/.github/workflows/main.yml
# Analyse les extensions VSCode du marketplace
guarddog extension scan ms-python.python
# Analyse une version spécifique d'une extension VSCode
guarddog extension scan ms-python.python --version 2023.20.0
# Analyse un répertoire local d'extension VSCode ou une archive VSIX
guarddog extension scan /tmp/my-extension/
# Exécute en mode débogage
guarddog --log-level debug npm scan express