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:
- Cree una clave nueva con el mismo patrón de etiqueta y la misma lista de IP.
- Despliéguela junto a la anterior, o cambie el secreto y reinicie.
- Compruebe que el tráfico pasa a la clave nueva.
- 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.
