Script de shell para detectar indicadores do ataque à cadeia de suprimentos do npm da TanStack (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Detecta indicadores do ataque à cadeia de suprimentos do npm do TanStack em uma máquina de desenvolvedor, um repositório ou um runner de CI. Script Bash, imagem Docker e GitHub Action — mesmo motor, três pontos de entrada.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
Em 11 de maio de 2026, atacantes publicaram 84 versões maliciosas em 42 pacotes @tanstack/* por meio de envenenamento de cache do GitHub Actions. O payload rouba tokens do GitHub, tokens do npm, credenciais da AWS/GCP/Azure e instala um daemon de dead-man's switch que apaga ~/ no momento em que o token roubado é revogado.
Escolha o ponto de entrada que corresponde ao seu ambiente.
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
O código de saída 0 significa limpo, 2 significa que foram encontrados indicadores de comprometimento. O JSON de descobertas é gravado em tanstack-findings.json no diretório atual. --user permite que o contêiner grave esse arquivo em um diretório de propriedade do seu usuário; no Linux, sem ele, a verificação ainda é executada, mas o JSON não pode ser gravado. No PowerShell, onde id não existe, remova a flag --user.
As tags de imagem não têm o prefixo v: 1.2.1 para uma versão exata, 1 para a versão mais recente da série 1.x (ela acompanha a tag v1 da Action) e latest.
A imagem é multi-arquitetura (linux/amd64, linux/arm64) e é distribuída com proveniência de build assinada via GitHub OIDC. Verifique antes de executar:
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
Um fluxo de trabalho endurecido completo está em
.github/workflows/tanstack-check.yml
e é o mesmo fluxo de trabalho que este repositório executa contra si mesmo.
| # | Verificação | Descrição |
|---|---|---|
| 1 | Dead-man's switch | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), unidades de usuário + sistema do systemd (Linux), processos em execução |
| 2 | Persistência | arquivos rc do shell, crontab de usuário/sistema, /etc/cron.*, autostart XDG, core.hooksPath global do git |
| 3 | Credenciais | variáveis de ambiente sensíveis, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, enumeração de arquivos .env* |
| 4 | IOC de rede | processos node em execução com conexões TCP de saída estabelecidas (heurística, revisão manual) |
| 5 | Varredura do repositório | dependências declaradas no package.json + versões fixadas no lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Instalados | node_modules/@tanstack/*/package.json verificado contra a lista de versões maliciosas conhecidas, depois contra o registro npm time[<version>] quando --online |
| 7 | Dicas de Actions | .github/workflows/* verificado em busca de pull_request_target, ausência de --ignore-scripts, uso de actions/cache |
| 8 | IOCs do Mini Shai-Hulud | arquivos de payload em node_modules (router_init.js, tanstack_runner.js), optionalDependency @tanstack/setup, adulteração de configuração de ferramentas de IA, domínios C2 no código-fonte, padrões de autor de commit e branch do atacante, tokens npm marcados com resgate, pacotes secundários propagados pelo worm, além de heurísticas de nível informativo para formatos de payload desconhecidos |
Com --online, o script também busca o aviso GHSA em tempo de execução para que a
cobertura de detecção acompanhe o estado ao vivo do aviso em vez de uma lista
de versões codificada de forma fixa.
Família afetada: @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router e
pacotes relacionados.
Famílias limpas (não afetadas): @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 | Descrição |
|---|---|
--scan-dir DIR | Diretório raiz a ser escaneado (padrão: $HOME). Recusa-se a escanear diretórios de sistema como /, /etc, /usr. |
--online | Consulta o aviso GHSA e o time[<version>] do registro npm para confirmar o comprometimento. Desativado por padrão — opt-in. |
--ghsa GHSA-ID | Substitui o ID do aviso usado em --online (padrão GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Substitui a janela de horário de publicação usada em --online. |
--fix | Imprime comandos de pin recomendados para os repositórios afetados (dry-run por padrão). |
--apply | Com --fix: opt-in para execução. Atualmente ainda recusa update cego; o pin manual é necessário. |
--yes, -y | Pula o prompt de confirmação para --apply. |
--json | Emite os achados como JSON para stdout (implica --quiet). |
--bad-versions-file F | Anexa entradas (pkg@version, uma por linha) à lista de versões conhecidas como ruins. |
--no-color | Desativa cores ANSI. |
--quiet, -q | Suprime a saída por verificação, imprime apenas o resumo. |
-h, --help | Mostra a ajuda. |
| Código | Significado |
|---|---|
| 0 | Limpo — nenhum indicador dentro do escopo escaneado |
| 1 | Apenas avisos — revisão recomendada |
| 2 | Falhas — indicadores de comprometimento presentes |
| 3 | Erro de ferramenta/uso |
Este repositório se defende contra a mesma classe de ataque que detecta. Concretamente: