Script shell pour détecter les indicateurs d'attaque de la chaîne d'approvisionnement npm TanStack (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Détecte les indicateurs de l'attaque de chaîne d'approvisionnement npm TanStack sur une machine de développeur, un dépôt ou un runner CI. Script Bash, image Docker et GitHub Action — même moteur, trois points d'entrée.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
Le 11 mai 2026, des attaquants ont publié 84 versions malveillantes réparties sur 42 paquets @tanstack/* via un empoisonnement du cache GitHub Actions. La charge utile dérobe des jetons GitHub, des jetons npm, des identifiants AWS/GCP/Azure, et installe un démon dead-man's switch qui efface ~/ dès que le jeton volé est révoqué.
Choisissez le point d'entrée correspondant à votre environnement.
TAG=v1.0.0
curl -fsSLO https://github.com/fabriziosalmi/tanstack-compromise-checker/releases/download/$TAG/check.sh
curl -fsSLO https://github.com/fabriziosalmi/tanstack-compromise-checker/releases/download/$TAG/check.sh.sha256
sha256sum -c check.sh.sha256
bash check.sh --online
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD":/scan \
ghcr.io/fabriziosalmi/tanstack-compromise-checker:1 \
/scan true fail tanstack-findings.json '' GHSA-g7cv-rxg3-hmpx
Le code de sortie 0 signifie que tout est propre, 2 signifie que des indicateurs de compromission ont été trouvés. Le JSON des résultats est écrit dans tanstack-findings.json dans le répertoire courant. --user permet au conteneur d'écrire ce fichier dans un répertoire appartenant à votre utilisateur ; sous Linux, sans cette option, l'analyse s'exécute toujours, mais le JSON ne peut pas être écrit. Dans PowerShell, où id n'existe pas, retirez l'option --user.
Les tags d'image ne portent pas de préfixe v : 1.2.1 pour une version exacte, 1 pour la dernière version 1.x (elle suit le tag d'Action v1), et latest.
L'image est multi-architecture (linux/amd64, linux/arm64) et est livrée avec une provenance de build signée via GitHub OIDC. Vérifiez avant d'exécuter :
gh attestation verify \
oci://ghcr.io/fabriziosalmi/tanstack-compromise-checker:1 \
--repo fabriziosalmi/tanstack-compromise-checker
permissions: {}
jobs:
check:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v6
with:
persist-credentials: false
- uses: fabriziosalmi/tanstack-compromise-checker@v1
with:
scan-dir: .
online: 'true'
fail-on: fail
Un workflow durci complet se trouve dans
.github/workflows/tanstack-check.yml
et correspond au même workflow que ce dépôt exécute sur lui-même.
| # | Vérification | Description |
|---|---|---|
| 1 | Dead-man's switch | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), unités systemd user + system (Linux), processus en cours d'exécution |
| 2 | Persistance | fichiers rc du shell, crontab utilisateur/système, /etc/cron.*, autostart XDG, core.hooksPath global de git |
| 3 | Identifiants | variables d'environnement sensibles, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, énumération des fichiers .env* |
| 4 | IOC réseau | processus node en cours d'exécution avec des connexions TCP sortantes établies (heuristique, revue manuelle) |
| 5 | Analyse du dépôt | dépendances déclarées dans package.json + versions épinglées dans le lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Installés | node_modules/@tanstack/*/package.json comparés à la liste des versions malveillantes connues, puis au registre npm time[<version>] lorsque --online |
| 7 | Indices Actions | .github/workflows/* analysés pour détecter pull_request_target, l'absence de --ignore-scripts, l'utilisation de actions/cache |
| 8 | IOC Mini Shai-Hulud | fichiers de payload dans node_modules (router_init.js, tanstack_runner.js), optionalDependency @tanstack/setup, altération de la configuration des outils d'IA, domaines C2 dans le code source, motifs de branches et d'auteurs de commits de l'attaquant, jetons npm marqués par une rançon, paquets secondaires propagés par le ver, ainsi que des heuristiques de niveau informationnel pour les formes de payload inconnues |
Avec --online, le script récupère également l'avis GHSA à l'exécution afin que
la couverture de détection suive l'état en direct de l'avis plutôt qu'une liste
de versions codée en dur.
Famille affectée : @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router, et
les paquets associés.
Familles saines (non affectées) : @tanstack/react-query,
@tanstack/react-table, @tanstack/react-virtual, @tanstack/form,
@tanstack/store.
# Quick check (current user's home)
bash check.sh
# Online mode: query the GHSA advisory and npm registry publish-time
bash check.sh --online
# Scan a specific directory
bash check.sh --scan-dir /path/to/your/repos
# JSON output for CI/SIEM integration
bash check.sh --json > findings.json
# Suggest pin commands for affected repos (dry-run)
bash check.sh --scan-dir /path/to/repos --fix
# Provide an extended known-bad list
bash check.sh --bad-versions-file ./extra-bad-versions.txt
| Option | Description |
|---|---|
--scan-dir DIR | Répertoire racine à analyser (par défaut : $HOME). Refuse d'analyser les répertoires système comme /, /etc, /usr. |
--online | Interroge l'avis GHSA et le champ time[<version>] du registre npm pour confirmer la compromission. Désactivé par défaut — sur opt-in. |
--ghsa GHSA-ID | Remplace l'ID d'avis utilisé avec --online (par défaut GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Remplace la fenêtre de publication utilisée avec --online. |
--fix | Affiche les commandes d'épinglage recommandées pour les dépôts affectés (dry-run par défaut). |
--apply | Avec --fix : opt-in pour l'exécution. Refuse toujours actuellement un update à l'aveugle ; un épinglage manuel est requis. |
--yes, -y | Ignore l'invite de confirmation pour --apply. |
--json | Émet les résultats au format JSON sur stdout (implique --quiet). |
--bad-versions-file F | Ajoute des entrées (pkg@version, une par ligne) à la liste des versions connues comme malveillantes. |
--no-color | Désactive les couleurs ANSI. |
--quiet, -q | Supprime la sortie par vérification, n'affiche que le résumé. |
-h, --help | Affiche l'aide. |
| Code | Signification |
|---|---|
| 0 | Propre — aucun indicateur dans le périmètre analysé |
| 1 | Avertissements uniquement — une revue est recommandée |
| 2 | Échecs — indicateurs de compromission présents |
| 3 | Erreur d'outil/d'utilisation |
Ce dépôt se défend contre la même classe d'attaque qu'il détecte. Concrètement :