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

