---
title: "Restringir uma chave de API de LLM aos IPs do servidor"
description: "Proteja as chaves da BroadNet Inference com listas de IPs permitidos, separe chaves de inferência de credenciais do portal e revogue uma chave vazada em segundos."
url: https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/api-keys-ip-allow-lists/) (atualizado em 2026-11-16).

# Restrinja chaves de API aos seus servidores com lista de IPs

Atualizado em 2026-11-16

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:

```bash
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.

```bash
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](https://broadrouter.com/pt/guides/errors-and-retries/). Para fazer a primeira requisição com uma chave nova, siga [o guia do SDK Python da OpenAI](https://broadrouter.com/pt/guides/openai-python-sdk/). O [verbete do glossário sobre lista de IPs permitidos](https://broadrouter.com/pt/glossary/ip-allow-list/) explica a ideia em termos gerais.

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

## Termos neste guia

[Lista de IPs permitidos (IP allow list)](https://broadrouter.com/pt/glossary/ip-allow-list/)

Uma lista de IPs permitidos é um controle de segurança que aceita requisições apenas de endereços IP ou faixas CIDR listados e recusa todos os outros. Em uma API, ela limita o estrago de uma chave vazada, porque a chave não funciona a partir de redes que não estão na lista.

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

## 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.

## Guias relacionados

-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**Fontes**

-   [Referência da API da BroadNet Inference, listas de IPs permitidos (conferido em 2026-11-16) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [Referência da API da BroadNet Inference, chaves por hora e credenciais do portal (conferido em 2026-11-16) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [Referência da API da BroadNet Inference, limites (validade das chaves e chaves ativas) (conferido em 2026-11-16) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
