> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Contrato de aplicação da allowlist de IP da Plataforma

> A Plataforma agora documenta o limite de proxy confiável e o comportamento de aplicação das allowlists de IP.

<Badge stroke icon="calendar-days" iconType="regular">26 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção de documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

***

Equipes que configuram allowlists de IP para serviços da Plataforma atrás de um proxy reverso, balanceador de carga ou CDN.

## O que mudou

***

As allowlists de IP determinam o endereço do cliente a partir de `X-Forwarded-For` apenas quando o peer direto está nos CIDRs de proxy confiável configurados. Uma allowlist não vazia é aplicada apenas para um escopo `console` ou `api` selecionado; uma lista sem nenhum dos dois escopos fica inerte. Um IP de cliente resolvido que não é permitido é negado com HTTP 403. Um IP de cliente ausente ou inutilizável também é negado, a menos que o peer de transporte da requisição esteja em `PLATFORM_INTERNAL_CIDRS`. Se nenhuma allowlist estiver configurada, o middleware permite a requisição.

Esta é uma correção de documentação do comportamento de aplicação existente; não anuncia um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Um CIDR de proxy confiável ausente ou incorreto pode fazer com que tráfego legítimo seja negado ou tornar os IPs de cliente encaminhados não confiáveis.

## O que você precisa fazer

***

<Steps>
  <Step>Configure como proxies confiáveis apenas os CIDRs dos proxies que se conectam diretamente ao serviço.</Step>
  <Step>Teste requisições permitidas e negadas pela cadeia de proxies de produção antes de habilitar uma allowlist.</Step>
  <Step>Não confie em `X-Forwarded-For` vindo de clientes diretos ou de um proxy não confiável.</Step>
</Steps>

### Prazo

Valide antes de habilitar ou alterar uma allowlist de IP.