Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Formação DevOps

    O que é X-Forwarded-For?

    O X-Forwarded-For transporta endereços IP de requisições que atravessam proxies. A aplicação precisa reconhecer os intermediários confiáveis ao ler a lista.

    Também chamado de: XFF

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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.20

    O 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

    Aplicaçã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
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano