Краткий ответ
Максимальная покупательная способность ключа определяется вашим балансом аккаунта — то есть если утечет любой один ключ, ваш наихудший возможный убыток будет равен всему, что осталось на вашем счете. Защита ваших ключей сводится к четырем вещам: выдавайте отдельные ключи для каждой цели, задавайте каждому ключу границу полномочий, ограничивайте сумму, которую может потратить один ключ, и не храните ключи там, где их может увидеть кто-то другой.1. Установите для token границу прав доступа
При создании token отметьте «Включить расширенные параметры», чтобы показать настройки белого списка IP и доступных моделей.
Белый список IP-адресов (рекомендуется для production)
Это самая надежная защита из доступных. После настройки только запросы с указанных IP-адресов смогут использовать token — даже если ключ утечет, с любого другого компьютера он бесполезен.Белый список доступных моделей (для выделенных tokens)
Если оставить поле “Доступные модели” пустым, ограничений не будет — token сможет вызывать любую model на платформе. После заполнения этого поля token сможет только использовать модели, которые вы указали. У этого есть и плюсы, и минусы:Подходит
tokens для одной задачи: сервис, который только генерирует изображения, token, которым вы делитесь с внешним сотрудником, или изоляция бюджета по каждой модели.
Не подходит
Ежедневное личное использование и пробное тестирование. Вам придется возвращаться в консоль каждый раз, когда вы переключаете models, а несовпадающие псевдонимы model могут ломать вызовы.
В большинстве случаев мы не рекомендуем задавать доступные модели. См. Нужно ли задавать доступные модели для token? для полного анализа компромиссов.
2. Установите лимит расходов на токен
Это относится ко всем, и особенно к тестовым ключам. При создании токена отключите «Неограниченная квота» и укажите сумму в поле «Авторизованная квота» — либо используйте один из пресетов ниже под полем ($5 / $20 / $50 / $100 / $200 / $500).
- Скомпрометированный ключ с квотой $20 обойдется вам максимум в $20
- Скомпрометированный ключ с включенной «Неограниченной квотой» может стоить вам весь баланс аккаунта
Максимальная сумма расходов по токену ограничена балансом вашего аккаунта. Квота $500 не резервирует и не замораживает эти деньги — это лишь верхний предел расходов этого токена. Реально он все равно может потратить только то, что доступно на балансе.
3. Храните боевые и тестовые ключи раздельно
Никогда не используйте один ключ и для боевого трафика, и для локального тестирования. Когда они разделены, вы сможете полностью отключить проблемный test token, не затрагивая production.4. Не храните ключи в этих местах
Репозитории кода
Это безусловно самый распространенный путь утечки. Если ключ однажды попадает в Git, он остается в истории коммитов даже после удаления файла, и любой, у кого есть доступ к репозиторию, может его извлечь. Вместо этого читайте их из переменных окружения:.env в .gitignore и проверяйте перед коммитом. Эта команда подходит для самопроверки:
Префикс
(^|[^A-Za-z0-9]) в этом шаблоне важен. Без него sk- внутри обычных слов вроде task-, risk- и disk- вызывает лавину ложных срабатываний, которая скрывает реальные результаты.Публичная документация, скриншоты и журналы
Перед публикацией документации или технического материала проверьте текст, примеры кода и скриншоты. Скриншоты консоли, записи терминала и журналы ошибок нередко содержат ключ целиком. Используйте заполнитель вродеsk-your-api-key в каждом примере.
Переписка с AI и AI-агентами
Этому пути утечки всего несколько лет, и его чаще всего недооценивают. Вставка ключа в чат кажется временной мерой, но на практике:Транскрипты попадают на диск
Инструменты AI для программирования обычно хранят полный разговор на вашем компьютере в виде файлов обычного текста, сохраняют их бессрочно и никогда не очищают автоматически.
Возобновление повторно передает
Возобновление старой сессии снова отправляет весь транскрипт как контекст, поэтому ключ не остается статичным.
Снимки файлов дублируют его
Эти инструменты часто создают снимки файлов до и после изменений, поэтому скрипт с ключом оказывается скопирован несколько раз.
Любой локальный процесс может прочитать их
Эти файлы доступны для чтения любой программе, запущенной от вашего имени — это более слабая граница, чем у вашего репозитория кода.
Что делать, если ключ уже утек
1
Немедленно удалите или отключите token
Перейдите на страницу token и удалите или отключите скомпрометированный token. Это единственное действие, которое немедленно прекращает утечку, и оно выполняется до любого расследования.
2
Создайте replacement token
Выпустите новый token — на этот раз с лимитом расходов и любыми применимыми границами разрешений — и обновите конфигурацию приложения.
3
Проверьте логи на предмет последствий
Просмотрите ваши журналы вызовов на предмет аномалий в период утечки: незнакомые модели, необычный объем или запросы в часы, когда вы не работали.
4
Устраните источник утечки
Выясните, где именно произошла утечка ключа — в коде, документации, скриншотах, транскриптах чата — и удалите это везде. Иначе ключ на замену утечет тем же способом.
Частые вопросы
Я настроил IP whitelist, и теперь каждый вызов завершается ошибкой. Что пошло не так?
Я настроил IP whitelist, и теперь каждый вызов завершается ошибкой. Что пошло не так?
Скорее всего, указан неверный IP. Вам нужен публичный исходящий IP сервера, а не внутренний адрес вроде
192.168.x.x.Если вы вызываете из домашнего широкополосного подключения или офисной сети, исходящий IP меняется вместе с вашим ISP, и такие среды плохо подходят для IP whitelist — используйте вместо этого лимит расходов.Чтобы устранить проблему, сначала очистите IP whitelist, убедитесь, что вызовы снова работают, а затем добавляйте правильные IP по одному.Если задать квоту, деньги будут списаны или заморожены заранее?
Если задать квоту, деньги будут списаны или заморожены заранее?
Нет. Авторизованная квота — это только потолок расходов для этого token, а не предоплата и не блокировка средств.Вы можете назначить пяти token по квоте $100 каждому, имея на аккаунте только $50 — они будут делить эти $50, и когда они закончатся, ни один из token работать не будет. Максимальная расходная способность token всегда ограничена балансом аккаунта.
Сколько token может создать один аккаунт?
Сколько token может создать один аккаунт?
Ограничений нет; создавайте столько, сколько нужно.Мы рекомендуем разделять их по схеме проект плюс среда, например
prod-support-bot, prod-image-service, test-model-eval. Более гранулярные token позволяют отключить ровно один, не затрагивая ничего остального, а расходы и логи каждого token можно проверять независимо.Когда квота token исчерпана, он становится недействительным?
Когда квота token исчерпана, он становится недействительным?
Нет. После исчерпания квоты вызовы отклоняются, но сам token сохраняется. Просто отредактируйте token и увеличьте разрешенную квоту в консоли, чтобы продолжить — не нужно создавать новый или обновлять конфигурацию.Именно поэтому стоит задавать лимит расходов: это восстановимый ограничитель, а не необратимое удаление.
Как понять, что кто-то еще использует мой key?
Как понять, что кто-то еще использует мой key?
Проверьте логи вызовов. Самые важные три признака: models, которые вы никогда не используете, вызовы вне рабочего времени и объем запросов, не соответствующий вашей нагрузке.См. Как расследовать неожиданное использование ключа? для полной процедуры.
Связанные документы
Tokens и группы
Полная справка по созданию, редактированию и группировке tokens.
Белый список моделей Token
Стоит ли задавать доступные модели и на что обратить внимание.
Изучение использования ключа
Используйте логи, чтобы определить реального инициатора неожиданных обращений.
Безопасность данных платформы
Как APIYI шифрует трафик и защищает ваши данные на стороне платформы.
Безопасность никогда не бывает мелочью. Все настройки выше находятся на странице управления token — нескольких минут настройки достаточно, чтобы закрыть большую часть риска.