X-Forwarded-For (XFF) é um cabeçalho de solicitação HTTP que identifica o endereço IP de origem de um cliente que se conecta a um servidor web através de um proxy. Sem ele, o servidor vê apenas o IP do último proxy. Como o cabeçalho expõe o IP do cliente por design, um proxy que o adiciona passa seu endereço original para o site de destino.

Cada proxy na cadeia anexa o endereço IP de onde recebeu a conexão. A entrada mais à esquerda é o cliente reivindicado e a mais à direita é o proxy mais recente, por exemplo X-Forwarded-For: 203.0.113.195, 198.51.100.178.

Status Padrão e Cabeçalhos Relacionados

  • Padrão de fato: XFF é amplamente utilizado, mas não está definido em nenhuma especificação atual.
  • Cabeçalho Forwarded: O RFC 7239 define um cabeçalho padrão Forwarded para as mesmas informações, mas é usado muito menos na prática.
  • Cabeçalhos acompanhantes: X-Forwarded-Host, X-Forwarded-Proto e Via carregam detalhes relacionados ao proxy.
  • Balanceadores de carga: Alguns balanceadores de carga permitem que você anexe o IP do cliente ao XFF, passe-o inalterado ou o remova.

Confiança e Spoofing

Um cliente pode enviar um cabeçalho X-Forwarded-For forjado, portanto, apenas endereços adicionados por proxies confiáveis são confiáveis. Servidores que usam XFF para limitação de taxa ou controle de acesso devem ler a lista da direita, ignorando proxies confiáveis conhecidos, e tratar os valores mais à esquerda como não confiáveis. Se o servidor também puder ser acessado diretamente da internet, nenhuma parte da lista pode ser confiável.

Para Que Serve o X-Forwarded-For

Um servidor atrás de um proxy ou balanceador de carga registra apenas o endereço IP desse dispositivo. O XFF permite recuperar o endereço do cliente para depuração, estatísticas e conteúdo dependente de localização.

Lendo X-Forwarded-For no NGINX

O módulo realip do NGINX substitui o endereço do cliente por um retirado de um cabeçalho como X-Forwarded-For.

  • set_real_ip_from: Lista endereços confiáveis conhecidos por enviar valores corretos.
  • real_ip_header X-Forwarded-For;: Diz ao NGINX qual cabeçalho ler.
  • real_ip_recursive on;: Usa o último endereço no cabeçalho que não é confiável, em vez do último endereço geral.

O módulo não é construído por padrão. Ele precisa da opção de construção --with-http_realip_module.

Termos Relacionados