GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Все руководства

· reAPI Team

Утечка API-ключа: останови несанкционированные запросы и списания

Локализуй утечку API-ключа, отдели новые запросы от ожидающих списаний, безопасно замени раскрытые учётные данные и подготовь доказательства для проверки начислений.

Утечка API-ключа: останови несанкционированные запросы и списания

Прямо сейчас отзови раскрытый ключ в консоли аккаунта провайдера. Запиши время. Скриншот, репозиторий или запись журнала можно исследовать после того, как учётные данные станут недействительными.

Удаление места, где появился секрет, не делает недействительной копию, которая уже есть у другого человека. Поэтому рекомендации GitHub ставят отзыв или ротацию перед очисткой репозитория.[1] Если приложение использует этот ключ, рассчитывай, что замену придётся согласовать. Работающее приложение — не причина оставлять активными учётные данные, о раскрытии которых уже известно.

Начни с привычного входа в аккаунт

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

В reAPI отзыв блокирует новые запросы с этим ключом. Приложениям, у которых он остался, понадобится замена. Документация по аутентификации также указывает, что ожидающие задачи могут продолжить выполнение до завершения и расходовать кредиты после отзыва.[2] Эта вторая часть важна, когда ты проверяешь баланс сразу после отзыва.

Проверяй автоматическое пополнение и незавершённые задания как отдельные механизмы управления. Если решишь отключить автоматическое финансирование, выясни, что именно останавливает эта настройка. Она не отзывает API-ключ, не отменяет принятые задания и сама по себе не объясняет списание. Если провайдер поддерживает отмену, проверь подтверждённый результат задачи и правило расчёта оплаты, а не считай, что нажатие «Отменить» сделало задание бесплатным.

На этом этапе достаточно короткой заметки: затронутый аккаунт, метка учётных данных, время обнаружения и время отзыва с часовым поясом. Более подробное расследование можно провести позже. Ожидание идеального отчёта продлевает время, в течение которого раскрытыми учётными данными можно пользоваться.

Почему баланс может меняться после отзыва

Предположим, запрос на генерацию принят в 09:01, ты отзываешь раскрытый ключ в 09:03, а задача завершается в 09:07. Это иллюстративная последовательность, а не описание зарегистрированного инцидента. Согласно документированному поведению ожидающих задач reAPI, ранее принятое задание может завершиться и потратить кредиты. Контракт задач также отделяет резервирование при отправке от окончательного расчёта.[2][3]

Сам по себе окончательный расчёт в 09:07 не доказывает, что после 09:03 ключ использовался для аутентификации нового запроса. Проверь, когда задача была принята. Эта временная метка отвечает на другой вопрос, чем время окончания обработки или появления списания.

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

Для каждого подозрительного запроса сохрани, если эти сведения доступны, ID, модель или конечную точку, время принятия, время завершения и окончательно начисленную сумму. Добавь, распознаёт ли его твоё приложение. Твоя цель — отделить известные задания от необъяснённых, а не доказать гипотезу по уменьшающемуся балансу.

Сумма под угрозой также может отличаться от уже окончательно начисленной. Читай поля резервирования и итогового использования в соответствии с контрактом платформы. В reAPI обработка платежа за выполняющуюся задачу с нулевым окончательно учтённым использованием ещё не завершена; этот ноль не доказывает возврат ранее зарезервированных средств.[3] Продолжай отслеживать нерешённые задачи, пока их результаты не станут известны.

Замени ключ в процессе, который действительно его использует

Создай замену через панель провайдера после аутентификации и сохрани её с помощью механизма управления секретами приложения. reAPI описывает создание ключей в настройках API Keys и рекомендует отдельные учётные данные для сред и сервисов.[2] Чётко обозначь назначение замены, чтобы при следующей ротации не пришлось заново искать всех потребителей.

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

Затем проследи путь учётных данных в приложении. Проверь веб-сервис, фоновые рабочие процессы, задания по расписанию и всю автоматизацию, вызывающую API. Включай локальную разработку и CI только в том случае, если они используют эти учётные данные. Нужно найти тех, кто действительно читает секрет, а не составлять длинный список систем, которые ты не эксплуатируешь.

Представь, что после ротации сайт снова работает, но API-вызовы фонового рабочего процесса по-прежнему возвращают ошибки аутентификации. Это гипотетический диагностический пример. Успешный веб-запрос подтверждает, что у одного процесса рабочая конфигурация. Об окружении отдельного рабочего процесса он ничего не говорит. Прежде чем создавать ещё один ключ, проверь, что на самом деле загружает процесс, в котором возникает ошибка.

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

При ошибке аутентификации reAPI проверь документированный заголовок Bearer и фактический ответ с ошибкой. Недействительные или отозванные учётные данные отличаются от недостаточного баланса и ошибок конечной точки.[2] Если новый ключ действителен, но аккаунт не может оплатить запрошенное задание, повторная ротация не решит проблему баланса.

