Prezentare generală
Lista de adrese IP permise este o funcție de securitate opțională care îți permite să limitezi adresele IP de la care poate fi accesat API-ul OpenAI pe care îl folosești.
Când este activată, sunt permise doar cererile provenite de la adresele IP sau din intervalele IP configurate. Cererile de la toate celelalte adrese IP sunt respinse, chiar dacă includ o cheie API validă.
Această funcție contribuie la reducerea riscului de utilizare neautorizată a API-ului, limitând accesul la medii de rețea de încredere.
Notă: lista de adrese IP permise se aplică doar cererilor API. Aceasta nu afectează accesul la platform.openai.com sau autentificarea utilizatorilor.
De ce să folosești o listă de adrese IP permise
Lista de adrese IP permise te poate ajuta să:
Limitezi accesul la API la infrastructura cunoscută (de exemplu, serverele sau mediile tale cloud)
Reduci expunerea la riscuri în cazul divulgării unei chei API
Adaugi un nivel suplimentar de control asupra surselor traficului API
Lista de adrese IP permise este folosită cel mai frecvent în medii de producție în care traficul API provine din intervale de adrese de rețea fixe sau bine definite.
Cum funcționează
Configurezi o listă de adrese IP sau intervale CIDR permise.
Cererile de la adresele IP permise sunt acceptate.
Cererile de la adresele IP care nu se află pe lista de adrese permise sunt respinse.
Lista de adrese IP permise poate fi aplicată:
La nivel de organizație sau
La nivel de proiect
Disponibilitate
Lista de adrese IP permise este disponibilă pentru toți clienții API.
Pentru a configura lista de adrese IP permise, urmează pașii de mai jos.
Configurarea listei de adrese IP permise
Notă: poți adăuga până la 50 de adrese IP sau intervale CIDR.
Deschide Setări.
Selectează Securitate.
Selectează Lista de adrese IP permise.
Adaugă una sau mai multe adrese IP ori intervale CIDR.
(Opțional) Folosește instrumentul Verificare pentru a verifica dacă o adresă IP este inclusă în lista de adrese permise.
Activează lista de adrese permise pentru:
Un anumit proiect sau
Întreaga organizație.
Testează cererile trimise din mediile pe care intenționezi să le folosești.
Îți recomandăm să începi cu un singur proiect înainte de a aplica restricțiile la nivelul întregii organizații.
După efectuarea modificărilor, poate dura până la 15 minute până când acestea intră în vigoare.
Notă: trebuie să ai permisiunile corespunzătoare în organizație pentru a configura setările listei de adrese IP permise.
Depanare
Dacă cererile eșuează în mod neașteptat:
Asigură-te că cererea provine de la o adresă IP permisă.
Verifică dacă adresele IP ale infrastructurii tale s-au schimbat.
Verifică dacă intervalele IP configurate sunt corecte.
Așteaptă până la 15 minute pentru propagarea modificărilor de configurare.
Folosește instrumentul Verificare pentru a verifica dacă o adresă IP este permisă.
Ce se întâmplă când o cerere este blocată
Dacă o cerere provine de la o adresă IP care nu se află pe lista de adrese permise, aceasta eșuează și returnează:
Stare HTTP: 401 Unauthorized
Cod de eroare: ip_not_authorized
Exemplu de răspuns:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Întrebări frecvente
Lista de adrese IP permise va împiedica orice utilizare neautorizată a cheii mele API?
Nu. Lista de adrese IP permise poate contribui la reducerea riscurilor, limitând sursele cererilor API, dar nu previne complet toate formele de utilizare abuzivă. Aceasta trebuie folosită împreună cu alte bune practici de securitate, precum stocarea în siguranță a cheilor, rotația acestora și protejarea temeinică a contului. Pentru securitate sporită, consultă ghidurile din centrul nostru de ajutor despre Bune practici pentru siguranța cheilor API și Prevenirea utilizării neautorizate.
Lista de adrese IP permise afectează latența?
Utilizarea listei de adrese IP permise poate adăuga o latență minimă în unele cazuri, de obicei la primele cereri. Nu se preconizează că va afecta semnificativ performanța generală a API-ului.
Cum aflu dacă o cerere eșuează din cauza listei de adrese IP permise?
Cererile care eșuează din cauza listei de adrese IP permise returnează:
HTTP status: 401 UnauthorizedError code: ip_not_authorized