Reescrever os cabeçalhos de solicitação e resposta HTTP com o Gateway de Aplicativo do Azure - portal do Azure

Este artigo descreve como usar o portal do Azure para configurar uma instância de SKU do Gateway de Aplicativo do Azure v2 para reescrever os cabeçalhos HTTP em solicitações e respostas.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Antes de começar

Você precisa ter uma instância de SKU do Gateway de Aplicativo v2 para concluir as etapas neste artigo. Não há suporte para a reescrita de cabeçalhos na SKU v1. Se você não tiver o SKU v2, crie uma instância da SKU v2 do Gateway de Aplicativo antes de começar.

Criar os objetos necessários

Para configurar a reescrita do cabeçalho HTTP, sigas estas etapas.

1. Criar os objetos que são necessários para uma reescrita de cabeçalho HTTP:

   • Ação de reescrita: Usada para especificar os campos solicitação e cabeçalho da solicitação que você deseja reescrever e o novo valor para os cabeçalhos. Você pode associar uma ou mais condições de reescrita a uma ação de reescrita.

   • Condição de reescrita: Uma configuração opcional. As condições de reescrita avaliam o conteúdo das solicitações e respostas HTTP(S). A ação de reescrita ocorre se a solicitação ou resposta HTTP(S) corresponder à condição de reescrita.

     Se você associar mais de uma condição a uma ação, a ação ocorrerá somente quando todas as condições forem atendidas. Em outras palavras, a operação é uma operação AND lógica.

   • Regra de reescrita: contém várias combinações de ação de reescrita/condição de reescrita.

   • Sequência de regras: Ajuda a determinar a ordem na qual as regras de reescrita são executadas. Essa configuração é útil quando você tem várias regras de reescrita em um conjunto de reescrita. Uma regra de reescrita que tem um valor de sequência de regra mais baixo é executada primeiro. Se você atribuir o mesmo valor de sequência de regras a duas regras de reescrita, a ordem de execução será não determinística.

   • Conjunto de reescrita: Contém várias regras de reescrita que serão associadas a uma regra de roteamento de solicitação.

2. Anexe o conjunto de reconfiguração a uma regra de roteamento. A configuração de reescrita é anexada ao ouvinte de origem por meio da regra de roteamento.

   • Quando você usa uma regra de roteamento básica, a configuração de reescrita de cabeçalho é associada a um ouvinte de origem e é uma reescrita de cabeçalho global.
   • Quando você usa uma regra de roteamento com base em caminho, a configuração de reescrita de cabeçalho é definida no mapa de caminho da URL. Nesse caso, ela se aplica somente à área de caminho específico de um site.

Você pode criar vários conjuntos de reescrita de cabeçalho HTTP e aplicar cada conjunto de reescrita a vários ouvintes. Mas você pode aplicar apenas um conjunto de reescrita a um ouvinte específico.

Entrar no Azure

Entre no portal do Azure com sua conta do Azure.

Configurar uma reescrita de cabeçalho

Neste exemplo, modificamos um URL de redirecionamento reescrevendo o cabeçalho de local na resposta HTTP enviada por um aplicativo de back-end.

1. Selecione Todos os recursos e, em seguida, selecione seu gateway de aplicativo.

2. No painel de serviço, selecione Reescritas.

3. Selecione Conjunto de reescrita.

   

4. Informe um nome para o conjunto de reescrita e associe-o a uma regra de roteamento:

   1. Na caixa Nome, insira o nome para o conjunto de reescrita.
   2. Na lista Regras de roteamento associadas, selecione uma ou mais regras. Selecione apenas as regras que não foram associadas a outros conjuntos de reescrita. As regras que já foram associadas a outros conjuntos de reescrita ficam esmaecidas.
   3. Selecione Avançar.

   

5. Criar uma regra de reescrita:

   1. Selecione Adicionar regra de reescrita.

      

   2. Na caixa Nome da regra de reescrita, insira um nome para a regra de reescrita. Na caixa Sequência de regras, insira um número.

      

6. Neste exemplo, reescrevemos o cabeçalho de local somente quando ele contém uma referência a azurewebsites.net. Para realizar essa etapa, adicione uma condição para avaliar se o cabeçalho de local na resposta contém azurewebsites.net:

   1. Selecione Adicionar condição e escolha a caixa que contém as instruções If para expandi-la.

      

   2. Na lista tipo de variável a ser verificada, selecione cabeçalho HTTP.

   3. Na lista tipo de cabeçalho, selecione resposta.

   4. Nome do cabeçalho: selecione o Cabeçalho comum. Neste exemplo, estamos avaliando o cabeçalho de local, que é um cabeçalho comum.

   5. Na lista cabeçalho comum, selecione local.

   6. Em Diferenciar maiúsculas de minúsculas, selecione Não.

   7. Na lista Operador, selecione igual (=).

   8. Insira um padrão de expressão regular. Neste exemplo, usamos o padrão (https?):\/\/.*azurewebsites.net(.*)$.

   9. Selecione OK.

   

7. Adicione uma ação para reescrever o cabeçalho de local:

   1. Na lista Tipo de ação, selecione Conjunto.
   2. Na lista tipo de cabeçalho, selecione resposta.
   3. Nome do cabeçalho: selecione o Cabeçalho comum.
   4. Na lista cabeçalho comum, selecione local.
   5. Insira o valor do cabeçalho. Neste exemplo, usamos {http_resp_Location_1}://contoso.com{http_resp_Location_2} como o valor do cabeçalho. Esse valor substitui azurewebsites.net por contoso.com no cabeçalho do local.
   6. Selecione OK.

   

8. Selecione Criar para criar o conjunto de reescrita.

   

9. O painel Reescritas é aberto. Verifique se o conjunto de reescrita que você criou está na lista de conjuntos de reescrita.

   

Conteúdo relacionado

Para saber mais sobre como configurar alguns casos de uso comuns, consulte Cenários comuns de reescrita de cabeçalho.