VibeCoderzVibeCoderz
Все статьи
Вайбкодинг: гайды2026/08/118 мин чтения

Как настроить GitHub Secret Scanning и Push Protection в 2026 году

Содержание (9)+

GitHub secret scanning бесплатно ловит утекшие токены в публичных репозиториях, а push protection блокирует коммит с секретом еще до того, как он попадет в историю Git. Ниже пошагово: включение сканирования, custom patterns под ЮKassa и Telegram, и вторая линия защиты локально через detect-secrets. Разберем, что делать бесплатно на GitHub, а где нужен pre-commit хук на своей машине.

GitHub Secret Scanning бесплатен для публичных репозиториев и платен для приватных ($19 за коммитера в месяц). Push Protection блокирует пуш с найденным секретом. Custom patterns ловят токены ЮKassa и Telegram, которых нет в стандартных 337+ паттернах. Для полного покрытия добавьте detect-secrets как pre-commit хук.

Что такое GitHub Secret Scanning?

GitHub Secret Scanning — это встроенная функция, которая автоматически ищет в коде, issues и pull request'ах паттерны известных токенов: AWS-ключи, Google API, MongoDB-строки и еще 200+ форматов от партнеров GitHub.

GitHub Secret Scanning — это автоматический поиск утекших секретов по regex-паттернам партнеров плюс AI-модель на базе Copilot для generic-паролей. Для части паттернов доступна проверка валидности: система стучится в API провайдера и узнает, активен ли токен прямо сейчас.

Работает это так. Сканирование включается на уровне репозитория, организации или всего enterprise. GitHub проходит по коммитам, истории, issues и discussions, ищет совпадения с известными форматами. Найденный токен превращается в алерт с указанием файла, строки и рекомендацией по устранению.

Отдельно стоит validity check. Активный токен опаснее отозванного, и проверка валидности помогает расставить приоритеты: сначала гасить то, что реально работает прямо сейчас, а не то, что уже мертво.

Для приватных и internal-репозиториев функция требует GitHub Advanced Security или отдельный продукт GitHub Secret Protection. Для публичных репозиториев сканирование включено по умолчанию и бесплатно всегда.

Изображение

Как включить secret scanning для репозитория?

Включить secret scanning можно за один клик в настройках репозитория, организации или через готовую конфигурацию на несколько репо сразу.

Для одного репозитория путь простой: Settings -> Advanced Security -> кнопка Enable у Secret Protection. Сканирование сразу запускает первый проход по всей истории и уже за секунды показывает список найденных секретов, если они есть.

Шаг 1. Откройте вкладку Settings нужного репозитория.

Шаг 2. Слева найдите раздел Advanced Security.

Шаг 3. Нажмите Enable напротив Secret Protection. GitHub предупредит, расходует ли это дополнительные лицензии.

Шаг 4. После включения появится блок дополнительных опций: non-provider patterns, generic password detection через Copilot, validity check.

Изображение

На уровне организации логика немного другая. В Organization Settings есть Global Settings, где задаются паттерны для всех репо разом, и Configurations, набор правил, которые применяются выборочно к части репозиториев. Это удобно, если часть команды работает с приватными данными, а часть, скажем, с open source.

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

Что такое push protection и как он блокирует утечку?

Push Protection проверяет коммит в реальном времени до того, как он попадет на сервер GitHub. Если находит секрет, блокирует пуш и просит либо убрать его, либо явно подтвердить обход с причиной.

Push protection работает как турникет перед входом в репозиторий, а не как камера после кражи. GitHub проверяет каждый коммит на этапе push, и если совпадение находится, терминал или редактор сразу получают ошибку с номером строки.

Включается там же, в Advanced Security, кнопкой Enable у Push Protection. По умолчанию обойти блокировку может любой, у кого есть right access, но это настраивается: можно ограничить обход только ролью security manager или конкретной командой.

Если обход разрешен, у разработчика есть до трех часов на пуш после подтверждения причины (тест, false positive, «исправлю позже»). Каждый обход фиксируется в audit log организации, так что молча спрятать секрет через bypass не получится, это все равно попадет в отчет.

Отдельно есть настройка prevent direct alert dismissal: без нее алерт может закрыть любой репозиторный админ, с ней закрытие идет через запрос, который утверждает только owner организации или security-команда.

Максим: «GoBanana веб-версию мы собрали за 3 часа после выхода модели. На такой скорости руками искать закоммiченные ключи некогда, поэтому push protection у нас включен с первого дня в каждом новом репозитории.»
Изображение

Как настроить custom pattern для ЮKassa и Telegram токенов?

Стандартные 200+ паттернов GitHub заточены под западных провайдеров и не ловят российские токены вроде ключей ЮKassa или ботов Telegram. Custom pattern закрывает эту дыру одним regex-правилом.

