Overzicht
Een IP-toegangslijst is een optionele beveiligingsfunctie waarmee je kunt beperken welke IP-adressen toegang hebben tot je OpenAI-API.
Als deze functie is ingeschakeld, worden alleen verzoeken van ingestelde IP-adressen of IP-bereiken toegestaan. Verzoeken van alle andere IP-adressen worden geweigerd, zelfs als ze een geldige API-sleutel bevatten.
Deze functie helpt het risico op ongeautoriseerd API-gebruik te verkleinen door de toegang te beperken tot vertrouwde netwerkomgevingen.
Opmerking: IP-toegangslijsten zijn alleen van toepassing op API-verzoeken. Ze hebben geen invloed op de toegang tot platform.openai.com of het inloggen van gebruikers.
Waarom een IP-toegangslijst gebruiken
Met een IP-toegangslijst kun je:
API-toegang beperken tot bekende infrastructuur (bijvoorbeeld je servers of cloudomgevingen)
Het risico beperken als een API-sleutel uitlekt
Extra controle krijgen over waar API-verkeer vandaan mag komen
IP-toegangslijsten worden vooral gebruikt in productieomgevingen waar API-verkeer afkomstig is uit vaste of duidelijk afgebakende netwerkbereiken.
Hoe het werkt
Je stelt een lijst met toegestane IP-adressen of CIDR-bereiken in.
Verzoeken van toegestane IP-adressen worden geaccepteerd.
Verzoeken van IP-adressen die niet op de toegangslijst staan, worden geweigerd.
Je kunt een IP-toegangslijst toepassen op:
Organisatieniveau, of
Projectniveau
Beschikbaarheid
IP-toegangslijsten zijn beschikbaar voor alle API-klanten.
Volg de onderstaande stappen om een IP-toegangslijst in te stellen.
Een IP-toegangslijst instellen
Opmerking: Je kunt maximaal 50 IP-adressen of CIDR-bereiken toevoegen.
Open Instellingen.
Selecteer Beveiliging.
Selecteer IP-toegangslijst.
Voeg een of meer IP-adressen of CIDR-bereiken toe.
(Optioneel) Gebruik de tool Controleren om na te gaan of een IP-adres op je toegangslijst staat.
Schakel de toegangslijst in voor:
Een specifiek project, of
Je hele organisatie.
Test verzoeken vanuit de omgevingen die je wilt gebruiken.
We raden aan om met één project te beginnen voordat je de toegangslijst voor de hele organisatie afdwingt.
Het kan tot 15 minuten duren voordat wijzigingen van kracht worden.
Opmerking: Je moet over de juiste organisatierechten beschikken om een IP-toegangslijst in te stellen.
Problemen oplossen
Als verzoeken onverwacht mislukken:
Controleer of het verzoek afkomstig is van een toegestaan IP-adres.
Controleer of de IP-adressen van je infrastructuur zijn gewijzigd.
Controleer of je ingestelde IP-bereiken kloppen.
Houd er rekening mee dat het tot 15 minuten kan duren voordat configuratiewijzigingen overal zijn doorgevoerd.
Gebruik de tool Controleren om na te gaan of een IP-adres is toegestaan.
Wat er gebeurt als een verzoek wordt geblokkeerd
Als een verzoek afkomstig is van een IP-adres dat niet op de toegangslijst staat, mislukt het met:
HTTP-status: 401 Unauthorized
Foutcode: ip_not_authorized
Voorbeeldantwoord:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Veelgestelde vragen
Voorkomt een IP-toegangslijst elk ongeautoriseerd gebruik van mijn API-sleutel?
Nee. Een IP-toegangslijst kan het risico verkleinen door te beperken waar API-verzoeken vandaan mogen komen, maar voorkomt niet alle vormen van misbruik. Gebruik deze functie samen met andere aanbevolen beveiligingsmaatregelen, zoals het veilig opslaan en regelmatig vervangen van sleutels en een sterke accountbeveiliging. Raadpleeg voor aanvullende beveiliging onze handleidingen in het Helpcentrum over aanbevolen werkwijzen voor veilige API-sleutels en het voorkomen van ongeautoriseerd gebruik.
Heeft een IP-toegangslijst invloed op de latentie?
Een IP-toegangslijst kan in sommige gevallen een minimale vertraging veroorzaken, meestal bij de eerste verzoeken. Naar verwachting heeft dit geen noemenswaardige invloed op de algehele API-prestaties.
Hoe weet ik of een verzoek mislukt door de IP-toegangslijst?
Verzoeken die mislukken door de IP-toegangslijst geven het volgende terug:
HTTP status: 401 UnauthorizedError code: ip_not_authorized