BroadRouter
Começar

Restrinja chaves de API aos seus servidores com lista de IPs

Atualizado em

Adicione à lista de IPs permitidos da conta os endereços IPv4 ou IPv6 de saída dos seus servidores, ou faixas CIDR, até 32 entradas. Novas chaves herdam a lista, a menos que você passe allowed_ips ao criar uma. Requisições de outros endereços recebem 403, e mudanças na lista ou revogações passam a valer em até cinco segundos.

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_ips por 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.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

Perguntas frequentes

Como restringir uma chave de API de LLM ao IP do meu servidor?

Adicione o endereço público de saída do servidor, ou uma faixa CIDR, à lista de IPs permitidos na página da conta da BroadNet, ou passe allowed_ips ao criar a chave via POST /portal/keys. Requisições de qualquer outro endereço são recusadas com 403.

Uma lista de IPs vazia bloqueia tudo?

Não. Uma lista vazia significa nenhuma restrição de IP, então a chave funciona de qualquer endereço. Adicione pelo menos uma entrada para ativar a restrição.

Posso usar uma chave de inferência para criar outras chaves?

Não. Chaves de inferência só chamam as rotas de modelo /v1/*. Criar e revogar chaves, mudar os IPs permitidos e comprar chaves por hora exige uma credencial do portal, que tem autoridade total sobre a conta.

Quão rápido funciona a revogação de uma chave vazada?

A documentação da BroadNet diz que novas requisições param em até cinco segundos após uma revogação ou mudança na lista de IPs, porque as decisões de autorização podem ficar esse tempo em um cache replicado.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity