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
Forwardedpara as mesmas informações, mas é usado muito menos na prática. - Cabeçalhos acompanhantes:
X-Forwarded-Host,X-Forwarded-ProtoeViacarregam 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.