> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/es/user-manual/account/api-keys/ip-allowlist.md).

# Lista de IP permitidas

Una lista de IP permitidas restringe una clave API a solicitudes procedentes de direcciones IP públicas de salida especificadas. Puedes configurarla por separado para cada clave.

La verificación de la lista de IP permitidas es opcional y está desactivada de forma predeterminada. Puedes guardar primero la lista de IP permitidas y activar la verificación cuando tus aplicaciones estén listas.

## Antes de empezar

Identifica todas las direcciones IP públicas de salida que usan tus aplicaciones para llamar a la API, incluidos los servidores de producción, los entornos de respaldo y las tareas programadas.

Usa la IP pública que ve la API, que puede pertenecer a una puerta de enlace NAT o a un proxy de salida. Es posible que la dirección de red privada de tu servidor y la IP pública de tu navegador no sean las direcciones que utiliza tu aplicación.

Si las direcciones de salida cambian cuando los servidores se reinician o escalan, considera configurar una IP de salida estable antes de activar la lista de permitidos. De lo contrario, actualiza la lista de permitidos antes de cambiar tus direcciones de salida.

También necesitas permiso para administrar la clave API correspondiente. Si no puedes acceder a la configuración, ponte en contacto con el administrador de tu cuenta u organización.

## Guardar tu lista de IP permitidas

1. Abre [Sistema → API](https://app.blocksec.com/phalcon/compliance/system/api).
2. Busca la clave API que quieres proteger y selecciona **Administrar** para abrir **Configuración de seguridad**.
3. Selecciona **Configurar lista de IP permitidas**.
4. Introduce las direcciones IP públicas o los rangos CIDR de tus aplicaciones. Usa **Añadir IP** para agregar más entradas.
5. Revisa la lista completa, selecciona **Guardar lista de IP permitidas** y confirma.

Guardar la lista no activa la verificación de la lista de IP permitidas. Puedes mantener la verificación desactivada mientras preparas tus aplicaciones.

## Activar la verificación de la lista de IP permitidas

1. Abre la **Configuración de seguridad** de la clave API y revisa la lista de IP permitidas guardada.
2. Confirma que incluya todas las direcciones IP públicas de salida necesarias.
3. Activa la verificación de la lista de IP permitidas cuando tus aplicaciones estén listas.
4. Envía una solicitud desde tu aplicación para comprobar que el acceso funciona según lo previsto.

Una vez activada la verificación, se rechazarán las solicitudes procedentes de direcciones IP que no estén en la lista guardada, aunque usen la clave API correcta.

## Entradas compatibles

Puedes introducir:

* Una única dirección IPv4 pública.
* Una única dirección IPv6 pública.
* Un rango de red pública en notación CIDR estándar.

Un rango CIDR permite todas las direcciones de esa red. Usa el rango más pequeño que abarque las direcciones de salida de tu aplicación.

No se admiten dominios, URL, números de puerto, comodines como `*`, direcciones privadas o de bucle local ni rangos que permitan todas las direcciones, como `0.0.0.0/0` o `::/0`.

Corrige cualquier error de validación antes de guardar y respeta el límite de entradas que se muestra en la página.

## Actualizar tu lista de IP permitidas

1. Abre la **Configuración de seguridad** de la clave API.
2. Selecciona **Editar** en la sección de la lista de IP permitidas.
3. Añade o elimina entradas según sea necesario.
4. Selecciona **Guardar lista de IP permitidas**, revisa la confirmación y aplica el cambio.

Al guardar, se actualiza la lista de IP permitidas. Cuando la verificación está activada, se rechazarán las solicitudes procedentes de las direcciones IP eliminadas de la lista. Cuando la verificación está desactivada, guardar la lista no la activa.

Al trasladar aplicaciones a nuevos servidores, añade primero las nuevas direcciones de salida. Verifica las solicitudes desde el nuevo entorno antes de eliminar las direcciones antiguas.

## Desactivar la verificación de la lista de IP permitidas

1. Abre la **Configuración de seguridad** de la clave API.
2. Desactiva la verificación de la lista de IP permitidas y confirma.

Las restricciones de IP se eliminan de inmediato. Entonces, la clave API se puede usar desde cualquier dirección IP.

Las direcciones guardadas se conservan. Para volver a activar la verificación, revisa la lista guardada y activa la verificación de la lista de IP permitidas.

## Solución de problemas

### Las solicitudes fallan después de activar o actualizar la lista de permitidos

* Confirma que la solicitud use la clave API cuya lista de permitidos configuraste.
* Comprueba la IP pública de salida real de la aplicación que realiza la solicitud.
* Incluye todas las direcciones de salida que usan tus servidores de producción, copias de seguridad, puertas de enlace NAT o proxies.
* Si tu infraestructura usa IPv6, comprueba si las solicitudes salen a través de una dirección IPv6 en lugar de la dirección IPv4 que añadiste.
* Comprueba si una implementación o un cambio reciente en la infraestructura introdujo una nueva IP de salida.

Actualiza la lista de permitidos para incluir cualquier dirección de salida que falte.

### No se puede guardar una entrada

Comprueba que la entrada sea una dirección IP pública o un rango CIDR compatible y que la lista no esté vacía. Corrige los errores que se muestran en la página y asegúrate de que el número de entradas no supere el límite indicado.

### Una solicitud de guardado se agota

Vuelve a abrir o actualiza la **Configuración de seguridad** para comprobar si el cambio se guardó antes de volver a intentarlo.

Si necesitas más ayuda, ponte en contacto con <phalcon_support@blocksec.com>. Incluye la hora de la solicitud, el endpoint, los detalles de la respuesta y el ID de solicitud, si está disponible. No compartas tu clave API completa.
