Скрипт оболочки для обнаружения индикаторов атаки на цепочку поставок TanStack npm (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Обнаруживает индикаторы атаки на цепочку поставок npm TanStack на машине разработчика, в репозитории или на CI-раннере. Bash-скрипт, Docker-образ и GitHub Action — один движок, три точки входа.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
11 мая 2026 года злоумышленники опубликовали 84 вредоносные версии в 42 пакетах @tanstack/* через отравление кэша GitHub Actions. Полезная нагрузка крадёт токены GitHub, токены npm, учётные данные AWS/GCP/Azure и устанавливает демон dead-man's switch, который стирает ~/ в момент отзыва украденного токена.
Выберите точку входа, соответствующую вашей среде.
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
Код выхода 0 означает отсутствие проблем, 2 — обнаружены индикаторы компрометации. JSON с результатами записывается в tanstack-findings.json в текущем каталоге. Флаг --user позволяет контейнеру записать этот файл в каталог, принадлежащий вашему пользователю; в Linux без него сканирование всё равно выполняется, но JSON записать не удаётся. В PowerShell, где id отсутствует, уберите флаг --user.
Теги образов не имеют префикса v: 1.2.1 для точного релиза, 1 для последнего релиза ветки 1.x (он перемещается вместе с тегом Action v1), и latest.
Образ является мультиархитектурным (linux/amd64, linux/arm64) и поставляется с провенансом сборки, подписанным через GitHub OIDC. Проверьте перед запуском:
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
Полный усиленный рабочий процесс находится в
.github/workflows/tanstack-check.yml
и это тот же рабочий процесс, который этот репозиторий запускает против самого себя.
| # | Проверка | Описание |
|---|---|---|
| 1 | Dead-man's switch | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), пользовательские и системные юниты systemd (Linux), запущенные процессы |
| 2 | Persistence | rc-файлы оболочки, пользовательский/системный crontab, /etc/cron.*, XDG autostart, глобальный git core.hooksPath |
| 3 | Credentials | чувствительные переменные окружения, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, перечисление файлов .env* |
| 4 | Network IOC | запущенные процессы node с установленными исходящими TCP-соединениями (эвристика, ручная проверка) |
| 5 | Repo scan | объявленные зависимости в package.json + зафиксированные версии в lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Installed | node_modules/@tanstack/*/package.json сверяются со списком известных вредоносных версий, затем с реестром npm time[<version>] при --online |
| 7 | Actions hints | .github/workflows/* сканируются на pull_request_target, отсутствие --ignore-scripts, использование actions/cache |
| 8 | Mini Shai-Hulud IOCs | файлы полезной нагрузки в node_modules (router_init.js, tanstack_runner.js), optionalDependency @tanstack/setup, вмешательство в конфигурацию AI-инструментов, C2-домены в исходном коде, шаблоны автора коммитов и веток атакующего, npm-токены с пометкой выкупа, вторичные пакеты, распространяемые червём, а также эвристики информационного уровня для неизвестных форм полезной нагрузки |
При --online скрипт также получает GHSA-рекомендацию во время выполнения, чтобы
охват обнаружения отслеживал актуальное состояние рекомендации, а не жёстко заданный
список версий.
Затронутое семейство: @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router и
связанные пакеты.
Чистые семейства (не затронуты): @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
| Флаг | Описание |
|---|---|
--scan-dir DIR | Корневой каталог для сканирования (по умолчанию: $HOME). Отказывается сканировать системные каталоги, такие как /, /etc, /usr. |
--online | Запрашивает рекомендацию GHSA и time[<version>] из реестра npm для подтверждения компрометации. По умолчанию отключено — включается явно. |
--ghsa GHSA-ID | Переопределяет идентификатор рекомендации, используемый в --online (по умолчанию GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Переопределяют временное окно публикации, используемое в --online. |
--fix | Выводит рекомендуемые команды закрепления версий для затронутых репозиториев (по умолчанию — пробный запуск). |
--apply | Вместе с --fix: явное согласие на выполнение. В настоящее время всё ещё отказывается от слепого update; требуется ручное закрепление версий. |
--yes, -y | Пропускает запрос подтверждения для --apply. |
--json | Выводит результаты в формате JSON в stdout (подразумевает --quiet). |
--bad-versions-file F | Добавляет записи (pkg@version, по одной на строку) в список известных вредоносных версий. |
--no-color | Отключает ANSI-цвета. |
--quiet, -q | Подавляет вывод по каждой проверке, печатает только сводку. |
-h, --help | Показывает справку. |
| Код | Значение |
|---|---|
| 0 | Чисто — индикаторов в просканированной области нет |
| 1 | Только предупреждения — рекомендуется проверка |
| 2 | Сбои — присутствуют индикаторы компрометации |
| 3 | Ошибка инструмента/использования |
Этот репозиторий защищается от того же класса атак, который он обнаруживает. Конкретно: