---
title: "¿Qué es una lista de IP permitidas para una API key?"
description: "Una lista de IP permitidas solo acepta solicitudes de las direcciones o rangos CIDR listados. Cómo protege una clave de API, cómo funciona CIDR y fallos en la nube."
url: https://broadrouter.com/es/glossary/ip-allow-list/
lang: es
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/glossary/ip-allow-list/) (actualizado el 2026-11-14).

# Lista de IP permitidas (IP allow list)

Actualizado 2026-11-14

Una lista de IP permitidas es un control de seguridad que solo acepta solicitudes de direcciones IP o rangos CIDR incluidos en ella y rechaza todas las demás. En una API, limita el daño de una clave filtrada, porque la clave no funciona desde redes que no estén en la lista.

También llamado: lista de IP permitidas, lista blanca de IP, IPs permitidas, restricción por IP, allowlist de IP, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed\_ips

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](https://broadrouter.com/es/glossary/api-key/) 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:

```bash
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](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/), y la tabla de errores en [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/). Para el panorama más amplio de protección de datos, consulte la [lista de verificación de ZDR](https://broadrouter.com/es/blog/zero-data-retention-llm-api-checklist/).

## 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 `/8` cubre más de 16 millones de direcciones.

## Preguntas frecuentes

### ¿Basta una lista de IP permitidas para proteger una clave de API?

No. Es una capa más. Siga guardando las claves en servidores, fuera del código y de los logs, dé a cada aplicación su propia clave y revóquelas rápido si se filtran.

### Mis servidores son serverless o con autoescalado. ¿Puedo usar una lista de IP permitidas?

Solo si el tráfico saliente sale desde direcciones conocidas. Hágalo pasar por un NAT gateway o un proxy de salida con IPs fijas y añada esas direcciones a la lista.

### ¿Qué error recibo desde una IP que no está en la lista?

En BroadNet Inference, un 403. Otras APIs suelen devolver también un 403.

## Vea también

-   [Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/) (término)
-   [Retención cero de datos (zero data retention, ZDR)](https://broadrouter.com/es/glossary/zero-data-retention/) (término)
-   [Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/) (término)
-   [Limite sus claves de API a sus servidores con listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/) (guía)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/) (guía)
-   [API de LLM con retención cero de datos: lista de 10 preguntas](https://broadrouter.com/es/blog/zero-data-retention-llm-api-checklist/) (artículo)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-ip-allow-list&utm_content=page-cta) ·

**Fuentes**

-   [RFC 4632: enrutamiento entre dominios sin clases (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, administrar direcciones IP permitidas en una organización](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Referencia de la API de BroadNet Inference, listas de IP permitidas (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