Custom pattern — это ваш собственный regex, который GitHub добавляет к списку проверок. Настраивается на уровне репозитория, организации или enterprise, а Copilot может сгенерировать выражение по текстовому описанию формата токена.

Токен Telegram-бота имеет предсказуемую структуру: числовой ID бота, двоеточие, затем 35 символов из букв, цифр, дефиса и подчеркивания. Секретный ключ ЮKassa стартует с live_ для боевого режима или test_ для тестового, дальше идет 43-символьная строка base64.

Изображение
СервисФормат токенаRegex-паттерн
Telegram Bot API123456789:AAHdq...\d{8,10}:[A-Za-z0-9_-]{35}
ЮKassa secret keylive_... / test_...(live|test)_[A-Za-z0-9_-]{43}
ЮKassa shop_idчисловой ID магазина"shop_id"\s*:\s*"\d{5,7}"

Чтобы добавить паттерн: Settings -> Advanced Security -> Custom patterns -> New pattern. Вставьте regex, добавьте тестовую строку с реальным форматом токена (без реального значения, конечно) и запустите dry run. Он просканирует репозиторий на совпадения без публикации правила.

Если dry run чистый, публикуйте паттерн. Отдельным шагом включите Push Protection именно для него, публикация паттерна сама по себе push protection не активирует.

Сколько стоит GitHub Secret Scanning в 2026 году?

Для публичных репозиториев секретное сканирование и push protection бесплатны всегда. Для приватных нужен отдельный платный продукт GitHub Secret Protection.

С апреля 2025 GitHub разделил Advanced Security на два самостоятельных продукта. Secret Protection стоит $19 за активного коммитера в месяц, Code Security с CodeQL и Copilot Autofix идет отдельно за $30.
Изображение
ТарифЦенаЧто входит
Публичный репозиторийБесплатноSecret Scanning, Push Protection, custom patterns
GitHub Secret Protection$19/коммитер/месТо же для приватных репо + Copilot AI-детекция паролей
GitHub Code Security$30/коммитер/месCodeQL, Copilot Autofix, security campaigns (отдельно от Secret Protection)

Платят не за место в организации, а за активного коммитера, то есть за каждого, кто пушил код в репозиторий с включенной защитой за последние 90 дней. Боты и CI-пайплайны, которые тоже коммитят, попадают в этот счет. Если хотите контролировать бюджет, включайте защиту не на всю организацию сразу, а на конкретные репозитории с секретами.

Как настроить detect-secrets как pre-commit хук?

detect-secrets ловит секреты локально, до того как коммит вообще уйдет в GitHub, и работает даже в приватном репозитории без платной подписки.

detect-secrets создает baseline-файл с хешами уже существующих в коде секретов. Новые находки блокируют коммит, старые проходят молча. Это решает проблему брошенных ключей в старом коде без требования вычистить историю разом.

Шаг 1. Установите библиотеку: pip install detect-secrets.

Шаг 2. Создайте baseline для текущего состояния репозитория:

detect-secrets scan > .secrets.baseline

Просмотрите файл перед коммитом, он покажет все, что уже найдено в кодовой базе.

Шаг 3. Установите фреймворк pre-commit: pip install pre-commit.

Шаг 4. Добавьте в .pre-commit-config.yaml:

repos:
  - repo: https://github.com/Yelp/detect-secrets
    rev: v1.5.0
    hooks:
      - id: detect-secrets
        args: ['--baseline', '.secrets.baseline']

Шаг 5. Установите хук: pre-commit install. Теперь при каждом git commit detect-secrets сканирует только staged-изменения, а не весь репозиторий, поэтому хук отрабатывает за секунды, а не минуты.

Ложные срабатывания снимаются прямо в коде через # pragma: allowlist secret в конце строки, без правки baseline вручную.

Изображение

GitHub Secret Scanning или detect-secrets: что выбрать?

Это не конкурирующие решения, а два слоя одной защиты: detect-secrets ловит секрет на машине разработчика, GitHub Secret Scanning подстраховывает на сервере, если хук кто-то обошел флагом --no-verify.

Изображение
КритерийGitHub Secret Scanningdetect-secrets
Где срабатываетНа сервере GitHubЛокально, до коммита
Стоимость приватных репоОт $19/коммитер/месБесплатно
Custom-паттерныДа, через UI и dry runДа, через plugins и regex
ОбходPush protection bypass с логомФлаг --no-verify без следа
Проверка старой историиДа, полное сканированиеТолько baseline-снапшот

Разработчики, экономящие на приватных репо, часто ставят detect-secrets как единственный слой. Рискованно: --no-verify не оставляет запись нигде, и один невнимательный коммит проходит незамеченным. Комбинация обоих слоев закрывает и обход хука, и брешь до момента его установки у нового участника команды.

