BroadRouter
Comenzar

Claves de API de LLM seguras: almacenamiento, rotación y listas de IP

Por el equipo de BroadNet Inference · 6 min de lectura · Publicado · Actualizado

Guarde las claves de API de LLM en un gestor de secretos, nunca en el código ni en el navegador. Dé a cada aplicación o agente su propia clave, rótelas periódicamente y restrínjalas a sus servidores con una lista de IP permitidas. BroadNet Inference indica que sus listas admiten 32 entradas, que la revocación detiene las nuevas solicitudes en cinco segundos y que las claves duran un año.

Para proteger una clave de API de LLM, guárdela en un gestor de secretos y llame al modelo solo desde su servidor, nunca desde un navegador o una app. Dé a cada carga de trabajo su propia clave, rote las claves periódicamente, restrínjalas a las IP de sus servidores con una lista de permitidas y, si una clave se filtra, revóquela primero e investigue después.

Este artículo reúne los hábitos que mantienen seguras las claves, con los controles concretos que ofrece BroadNet Inference. Para los pasos en el portal, consulte la guía de claves de API y listas de IP permitidas; para presupuestos y protección frente a bucles descontrolados, consulte control del gasto en APIs de LLM.

¿Dónde se debe guardar una clave de API de LLM?

Guarde las claves en un gestor de secretos o en los secretos cifrados de su plataforma, nunca en el código. El OWASP Secrets Management Cheat Sheet analiza las opciones a fondo. Tenga en cuenta su advertencia: las variables de entorno “are generally accessible to all processes and may be included in logs or system dumps” (Traducción: suelen ser accesibles para todos los procesos y pueden acabar en logs o volcados del sistema), por lo que OWASP prefiere, cuando se puede elegir, archivos de secretos montados u obtener los secretos de un almacén de secretos. Una variable de entorno que se rellena desde un gestor de secretos al arrancar es el término medio habitual.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)

Use os.environ[...], no os.getenv(...) con un valor por defecto escrito en el código; así es como las claves acaban en Git. En desarrollo local, un archivo .env está bien si figura en .gitignore desde el primer commit. Active el escaneo de secretos y la protección de push de su plataforma Git. En GitHub, la protección de push bloquea los push que contienen formatos de secretos conocidos antes de que lleguen al repositorio; la protección de push para usuarios viene activada por defecto, pero la protección a nivel de repositorio viene desactivada y debe activarla un administrador del repositorio o el propietario de la organización.

¿Se puede poner una clave de API en un navegador o una app móvil?

No. Todo lo que se entrega a un cliente se puede extraer. El código del front-end y los paquetes de las apps son públicos, por mucho que se minifiquen u ofusquen. Llame al LLM desde su servidor, autentique allí a sus propios usuarios y aplique sus propios límites por usuario antes de reenviar la solicitud.

Lo mismo vale para las herramientas de escritorio que entrega a otras personas. Si un compañero necesita acceso a un agente de programación, dele su propia clave en su propia cuenta en lugar de compartir una.

¿Por qué dar a cada carga de trabajo su propia clave?

En BroadNet Inference, una cuenta puede tener hasta diez claves activas. Aprovéchelas:

Etiqueta de la clave Quién la usa
prod-api Backend de producción
prod-worker Trabajos por lotes
staging Entorno de staging
agent-ci Agente de programación en CI
dev-laptop-<name> Desarrollo local

Si una se filtra, solo revoca esa clave y las demás siguen funcionando. Las etiquetas también hacen legible el uso: puede ver cuánto gasta cada carga de trabajo. Nombre las claves según lo que las usa, no según quién las creó.

¿Cómo protegen una clave las listas de IP permitidas?

Con una lista de IP permitidas, una clave robada falla en cualquier lugar que no sea su propia infraestructura. En BroadNet Inference:

  • La lista de la cuenta admite hasta 32 entradas, una dirección IPv4 o IPv6 o un rango CIDR por línea.
  • Una lista vacía significa que no hay restricción.
  • Las claves nuevas heredan la lista de la cuenta, salvo que cree una clave con su propio allowed_ips, que sustituye la lista heredada para esa clave.
  • Una solicitud desde una dirección fuera de la lista se rechaza con un 403 (“refused by model, route or IP policy”; traducción: rechazada por la política de modelo, ruta o IP).

Cree una clave con su propia lista mediante la API del portal:

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

La respuesta contiene la clave en bruto una sola vez. Guárdela de inmediato en su gestor de secretos; no se puede volver a leer. Los pasos completos están en la guía de listas de IP permitidas.

Las listas de IP permitidas convienen a servidores con IP de salida estables: un VPS, un gateway NAT, una IP fija de oficina. Para portátiles que cambian de red, use una clave aparte sin lista y mantenga bajo el saldo expuesto.

¿Por qué separar las claves de inferencia de las credenciales de administración?

BroadNet usa dos tipos de credenciales:

