O endereço recebido pelo servidor
O X-Forwarded-For é um cabeçalho de requisição HTTP que transporta endereços IP associados ao percurso por proxies. Sem essa informação, um servidor atrás de um proxy reverso vê no transporte o endereço do proxy que estabeleceu a conexão com ele. O cabeçalho permite informar o endereço do cliente e dos intermediários anteriores.
A lista usa vírgulas para separar os endereços. Quando um proxy acrescenta o endereço da conexão recebida, ele o coloca à direita do conteúdo existente. No Nginx, esse é o comportamento da variável $proxy_add_x_forwarded_for. O cabeçalho, por si só, não confirma que os valores recebidos de fora sejam verdadeiros.
Uma requisição atravessa dois proxies
Neste exemplo didático, o cliente 203.0.113.10 acessa o proxy A, com endereço 192.0.2.20, que encaminha a requisição ao proxy B. O cliente não envia X-Forwarded-For. Os dois proxies acrescentam o endereço da conexão que recebem, produzindo no servidor:
X-Forwarded-For: 203.0.113.10, 192.0.2.20O proxy A acrescentou 203.0.113.10 porque esse foi o endereço recebido na conexão do cliente. O proxy B acrescentou 192.0.2.20, o endereço de A. Já o endereço de B aparece na conexão recebida pelo servidor, portanto não precisa estar nessa lista. Os endereços são ilustrativos e não descrevem uma instalação existente.
Como interpretar uma lista recebida
Você precisa identificar os proxies confiáveis para usar essa lista em restrições por endereço. No módulo realip do Nginx, set_real_ip_from declara essas origens. Com real_ip_recursive on, uma conexão vinda de origem confiável permite selecionar o último endereço não confiável do cabeçalho, conforme a documentação do módulo.
Um cliente pode fornecer valores falsos à esquerda. Usar cegamente o primeiro endereço permite atribuir a requisição a outra origem e contornar limites de acesso. O acesso direto ao servidor também precisa ser considerado: cabeçalhos recebidos por esse caminho não têm a confirmação de um proxy administrado. A identificação do endereço continua distinta da autenticação, que verifica a identidade e as permissões para acessar a aplicação.
Dúvidas frequentes
Perguntas frequentes sobre X-Forwarded-For
- O primeiro endereço da lista é sempre o cliente original?
- Essa posição depende de clientes e proxies corretamente configurados. Um cliente pode enviar um valor falso, por isso a aplicação precisa interpretar a lista conforme os intermediários confiáveis.
- O último proxy aparece no fim do cabeçalho?
- Normalmente, o último proxy é identificado pelo endereço da conexão recebida pelo servidor. Ao acrescentar o endereço recebido, cada proxy registra no cabeçalho a ponta que se conectou a ele.
- Como o Nginx seleciona o endereço com real_ip_recursive ativo?
- Quando a conexão vem de uma origem declarada confiável, o módulo realip procura o último endereço não confiável na lista. A opção exige uma lista correta de proxies confiáveis.
Para continuar
Recursos relacionados
Documentação
MDN: endereços encaminhados e confiança nos proxies
Descreve a sintaxe do cabeçalho e os cuidados para usar endereços acrescentados por proxies confiáveis.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar os proxies confiáveis e comparar os cabeçalhos com os registros de acesso.
Abrir recursoAplicação na formação
Formação DevOps
A configuração de proxies exige distinguir o endereço da conexão dos endereços informados nos cabeçalhos HTTP.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.