Por defecto, una clave de API funciona desde cualquier lugar. Una lista de IP permitidas la vincula a los lugares donde realmente ejecuta su código.
Cómo funciona
El edge de la API compara la IP de origen de cada solicitud con una lista. Si la dirección está en la lista, o dentro de un rango incluido, la solicitud sigue hacia la comprobación normal de la clave. Si no, se rechaza.
Los rangos se escriben en notación CIDR: una dirección, una barra y una longitud de prefijo. El RFC 4632 explica que la longitud de prefijo es cuántos bits iniciales son fijos. Para IPv4:
| Entrada | Cubre |
|---|---|
203.0.113.7 |
una dirección |
198.51.100.0/24 |
256 direcciones, de 198.51.100.0 a 198.51.100.255 |
10.0.0.0/16 |
65,536 direcciones |
IPv6 usa la misma idea con direcciones de 128 bits, como 2001:db8::/48.
La dirección que importa es su IP de salida (egress): la dirección pública desde la que sale el tráfico de su servidor. Detrás de un NAT, un balanceador de carga o un proxy corporativo, a menudo no es la dirección que la máquina muestra como propia.
Por qué importa
Las claves de API son bearer tokens: quien tiene una puede usarla. Las claves se filtran por commits, logs, capturas de pantalla y portátiles. Con una lista de IP permitidas, una clave robada falla desde la red del atacante, lo que convierte una filtración de un incidente de gasto en algo sin consecuencias. GitHub, por ejemplo, aplica su lista de IP permitidas a las llamadas a la API y a los tokens de acceso personal, además de a los inicios de sesión web.
El precio es algo de trabajo operativo. Cada nuevo servidor, región o runner de CI necesita que se añada su IP de salida, y las IPs dinámicas necesitan una ruta de salida fija.
En BroadNet Inference
En la página de la cuenta, añada una dirección IPv4 o IPv6 o un rango CIDR por línea, hasta 32 entradas. Una lista vacía significa sin restricciones. Las claves nuevas heredan la lista de la cuenta. Un allowed_ips por clave la sustituye para esa clave:
curl -X POST https://inference.broadnet.ai/portal/keys \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
-H "Content-Type: application/json" \
-d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
Las solicitudes desde otras direcciones reciben un 403. Tras un cambio o la revocación de una clave, las solicitudes nuevas se detienen en cinco segundos. Los pasos completos están en claves de API y listas de IP permitidas, y la tabla de errores en errores y reintentos. Para el panorama más amplio de protección de datos, consulte la lista de verificación de ZDR.
Errores comunes
- Añadir la dirección privada de un servidor, como
10.x.x.x, en lugar de su IP pública de salida. - Usar un rango muy amplio para que desaparezcan los errores. Un
/8cubre más de 16 millones de direcciones.