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: httpsO 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
Documentação
MDN: cabeçalho X-Forwarded-Proto
Explica os valores http e https e apresenta o cabeçalho Forwarded como alternativa padronizada.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Você pode usar uma sessão de Desenvolvimento Colaborativo para investigar redirecionamentos e a configuração do proxy no seu projeto.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.