Что делать, если секрет уже утек в историю Git?

Первый шаг всегда один: ротация секрета, а не попытка вычистить историю коммитов.

Удаление секрета из кода коммита переписывает все последующие хеши коммитов и требует force push, что может сломать форки и локальные копии у всей команды. Смысла в этом обычно меньше, чем кажется: если токен уже засветился публично, его достаточно просто инвалидировать на стороне провайдера.

Дальше в GitHub: откройте алерт в Secret Scanning, посмотрите все места, где найден токен (иногда он дублируется в нескольких файлах), закройте алерт с пометкой revoked после ротации. Незакрытые алерты не пропадают сами, GitHub не отслеживает удаление секрета из кода автоматически.

Изображение

FAQ по настройке github secret scanning

Работает ли secret scanning для приватных репозиториев бесплатно? Нет. Для публичных репозиториев функция всегда бесплатна, для приватных нужен платный GitHub Secret Protection, $19 за активного коммитера в месяц.

Push protection можно обойти? Да, если роль пользователя это разрешает. Каждый обход попадает в audit log организации с причиной и именем того, кто нажал allow.

Custom pattern сразу блокирует пуш? Нет. После публикации паттерна push protection для него нужно включить отдельно, публикация сама по себе только добавляет паттерн в сканирование.

detect-secrets заменяет GitHub Secret Scanning? Нет, это разные уровни защиты. detect-secrets ловит секрет до пуша локально, GitHub Secret Scanning подстраховывает на сервере, если хук обошли или не установили.

Что делать с false positive в detect-secrets? Добавить # pragma: allowlist secret в конце строки или занести значение в исключения через --exclude-secrets.

Нужно ли переписывать историю Git после утечки секрета? Обычно нет. Достаточно ротировать (инвалидировать) секрет у провайдера и закрыть алерт. Force push с переписыванием истории ломает форки и чаще создает проблем больше, чем решает.

Сколько времени занимает настройка detect-secrets в проекте? Baseline-скан плюс подключение к pre-commit занимает 10-15 минут на средний репозиторий, дальше хук работает автоматически при каждом коммите.


Настроить push protection и custom patterns стоит в первый же день работы над репозиторием, а не после первой утечки. Полный каталог AI-инструментов для разработки, включая GitHub Copilot, смотрите в каталоге VibeCoderz. Если нужна помощь с настройкой безопасности проекта или выбором стека, запишитесь на консультацию к Максиму.

Обновлено: октябрь 2026

Автор

Елисавета Наговицына

Предприниматель · Контент-маркетолог · SEO-стратег · AI-продуктолог

2026/08/11

400 000+ органических переходов за 3 месяца. Со-основатель GoBanana (231K пользователей, 12+ млн ₽ без рекламы) и NeuroScribe (65K пользователей). SEO/GEO-стратегии для AI-поисковиков, 1 700+ единиц контента, 17+ реализованных стратегий.

Об авторе →
All Posts

Инструменты, упомянутые в статье

Читать далее

📄 Статья

Figma to code: как превратить макет в готовый сайт через ИИ

Сверните время от дизайна до готового сайта: Figma‑to‑code инструменты превращают макет в React, Vue, Tailwind и др., но каждый требует своей настройки и точности.

2026/06/308 мин
📄 Статья

Microsoft запустила собственные AI-модели: 7 штук за один день — конец аренды мозгов у OpenAI

Microsoft в один день выпустила семь собственных AI‑моделей, избавившись от OpenAI и Anthropic, что позволяет снизить затраты и усилить контроль над технологиями.

2026/06/048 мин
📄 Статья

Gemini Code 22: что это за версия и почему её ищут

Gemini Code 22 – это миф: Google не выпускал такой версии, а путаница возникла из названий дат и подверсий. В статье разберём существующие варианты Gemini и подскажем, как выбрать подходящий.

2026/05/1310 мин
📄 Статья

Как тестировать AI-сгенерированный код в 2026 году

Тестируйте AI‑код без навыков программирования: инструменты автоматически кликают, проверяют UI и генерируют тесты одним промптом, экономя время и снижая риск неожиданных сбоев.

2026/04/249 мин
📄 Статья

Вайбкодинг игр 2026: как создавать игры с ИИ и реальные кейсы

Создавай игры за считанные часы, просто описывая идею, а ИИ генерирует код и механику — в 2026 году это уже реальность для новичков, а реальные кейсы подтверждают эффективность.

2026/04/2110 мин
📄 Статья

Vibe Coding в 2026: тренды, инструменты и куда движется рынок

В 2026 вайб‑кодинг уже нормализован: большинство разработчиков ежедневно используют AI, а рынок переходит от простого применения к оптимизации процессов и архитектуре агентных систем.

2026/04/219 мин