Visió general
La llista d'IP permeses és una funció de seguretat opcional que et permet restringir les adreces IP que poden accedir a la teva API d'OpenAI.
Quan està activada, només es permeten les sol·licituds procedents de les adreces IP o dels intervals d'IP configurats. Les sol·licituds de totes les altres IP es rebutgen, encara que incloguin una clau d'API vàlida.
Aquesta funció està pensada per ajudar a reduir el risc d'ús no autoritzat de l'API limitant l'accés a entorns de xarxa de confiança.
Nota: La llista d'IP permeses només s'aplica a les sol·licituds a l'API. No afecta l'accés a platform.openai.com ni l'inici de sessió dels usuaris.
Per què fer servir una llista d'IP permeses
La llista d'IP permeses et pot ajudar a:
Restringir l'accés a l'API a infraestructures conegudes (per exemple, els teus servidors o entorns al núvol)
Reduir l'exposició al risc en cas de filtració d'una clau d'API
Afegir un nivell addicional de control sobre l'origen del trànsit de l'API
La llista d'IP permeses s'utilitza sobretot en entorns de producció on el trànsit de l'API prové d'intervals de xarxa fixos o ben definits.
Com funciona
Configures una llista d'adreces IP o intervals CIDR permesos.
Les sol·licituds procedents d'IP permeses s'accepten.
Les sol·licituds procedents d'IP que no figuren a la llista d'IP permeses es rebutgen.
La llista d'IP permeses es pot aplicar a:
L'organització, o bé
El projecte
Disponibilitat
La llista d'IP permeses està disponible per a tots els clients de l'API.
Per configurar la llista d'IP permeses, segueix els passos següents.
Configura la llista d'IP permeses
Nota: Pots afegir fins a 50 adreces IP o intervals CIDR.
Obre Configuració.
Selecciona Seguretat.
Selecciona Llista d'IP permeses.
Afegeix una o més adreces IP o intervals CIDR.
(Opcional) Fes servir l'eina Comprova per verificar si una IP està inclosa a la llista d'IP permeses.
Activa la llista d'IP permeses per a:
Un projecte concret, o bé
Tota l'organització.
Prova d'enviar sol·licituds des dels entorns que preveus utilitzar.
Recomanem començar amb un sol projecte abans d'aplicar la restricció a tota l'organització.
Els canvis poden trigar fins a 15 minuts a tenir efecte.
Nota: Has de tenir els permisos adequats a l'organització per configurar la llista d'IP permeses.
Resolució de problemes
Si les sol·licituds fallen de manera inesperada:
Confirma que la sol·licitud prové d'una adreça IP permesa.
Comprova si les IP de la teva infraestructura han canviat.
Revisa que els intervals d'IP configurats siguin correctes.
Espera fins a 15 minuts perquè es propaguin els canvis de configuració.
Fes servir l'eina Comprova per verificar si una IP està permesa.
Què passa quan es bloqueja una sol·licitud
Si una sol·licitud prové d'una adreça IP que no figura a la llista d'IP permeses, fallarà amb:
Estat HTTP: 401 Unauthorized
Codi d'error: ip_not_authorized
Exemple de resposta:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Preguntes freqüents
La llista d'IP permeses impedirà qualsevol ús no autoritzat de la meva clau d'API?
No. La llista d'IP permeses pot ajudar a reduir el risc restringint l'origen de les sol·licituds a l'API, però no impedeix del tot totes les formes d'ús indegut. Cal fer-la servir juntament amb altres bones pràctiques de seguretat, com ara l'emmagatzematge segur de les claus, la rotació de claus i una protecció sòlida del compte. Per reforçar la seguretat, consulta les guies del nostre centre d'ajuda sobre bones pràctiques per a la seguretat de les claus d'API i prevenció de l'ús no autoritzat.
La llista d'IP permeses afecta la latència?
La llista d'IP permeses pot afegir una latència mínima en alguns casos, normalment en les primeres sol·licituds. No es preveu que afecti significativament el rendiment global de l'API.
Com puc saber si una sol·licitud falla a causa de la llista d'IP permeses?
Les sol·licituds que fallen a causa de la llista d'IP permeses retornen:
HTTP status: 401 UnauthorizedError code: ip_not_authorized