Начните с проверки файлов проекта, истории Git и кода, который сайт отправляет в браузер. Claude Code поможет найти подозрительные места, но его отчёт нужно сверить с настройками сервисов и опубликованной версией сайта. Если секретный API-ключ уже попал в открытый доступ, удаление строки не решит проблему: ключ нужно отозвать. Ниже разберём, что поручить ИИ, как проверить находки и какие подтверждения запросить у разработчика перед запуском сайта.
Где искать API-ключи и как отличить секрет от публичного ключа?
API-ключ даёт программе доступ к внешнему сервису. Например, сайт использует его, чтобы отправить запрос к нейросети или запустить рассылку. Если ключ разрешает платные операции, посторонний человек с этим ключом получает возможность расходовать ваш баланс в пределах доступных прав.
При этом название API_KEY само по себе ещё не означает утечку. Существуют публичные идентификаторы и ключи, которые сервис разрешает использовать в браузере. Проверьте назначение ключа в документации сервиса: какие действия он разрешает, где его допустимо размещать и какие ограничения доступны в настройках.
Начните с мест, куда секрет мог попасть при разработке:
- Файлы настроек, включая .env и его локальные копии. Наличие секрета в таком файле допустимо только при правильных ограничениях доступа.
- Исходный код страниц и серверных обработчиков, особенно примеры подключения внешних сервисов.
- История Git: старые версии файлов сохраняют строки, которые уже удалили из текущего кода.
- Готовая сборка сайта, которую браузер скачивает с сервера.
- Отладочные журналы, тестовые файлы и инструкции по запуску проекта.
Для небольшого бизнеса полезно сначала составить список подключений: какой сервис использует сайт, где находится его кабинет и кто управляет доступом. Без этого списка трудно понять, относится найденная строка к действующему ключу или к учебному примеру. Значения ключей в список не переносите.
Как поручить Claude Code проверку без изменения сайта?
Откройте копию проекта и начните с аудита без правок. Не давайте агенту доступ к рабочему серверу только ради поиска секретов. Если рабочая среда ещё не настроена, пригодится инструкция как установить Claude Code и проверить его на копии сайта.
Перед проверкой уточните, какие файлы агенту разрешено читать и куда инструмент передаёт содержимое проекта. Секреты не стоит вставлять в чат для распознавания. Для первого прохода достаточно искать подозрительные имена переменных и места подключения сервисов, скрывая сами значения в отчёте.
Задание для Claude Code можно сформулировать так:
«Проведи аудит проекта на возможные утечки секретов. Пока ничего не меняй, не отправляй сетевые запросы и не устанавливай инструменты. Найди места, где встречаются API-ключи, токены и заголовки авторизации. Проверь, какие настройки попадают в браузерную сборку. Если доступна история Git, проверь и её. Не выводи значения секретов в ответ, команды или журналы. Для каждой находки укажи путь, расположение в файле, причину подозрения и способ ручной проверки. Отдельно перечисли то, что проверить не удалось».
Попросите агента искать не только слово key. Ключ может лежать в переменной с произвольным именем, в адресе запроса или в заголовке Authorization. Полезно дополнить такой разбор сканером секретов: он ищет характерные шаблоны, а Claude Code помогает понять, как найденное значение связано с работой сайта. Ни один из этих способов не гарантирует отсутствие утечек.
Принимать отчёт проще, если каждая находка отвечает на конкретный вопрос: «В каком файле находится значение и может ли его получить посетитель?» Формулировка «всё безопасно» без перечня проверенных мест для приёмки не подходит.
Как проверить, не попал ли секрет в браузер и историю Git?
Откройте опубликованный сайт и инструменты разработчика в браузере. Во вкладке Network просмотрите запросы, которые возникают при действии с внешним сервисом. Например, отправьте тестовый запрос через форму ИИ-помощника, если она есть на сайте. Проверьте адрес запроса, его заголовки и содержимое.
Если браузер передаёт секретный ключ внешнему сервису, посетитель тоже сможет его увидеть. Перенос значения в другую переменную или сжатие JavaScript этого не исправят. Для секретного ключа обычно нужен серверный обработчик: браузер обращается к вашему серверу, а сервер выполняет разрешённую операцию с внешним сервисом. Сам обработчик тоже требует ограничений, иначе посторонние смогут расходовать ресурс через него.
Затем проверьте файлы JavaScript, которые сайт загрузил в браузер. Ищите названия подключённых сервисов, подозрительные переменные и фрагменты авторизации. Файл .env не защищает секрет автоматически: система сборки может подставить значение переменной прямо в код для посетителей. Правила такого подставления зависят от проекта.
Проверку Git поручите разработчику или агенту отдельной задачей. Нужен просмотр истории, доступных веток и тегов, а не только текущих файлов. Добавление .env в .gitignore предотвращает его случайное добавление в будущем, но не убирает файл из прежних коммитов и не прекращает отслеживание файла, который уже попал в Git.
Отсутствие ключа в исходниках ещё не подтверждает безопасность работающего сайта. На сервере могла остаться старая сборка. Сопоставьте версию проекта с тем, что браузер получает сейчас, а после исправлений проверьте доступность сайта после правок Claude Code, чтобы защита ключа не отключила нужную функцию.
Что делать, если секретный API-ключ уже опубликован?
Сначала определите, кто управляет ключом и какую функцию сайта затронет его отключение. Если ключ оказался в публичном репозитории или браузерном коде, считайте его скомпрометированным. Удаление из файла не отменяет доступ у человека, который успел сохранить значение.
- В кабинете сервиса отзовите ключ, который попал в открытый доступ. Учтите, что связанные с ним функции перестанут работать до замены.
- Создайте замену с минимальными нужными правами и доступными ограничениями. Передайте её через настройки серверного окружения, без вставки в чат или исходный код.
- Исправьте подключение и опубликуйте новую сборку. Убедитесь, что браузер больше не получает секрет, а нужная операция проходит через сервер.
- Проверьте журнал использования и расходы в кабинете сервиса. Сохраните сведения о подозрительных операциях для обращения в поддержку.
- Согласуйте очистку истории Git и доступных копий с теми, кто работает над проектом. Переписывание истории влияет на совместную работу и требует отдельного подтверждения.
Очистка истории уменьшает дальнейшее распространение секрета, но не заменяет отзыв. Чужие копии репозитория вы не контролируете. В отчёте об исправлении достаточно указать, какой доступ закрыли, где теперь хранится замена и как проверили работу функции, без самих значений ключей.
Какие ошибки мешают проверить сайт перед запуском?
- Проверяют только текущую папку проекта. Исправление: включить в задание историю Git и опубликованную сборку.
- Принимают любое совпадение за утечку. Исправление: выяснить назначение значения по документации и настройкам сервиса.
- Считают скрытое поле или сжатый JavaScript защитой. Исправление: проверить всё, что получает браузер, и убрать оттуда секретный доступ.
- Просят ИИ показать найденные ключи полностью. Исправление: запрашивать пути и описание риска с маскировкой значений.
- Разрешают агенту сразу удалить файлы и переписать историю. Исправление: сначала получить отчёт, затем отдельно согласовать изменения и способ восстановления.
Если сайт делает подрядчик, включите проверку секретов в приёмку. Попросите перечень подключённых сервисов, описание серверных настроек и отчёт по браузерной сборке. Для отдельной технической проверки передайте копию проекта без действующих секретов и список функций, которые нужно проверить. Результатом должен стать список находок с подтверждениями исправлений, а не обещание «ИИ всё посмотрел».
Начните с действия на две минуты: откройте проект и добавьте задачу «Проверить секреты в файлах, истории Git и браузерной сборке; значения ключей в отчёт не включать».