Храни серверные учётные данные на сервере. Рекомендации Google по управлению ключами предостерегают от встраивания секретов в клиентский код, а GitHub рекомендует более безопасное обращение с секретами, чтобы избежать повторного раскрытия.[4][1] Браузерная сборка или распространяемое мобильное приложение — неподходящее место, чтобы прятать замену только потому, что так работает самый короткий пример из руководства.

Выясни, как утекла эта копия

Когда старые учётные данные станут недействительными, а законные потребители получат замену, вернись к раскрытой копии. Проверь конкретный путь, через который она могла быть опубликована: историю репозитория, собранные фронтенд-ресурсы, журналы CI, блокноты, скриншоты или опубликованный вывод диагностики.

Если она появилась в Git-репозитории, удаление текущего файла — только часть очистки. GitHub объясняет, что конфиденциальное содержимое может оставаться в истории, форках и клонах.[1] Любую очистку истории согласовывай с людьми, использующими репозиторий. Именно отзыв решает проблему скопированных учётных данных; очистка сокращает дальнейшее раскрытие в этих местах.

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

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

Отделяй установленные факты от определения виновника. Отсутствие запроса в журналах приложения свидетельствует о том, что эти журналы его не объясняют. Оно не устанавливает, кто отправил запрос или где получил учётные данные. Записывай подтверждаемое раскрытие и идентифицируемый трафик; остальное оставь для расследования.

Ограничь замену там, где подходят доступные механизмы

Google рекомендует отдельные учётные данные для приложений или команд, подходящие ограничения и мониторинг.[4] Применительно к ротации это означает предоставление фоновому процессу обработки изображений только необходимого доступа, если провайдер поддерживает такое ограничение, вместо привычного создания ещё одних широко используемых общих учётных данных.

Доступные механизмы различаются. fal документирует разрешения, срок действия и настройки разрешённых моделей. Security Center от OpenRouter документирует ограничения расходов и срока действия и отличает отключение ключа от его архивирования; список разрешённых IP-адресов — функция Enterprise.[5][6] Прежде чем полагаться на настройку, проверь область действия опции, действительно доступной в твоём аккаунте.

Для лимита расходов установи, ограничивает ли он учётные данные, аккаунт, операцию пополнения или другую величину и что происходит с принятыми заданиями. Для срока действия определи, каким приложениям нужна замена до этой даты. Для ограничения моделей проверь, допускает ли оно законную рабочую нагрузку. Механизм полезен, когда ты знаешь, какой сбой он сдерживает.

Назначь человека, который будет реагировать на предупреждения о необычном использовании. Уведомление может подсказать, что нужно расследование; для реагирования всё равно нужен человек, способный определить затронутые учётные данные и отозвать их. Храни сведения об ответственном рядом с назначением ключа. Во время инцидента ими проще воспользоваться, чем необъяснённым списком старых названий учётных данных.

Смена API-провайдера может быть отдельным продуктовым решением после инцидента. Она не делает недействительным ключ, оставшийся активным у старого провайдера, и не исправляет приложение, которое помещает следующий серверный секрет в ту же публичную сборку.

Отправь поддержке нерешённые вопросы

Подготовь обращение по начислениям на основе составленной хронологии. Укажи аккаунт или проект, безопасный идентификатор учётных данных, предполагаемый период подозрительной активности, время отзыва и ID запросов. Приложи соответствующие записи о списаниях и все идентификаторы квитанций, необходимые провайдеру. Не включай API-ключи, данные карт и непубличные файлы клиентов в общедоступные обращения и скриншоты.

Можно сформулировать запрос вокруг фактов, которые ещё нужно подтвердить:

Мы отозвали затронутые учётные данные в [время и часовой пояс]. В приложенном списке запросов деятельность, распознаваемая нашим приложением, отделена от деятельности, которую мы не можем объяснить. Подтвердите, были ли какие-либо из этих запросов приняты после отзыва, объясните окончательный расчёт по ранее ожидавшим заданиям и проверьте оспариваемые начисления.

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

Расследование безопасности и корректировка начислений — отдельные результаты. Обнаружение утечки или открытие обращения не означает, что списания будут отменены. Продолжай проверку, пока провайдер не ответит на конкретные запросы и не объяснит все корректировки. Тем временем новые учётные данные приложения, исправленный путь раскрытия и незавершённые задания можно по отдельности проверить по соответствующим записям.

Источники

  1. GitHub. Удаление конфиденциальных данных из репозитория. Дата обращения: 15 ноября 2026 года. Рекомендации GitHub по безопасности.
  2. reAPI. Справочник по аутентификации. Дата обращения: 15 ноября 2026 года. Документация по аутентификации.
  3. reAPI. Справочник по задачам. Дата обращения: 15 ноября 2026 года. Жизненный цикл задач и окончательный расчёт.
  4. Google Cloud. Рекомендации по управлению API-ключами. Дата обращения: 15 ноября 2026 года. Рекомендации Google Cloud по аутентификации.
  5. fal. Аутентификация по ключу. Дата обращения: 15 ноября 2026 года.
  6. OpenRouter. Управление API-ключами и снижение рисков с новым Security Center. Опубликовано 28 сентября 2026 года; дата обращения: 15 ноября 2026 года.
Все руководства