Áttekintés
Az IP-engedélyezési lista egy opcionális biztonsági funkció, amellyel korlátozhatod, hogy mely IP-címekről lehessen hozzáférni az OpenAI API-dhoz.
Bekapcsolásakor csak a beállított IP-címekről vagy IP-tartományokból érkező kérések engedélyezettek. A rendszer minden más IP-címről érkező kérést elutasít, még akkor is, ha érvényes API-kulcsot tartalmaz.
A funkció célja, hogy a hozzáférést megbízható hálózati környezetekre korlátozva segítsen csökkenteni a jogosulatlan API-használat kockázatát.
Megjegyzés: Az IP-engedélyezési lista csak az API-kérésekre vonatkozik. Nem befolyásolja a platform.openai.com elérését vagy a felhasználók bejelentkezését.
Miért érdemes IP-engedélyezési listát használni?
Az IP-engedélyezési lista segítségével:
Ismert infrastruktúrára korlátozhatod az API-hozzáférést (például a szervereidre vagy felhőkörnyezeteidre)
Csökkentheted az API-kulcs kiszivárgásából eredő kockázatot
További módon szabályozhatod, hogy honnan érkezhet API-forgalom
Az IP-engedélyezési listát leggyakrabban olyan éles környezetekben használják, ahol az API-forgalom rögzített vagy jól meghatározott hálózati tartományokból érkezik.
Hogyan működik?
Összeállítasz egy listát az engedélyezett IP-címekről vagy CIDR-tartományokról.
A rendszer elfogadja az engedélyezett IP-címekről érkező kéréseket.
Az engedélyezési listán nem szereplő IP-címekről érkező kéréseket elutasítja.
Az IP-engedélyezési lista alkalmazható:
Szervezeti szinten, vagy
Projektszinten
Elérhetőség
Az IP-engedélyezési lista minden API-ügyfél számára elérhető.
Az IP-engedélyezési lista beállításához kövesd az alábbi lépéseket.
IP-engedélyezési lista beállítása
Megjegyzés: Legfeljebb 50 IP-címet vagy CIDR-tartományt adhatsz hozzá.
Nyisd meg a Beállítások menüt.
Válaszd a Biztonság lehetőséget.
Válaszd az IP-engedélyezési lista lehetőséget.
Adj hozzá egy vagy több IP-címet vagy CIDR-tartományt.
(Opcionális) Az Ellenőrzés eszközzel ellenőrizheted, hogy egy IP-cím szerepel-e az engedélyezési listádon.
Kapcsold be az engedélyezési lista használatát:
Egy adott projektre, vagy
A teljes szervezetedre.
Teszteld a kéréseket a használni kívánt környezetekből.
Javasoljuk, hogy először egyetlen projekten próbáld ki, mielőtt a teljes szervezetre érvényesíted a korlátozást.
A módosítások érvénybe lépése akár 15 percet is igénybe vehet.
Megjegyzés: Az IP-engedélyezési lista beállításához megfelelő szervezeti jogosultságokkal kell rendelkezned.
Hibaelhárítás
Ha a kérések váratlanul sikertelenek:
Győződj meg arról, hogy a kérés engedélyezett IP-címről érkezik.
Ellenőrizd, hogy megváltoztak-e az infrastruktúrád IP-címei.
Ellenőrizd a beállított IP-tartományok helyességét.
Várj akár 15 percet, amíg a beállítások módosításai mindenhol érvénybe lépnek.
Az Ellenőrzés eszközzel ellenőrizheted, hogy egy IP-cím engedélyezett-e.
Mi történik egy kérés blokkolásakor?
Ha egy kérés az engedélyezési listán nem szereplő IP-címről érkezik, a következő hibával meghiúsul:
HTTP-állapot: 401 Unauthorized
Hibakód: ip_not_authorized
Példaválasz:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Gyakori kérdések
Az IP-engedélyezési lista megakadályozza az API-kulcsom minden jogosulatlan használatát?
Nem. Az IP-engedélyezési lista segíthet csökkenteni a kockázatot azáltal, hogy korlátozza, honnan érkezhetnek API-kérések, de nem akadályozza meg teljesen a visszaélések minden formáját. Más bevált biztonsági gyakorlatokkal együtt érdemes használni, például a kulcsok biztonságos tárolásával és rendszeres cseréjével, valamint a fiók erős védelmével. A biztonság további növeléséhez tekintsd át súgóközpontunk útmutatóit: Bevált gyakorlatok az API-kulcsok védelméhez és A jogosulatlan használat megelőzése.
Befolyásolja az IP-engedélyezési lista a késleltetést?
Az IP-engedélyezési lista egyes esetekben minimális késleltetést okozhat, jellemzően az első kéréseknél. Várhatóan nem befolyásolja jelentősen az API általános teljesítményét.
Honnan tudhatom, hogy egy kérés az IP-engedélyezési lista miatt sikertelen?
Az IP-engedélyezési lista miatt sikertelen kérések a következőket adják vissza:
HTTP-állapot: 401 UnauthorizedHibakód: ip_not_authorized