Suporte de protocolo para cabeçalhos HTTP no Azure Front Door

  • Artigo

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.

Diagrama mostrando o cliente fazendo solicitação ao Azure Front Door, que é encaminhado para o back-end. A resposta é enviada do Azure Front Door para o cliente.

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