Script de shell para detectar indicadores de ataque a la cadena de suministro de TanStack npm (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Detecta indicadores del ataque a la cadena de suministro de npm de TanStack en una máquina de desarrollador, un repositorio o un runner de CI. Script de Bash, imagen de Docker y GitHub Action — el mismo motor, tres puntos de entrada.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
El 11 de mayo de 2026, los atacantes publicaron 84 versiones maliciosas en 42 paquetes @tanstack/* mediante envenenamiento de caché de GitHub Actions. El payload roba tokens de GitHub, tokens de npm, credenciales de AWS/GCP/Azure e instala un daemon de dead-man's switch que borra ~/ en el momento en que se revoca el token robado.
Elige el punto de entrada que coincida con tu entorno.
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
El código de salida 0 significa limpio, 2 significa que se encontraron indicadores de compromiso. El JSON de hallazgos se escribe en tanstack-findings.json en el directorio actual.
--user permite que el contenedor escriba ese archivo en un directorio propiedad de tu
usuario; en Linux sin él, el escaneo se ejecuta igual, pero el JSON no se puede escribir.
En PowerShell, donde id no existe, omite la opción --user.
Las etiquetas de imagen no llevan el prefijo v: 1.2.1 para una versión exacta, 1 para la
última versión 1.x (se mueve con la etiqueta de Action v1), y latest.
La imagen es multiarquitectura (linux/amd64, linux/arm64) e incluye procedencia de compilación
firmada mediante GitHub OIDC. Verifica antes de ejecutar:
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 flujo de trabajo endurecido completo se encuentra en
.github/workflows/tanstack-check.yml
y es el mismo flujo de trabajo que este repositorio ejecuta contra sí mismo.
| # | Comprobación | Descripción |
|---|---|---|
| 1 | Interruptor de hombre muerto | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), unidades de usuario y de sistema de systemd (Linux), procesos en ejecución |
| 2 | Persistencia | archivos rc del shell, crontab de usuario/sistema, /etc/cron.*, autostart de XDG, core.hooksPath global de git |
| 3 | Credenciales | variables de entorno sensibles, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, enumeración de archivos .env* |
| 4 | IOC de red | procesos node en ejecución con conexiones TCP salientes establecidas (heurístico, revisión manual) |
| 5 | Escaneo del repositorio | dependencias declaradas en package.json + versiones fijadas en el lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Instalados | node_modules/@tanstack/*/package.json comprobado contra la lista de versiones maliciosas conocidas, y luego contra el registro de npm time[<version>] cuando se usa --online |
| 7 | Indicadores de Actions | .github/workflows/* escaneado en busca de pull_request_target, ausencia de --ignore-scripts, uso de actions/cache |
| 8 | IOC de Mini Shai-Hulud | archivos de payload en node_modules (router_init.js, tanstack_runner.js), optionalDependency @tanstack/setup, manipulación de la configuración de herramientas de IA, dominios C2 en el código fuente, patrones de autor de commit y rama del atacante, tokens de npm marcados con rescate, paquetes secundarios propagados por el gusano, además de heurísticos de nivel informativo para formas de payload desconocidas |
Con --online, el script también obtiene el aviso GHSA en tiempo de ejecución para que la
cobertura de detección siga el estado en vivo del aviso en lugar de una lista
de versiones codificada de forma fija.
Familia afectada: @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router y
paquetes relacionados.
Familias limpias (no afectadas): @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
| Flag | Descripción |
|---|---|
--scan-dir DIR | Directorio raíz a escanear (por defecto: $HOME). Se niega a escanear directorios del sistema como /, /etc, /usr. |
--online | Consulta el aviso de GHSA y el time[<version>] del registro de npm para confirmar el compromiso. Desactivado por defecto — opt-in. |
--ghsa GHSA-ID | Sobrescribe el ID del aviso usado en --online (por defecto GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Sobrescribe la ventana de tiempo de publicación usada en --online. |
--fix | Imprime los comandos de pin recomendados para los repos afectados (dry-run por defecto). |
--apply | Con --fix: opt-in a la ejecución. Actualmente sigue negándose a ejecutar update a ciegas; se requiere pin manual. |
--yes, -y | Omite el prompt de confirmación para --apply. |
--json | Emite los hallazgos como JSON a stdout (implica --quiet). |
--bad-versions-file F | Añade entradas (pkg@version, una por línea) a la lista de versiones maliciosas conocidas. |
--no-color | Desactiva los colores ANSI. |
--quiet, -q | Suprime la salida por comprobación, imprime solo el resumen. |
-h, --help | Muestra la ayuda. |
| Código | Significado |
|---|---|
| 0 | Limpio — sin indicadores dentro del alcance escaneado |
| 1 | Solo advertencias — se recomienda revisión |
| 2 | Fallos — indicadores de compromiso presentes |
| 3 | Error de herramienta/uso |
Este repositorio se defiende contra la misma clase de ataque que detecta. Concretamente: