tanstack-compromise-checker

Обнаружение индикаторов 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 и устанавливает демон "мёртвой руки", который уничтожает ~/ в момент отзыва украденного токена.

Быстрый старт

Выберите точку входа, соответствующую вашей среде.

macOS / Linux / WSL2 / Git Bash

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 — работает во всех ОС, поддерживающих Docker (включая Windows)

docker run --rm -v "$PWD":/scan \
  ghcr.io/fabriziosalmi/tanstack-compromise-checker:v1.0.0 \
  /scan true fail tanstack-findings.json '' GHSA-g7cv-rxg3-hmpx

Образ является multi-arch (linux/amd64, linux/arm64) и поставляется с проверкой подлинности сборки, подписанной через GitHub OIDC. Проверьте перед запуском:

gh attestation verify \
  oci://ghcr.io/fabriziosalmi/tanstack-compromise-checker:v1.0.0 \
  --repo fabriziosalmi/tanstack-compromise-checker

GitHub Action — блокировка скомпрометированных зависимостей в CI

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 и это тот же рабочий процесс, который этот репозиторий запускает против самого себя.

Что проверяет скрипт

С --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.

Использование

# Быстрая проверка (домашняя папка текущего пользователя)
bash check.sh

# Онлайн-режим: запрос к рекомендации GHSA и времени публикации в npm registry
bash check.sh --online

# Сканирование конкретной директории
bash check.sh --scan-dir /path/to/your/repos

# JSON-вывод для интеграции с CI/SIEM
bash check.sh --json > findings.json

# Предложение команд фиксации для затронутых репозиториев (пробный запуск)
bash check.sh --scan-dir /path/to/repos --fix

# Предоставление расширенного списка известных плохих версий
bash check.sh --bad-versions-file ./extra-bad-versions.txt

Все опции

Коды завершения

Позиция безопасности

Этот репозиторий защищается от того же класса атак, которые он обнаруживает. Конкретно:

• Каждое uses: GitHub Action зафиксировано по 40-символьному SHA коммита, а не по плавающему тегу.
• Базовый Docker-образ зафиксирован по неизменяемому multi-arch digest манифеста.
• Каждый рабочий процесс объявляет permissions: {} на верхнем уровне; задачи предоставляют только то, что им нужно.
• actions/checkout вызывается с persist-credentials: false, чтобы в $GITHUB_WORKSPACE не оставалось аутентифицированного git-удаленного репозитория.
• step-security/harden-runner — первый шаг каждого рабочего процесса, отслеживающий исходящие соединения раннера.
• OpenSSF Scorecard запускается еженедельно и при каждом пуше в main; результаты загружаются как SARIF.
• Каждый релиз публикует аттестацию подлинности сборки SLSA для Docker-образа. Любой может проверить её офлайн с помощью gh attestation.
• Каждый релиз поставляется с check.sh.sha256, покрывающим все устанавливаемые артефакты.

Полная политика в SECURITY.md.

Не используйте curl | bash для любого инструмента безопасности, включая этот. Всегда скачивайте, проверяйте контрольную сумму, просматривайте, затем запускайте.

Пример вывода

━━  1 / 8  АРТЕФАКТЫ МЁРТВОЙ РУКИ
  ✔  Артефактов мёртвой руки не найдено

━━  2 / 8  ВЕКТОРЫ ПОСТОЯНСТВА
  ✔  Векторов постоянства не обнаружено

━━  3 / 8  РАСКРЫТИЕ ТОКЕНОВ / УЧЁТНЫХ ДАННЫХ
  ✔  Раскрытия учётных данных не обнаружено

━━  4 / 8  СЕТЕВЫЕ ИНДИКАТОРЫ
  ✔  В настоящее время TCP-соединений node не установлено (или не наблюдаются)

━━  5 / 8  СКАНИРОВАНИЕ РЕПОЗИТОРИЯ — package.json + lock-файлы
  ℹ  Найдено 12 package.json + 8 lock-файлов
  ✔  Скомпрометированных семейств в package.json не объявлено
  ✔  Скомпрометированных фиксаций в lock-файлах не найдено

━━  6 / 8  УСТАНОВЛЕННЫЕ node_modules — прямая проверка версий
  ✔  Скомпрометированных пакетов в установленных node_modules не найдено

━━  7 / 8  ПОДСКАЗКИ ПО УСИЛЕНИЮ GITHUB ACTIONS
  ✔  Опасных паттернов GitHub Actions не обнаружено (в сканируемой области)

━━  8 / 8  ПОЛЕЗНАЯ НАГРУЗКА MINI SHAI-HULUD + ВСПОМОГАТЕЛЬНЫЕ IOC
  ✔  Полезной нагрузки Mini Shai-Hulud / вспомогательных IOC не обнаружено

━━  СВОДКА
  Пройдено: 8    Предупреждений: 0    Ошибок: 0
  Область : /Users/alice/dev
  ✔  Индикаторов компрометации в области: /Users/alice/dev не обнаружено
  Примечание: чистый результат для /Users/alice/dev не подтверждает остальную часть системы.

Если вы скомпрометированы

НЕ отзывайте свой токен GitHub до остановки демона — механизм мёртвой руки выполнит rm -rf ~/ в момент отзыва токена.

1. Сначала остановите демона:
   • macOS 14+: launchctl bootout gui/$UID ~/Library/LaunchAgents/com.user.gh-token-monitor.plist
   • macOS (старые версии): launchctl unload ~/Library/LaunchAgents/com.user.gh-token-monitor.plist
   • Linux: systemctl --user stop gh-token-monitor && systemctl --user disable gh-token-monitor
2. Удалите скрипт: rm -f ~/.local/bin/gh-token-monitor.sh
3. Затем отзовите и смените: токен GitHub, токен npm, учетные данные AWS/GCP/Azure, ключи SSH, SSH-агент.
4. Просмотрите журнал аудита GitHub: https://github.com/settings/security-log
5. Проверьте ~/.aws/credentials, ~/.kube/config, ~/.config/gh/hosts.yml, ~/.npmrc.

Зависимости

Bash-скрипт требует:

• bash 4+
• jq (рекомендуется) — разбор package-lock.json
• python3 (необязательный запасной вариант) — используется, когда jq отсутствует
• curl — требуется для --online
• lsof или ss (необязательно) — эвристика сетевых IOC

Docker-образ включает всё вышеперечисленное. Используйте его в системах, где вы не можете или не хотите устанавливать эти инструменты.

Участие в разработке

Приветствуются проблемы (issues) и запросы на слияние (pull requests). Обратите внимание, что в этом репозитории используются CODEOWNERS: все PR требуют проверки мейнтейнером.

Ссылки

• Официальный пост-мортем TanStack
• Рекомендация GitHub GHSA-g7cv-rxg3-hmpx
• Анализ Snyk
• Блог Wiz — Mini Shai-Hulud
• Статья StepSecurity
• Orca Security — 160+ пакетов

Лицензия

MIT.