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

# Control de acceso

> Limita tu API Key a las IPs de tus servidores o a ciertos países.

<span id="que-es" />

## Qué es

El control de acceso limita desde dónde se puede usar tu API Key. Si alguien la obtiene, no puede usarla fuera de tus redes. Se configura en el dashboard, en **Control de acceso**, y las reglas son de la cuenta: rotar la API Key no las cambia.

Viene incluido en el plan Escala. Los demás planes ven la sección, pero no pueden crear reglas.

<span id="reglas" />

## IPs y países

* **IPs y rangos:** IPv4, IPv6 o rangos CIDR (por ejemplo `203.0.113.0/24`), hasta 3 por cuenta. Cada regla se puede pausar sin borrarla.
* **Países:** códigos ISO de dos letras (por ejemplo `VE`), hasta 3 por cuenta.

Una consulta pasa si su IP está en una regla activa **o** llega desde un país permitido. Sin reglas activas ni países, la API Key funciona desde cualquier lugar.

No se aceptan IPs privadas ni reservadas, ni rangos demasiado amplios. Una consulta cuyo país no se puede determinar no cuenta como país permitido.

La IP que cuenta es la de tu servidor, no la de tus usuarios. Si tu servidor sale por IPv6, agrega su IPv6 o su rango: una regla IPv4 no lo cubre. En **Sugerencias** ves las IPs, IPv4 o IPv6, desde las que ya llamaste.

<span id="rechazo" />

## Consulta rechazada

Una consulta desde fuera de tu lista recibe `403` con el código `ip_not_allowed`. El mensaje nombra la IP que vimos y, si tienes países permitidos, el país:

```json theme={null}
{
  "code": "ip_not_allowed",
  "message": "This API key cannot be used from 203.0.113.7. Add it in Control de acceso or call from an allowed IP.",
  "field": "ip"
}
```

El rechazo no consume consultas ni velocidad de tu plan. No lo reintentes: agrega la IP a tu lista o llama desde una red permitida.

<span id="panel" />

## En el dashboard

* **Sugerencias:** las IPs desde las que usaste tu API Key en los últimos días, para agregarlas con un clic.
* **Rechazos:** las consultas bloqueadas de las últimas 24 horas, por IP.
* **Confirmación:** si un cambio dejaría afuera IPs que usaron tu API Key en las últimas 24 horas, el dashboard te pide confirmarlo antes de aplicarlo.
* **Aviso:** si tu API Key se usa desde una IP fuera de tu lista, te avisamos en el dashboard, como máximo una vez por día.

Los cambios se aplican en segundos.

<span id="plan" />

## Si cambias de plan

Al bajar a un plan sin control de acceso, tus reglas quedan guardadas pero dejan de aplicarse: la API Key funciona desde cualquier lugar. Puedes borrarlas, o volver a un plan que lo incluya y se aplican otra vez.


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