O nome público depois do encaminhamento
O X-Forwarded-Host é um cabeçalho HTTP usado por proxies para informar o host originalmente solicitado pelo cliente. Ele permite recuperar o nome público quando o intermediário modifica o cabeçalho Host ao encaminhar a requisição para a aplicação.
Um proxy reverso recebe a conexão externa e faz outra requisição ao serviço interno. Esses dois trechos podem usar nomes diferentes. A aplicação consegue gerar um link com o domínio público ao interpretar a informação encaminhada, desde que ela venha de um proxy configurado como confiável.
Dois nomes na requisição interna
Este exemplo didático mostra os cabeçalhos que um proxy poderia enviar à aplicação depois de receber uma requisição para portal.example.com:
Host: app-interna:3000X-Forwarded-Host: portal.example.comOs cabeçalhos identificam dois destinos relacionados: app-interna:3000 é o serviço interno que recebe a requisição e portal.example.com é o nome público preservado pelo proxy. Ao interpretar X-Forwarded-Host, a aplicação pode gerar links com esse domínio público.
Esse par de cabeçalhos ilustra uma configuração possível. O proxy também pode preservar o Host original, por isso você precisa conferir os valores recebidos pela aplicação e o tratamento configurado para eles.
Confiança no proxy e suporte da aplicação
No Express, a opção trust proxy afeta a origem do valor de req.hostname, que pode ser derivado de X-Forwarded-Host. O próprio cliente pode enviar esse cabeçalho. Ao configurar a confiança, confira se o último proxy confiável remove ou sobrescreve valores externos que a aplicação não deve aceitar.
O X-Forwarded-Host é uma convenção difundida. O parâmetro host do cabeçalho padronizado Forwarded tem função relacionada, mas o suporte depende da implementação. Nenhum dos dois autentica o cliente ou concede permissão de acesso ao site.
Dúvidas frequentes
Perguntas frequentes sobre X-Forwarded-Host
- O X-Forwarded-Host também informa o protocolo externo?
- Esse cabeçalho identifica o host original. A indicação de HTTP ou HTTPS costuma usar X-Forwarded-Proto, que precisa do mesmo cuidado com a confiança no proxy.
- Ativar trust proxy no Express torna o valor confiável?
- A opção faz o Express usar informações encaminhadas conforme a configuração. O último proxy confiável precisa remover ou sobrescrever cabeçalhos externos indevidos, pois o cliente também pode enviar esses valores.
- O Forwarded substitui esse cabeçalho automaticamente?
- O parâmetro host do Forwarded oferece uma forma padronizada de transportar o host original. A aplicação e o proxy precisam oferecer suporte a ele. A presença de Forwarded não converte automaticamente os campos X-Forwarded-*.
Para continuar
Recursos relacionados
Documentação
MDN: host original no encaminhamento por proxy
Apresenta o uso de X-Forwarded-Host para preservar o nome solicitado quando o encaminhamento altera o Host.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão de Desenvolvimento Colaborativo para conferir os cabeçalhos encaminhados e a configuração de confiança no proxy.
Abrir recursoAplicação na formação
Formação DevOps
Uma aplicação atrás de um proxy precisa interpretar o domínio público sem confundi-lo com o endereço interno do serviço.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.