Saltar al contenido
API v1 · https://bentho.org/api
API · EMPEZAR

Lista de IPs

Cada espacio puede aceptar llamadas solo desde ciertas IPs. Una clave filtrada no sirve desde otro sitio.

Cómo funciona

  • Vive en ips_permitidas, dentro de la configuración de la API del espacio.
  • Lista vacía ([]) = cualquier IP. Es el valor por defecto.
  • Hasta 100 entradas: IPs sueltas o rangos CIDR, IPv4 o IPv6.
  • Se aplica solo a las claves. El Studio, con tu sesión, sigue entrando: por ahí arreglas una lista mal puesta.

Qué IP cuenta

La IP pública con la que tu servidor sale a internet, tal como llega a Bentho. No la de tu red interna ni la de un proxy intermedio.

Antes de activar la lista, comprueba tu IP de salida. Si tu servidor está en la nube, puede salir por un rango y no por una IP fija: pon el rango.

Configurarla

PATCH · CLAVE CON PERMISO ESCRIBE
curl -X PATCH https://bentho.org/api/companies/mi-espacio/api-config \
  -H "Authorization: Bearer $BENTHO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips_permitidas": ["203.0.113.10", "198.51.100.0/24", "2001:db8::/32"]}'

Se guarda normalizada:

  • Un rango con bits de host se ajusta a su red: 198.51.100.7/24 queda 198.51.100.0/24.
  • Una IP con /32 (o /128) se guarda sin sufijo.
  • Los duplicados desaparecen.

Si la IP no está

403
{"detail": "Esta dirección IP no está autorizada en este espacio."}

Una petición rechazada por IP no gasta cuota diaria ni cuenta para el límite por segundo. Si Bentho no puede saber tu IP y la lista no está vacía, también rechaza.

Errores al guardar (422):

  • "«<valor>» no es una IP ni un rango CIDR válido."
  • "Como máximo 100 IPs o rangos."
  • "«ips_permitidas» tiene que ser una lista."