Uma chave de API funciona como uma senha para um programa. Ela também é uma autorização de gasto: quem a tem pode usar o seu saldo.
Como funciona
As APIs de LLM tratam a chave como um bearer token. O cliente a envia em toda requisição:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
A RFC 6750 define um bearer token como aquele que “any party in possession of the token” (tradução: qualquer parte que esteja de posse do token) pode usar. Não existe um segundo fator. Por isso a mesma RFC diz que os clientes devem sempre enviar bearer tokens por TLS (https://).
O provedor procura a chave, encontra a conta, verifica limites e políticas e então atende ou recusa a requisição. Uma chave ausente ou errada costuma retornar 401; uma chave recusada por uma política, como uma lista de IPs permitidos, costuma retornar 403.
Por que importa
Uma chave vazada é uma das formas mais comuns de uma conta de API disparar, porque bots varrem código público em busca de segredos. Ela também pode expor dados se alcançar endpoints que retornam detalhes da conta. Boas práticas, alinhadas às orientações da OWASP sobre segredos:
- Carregue as chaves de variáveis de ambiente ou de um gerenciador de segredos. Nunca faça commit delas nem as embuta em imagens de contêiner.
- Dê a cada app ou agente a sua própria chave, para poder revogar uma sem parar tudo.
- Faça rotação das chaves periodicamente e logo depois de qualquer suspeita de vazamento.
- Limite onde a chave funciona, por exemplo com uma lista de IPs de servidores permitidos.
Na BroadNet Inference
A BroadNet separa duas credenciais. Uma chave de inferência chama os modelos em /v1/*. Uma credencial do portal automatiza a conta: chaves, IPs permitidos e compras. Trate a segunda como autoridade total sobre a conta.
As duas aparecem uma única vez. A BroadNet guarda apenas um hash SHA-256, então não consegue mostrar a chave de novo. Uma chave de pagamento por uso vale por um ano, e uma conta pode ter até dez chaves ativas. Cada chave pode ter a sua própria lista de IPs permitidos. Depois de uma revogação ou de uma mudança na lista de IPs permitidos, as novas requisições param em até cinco segundos.
As chaves dos planos de preço fixo são separadas e nunca descontam do seu saldo. Os passos de configuração estão em chaves de API e listas de IPs permitidos, e os códigos de status em erros e novas tentativas.
Erros comuns
- Registrar em log os cabeçalhos completos das requisições. Isso grava a chave nos seus logs.
- Compartilhar uma única chave com o time todo. Você perde a possibilidade de revogar o acesso de uma pessoa só.
- Enviar a chave para o suporte. Envie o valor do cabeçalho
X-Request-ID.