Общ преглед

Списъкът с разрешени IP адреси е незадължителна функция за сигурност, която ви позволява да ограничите IP адресите, от които е възможен достъп до вашия OpenAI API.

Когато функцията е включена, се допускат само заявки от зададените 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 нотация.

1. Отворете Настройки.

2. Изберете Сигурност.

3. Изберете Списък с разрешени IP адреси.

4. Добавете един или повече IP адреси или диапазони в CIDR нотация.

5. (По избор) Използвайте инструмента Проверка, за да проверите дали даден IP адрес е включен в списъка с разрешени адреси.

6. Включете ограничаването на достъпа по списъка за:

   • Конкретен проект или

   • Цялата ви организация.

7. Тествайте заявки от средите, които планирате да използвате.

Препоръчваме да започнете с един проект, преди да приложите ограниченията за цялата организация.

След като направите промени, може да са необходими до 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 статус: 401 Unauthorized

• Код на грешката: ip_not_authorized