Oversikt
IP-tillatelseslister er en valgfri sikkerhetsfunksjon som lar deg begrense hvilke IP-adresser som har tilgang til OpenAI-API-et ditt.
Når funksjonen er aktivert, tillates bare forespørsler fra de konfigurerte IP-adressene eller IP-områdene. Forespørsler fra alle andre IP-adresser avvises, selv om de inneholder en gyldig API-nøkkel.
Funksjonen er ment å bidra til å redusere risikoen for uautorisert API-bruk ved å begrense tilgangen til pålitelige nettverksmiljøer.
Merk: IP-tillatelseslister gjelder bare API-forespørsler. De påvirker ikke tilgangen til platform.openai.com eller brukerpålogging.
Hvorfor bruke IP-tillatelseslister
IP-tillatelseslister kan hjelpe deg med å:
Begrense API-tilgangen til kjent infrastruktur (for eksempel serverne eller skymiljøene dine)
Redusere risikoen hvis en API-nøkkel lekker
Gi et ekstra lag med kontroll over hvor API-trafikken kommer fra
IP-tillatelseslister brukes oftest i produksjonsmiljøer der API-trafikken kommer fra faste eller klart definerte nettverksområder.
Slik fungerer det
Du konfigurerer en liste over tillatte IP-adresser eller CIDR-områder.
Forespørsler fra tillatte IP-adresser godtas.
Forespørsler fra IP-adresser som ikke står på tillatelseslisten, avvises.
IP-tillatelseslister kan brukes på:
Organisasjonsnivå, eller
Prosjektnivå
Tilgjengelighet
IP-tillatelseslister er tilgjengelige for alle API-kunder.
Følg trinnene nedenfor for å konfigurere en IP-tillatelsesliste.
Konfigurer en IP-tillatelsesliste
Merk: Du kan legge til opptil 50 IP-adresser eller CIDR-områder.
Åpne Innstillinger.
Velg Sikkerhet.
Velg IP-tillatelsesliste.
Legg til én eller flere IP-adresser eller CIDR-områder.
(Valgfritt) Bruk verktøyet Kontroller for å sjekke om en IP-adresse er med i tillatelseslisten din.
Aktiver tillatelseslisten for:
Et bestemt prosjekt, eller
Hele organisasjonen din.
Test forespørsler fra miljøene du forventer å bruke.
Vi anbefaler at du starter med ett prosjekt før du aktiverer håndheving for hele organisasjonen.
Det kan ta opptil 15 minutter før endringer trer i kraft.
Merk: Du må ha de nødvendige tillatelsene i organisasjonen for å konfigurere innstillingene for IP-tillatelseslister.
Feilsøking
Hvis forespørsler mislykkes uventet:
Bekreft at forespørselen kommer fra en tillatt IP-adresse.
Sjekk om IP-adressene i infrastrukturen din har endret seg.
Kontroller at de konfigurerte IP-områdene er riktige.
Vent i opptil 15 minutter mens konfigurasjonsendringene trer i kraft.
Bruk verktøyet Kontroller for å sjekke om en IP-adresse er tillatt.
Hva skjer når en forespørsel blokkeres
Hvis en forespørsel kommer fra en IP-adresse som ikke står på tillatelseslisten, mislykkes den med:
HTTP-status: 401 Unauthorized
Feilkode: ip_not_authorized
Eksempel på svar:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Vanlige spørsmål
Vil en IP-tillatelsesliste forhindre all uautorisert bruk av API-nøkkelen min?
Nei. En IP-tillatelsesliste kan bidra til å redusere risikoen ved å begrense hvor API-forespørsler kan komme fra, men den forhindrer ikke alle former for misbruk. Den bør brukes sammen med andre anbefalte sikkerhetstiltak, som sikker oppbevaring av nøkler, nøkkelrotasjon og god kontosikkerhet. For ytterligere sikkerhet kan du lese veiledningene våre i hjelpesenteret om anbefalte fremgangsmåter for API-nøkkelsikkerhet og forebygging av uautorisert bruk.
Påvirker IP-tillatelseslister responstiden?
IP-tillatelseslister kan i noen tilfeller gi en minimal forsinkelse, vanligvis ved de første forespørslene. Dette forventes ikke å påvirke den samlede API-ytelsen vesentlig.
Hvordan vet jeg om en forespørsel mislykkes på grunn av IP-tillatelseslisten?
Forespørsler som mislykkes på grunn av IP-tillatelseslisten, returnerer:
HTTP status: 401 UnauthorizedError code: ip_not_authorized