BroadRouter
Comenzar

Limite sus claves de API a sus servidores con listas de IP permitidas

Actualizado

Agregue las direcciones IPv4 o IPv6 de salida de sus servidores, o rangos CIDR, a la lista de IP permitidas de la cuenta, hasta 32 entradas. Las claves nuevas heredan la lista salvo que pase allowed_ips al crearlas. Las solicitudes desde otras direcciones reciben un 403, y los cambios en la lista o las revocaciones surten efecto en cinco segundos.

Una clave filtrada es la forma más común en que una factura de API se dispara. BroadNet Inference le ofrece dos controles: una lista de IP permitidas y la revocación rápida.

Dos tipos de credencial

Credencial Úsela para Trátela como
Clave de inferencia Solicitudes de modelos a /v1/* Un secreto para una sola app o agente
Credencial del portal Automatización de la cuenta: claves, IP permitidas, compras Autoridad total sobre la cuenta

Ambas se muestran una sola vez. El portal solo guarda un hash SHA-256, así que no puede volver a mostrar la clave. Una clave de inferencia de pago por uso dura un año desde su creación, y una cuenta puede tener hasta diez claves activas.

Configure una lista de IP permitidas

En la página de la cuenta, agregue una dirección IPv4 o IPv6 o un rango CIDR por línea, hasta 32 entradas. Una lista vacía significa que no hay restricción de IP. Las claves nuevas heredan esta lista de la cuenta. El edge comprueba, en cada solicitud a la API, la IP del cliente que informa Cloudflare.

Para administrar la lista de la cuenta desde un script, PUT /portal/allowed_ips la reemplaza en una sola llamada (requiere credencial del portal).

Para darle a una clave su propia lista, indíquela al crearla con una credencial del portal:

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

Un allowed_ips por clave reemplaza, para esa clave, la lista heredada de la cuenta. La respuesta contiene la clave en bruto una sola vez; guárdela de inmediato.

Revoque rápido una clave filtrada

DELETE /portal/keys/{alias} revoca una clave de pago por uso, y DELETE /portal/keys/hourly/{alias} revoca una clave por hora (el cargo de la compra original se mantiene). Tras una revocación o un cambio en la lista de IP permitidas, las solicitudes nuevas se detienen en cinco segundos.

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

Asigne a KEY_ALIAS el alias que se muestra para la clave en la página de la cuenta o en GET /portal/keys. El alias no es la clave secreta. Si se filtra una credencial del portal, revóquela con DELETE /portal/credentials/{id}: puede hacer todo lo que puede hacer su cuenta.

Solución de problemas

  • 403 desde un servidor que agregó a la lista. El edge ve su dirección pública de salida, no la IP privada del servidor. Los servidores detrás de un gateway NAT, un proxy o un balanceador de carga salen con la dirección de ese dispositivo. Un servidor con IPv6 puede salir por IPv6 aunque usted solo haya agregado su dirección IPv4. Agregue la dirección desde la que realmente sale la solicitud, o un rango CIDR que la cubra.
  • Una clave nueva ignora la lista de la cuenta. Un arreglo allowed_ips por clave reemplaza, para esa clave, la lista heredada de la cuenta. Revise lo que pasó al crearla.
  • 409 key_limit_reached. La cuenta ya tiene diez claves activas. Revoque una que ya no use.
  • Las solicitudes siguen funcionando unos segundos después de revocar. Es lo esperado durante un máximo de cinco segundos, mientras la caché se actualiza.

Una solicitud desde una dirección que no está en la lista recibe un 403. Consulte todos los códigos de error de BroadNet y cuándo reintentar. Para hacer su primera solicitud con una clave nueva, siga la guía del SDK de OpenAI para Python. La entrada del glosario sobre listas de IP permitidas explica la idea en términos generales.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

Preguntas frecuentes

¿Cómo restrinjo una clave de API de LLM a la dirección IP de mi servidor?

Agregue la dirección pública de salida del servidor, o un rango CIDR, a la lista de IP permitidas en la página de su cuenta de BroadNet, o pase allowed_ips al crear la clave con POST /portal/keys. Las solicitudes desde cualquier otra dirección se rechazan con un 403.

¿Una lista vacía lo bloquea todo?

No. Una lista vacía significa que no hay restricción de IP, así que la clave funciona desde cualquier dirección. Agregue al menos una entrada para activar la restricción.

¿Puedo usar una clave de inferencia para crear otras claves?

No. Las claves de inferencia solo llaman a las rutas de modelos /v1/*. Crear y revocar claves, cambiar las IP permitidas y comprar claves por hora requiere una credencial del portal, que tiene autoridad total sobre la cuenta.

¿Qué tan rápido surte efecto revocar una clave filtrada?

La documentación de BroadNet dice que las solicitudes nuevas se detienen dentro de los cinco segundos posteriores a una revocación o a un cambio en la lista de IP permitidas, porque las decisiones de autorización pueden permanecer ese tiempo en una caché replicada.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity