Descripción general
La lista de IP permitidas es una función de seguridad opcional que te permite restringir qué direcciones IP pueden acceder a tu API de OpenAI.
Cuando está activada, solo se permiten las solicitudes que provienen de las direcciones IP o los rangos de IP configurados. Las solicitudes de todas las demás IP se rechazan, incluso si incluyen una clave de API válida.
Esta función ayuda 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 el acceso a platform.openai.com ni el 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 infraestructura conocida (por ejemplo, tus servidores o entornos en la nube)
Reducir la exposición al riesgo si se filtra una clave de API
Agregar una capa adicional 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 proviene de rangos de red fijos o bien definidos.
Cómo funciona
Configuras una lista de direcciones IP o rangos CIDR permitidos.
Se aceptan las solicitudes de las IP permitidas.
Se rechazan las solicitudes de las IP que no están en la lista de IP permitidas.
La lista de IP permitidas se puede aplicar a nivel de:
Organización, o
Proyecto
Disponibilidad
La lista de IP permitidas está disponible para todos los clientes de la API.
Para configurar la lista de IP permitidas, sigue los pasos a continuación.
Configurar la lista de IP permitidas
Nota: puedes agregar hasta 50 direcciones IP o rangos CIDR.
Abre Configuración.
Selecciona Seguridad.
Selecciona Lista de IP permitidas.
Agrega una o más 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 específico, o
Toda tu organización.
Prueba las solicitudes desde los entornos que planeas usar.
Te recomendamos comenzar con un solo proyecto antes de aplicar las restricciones a toda la organización.
Los cambios pueden tardar hasta 15 minutos en aplicarse.
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 provenga de una dirección IP permitida.
Comprueba si las IP de tu infraestructura han cambiado.
Verifica que los rangos de IP configurados 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é sucede cuando se bloquea una solicitud
Si una solicitud proviene de una dirección IP que no está 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á todo 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 prácticas recomendadas 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 prácticas recomendadas para proteger las claves de API y prevención del uso no autorizado.
¿La lista de IP permitidas afecta la latencia?
La lista de IP permitidas puede agregar una latencia mínima en algunos casos, generalmente en las solicitudes iniciales. No se espera que afecte significativamente el 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:
Estado HTTP: 401 UnauthorizedCódigo de error: ip_not_authorized