Saltearse al contenido

IP allowlists

Una IP allowlist limita qué direcciones de cliente pueden usar tus datos. Hay dos tipos de lista:

ListaAplica aQuién la cambia
OrganizaciónTodas las API keys, y las herramientas de consulta, importación y exportación de la consolaOwners y admins
Por keyUna API keyOwners, admins y developers

Una lista sin entradas permite todas las direcciones. Cuando ambas listas tienen entradas, una petición debe coincidir con las dos: la lista de una key restringe la de la organización, nunca la amplía.

Dónde se aplica

  • HTTP, MCP y Bolt en db.namidb.com, antes de que se ejecute cualquier otra cosa. Una sesión Bolt se vuelve a verificar en cada sentencia, así que una conexión abierta se corta en cuanto su dirección deja de estar permitida.
  • El editor de consultas, el importador y las descargas de exportaciones de la consola, contra la dirección de la persona que usa la consola.
  • Las solicitudes y descargas de exportaciones de la API de gestión.

Una petición rechazada responde 403 ip_not_allowed. El mensaje indica la dirección que se vio y qué lista la rechazó. Por Bolt es un fallo Neo.ClientError.Security.Forbidden y la conexión se cierra.

Agregar entradas

Consola: API keys → IP allowlist para la lista de la organización, o el botón de IP allowlist en la fila de una key para su propia lista. Cada entrada es una dirección o un rango CIDR IPv4 o IPv6 con una etiqueta opcional:

203.0.113.7 one address (stored as 203.0.113.7/32)
203.0.113.0/24 a range
2001:db8:1234::/48 an IPv6 range

Los rangos se normalizan (203.0.113.7/24 se guarda como 203.0.113.0/24), y /0 se rechaza. Con la API:

Ventana de terminal
curl -X POST https://app.namidb.com/api/v1/ip-allowlist \
-H "Authorization: Bearer $NAMIDB_MANAGEMENT_TOKEN" -H "Content-Type: application/json" \
-d '{"cidr": "203.0.113.0/24", "label": "office"}'
# A key's own list:
curl -X POST https://app.namidb.com/api/v1/ip-allowlist \
-H "Authorization: Bearer $NAMIDB_MANAGEMENT_TOKEN" -H "Content-Type: application/json" \
-d '{"cidr": "198.51.100.10", "label": "ci runner", "api_key_id": "8f14e45f-…"}'
PlanEntradas por lista
Free1
Pro20
Scale100

Después de bajar de plan, las listas más largas se siguen aplicando; simplemente no puedes agregar más hasta que entren en el límite.

Comportamiento a tener en cuenta

  • Los cambios llegan a todos los endpoints en unos dos segundos, incluidas las sesiones Bolt abiertas.
  • Rotar una key conserva su allowlist.
  • Los cambios piden el segundo factor cuando tienes uno registrado, y quedan en el registro de auditoría.
  • Agrega tu propia dirección (y la de tus runners de CI) antes de activar una lista de la organización, o tus consultas desde la consola también se rechazarán.
  • Las peticiones rechazadas por una allowlist no cuentan como uso.

Encontrar la dirección correcta

La dirección que ve NamiDB es la dirección pública por la que sale tu tráfico: la salida de tu oficina o de tu VPN, un NAT gateway, o el rango de salida de tu proveedor de nube. Los mensajes ip_not_allowed la indican. Las plataformas serverless suelen usar pools de direcciones grandes y cambiantes; ahí conviene más limitar el alcance de las keys y usar vencimientos cortos.