Pregled
Seznam dovoljenih naslovov IP je izbirna varnostna funkcija, s katero lahko določite, kateri naslovi IP lahko dostopajo do vašega API-ja OpenAI.
Ko je omogočena, so dovoljene le zahteve z nastavljenih naslovov IP ali iz nastavljenih obsegov naslovov IP. Zahteve z vseh drugih naslovov IP so zavrnjene, tudi če vsebujejo veljaven ključ API.
Ta funkcija pomaga zmanjšati tveganje nepooblaščene uporabe API-ja tako, da dostop omeji na zaupanja vredna omrežna okolja.
Opomba: Seznam dovoljenih naslovov IP velja samo za zahteve API. Ne vpliva na dostop do platform.openai.com ali na prijavo uporabnikov.
Zakaj uporabljati seznam dovoljenih naslovov IP
Seznam dovoljenih naslovov IP vam lahko pomaga:
omejiti dostop do API-ja na znano infrastrukturo (na primer vaše strežnike ali okolja v oblaku)
zmanjšati izpostavljenost tveganjem ob razkritju ključa API
uvesti dodatno raven nadzora nad izvorom prometa API
Seznam dovoljenih naslovov IP se najpogosteje uporablja v produkcijskih okoljih, kjer promet API izvira iz stalnih ali jasno določenih omrežnih obsegov.
Kako deluje
Nastavite seznam dovoljenih naslovov IP ali obsegov CIDR.
Zahteve z dovoljenih naslovov IP so sprejete.
Zahteve z naslovov IP, ki niso na seznamu dovoljenih naslovov, so zavrnjene.
Seznam dovoljenih naslovov IP lahko uporabite na:
ravni organizacije ali
ravni projekta
Razpoložljivost
Seznam dovoljenih naslovov IP je na voljo vsem strankam, ki uporabljajo API.
Za nastavitev seznama dovoljenih naslovov IP sledite spodnjim korakom.
Nastavitev seznama dovoljenih naslovov IP
Opomba: Dodate lahko do 50 naslovov IP ali obsegov CIDR.
Odprite Nastavitve.
Izberite Varnost.
Izberite Seznam dovoljenih naslovov IP.
Dodajte enega ali več naslovov IP ali obsegov CIDR.
(Izbirno) Z orodjem Preveri preverite, ali je naslov IP na vašem seznamu dovoljenih naslovov.
Omogočite omejitev dostopa na dovoljene naslove IP za:
posamezen projekt ali
celotno organizacijo.
Preizkusite zahteve iz okolij, ki jih nameravate uporabljati.
Priporočamo, da omejitev najprej uvedete za en projekt, preden jo omogočite za celotno organizacijo.
Po spremembi nastavitev lahko traja do 15 minut, da spremembe začnejo veljati.
Opomba: Za urejanje nastavitev seznama dovoljenih naslovov IP morate imeti ustrezna dovoljenja v organizaciji.
Odpravljanje težav
Če so zahteve nepričakovano neuspešne:
Preverite, ali zahteva izvira z dovoljenega naslova IP.
Preverite, ali so se naslovi IP vaše infrastrukture spremenili.
Preverite pravilnost nastavljenih obsegov naslovov IP.
Počakajte do 15 minut, da spremembe nastavitev začnejo veljati povsod.
Z orodjem Preveri preverite, ali je naslov IP dovoljen.
Kaj se zgodi, ko je zahteva blokirana
Če zahteva izvira z naslova IP, ki ni na seznamu dovoljenih naslovov, je zavrnjena z naslednjima podatkoma:
Stanje HTTP: 401 Unauthorized
Koda napake: ip_not_authorized
Primer odgovora:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Pogosta vprašanja
Ali bo seznam dovoljenih naslovov IP preprečil vsakršno nepooblaščeno uporabo mojega ključa API?
Ne. Seznam dovoljenih naslovov IP lahko pomaga zmanjšati tveganje z omejevanjem izvora zahtev API, vendar ne prepreči vseh oblik zlorabe. Uporabljajte ga skupaj z drugimi dobrimi varnostnimi praksami, kot so varno shranjevanje ključev, redna menjava ključev in zanesljiva zaščita računa. Za dodatno varnost si v našem centru za pomoč oglejte vodnika Dobre prakse za varnost ključev API in Preprečevanje nepooblaščene uporabe.
Ali seznam dovoljenih naslovov IP vpliva na zakasnitev?
Uporaba seznama dovoljenih naslovov IP lahko v nekaterih primerih povzroči minimalno zakasnitev, običajno pri prvih zahtevah. Ne pričakujemo, da bi bistveno vplivala na splošno zmogljivost API-ja.
Kako vem, ali je zahteva neuspešna zaradi seznama dovoljenih naslovov IP?
Zahteve, ki so neuspešne zaradi seznama dovoljenih naslovov IP, vrnejo:
HTTP status: 401 UnauthorizedError code: ip_not_authorized