Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Formação DevOps

    O que é X-Forwarded-Proto?

    O X-Forwarded-Proto informa se o cliente usou HTTP ou HTTPS até o proxy. A aplicação usa esse cabeçalho conforme a confiança configurada no intermediário.

    Também chamado de: XFP

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    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 protocolo da conexão com o proxy

    O X-Forwarded-Proto é um cabeçalho de requisição que informa à aplicação se o cliente chegou ao proxy ou balanceador por HTTP ou HTTPS. Ele é útil quando o intermediário recebe uma conexão HTTPS e encaminha a requisição por HTTP ao servidor interno. Nesse caso, a aplicação vê uma conexão HTTP, mas precisa conhecer o protocolo usado no acesso público.

    O proxy preenche o cabeçalho com o protocolo observado na conexão do cliente. A aplicação pode usar essa informação ao gerar endereços e redirecionamentos. O valor recebido só descreve o trecho indicado pelo proxy, sem alterar a criptografia da conexão interna.

    HTTPS no acesso público

    Neste exemplo, o navegador acessa https://painel.example.test. O proxy encerra a conexão HTTPS e envia a requisição ao servidor interno por HTTP, incluindo:

    X-Forwarded-Proto: https

    O valor https descreve o acesso do navegador ao proxy. Uma aplicação configurada para confiar nesse intermediário pode reconhecê-lo como o protocolo público e gerar um endereço com https://. O tráfego entre o proxy e a aplicação continua usando HTTP, conforme definido no exemplo.

    A confiança depende do caminho da requisição

    No Express, a opção trust proxy permite usar o cabeçalho na propriedade req.protocol. Você precisa configurar os proxies confiáveis conforme o caminho efetivo das requisições e conferir se o último proxy confiável remove ou sobrescreve valores externos. Se ele repassar livremente o cabeçalho recebido, o cliente poderá informar um protocolo falso.

    O X-Forwarded-Proto é uma convenção de uso difundido, com o parâmetro proto do cabeçalho Forwarded como alternativa padronizada. Para configurar a interpretação do cabeçalho nesse framework, consulte o guia do Express sobre proxies.

    Dúvidas frequentes

    Perguntas frequentes sobre X-Forwarded-Proto

    O cabeçalho torna a conexão interna criptografada?
    O cabeçalho apenas informa um protocolo. A criptografia entre o proxy e a aplicação exige que esse trecho também use HTTPS.
    Como o Express usa o X-Forwarded-Proto?
    Com a confiança no proxy habilitada para a origem da requisição, o Express usa o cabeçalho para compor req.protocol. A configuração precisa corresponder aos proxies que encaminham o tráfego.
    Qual é a alternativa padronizada?
    O cabeçalho Forwarded possui o parâmetro proto para informar o protocolo. Sua adoção depende do suporte do proxy e da aplicação.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Formação DevOps

    Ao publicar uma aplicação atrás de um proxy, você precisa conferir qual protocolo ela usa nos endereços de redirecionamento.

    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