Una clave de API funciona como una contraseña para un programa. También es una autorización de gasto: quien la tenga puede usar su saldo.
Cómo funciona
Las APIs de LLM tratan la clave como un token bearer. El cliente la envía en cada solicitud:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
El RFC 6750 define un token bearer como aquel que “any party in possession of the token” (traducción: cualquier parte que posea el token) puede usar. No hay un segundo factor. Por eso el mismo RFC indica que los clientes siempre deben enviar los tokens bearer por TLS (https://).
El proveedor busca la clave, encuentra la cuenta, revisa límites y políticas, y luego atiende o rechaza la solicitud. Una clave ausente o incorrecta suele devolver 401; una clave rechazada por una política, como una lista de IP permitidas, suele devolver 403.
Por qué importa
Una clave filtrada es una de las formas más comunes de que una factura de API se dispare, porque hay bots que escanean el código público en busca de secretos. También puede exponer datos si la clave llega a endpoints que devuelven detalles de la cuenta. Buenas prácticas, de acuerdo con la guía de secretos de OWASP:
- Cargue las claves desde variables de entorno o un gestor de secretos. Nunca las suba en un commit ni las incluya en imágenes de contenedores.
- Dé a cada app o agente su propia clave, para poder revocar una sin detener todo.
- Rote las claves de forma periódica y de inmediato ante cualquier sospecha de filtración.
- Limite desde dónde funciona una clave, por ejemplo con una lista de IP de servidores permitidas.
En BroadNet Inference
BroadNet separa dos credenciales. Una clave de inferencia llama a los modelos en /v1/*. Una credencial del portal automatiza la cuenta: claves, IP permitidas y compras. Trate la segunda como autoridad total sobre la cuenta.
Ambas se muestran una sola vez. BroadNet guarda solo un hash SHA-256, así que no puede volver a mostrar la clave. Una clave de pago por uso dura un año, y una cuenta puede tener hasta diez claves activas. Cada clave puede tener su propia lista de IP permitidas. Después de una revocación o de un cambio en la lista, las nuevas solicitudes se detienen en menos de cinco segundos.
Las claves de los planes de tarifa plana son independientes y nunca descuentan de su saldo. Los pasos de configuración están en claves de API y listas de IP permitidas, y los códigos de estado en errores y reintentos.
Errores comunes
- Registrar en logs los encabezados completos de la solicitud. Eso escribe la clave en sus logs.
- Compartir una sola clave en todo el equipo. Pierde la posibilidad de revocar el acceso de una persona.
- Enviar la clave al soporte. Envíe en su lugar el valor del encabezado
X-Request-ID.