> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar una lista blanca de IP

> Restringe el uso de la clave de API de la cuenta a direcciones IP públicas aprobadas.

Una lista blanca de IP limita el origen de las solicitudes autenticadas con la clave de API de tu cuenta de YCloud. Cuando la función está habilitada, YCloud acepta llamadas a la API mediante la clave solo desde las direcciones IP incluidas en la lista blanca.

YCloud recomienda habilitar la lista blanca de IP para cada cuenta que realice llamadas a las API desde entornos de servidor conocidos. Añade una capa de protección importante: incluso si una clave de API queda expuesta, se bloquean las solicitudes procedentes de direcciones IP no aprobadas.

<Warning>
  Añade todas las IP de salida de producción, staging, respaldo y conmutación por error antes de habilitar la lista blanca. Si un sistema activo envía solicitudes desde una dirección que no está en la lista, sus llamadas a la API de YCloud fallarán.
</Warning>

## Antes de comenzar

Asegúrate de que:

* Tu rol pueda acceder a **Desarrolladores** > **Lista blanca de IP** en el panel de control de YCloud.
* Conoces la dirección IP pública de salida utilizada por cada sistema que llama a las API de YCloud.
* Tu infraestructura utiliza direcciones IP de salida estáticas o dispones de un proceso para actualizar la lista blanca cuando cambia una dirección.
* Has incluido pasarelas de respaldo, pasarelas NAT, proxies y entornos de conmutación por error que puedan enviar solicitudes.

Añade la dirección IP pública que YCloud detecta para el tráfico de salida. No añadas una dirección interna privada, como una dirección en los rangos `10.0.0.0/8`, `172.16.0.0/12` o `192.168.0.0/16`.

## Añadir direcciones IP aprobadas

1. Inicia sesión en el [panel de control de YCloud](https://www.ycloud.com/console/).
2. Ve a **Desarrolladores** > **Lista blanca de IP**.
3. Haz clic en **Añadir IP a la lista blanca**.
4. Introduce la dirección IP pública de salida de un sistema que llame a las API de YCloud.
5. Guarda la dirección.
6. Repite estos pasos para cada origen de producción, staging, respaldo y conmutación por error.

<Frame caption="Enter one approved public IP address or range per line. This form has not been submitted.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/developer-whitelist-add-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=5a99a778009b758d26ab8cdc31671a8f" alt="Cuadro de diálogo Añadir IP a la lista blanca que muestra la entrada de una dirección por línea." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/developer-whitelist-add-annotated.svg" />
</Frame>

La tabla muestra cada dirección IP aprobada y la fecha en que se añadió.

## Habilitar la lista blanca de IP

Una vez que hayas añadido todas las direcciones necesarias:

1. Revisa la lista blanca con tu equipo de infraestructura o redes.
2. Activa la opción **Habilitar la función de listas blancas de IP**.
3. Envía una solicitud de prueba desde cada entorno esperado.
4. Confirma que los trabajos programados, los servicios relacionados con Webhooks y los sistemas de conmutación por error sigan pudiendo llamar a las API de YCloud.

<Note>
  La lista blanca se aplica a la dirección IP de origen de la solicitud de API de salida. Si las solicitudes pasan por una pasarela NAT o un proxy, añade la IP pública de salida de esa pasarela o proxy en lugar de la IP interna de la aplicación.
</Note>

## Actualizar la lista blanca de forma segura

Los cambios en la infraestructura pueden alterar tu IP pública de salida. Sigue este orden para evitar la interrupción del servicio:

1. Añade la nueva dirección IP pública a la lista blanca.
2. Envía una solicitud de prueba exitosa a través de la nueva dirección.
3. Dirige el tráfico de producción a la nueva ruta.
4. Confirma que ningún tráfico esté utilizando la dirección anterior.
5. Elimina la dirección IP anterior de la lista blanca.

No elimines una dirección hasta que se hayan migrado todos los servicios que dependen de ella.

## Recomendaciones de seguridad

* Habilita la lista blanca de IP incluso si tu clave de API está almacenada en un gestor de secretos.
* Concede acceso a la configuración de la lista blanca únicamente a miembros de confianza de la cuenta.
* Revisa la lista periódicamente y elimina las direcciones que ya no se utilicen.
* Monitorea los intentos de autenticación fallidos tras cambios en la red o infraestructura.
* Rota la clave de API de la cuenta de inmediato si sospechas que ha quedado expuesta. Consulta [Administrar claves de API](/es/documentation/developer/manage-api-keys).

Una lista blanca de IP complementa la gestión segura de claves de API; no reemplaza la rotación de claves, el acceso de privilegios mínimos ni la gestión de secretos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.