Credencial Qué puede hacer Dónde guardarla
Clave de inferencia Solicitudes a modelos en /v1/* Donde se ejecute la aplicación
Credencial del portal Crear y revocar claves, cambiar las IP permitidas, hacer compras Solo en su automatización o herramientas de administración

La documentación indica que cada credencial del portal debe tratarse como autoridad total sobre la cuenta. Nunca despliegue una credencial del portal junto a su aplicación. Si su servidor de aplicaciones se ve comprometido, el atacante debería obtener una clave de inferencia, no el control de la cuenta.

¿Con qué frecuencia se deben rotar las claves de API?

OWASP recomienda rotarlas con regularidad “so that any stolen credentials will only work for a short time” (Traducción: para que cualquier credencial robada solo funcione durante poco tiempo). Las claves de BroadNet duran un año desde su creación, así que todas habrá que reemplazarlas de todos modos. Convierta la rotación en rutina:

  1. Cree una clave nueva con el mismo patrón de etiqueta y la misma lista de IP.
  2. Despliéguela junto a la anterior, o cambie el secreto y reinicie.
  3. Compruebe que el tráfico pasa a la clave nueva.
  4. Revoque la clave anterior con DELETE /portal/keys/{alias}.

Como una cuenta puede tener hasta diez claves activas, puede mantener la anterior y la nueva a la vez durante unos minutos sin interrupción del servicio. Rote antes las claves a las que tenía acceso alguien que deja el equipo.

¿Qué hacer cuando se filtra una clave?

Cuando se filtra una clave, revóquela primero e investigue después. En BroadNet Inference, las nuevas solicitudes se detienen en un plazo de cinco segundos tras una revocación o un cambio en la lista de IP; la documentación explica que las decisiones de autorización pueden permanecer en una caché replicada durante ese intervalo acotado.

Después de revocarla:

  • revise el uso de la clave en la página de la cuenta o con GET /portal/usage;
  • averigüe cómo se filtró (historial de commits, logs de CI, una captura de pantalla compartida);
  • rote cualquier otro secreto guardado en el mismo lugar.

Una clave revocada o bloqueada devuelve 401 o 403; consulte la guía de errores para que su monitoreo no los trate como errores transitorios.

¿Cómo se filtran las claves a través de los logs?

Los logs son una filtración fácil de pasar por alto. Oculte la cabecera Authorization en el logging de depuración HTTP, en los servicios de reporte de errores y en los logs de acceso del proxy. Cuando contacte con soporte, envíe el X-Request-ID, la marca de tiempo, la ruta, el estado y el alias de la clave, nunca la clave en sí. La documentación de BroadNet indica que el portal solo guarda un hash de cada clave, así que tampoco puede mostrarle una clave perdida.

¿Cómo limitar el daño de una filtración que aún no ha detectado?

Aun con todos los hábitos anteriores, asuma que una clave podría filtrarse algún día. Reduzca el radio de impacto:

  • Mantenga el saldo de pago por uso en un nivel que pueda permitirse perder, y recargue según lo necesite.
  • Use un plan de tarifa plana para los agentes intensivos: una sesión de plan tiene un precio fijo, así que una clave de plan robada no puede disparar una factura por token. Consulte qué significa realmente “ilimitado”.
  • Configure alertas ante un gasto o una tasa de solicitudes inusual por clave; la calculadora de costos de API de LLM le da una cifra mensual normal con la que comparar. Nuestro artículo sobre control del gasto en APIs de LLM trata los presupuestos y las alertas.

¿Qué controles de claves ofrece BroadNet Inference?

Control BroadNet Inference
La clave se muestra una vez y se guarda como hash Sí
Claves activas por cuenta Hasta 10
Vigencia de la clave Un año
Lista de IP permitidas Hasta 32 entradas IPv4, IPv6 o CIDR
Lista de IP por clave Sí, allowed_ips al crearla
La revocación surte efecto En un plazo de cinco segundos
Credencial de administración separada Credencial del portal

Las claves protegen su cuenta; la retención cero de datos protege lo que envía a través de ella. Lea ambos temas antes de pasar a producción.

Preguntas frecuentes

¿Dónde debo guardar una clave de API de LLM?

En un gestor de secretos o en los secretos cifrados de su plataforma, inyectada en el proceso como variable de entorno, por ejemplo BROADNET_API_KEY. No en el código fuente, no en un archivo .env incluido en un commit y nunca en el código del front-end.

¿Con qué rapidez puedo revocar una clave de BroadNet Inference?

La documentación de BroadNet indica que las nuevas solicitudes se detienen en los cinco segundos siguientes a una revocación o a un cambio en la lista de IP, porque las decisiones de autorización pueden permanecer en una caché replicada durante ese intervalo acotado.

¿Cuánto dura una clave de BroadNet Inference?

Una clave de pago por uso dura un año desde su creación. Una cuenta puede tener hasta diez claves activas, así que puede crear la sustituta antes de que caduque la anterior.

¿Puede BroadNet volver a mostrarme una clave si la pierdo?

No. La documentación de BroadNet indica que la clave en bruto se devuelve una sola vez y que el portal solo guarda su hash. Cree una clave nueva y revoque la anterior.

¿Qué hago si se filtra mi clave de una API compatible con OpenAI?

Revóquela primero e investigue después. Revise el uso de la clave en busca de tráfico desconocido, averigüe por dónde se filtró (historial de commits, logs de CI, capturas de pantalla), rote cualquier otro secreto guardado en el mismo lugar y emita una clave de reemplazo con una lista de IP permitidas.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity