---
title: "O que é uma lista de IPs permitidos na chave de API? CIDR"
description: "Uma lista de IPs permitidos só aceita requisições de endereços ou faixas CIDR listados. Como protege uma chave de API de LLM, o CIDR e as armadilhas na nuvem."
url: https://broadrouter.com/pt/glossary/ip-allow-list/
lang: pt-BR
updated: 2026-11-14
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/glossary/ip-allow-list/) (atualizado em 2026-11-14).

# Lista de IPs permitidos (IP allow list)

Atualizado em 2026-11-14

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.

Também chamado de: lista de IPs permitidos, whitelist de IP, lista branca de IPs, IPs permitidos, restrição por IP, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed\_ips

Por padrão, uma chave de API funciona de qualquer lugar. Uma lista de IPs permitidos a prende aos lugares onde o seu código realmente roda.

## Como funciona

A borda da API compara o IP de origem de cada requisição com uma lista. Se o endereço estiver na lista, ou dentro de uma faixa listada, a requisição segue para a verificação normal da chave. Caso contrário, é recusada.

As faixas são escritas em notação CIDR: um endereço, uma barra e o tamanho do prefixo. O RFC 4632 explica que o tamanho do prefixo é a quantidade de bits iniciais fixos. Para IPv4:

| Entrada | Abrange |
| --- | --- |
| `203.0.113.7` | um endereço |
| `198.51.100.0/24` | 256 endereços, de `198.51.100.0` a `198.51.100.255` |
| `10.0.0.0/16` | 65.536 endereços |

O IPv6 usa a mesma ideia com endereços de 128 bits, como `2001:db8::/48`.

O endereço que importa é o seu IP de **saída** (egress): o endereço público de onde sai o tráfego do servidor. Atrás de NAT, de um load balancer ou de um proxy corporativo, muitas vezes ele não é o endereço que a máquina mostra para si mesma.

## Por que importa

[Chaves de API](https://broadrouter.com/pt/glossary/api-key/) são bearer tokens: quem tiver uma pode usá-la. Chaves vazam por commits, logs, capturas de tela e notebooks. Com uma lista de IPs permitidos, uma chave roubada não funciona a partir da rede do atacante, o que transforma um vazamento de incidente de gastos em um não-evento. O GitHub, por exemplo, aplica a sua lista às chamadas de API e aos personal access tokens, além dos logins na web.

O custo é algum trabalho operacional. Cada novo servidor, região ou runner de CI exige adicionar o seu IP de saída, e IPs dinâmicos exigem um caminho de saída fixo.

## Na BroadNet Inference

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. Novas chaves herdam a lista da conta. Um `allowed_ips` por chave a substitui para aquela chave:

```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"]}'
```

Requisições de outros endereços recebem um 403. Depois de uma alteração ou da revogação de uma chave, novas requisições param em até cinco segundos. O passo a passo completo está em [chaves de API e listas de IPs permitidos](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/), e a tabela de erros está em [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/). Para o quadro mais amplo de proteção de dados, veja o [checklist de ZDR](https://broadrouter.com/pt/blog/zero-data-retention-llm-api-checklist/).

## Erros comuns

-   Listar o endereço privado de um servidor, como `10.x.x.x`, em vez do seu IP público de saída.
-   Usar uma faixa muito ampla para fazer os erros sumirem. Um `/8` abrange mais de 16 milhões de endereços.

## Perguntas frequentes

### Uma lista de IPs permitidos basta para proteger uma chave de API?

Não. Ela é uma camada. Continue mantendo as chaves nos servidores, fora do código e dos logs, dê a cada app a sua própria chave e revogue rapidamente as chaves que vazarem.

### Meus servidores rodam em infraestrutura serverless ou com autoscaling. Posso usar uma lista de IPs permitidos?

Só se o tráfego de saída sair de endereços conhecidos. Faça-o passar por um NAT gateway ou proxy de saída com IPs fixos e liste esses IPs.

### Que erro recebo de um IP que não está na lista?

Na BroadNet Inference, um 403. Outras APIs normalmente também retornam 403.

## Veja também

-   [Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/) (termo)
-   [Retenção zero de dados (zero data retention)](https://broadrouter.com/pt/glossary/zero-data-retention/) (termo)
-   [Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/) (termo)
-   [Restrinja chaves de API aos seus servidores com lista de IPs](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/) (guia)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/) (guia)
-   [API de LLM com retenção zero de dados: checklist de 10 perguntas](https://broadrouter.com/pt/blog/zero-data-retention-llm-api-checklist/) (artigo)

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-glossary-ip-allow-list&utm_content=page-cta) ·

**Fontes**

-   [RFC 4632: Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, gerenciar os endereços IP permitidos de uma organização](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Referência da API da BroadNet Inference, listas de IPs permitidos (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
