Uma chave vazada é o jeito mais comum de uma conta de API sair do controle. A BroadNet Inference oferece dois controles: uma lista de IPs permitidos e revogação rápida.
Dois tipos de credencial
| Credencial | Use para | Trate como |
|---|---|---|
| Chave de inferência | Requisições de modelo para /v1/* |
Um segredo de um único app ou agente |
| Credencial do portal | Automação da conta: chaves, IPs permitidos, compras | Autoridade total sobre a conta |
As duas são mostradas uma única vez. O portal guarda só um hash SHA-256, então não consegue mostrar a chave de novo. Uma chave de inferência de pagamento por uso vale por um ano a partir da criação, e uma conta pode ter até dez chaves ativas.
Configure uma lista de IPs permitidos
Na página da conta, adicione um endereço IPv4 ou IPv6 ou uma faixa CIDR por linha, até 32 entradas. Uma lista vazia significa nenhuma restrição de IP. Novas chaves herdam essa lista da conta. Em toda requisição de API, a borda (edge) confere o IP do cliente informado pela Cloudflare.
Para gerenciar a lista da conta a partir de um script, PUT /portal/allowed_ips a substitui em uma chamada (exige credencial do portal).
Dê a uma chave a sua própria lista ao criá-la com uma credencial do portal:
curl -X POST https://inference.broadnet.ai/portal/keys \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
-H "Content-Type: application/json" \
-d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
Um allowed_ips por chave substitui, para aquela chave, a lista herdada da conta. A resposta traz a chave em texto puro uma única vez; guarde-a na hora.
Revogue uma chave vazada rapidamente
DELETE /portal/keys/{alias} revoga uma chave de pagamento por uso, e DELETE /portal/keys/hourly/{alias} revoga uma chave por hora (a cobrança da compra original continua). Depois de uma revogação ou de uma mudança na lista, novas requisições param em até cinco segundos.
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
Defina KEY_ALIAS com o alias mostrado para a chave na página da conta ou em GET /portal/keys. O alias não é a chave secreta. Se uma credencial do portal vazar, revogue-a com DELETE /portal/credentials/{id}: ela pode fazer tudo o que a sua conta faz.
Solução de problemas
- 403 de um servidor que está na lista. A borda vê o seu endereço público de saída, não o IP privado do servidor. Servidores atrás de um NAT gateway, proxy ou load balancer saem pelo endereço desse dispositivo. Um servidor com IPv6 pode sair por IPv6 mesmo que você tenha listado só o endereço IPv4 dele. Liste o endereço pelo qual a requisição realmente sai, ou uma faixa CIDR que o cubra.
- Uma chave nova ignora a lista da conta. Um array
allowed_ipspor chave substitui, para aquela chave, a lista herdada da conta. Confira o que você passou na criação. - 409
key_limit_reached. A conta já tem dez chaves ativas. Revogue uma que você não usa mais. - Requisições ainda funcionam alguns segundos depois da revogação. Esperado por até cinco segundos, enquanto o cache se atualiza.
Uma requisição de um endereço que não está na lista recebe 403. Veja todos os códigos de erro da BroadNet e quando tentar de novo. Para fazer a primeira requisição com uma chave nova, siga o guia do SDK Python da OpenAI. O verbete do glossário sobre lista de IPs permitidos explica a ideia em termos gerais.

