Saltar al contenido principal

​
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.

​
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.

​
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:
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.

​
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.

​
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.