← Назад в блог

Vulnerability Fixer: автоматическое исправление уязвимых зависимостей в Jiro Health

Опубликовано
•
4 мин чтения
•
--- просмотров

Часть моей работы в Jiro Health — аудит безопасности разрабатываемого продукта: мониторинг критических уязвимостей в сторонних библиотеках, их безопасное обновление и доставка патчей в каждый репозиторий. На этой записи — презентация автоматизированного решения, которое я для этого построил, перед всей инженерной командой на Engineering Round Table 10 сентября 2026 года.

Инструмент внутренний, публикация в открытый доступ пока не планируется, поэтому здесь описано, что он делает, а не как его поставить.

Слайд из презентации суммирует исходную точку:

Проблема

Новые CVE в зависимостях появляются каждый день. В продукте под требованиями HIPAA это не досадная мелочь, а обязательство: известный уязвимый пакет в продакшене — это замечание на ближайшем аудите. А ручное исправление CVE каждый раз одинаковый ритуал. Найти бюллетень, понять, какая версия на самом деле закрывает уязвимость, поднять пакет, не сломав тех, кто им пользуется, перегенерировать lockfile, открыть pull request, обновить тикет, сообщить команде. И повторить в следующем репозитории.

У ручного процесса три изъяна:

  • Повторяемость. Разработчики тратят часы на одинаковые поднятия версий вместо работы над продуктом.
  • Не масштабируется. Каждый репозиторий проверяется и патчится отдельно, по одному.
  • Медленно. Пропатчить и перепроверить всё занимает часы, и исправления отстают от публикации уязвимостей.

Что делает fixer

Pipeline запускается как workflow GitHub Actions против каждого репозитория: фронтенд, API и cloud functions. Один запуск проходит весь цикл.

  1. Обнаружение. OSV-Scanner и audit пакетного менеджера проходят по каждому манифесту в репозитории, включая workspaces монорепозитория, для npm и pnpm. Результаты объединяются и дедуплицируются, а исправленная версия берётся из самого бюллетеня OSV, а не из флага «fix available» у audit, который часто вводит в заблуждение.
  2. Уважение к существующей политике. Сначала читаются исключения и закреплённые версии, которые уже есть в репозитории, так что сканер никогда не переоткрывает то, что человек осознанно принял. Он также сообщает, какие из этих исключений больше не нужны.
  3. Исправление слоями. Первый слой применяет фикс самого сканера. Если этого мало, второй слой детерминированно закрепляет первую безопасную версию. Третий слой переходит вперёд на чистую опубликованную версию и сканирует заново, доказывая, что новых уязвимостей не появилось. Опциональный ИИ-агент может править манифесты в изолированной среде без CI-токенов, но по умолчанию он выключен.
  4. Проверка до коммита. Каждый разрешённый пакет сверяется с digest'ами целостности реестра. Guard совместимости отказывается заменять или объединять мажорные версии зависимостей, поэтому security-фикс никогда не протащит ломающее обновление. Всё, что guard не может доказать безопасным, уходит на ручное ревью, а не в PR.
  5. Ровно один PR. Ветка с фиксом содержит только файлы зависимостей. На репозиторий всегда не больше одного открытого fix PR: refresh обновляет его на месте, а не открывает второй, и устаревшие PR закрываются только после того, как каждая находка перепривязана к новому.
  6. Замыкание цикла. Создаётся или дополняется issue в Jira с находками, переводится в In Progress и связывается с веткой. QA-агент только на чтение пишет сводку влияния в тело PR и тикета. Сводка в Slack сообщает команде, что найдено и где PR.

Находки без доступного фикса не заметаются под ковёр. Отдельный запуск синхронизации исключений предлагает ограниченные по сроку исключения, по умолчанию на семь дней, в собственном PR на одобрение человеком. Неизвестная серьёзность и смешанные случаи никогда не подавляются автоматически.

Почему это важно

Fixer превращает управление уязвимостями из прерывания в ревью. Больше никто не ищет бюллетени, не подбирает версии и не пересобирает lockfile. Разработчик открывает PR, который уже пропатчен, уже сверен с реестром, уже доказанно не вносит новых находок, с написанным описанием влияния, и решает, мержить ли.

Для компании это меняет три вещи:

  • Время. Часы ручной работы на репозиторий на каждую публикацию уязвимости превращаются в минуты code review.
  • Единообразие. Все репозитории получают одинаковую обработку в один день, с одинаковыми guard'ами, а не только тот, про который кто-то вспомнил.
  • Доказательства. Каждый запуск оставляет след: находки в security-хранилище, тикет, PR с приложенным отчётом сканирования. Ровно то, что спрашивает аудит HIPAA.

Безопасность самого инструмента

Инструмент, который пушит код во все репозитории, — привлекательная цель, поэтому pipeline относится к себе как к недоверенному. Runner'ы блокируют исходящий трафик, кроме allowlist. Checkout'ы никогда не сохраняют учётные данные. Git-операции получают короткоживущие app-токены через конфигурацию в памяти, и эти токены никогда не попадают к ИИ-агенту и к шагам проверки. Сканер добавляет в индекс только разрешённые пути, никогда всё дерево, и отказывается публиковать PR, затрагивающий что-то кроме файлов зависимостей. Доступ к базе идёт через workload identity с короткоживущими токенами, без ключей сервисных аккаунтов и без сохранённых паролей.

Проблема зависимостей никуда не денется, и это одна из деталей, которая позволяет маленькой команде держать регулируемый продукт пропатченным, не превращая каждый CVE в пожарную тревогу.

Проекты

Jiro Health - практическая аналитика для врачей

Jiro Health - практическая аналитика для врачей

До: практикующим медикам в США приходилось собирать данные о доходах, рекомендациях и денежных потоках из систем, которые медленно подключались. После: как principal/founding engineer в команде основателей я веду разработку API своих подов от спецификации до релиза и строю интерфейсы корпоративного уровня на Node.js с фоновой обработкой данных на Python.

Статьи

Открыт для работы по контракту

Я доступен для работы по контракту. Если у вас есть интересная идея проекта, запишитесь на звонок через Calendly.

Записаться на 30-минутный звонок