Descripción general
La lista de IP permitidas es una función de seguridad opcional que te permite limitar qué direcciones IP pueden acceder a tu API de OpenAI.
Cuando está activada, solo se permiten solicitudes procedentes de las direcciones IP o los rangos de IP configurados. Las solicitudes procedentes de cualquier otra IP se rechazan, aunque incluyan una clave de API válida.
Esta función está diseñada para ayudar a reducir el riesgo de uso no autorizado de la API al limitar el acceso a entornos de red de confianza.
Nota: la lista de IP permitidas solo se aplica a las solicitudes a la API. No afecta al acceso a platform.openai.com ni al inicio de sesión de los usuarios.
Por qué usar una lista de IP permitidas
La lista de IP permitidas puede ayudarte a:
restringir el acceso a la API a infraestructuras conocidas (por ejemplo, tus servidores o entornos en la nube)
reducir la exposición al riesgo si se filtra una clave de API
añadir una capa de control sobre el origen del tráfico de la API
La lista de IP permitidas se usa principalmente en entornos de producción donde el tráfico de la API procede de rangos de red fijos o bien definidos.
Cómo funciona
Configuras una lista de direcciones IP o rangos CIDR permitidos.
Las solicitudes procedentes de IP permitidas se aceptan.
Las solicitudes procedentes de IP que no figuran en la lista se rechazan.
La lista de IP permitidas se puede aplicar a:
la organización, o
el proyecto
Disponibilidad
La función de lista de IP permitidas está disponible para todos los clientes de la API.
Para configurar la lista de IP permitidas, sigue los pasos que se indican a continuación.
Configurar la lista de IP permitidas
Nota: puedes añadir hasta 50 direcciones IP o rangos CIDR.
Abre Configuración.
Selecciona Seguridad.
Selecciona Lista de IP permitidas.
Añade una o varias direcciones IP o rangos CIDR.
(Opcional) Usa la herramienta Comprobar para verificar si una IP está incluida en tu lista de IP permitidas.
Activa la lista de IP permitidas para:
un proyecto concreto, o
toda tu organización.
Prueba a enviar solicitudes desde los entornos que tengas previsto usar.
Te recomendamos empezar con un solo proyecto antes de aplicar la lista a toda la organización.
Los cambios pueden tardar hasta 15 minutos en surtir efecto.
Nota: debes tener los permisos adecuados en la organización para configurar la lista de IP permitidas.
Solución de problemas
Si tus solicitudes fallan de forma inesperada:
Confirma que la solicitud procede de una dirección IP permitida.
Comprueba si han cambiado las IP de tu infraestructura.
Revisa los rangos de IP configurados para comprobar que sean correctos.
Espera hasta 15 minutos para que se propaguen los cambios de configuración.
Usa la herramienta Comprobar para verificar si una IP está permitida.
Qué ocurre cuando se bloquea una solicitud
Si una solicitud procede de una dirección IP que no figura en la lista de IP permitidas, fallará y devolverá:
Estado HTTP: 401 Unauthorized
Código de error: ip_not_authorized
Ejemplo de respuesta:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Preguntas frecuentes
¿La lista de IP permitidas evitará cualquier uso no autorizado de mi clave de API?
No. La lista de IP permitidas puede ayudar a reducir el riesgo al restringir el origen de las solicitudes a la API, pero no evita por completo todas las formas de uso indebido. Debes usarla junto con otras buenas prácticas de seguridad, como el almacenamiento seguro y la rotación de claves, y una protección sólida de la cuenta. Para reforzar la seguridad, consulta nuestras guías del centro de ayuda sobre buenas prácticas para proteger las claves de API y prevención del uso no autorizado.
¿La lista de IP permitidas afecta a la latencia?
La lista de IP permitidas puede añadir una latencia mínima en algunos casos, normalmente en las primeras solicitudes. No se prevé que afecte de forma significativa al rendimiento general de la API.
¿Cómo sé si una solicitud falla debido a la lista de IP permitidas?
Las solicitudes que fallan debido a la lista de IP permitidas devuelven:
HTTP status: 401 UnauthorizedError code: ip_not_authorized