Översikt
IP-tillåtelselistor är en valfri säkerhetsfunktion som låter dig begränsa vilka IP-adresser som får åtkomst till ditt OpenAI-API.
När funktionen är aktiverad tillåts endast förfrågningar från angivna IP-adresser eller IP-intervall. Förfrågningar från alla andra IP-adresser avvisas, även om de innehåller en giltig API-nyckel.
Funktionen är avsedd att minska risken för obehörig API-användning genom att begränsa åtkomsten till betrodda nätverksmiljöer.
Obs! IP-tillåtelselistor gäller endast API-förfrågningar. De påverkar inte åtkomsten till platform.openai.com eller användarinloggning.
Varför använda IP-tillåtelselistor?
IP-tillåtelselistor kan hjälpa dig att:
Begränsa API-åtkomsten till känd infrastruktur (till exempel dina servrar eller molnmiljöer)
Minska risken om en API-nyckel läcker
Få ytterligare kontroll över varifrån API-trafiken kommer
IP-tillåtelselistor används oftast i produktionsmiljöer där API-trafiken kommer från fasta eller väldefinierade nätverksintervall.
Så fungerar det
Du konfigurerar en lista över tillåtna IP-adresser eller CIDR-intervall.
Förfrågningar från tillåtna IP-adresser accepteras.
Förfrågningar från IP-adresser som inte finns med i tillåtelselistan avvisas.
IP-tillåtelselistor kan tillämpas på:
Organisationsnivå, eller
Projektnivå
Tillgänglighet
IP-tillåtelselistor är tillgängliga för alla API-kunder.
Följ stegen nedan för att konfigurera en IP-tillåtelselista.
Konfigurera en IP-tillåtelselista
Obs! Du kan lägga till upp till 50 IP-adresser eller CIDR-intervall.
Öppna Inställningar.
Välj Säkerhet.
Välj IP-tillåtelselista.
Lägg till en eller flera IP-adresser eller CIDR-intervall.
(Valfritt) Använd verktyget Kontrollera för att se om en IP-adress finns med i din tillåtelselista.
Aktivera tillåtelselistan för:
Ett specifikt projekt, eller
Hela din organisation.
Testa förfrågningar från de miljöer du planerar att använda.
Vi rekommenderar att du börjar med ett enskilt projekt innan du aktiverar begränsningarna för hela organisationen.
Det kan ta upp till 15 minuter innan ändringarna börjar gälla.
Obs! Du måste ha rätt behörigheter i organisationen för att konfigurera inställningarna för IP-tillåtelselistan.
Felsökning
Om förfrågningar misslyckas oväntat:
Kontrollera att förfrågan kommer från en tillåten IP-adress.
Kontrollera om IP-adresserna i din infrastruktur har ändrats.
Kontrollera att dina konfigurerade IP-intervall är korrekta.
Vänta upp till 15 minuter så att konfigurationsändringarna hinner slå igenom.
Använd verktyget Kontrollera för att se om en IP-adress är tillåten.
Vad händer när en förfrågan blockeras?
Om en förfrågan kommer från en IP-adress som inte finns med i tillåtelselistan misslyckas den med följande fel:
HTTP-status: 401 Unauthorized
Felkod: ip_not_authorized
Exempelsvar:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Vanliga frågor
Förhindrar IP-tillåtelselistor all obehörig användning av min API-nyckel?
Nej. IP-tillåtelselistor kan minska risken genom att begränsa varifrån API-förfrågningar får komma, men de förhindrar inte alla former av missbruk. De bör användas tillsammans med andra rekommenderade säkerhetsrutiner, som säker nyckellagring, nyckelrotation och stark kontosäkerhet. För ytterligare säkerhet, läs våra guider i hjälpcentret om rekommenderade rutiner för API-nyckelsäkerhet och hur du förhindrar obehörig användning.
Påverkar IP-tillåtelselistor svarstiden?
IP-tillåtelselistor kan i vissa fall ge en minimal fördröjning, vanligtvis vid de första förfrågningarna. Funktionen förväntas inte påverka API:ets övergripande prestanda nämnvärt.
Hur vet jag om en förfrågan misslyckas på grund av IP-tillåtelselistan?
Förfrågningar som misslyckas på grund av IP-tillåtelselistan returnerar:
HTTP status: 401 UnauthorizedError code: ip_not_authorized