STRIPE_SECRET_KEY=sk_live_... в файле .env.production, не охваченном .gitignore, попадет в репозиторий при следующем git add ., а ключ Hugging Face или OpenAI, вставленный в скрипт обучения, окажется в каждом форке и резервной копии. Этот навык находит такие и другие случаи записи секретов в файлы и объясняет, как исправить каждый из них.

Ваш агент запускает сканер для всех текстовых файлов проекта (код, файлы .env, YAML, JSON, блокноты, документация и файлы ключей). Он сопоставляет данные с опубликованным форматом каждого провайдера (префикс, длина и символы), проверяет наличие настоящих данных ключа после строки -----BEGIN PRIVATE KEY-----, читает URL баз данных и строки подключения, а также проверяет настройки, названия которых указывают на хранение секрета. Он пропускает очевидные заглушки (your_key_here, xxxx, ${VAR}, ключ из документации AWS), строки в тестовых файлах, помеченные как фиктивные, и эвристические правила в документации, lock-файлах и минифицированных сборках, а также учитывает gitleaks:allow и pragma: allowlist secret. Затем он читает файлы .gitignore: секреты в игнорируемых git файлах не влияют на итоговый вердикт и подсчитываются в одной заключительной строке, а файл с секретами, который попадет в коммит, отмечается в отчете. Сканер никогда не обращается к провайдерам и не выводит секреты. Результат проверки: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода.

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

BLOCK (исправить перед передачей)

• H01: ключи доступа и секретные ключи AWS (в том числе в CSV с ключами доступа и aws configure), API-ключи Google в серверном коде (Gemini), секреты клиентов Google OAuth, ключи учетных записей Azure Storage, ключи secret и service_role Supabase

• H02: токены GitHub, GitLab, npm (включая .npmrc _authToken) и PyPI

• H03: ключи OpenAI, Anthropic, OpenRouter и Hugging Face

• H04: рабочие ключи Stripe и секреты вебхуков, токены и вебхуки ботов Slack, Discord и Telegram, токены авторизации Twilio, ключи SendGrid

• H05: закрытые ключи (PEM, OpenSSH, PGP, PuTTY, age), содержащие данные ключа

• H06: пароли в URL баз данных и строках подключения к удаленным хостам

REVIEW (проверить перед выпуском)

• H11: тестовые ключи Stripe и токены TestPyPI

• H12: настройки с названиями, указывающими на секрет, и случайно выглядящими значениями (включая Laravel APP_KEY и похожие значения *_KEY), явно заданные заголовки Authorization, пароли для хостов контейнеров

• H13: JWT (ключи anon Supabase и пример с jwt.io пропускаются)

• H14: файлы .env, .npmrc, *.pem и подобные файлы с секретами, не охваченные ни одним правилом .gitignore

• H15: API-ключи Google в клиентских конфигурациях Firebase, Android, iOS или Maps, которым нужны ограничения по API и приложениям

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Справочник правил с объяснениями, форматами ключей и более безопасным подходом для каждого правила

• Небезопасный и безопасный примеры проектов (Django, Express, Firebase, npm и файлы развертывания), а также фактический отчет сканера по небезопасному примеру

Ограничения

Сканер читает файлы в текущем состоянии: история git, другие ветки и журналы CI не проверяются, а определить, работает ли ключ, невозможно. Статус игнорирования определяется только по файлам .gitignore; если в файле найдено более 50 совпадений по одному правилу, показываются первые 50. Двоичные хранилища ключей (.p12, .jks), короткие или похожие на слова пароли, секреты, разбитые на несколько строк, и не перечисленные выше провайдеры не отражаются в отчете. NOT FLAGGED не гарантирует отсутствие проблем.

Содержимое

Один ZIP-архив с 25 файлами: SKILL.md, сканер в scripts/ (4 файла Python), references/rules.md (все правила с объяснениями и более безопасными подходами) и examples/ (18 файлов примеров и report.md, фактический отчет сканера по небезопасному примеру).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных компонентов. Они только читают ваши файлы: доступа к сети нет, данные никуда не отправляются.