BroadRouter
Comenzar

Clave de API (API key)

Actualizado

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

También llamado: API key, clave de API, clave API, token de API, clave secreta, bearer token, clave de inferencia, API token, secret key, inference key

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.

Preguntas frecuentes

¿Puedo poner una clave de API de LLM en una app web o móvil?

No. Todo lo que se distribuye a un cliente puede extraerse. Mantenga la clave en un servidor y haga que su app llame a su servidor, que a su vez llama a la API del LLM.

¿Qué debo hacer si se filtra una clave?

Revóquela de inmediato, cree una nueva y revise el uso durante el periodo en que estuvo expuesta. Luego averigüe cómo se filtró, por ejemplo en un commit, una línea de log o una captura de pantalla.

¿Cuántas claves puedo tener en BroadNet Inference?

Hasta diez claves de pago por uso activas por cuenta. Cada una dura un año desde su creación. Las claves de plan son independientes.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity