Suporte de protocolo para cabeçalhos HTTP no Azure Front Door
Este artigo descreve o protocolo ao qual o Front Door dá suporte com partes do caminho de chamada (consulte a imagem). Nas seções a seguir, você encontrará informações sobre cabeçalhos HTTP compatíveis com o Front Door.
Importante
O Azure Front Door não certifica nenhum cabeçalho HTTP que não esteja documentado aqui.
Do cliente ao Azure Front Door
O Azure Front Door aceita a maioria dos cabeçalhos para a solicitação de entrada sem modificá-los. Alguns cabeçalhos reservados são removidos da solicitação recebida se forem enviados, incluindo cabeçalhos com o prefixo X-FD-*.
O cabeçalho da solicitação de depuração, X-Azure-DebugInfo, fornece informações extras de depuração sobre o Front Door. Você precisa enviar X-Azure-DebugInfo: 1 cabeçalho de solicitação do cliente para o Azure Front Door para receber cabeçalhos de resposta opcionais quando a resposta do Azure Front Door ao cliente.
Do Front Door ao back-end
O Azure Front Door inclui cabeçalhos para uma solicitação de entrada, a menos que eles sejam removidos devido a restrições. O Azure Front Door também anexa os seguintes cabeçalhos:
| Cabeçalho | Exemplo e descrição |
|---|---|
| Através de | Via: 1.1 Azure O Front Door adiciona a versão HTTP do cliente seguida pelo Azure como o valor do cabeçalho Via. Este cabeçalho indica a versão HTTP do cliente e que o Front Door era um destinatário intermediário da solicitação entre o cliente e o back-end. |
| X-Azure-ClientIP | X-Azure-ClientIP: 127.0.0.1 Representa o endereço IP do cliente associado à solicitação que está sendo processada. Por exemplo, uma solicitação proveniente de um proxy pode adicionar o cabeçalho X-Forwarded-For para indicar o endereço IP do chamador original. |
| X-Azure-SocketIP | X-Azure-SocketIP: 127.0.0.1 Representa o endereço IP do soquete associado à conexão TCP da qual a solicitação atual se originou. O endereço IP do cliente de uma solicitação pode não ser igual ao endereço IP do soquete dele porque o IP do cliente pode ser substituído arbitrariamente por um usuário. |
| X-Azure-Ref | X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz Uma cadeia de referência exclusiva que identifica uma solicitação atendida pelo Azure Front Door. Essa cadeia de caracteres é usada para pesquisar logs de acesso e é crítica para solução de problemas. |
| X-Azure-RequestChain | X-Azure-RequestChain: hops=1 Um cabeçalho que o Front Door usa para detectar loops de solicitação e os usuários não devem depender dele. |
| X-Azure-FDID | X-Azure-FDID: 55ce4ed1-4b06-4bf1-b40e-4638452104da Uma cadeia de caracteres de referência que identifica que a solicitação provém de um recurso específico do Front Door. O valor pode ser visto no portal do Azure ou recuperado com a API de gerenciamento. Você pode usar esse cabeçalho com ACLs de IP a fim de bloquear o ponto de extremidade para que ele aceite somente solicitações de um recurso específico do Front Door. Consulte as perguntas frequentes para saber mais |
| X-Forwarded-For | X-Forwarded-For: 127.0.0.1 O campo de cabeçalho HTTP X-Forwarded-For (XFF) geralmente identifica o endereço IP de origem de um cliente que se conecta a um servidor web por meio de um proxy HTTP ou balanceador de carga. Se houver um cabeçalho XFF, o Front Door acrescentará o IP de soquete do cliente a ele ou o adicionará com esse IP. |
| X-Forwarded-Host | X-Forwarded-Host: contoso.azurefd.net O campo de cabeçalho HTTP X-Forwarded-Host é um método comum usado para identificar o host original solicitado pelo cliente no cabeçalho de solicitação HTTP do Host. Isso ocorre porque o nome do anfitrião do Azure Front Door pode ser diferente para o servidor backend que processa a solicitação. Qualquer valor anterior é substituído pelo Azure Front Door. |
| X-Forwarded-Proto | X-Forwarded-Proto: http O X-Forwarded-Proto campo de cabeçalho HTTP é frequentemente usado para identificar o protocolo de origem de uma solicitação HTTP. O Front Door baseado na configuração pode se comunicar com o back-end usando HTTPS. Isso é verdadeiro mesmo quando a solicitação para o proxy reverso é HTTP. Qualquer valor anterior será substituído pelo Front Door. |
| X-FD-HealthProbe | X-FD-HealthProbe O campo de cabeçalho HTTP é usado para identificar a investigação de integridade do Front Door. Se o cabeçalho estiver definido como 1, a solicitação será investigada quanto à integridade. Ele pode ser usado para restringir o acesso do Front Door com um valor específico para o campo de cabeçalho X-Forwarded-Host. |
Do Front Door ao cliente
Todos os cabeçalhos enviados ao Azure Front Door pelo back-end também são transmitidos ao cliente. O Front Door também anexa os seguintes cabeçalhos a todas as respostas ao cliente:
| parâmetro | Exemplo e descrição |
|---|---|
| X-Azure-Ref | X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz Essa é uma cadeia de referência exclusiva que identifica uma solicitação atendida pelo Front Door, o que é fundamental para a solução de problemas, pois é usado para pesquisar logs de acesso. |
| X-Cache | X-Cache: Esse cabeçalho descreve o status de cache da solicitação. Para obter mais informações, confira Cache com o Azure Front Door. |
Cabeçalhos de resposta de depuração opcionais
Você precisa enviar X-Azure-DebugInfo: 1 cabeçalho de solicitação para ativar os seguintes cabeçalhos de resposta opcionais.
| Cabeçalho | Exemplo e descrição |
|---|---|
| X-Azure-OriginStatusCode | X-Azure-OriginStatusCode: 503 Esse cabeçalho contém o código de status HTTP retornado pelo back-end. Com ele, você pode identificar o código de status HTTP retornado pelo aplicativo em execução no back-end sem precisar analisar os logs de back-end. Esse código de status pode ser diferente do código de status HTTP na resposta enviada ao cliente pelo Front Door. Esse cabeçalho permite determinar se o back-end está com comportamento inadequado ou se o problema é com o serviço Front Door. |
| X-Azure-InternalError | Esse cabeçalho contém o código de erro que o Azure Front Door encontra ao processar a solicitação. Esse erro indica que o problema é interno ao serviço/infraestrutura do Azure Front Door. Relate o problema ao suporte. |
| X-Azure-ExternalError | X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar Este cabeçalho mostra o código de erro recebido pelos servidores do Front Door ao estabelecer conectividade com o servidor de back-end para processar uma solicitação. Este cabeçalho ajuda a identificar problemas na conexão entre o Front Door e o aplicativo de back-end. Este cabeçalho inclui uma mensagem de erro detalhada para ajudá-lo a identificar problemas de conectividade com seu back-end (por exemplo, resolução de DNS, certificado inválido e assim por diante.). |
Próximas etapas
- Saiba como Criar um perfil do Azure Front Door.
- Saiba como o Azure Front Door funciona.