Огляд
Список дозволених 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