Обзор
Список разрешённых IP-адресов — это дополнительная функция безопасности, позволяющая ограничить доступ к вашему API OpenAI определёнными IP-адресами.
Когда эта функция включена, разрешены только запросы с указанных IP-адресов или диапазонов IP-адресов. Запросы со всех остальных IP-адресов отклоняются, даже если содержат действительный ключ API.
Эта функция помогает снизить риск несанкционированного использования API, предоставляя доступ только из доверенных сетевых сред.
Примечание: список разрешённых IP-адресов применяется только к запросам API. Он не влияет на доступ к platform.openai.com или вход в аккаунт.
Зачем использовать список разрешённых IP-адресов
Список разрешённых IP-адресов помогает:
Ограничить доступ к API известной инфраструктурой (например, вашими серверами или облачными средами)
Снизить риски в случае утечки ключа API
Обеспечить дополнительный контроль над источниками трафика API
Список разрешённых IP-адресов чаще всего используют в производственных средах, где трафик API поступает из фиксированных или чётко определённых сетевых диапазонов.
Как это работает
Вы настраиваете список разрешённых IP-адресов или диапазонов CIDR.
Запросы с разрешённых IP-адресов принимаются.
Запросы с IP-адресов, не входящих в список разрешённых, отклоняются.
Список разрешённых IP-адресов можно применять на уровне:
Организации или
Проекта
Доступность
Список разрешённых IP-адресов доступен всем клиентам API.
Чтобы настроить список разрешённых IP-адресов, выполните следующие действия.
Настройка списка разрешённых IP-адресов
Примечание: можно добавить до 50 IP-адресов или диапазонов CIDR.
Откройте Настройки.
Выберите Безопасность.
Выберите Список разрешённых IP-адресов.
Добавьте один или несколько IP-адресов или диапазонов CIDR.
(Необязательно) Используйте инструмент Проверка, чтобы узнать, входит ли IP-адрес в список разрешённых.
Включите ограничение доступа по списку разрешённых IP-адресов для:
Отдельного проекта или
Всей организации.
Проверьте отправку запросов из сред, которые планируете использовать.
Рекомендуем начать с одного проекта, прежде чем включать ограничения для всей организации.
Внесённые изменения могут вступать в силу в течение 15 минут.
Примечание: для настройки списка разрешённых IP-адресов необходимы соответствующие права в организации.
Устранение неполадок
Если запросы неожиданно завершаются ошибкой:
Убедитесь, что запрос отправляется с разрешённого IP-адреса.
Проверьте, не изменились ли IP-адреса вашей инфраструктуры.
Проверьте правильность указанных диапазонов IP-адресов.
Подождите до 15 минут, пока изменения настроек вступят в силу.
Используйте инструмент Проверка, чтобы узнать, разрешён ли IP-адрес.
Что происходит при блокировке запроса
Если запрос поступает с IP-адреса, не входящего в список разрешённых, он отклоняется со следующими данными:
Статус HTTP: 401 Unauthorized
Код ошибки: ip_not_authorized
Пример ответа:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Часто задаваемые вопросы
Полностью ли список разрешённых IP-адресов предотвращает несанкционированное использование моего ключа API?
Нет. Список разрешённых IP-адресов помогает снизить риск, ограничивая источники запросов API, но не предотвращает все виды злоупотреблений. Его следует использовать вместе с другими мерами безопасности: безопасным хранением и регулярной сменой ключей, а также надёжной защитой аккаунта. Чтобы повысить безопасность, ознакомьтесь со статьями нашего справочного центра: Рекомендации по защите ключей API и Предотвращение несанкционированного использования.
Влияет ли список разрешённых IP-адресов на задержку?
Проверка по списку разрешённых IP-адресов в некоторых случаях может добавлять минимальную задержку, обычно при первых запросах. Существенного влияния на общую производительность API не ожидается.
Как узнать, что запрос отклонён из-за списка разрешённых IP-адресов?
При отклонении запроса из-за списка разрешённых IP-адресов возвращаются:
HTTP status: 401 UnauthorizedError code: ip_not_authorized