IP allowlists
Una IP allowlist limita qué direcciones de cliente pueden usar tus datos. Hay dos tipos de lista:
| Lista | Aplica a | Quién la cambia |
|---|---|---|
| Organización | Todas las API keys, y las herramientas de consulta, importación y exportación de la consola | Owners y admins |
| Por key | Una API key | Owners, 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 range2001:db8:1234::/48 an IPv6 rangeLos rangos se normalizan (203.0.113.7/24 se guarda como 203.0.113.0/24), y
/0 se rechaza. Con la API:
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-…"}'| Plan | Entradas por lista |
|---|---|
| Free | 1 |
| Pro | 20 |
| Scale | 100 |
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.