Modificando cabeçalhos de resposta HTTP

por Ruslan Yakushev

Esta seção da documentação se aplica ao Módulo de Regravação de URL versão 2.0 do IIS 7.

Este passo a passo orienta você sobre como usar o Módulo de Regravação de URL v 2.0 para definir cabeçalhos de resposta HTTP.

Pré-requisitos

Este passo a passo requer os seguintes pré-requisitos:

  1. IIS 7 ou superior com o serviço de função do ASP.NET habilitado;
  2. Url Rewrite Module 2.0 Release Candidate instalado;
  3. Passo a passo concluído no Proxy Reverso com Regravação de URL v2 e Roteamento de Solicitação de Aplicativo.

Introdução

O Módulo de Reescrita de URL 2.0 fornece suporte para a reescrita baseada em regras dos cabeçalhos HTTP de resposta. Um cenário de uso muito comum para definir os cabeçalhos de resposta é modificar a resposta de redirecionamento gerada por um aplicativo por trás de um balanceador de carga ou um proxy reverso. Por exemplo, quando um aplicativo por trás de um proxy reverso retorna uma resposta de redirecionamento, o cabeçalho local HTTP na resposta pode não representar o endereço voltado para a Internet, mas sim um endereço de aplicativo interno. O Módulo de Reescrita de URL 2.0 pode ser usado no servidor proxy reverso para modificar o cabeçalho Local na resposta. O cenário é representado no seguinte diagrama:

Diagrama que mostra o processo de resposta de redirecionamento entre o cliente, o servidor proxy reverso e o servidor cliente interno.

  1. Um cliente HTTP faz uma solicitação para uma página http://www.contoso.com/webmail/oldpage.aspxda Web.
  2. O servidor proxy reverso usa o URL Rewrite 2.0 e o Application Request Routing para encaminhar a solicitação a um servidor de conteúdo interno com base no nome da pasta no caminho solicitado do URL. Por exemplo, http://webmail/oldpage.aspx;
  3. O aplicativo Web em execução no servidor de conteúdo emite uma resposta de redirecionamento (HTTP/1.1 301) apontando um cliente HTTP para http://webmail/newpage.aspx;
  4. O servidor proxy reverso usa a Regravação de URL 2.0 para substituir o local de redirecionamento baseado interno na resposta pelo local de redirecionamento baseado na Internet: http://www.contoso.com/webmail/newpage.aspx.

Configurando um cenário passo a passo

Para configurar o cenário de demonstração, conclua o tutorial sobre Reverse Proxy com URL Rewrite v2 e ARR (Application Request Routing). No final desse passo a passo, você deve ter um site de proxy reverso que roteia solicitações para dois aplicativos de conteúdo: webmail e folha de pagamento.

Para este passo a passo, você precisará adicionar uma lógica de redirecionamento ao aplicativo webmail. No cenário da vida real, isso provavelmente seria um redirecionamento iniciado pelo código do aplicativo Web, mas, para simplificar, neste passo a passo, você usará uma regra de redirecionamento no Módulo de Reescrita de URL.

  1. Crie um arquivo chamado web.config na seguinte pasta:

    %SystemDrive%\inetpub\webmail

  2. Abra o arquivo em um editor de texto, cole o seguinte código XML dentro e salve o arquivo:

    <?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
  <rewrite>
    <rules>
     <rule name="Redirect" stopProcessing="true">
     <match url="^index\.aspx$" />
     <action type="Redirect" url="default.aspx" />
    </rule>
   </rules>
  </rewrite>
</system.webServer>
</configuration>

    Essa é uma regra que redirecionará todas as solicitações de index.aspx para default.aspx.

Agora abra um navegador da Web e faça uma solicitação http://localhost/webmail/index.aspx. Observe que o navegador foi redirecionado para http://localhost:8081/default.aspx, que é basicamente uma URL interna usada pelo aplicativo Web de webmail. Agora você configurará as regras de Reescrita de URL para modificar o cabeçalho de localização HTTP nas respostas de redirecionamento do HTTP para que o navegador seja redirecionado para uma URL adequada: http://localhost/webmail/default.aspx.

Modificando a regra de entrada para preservar o cabeçalho de host

Para poder modificar o cabeçalho local HTTP, é necessário preservar o valor original do cabeçalho do host HTTP. A regra de reescrita de saída usa o valor preservado ao modificar a resposta. Para preservar o valor original, armazene-o em uma variável de servidor temporária ORIGINAL_HOST.

  1. Na página de exibição de recurso de Reescrita de URL principal, selecione Exibir Variáveis de Servidor no painel Ações no lado direito:
    Captura de tela de Exibir Variáveis do Servidor em Gerenciar Variáveis de Servidor no painel Ações.
  2. Na página Variáveis de Servidor Permitidas , selecione Adicionar e, em seguida, insira o nome da variável de servidor que será usada para armazenar temporariamente o valor do cabeçalho do Host HTTP. Por exemplo, ORIGINAL_HOST:
    Captura de tela do nome da variável do servidor definido como HOST de sublinhado ORIGINAL.
  3. Selecione OK para salvar as alterações e, em seguida, retorne à página de exibição de recurso de Reescrita de URL principal. Depois disso, selecione a regra de entrada "Proxy Reverso para webmail" e selecione Editar.
  4. Na página Editar Regra de Entrada , expanda a caixa de grupo "Variáveis de Servidor"; Em seguida, selecione Adicionar e insira "ORIGINAL_HOST" para o nome da variável do servidor e "{HTTP_HOST}" para o "Valor":
    Captura de tela da página Editar Regra de Entrada com Definir Valor Variável do Servidor definido para preparar a chave de sublinhado HOST do H T T P.

Criando uma regra de saída para modificar o cabeçalho de resposta HTTP

Agora você criará uma regra de reescrita de saída que reescreve o cabeçalho local HTTP em respostas de redirecionamento para adicionar de volta a pasta do aplicativo ao caminho da URL e substituir o nome do host.

  1. Na página principal do modo de exibição do recurso de reescrita de URLs, selecione "Adicionar Regras" e, em seguida, selecione "Regra em Branco" na categoria "Regras de Saída".
  2. Na página "Editar Regra de Saída", nomeie a regra como "Reescrever Cabeçalho de Localização".
  3. Na lista suspensa "Pré-condição", escolha "<Criar nova pré-condição>".
  4. Na caixa de diálogo "Adicionar Pré-Condição", nomeie a pré-condição como "IsRedirection"
  5. Selecione "Adicionar" e, em seguida , insira {RESPONSE_STATUS} como uma entrada de condição e "3\d\d" como o padrão. Essa pré-condição é usada para verificar se a resposta tem um código de status de redirecionamento, como 301, 302, 307 e assim por diante. A caixa de diálogo de pré-condição deve ser semelhante à seguinte:
    Captura de tela do conjunto de chaves RESPONSE do sublinhado STATUS como uma entrada e três barras invertidas d backslash d definidas como o padrão.
  6. Selecione OK para retornar à página Editar Regra de Saída.
  7. Na caixa de grupo Correspondência, use a lista suspensa Escopo de Correspondência para selecionar Variável de Servidor.
  8. Insira RESPONSE_Location para o "Nome da variável" e "^http://[^/]+/(.*)" para o "Padrão". Isso configura a regra para operar no cabeçalho HTTP de resposta "Location" e corresponder seu valor com um padrão regex que armazena o caminho da URL em uma referência inversa.
  9. Expanda a caixa de grupo "Condições", selecione "Adicionar" e insira {ORIGINAL_HOST} como uma entrada de condição e ".+" como um padrão de condição. Essa condição verifica se a variável de servidor temporário ORIGINAL_HOST existe e tem um valor não vazio.
  10. Selecione Adicionar mais uma vez e adicione outra condição. Defina a entrada de condição como {URL} e o padrão como "^/(webmail|payroll)/.*". Essa expressão regular é usada para corresponder aos caminhos de URL que começam com /webmail ou /payroll. Além disso, o parêntese dentro do padrão captura a parte da cadeia de caracteres de URL correspondente, de modo que ela possa ser reutilizada ao construir a URL de substituição.
  11. Por fim, na caixa de grupo "Ação", escolha a ação "Reescrever" e insira "http://{ORIGINAL_HOST}/{C:1}/{R:1}" como um valor. Essa ação substitui o valor do cabeçalho Location do HTTP por uma cadeia de caracteres construído usando o nome do host da variável de servidor, a referência indireta da condição que contém o prefixo do caminho da URL e a referência indireta da regra que contém o caminho atual da URL no cabeçalho Location.

A página completa deve ser semelhante à seguinte:

Captura de tela do painel de Edição de Regras de Saída com HOST ORIGINAL e URL definidos como entrada da condição.

Testando a regra

Para testar se as regras funcionam corretamente, abra um navegador da Web e faça uma solicitação para http://localhost/webmail/index.aspx. O navegador deve ser redirecionado para http://localhost/webmail/default.aspx:

Captura de tela de um navegador da Web com o U R L original redirecionando para o novo U R L.

Resumo

Nesta introdução:

  • Você aprendeu a usar vários novos recursos no URL Rewrite 2.0 para implementar um cenário totalmente funcional de proxy reverso.
  • Você configurou a regra de entrada para encaminhar as solicitações para um servidor de conteúdo de back-end e definir uma variável de servidor temporária.
  • Em seguida, você definiu uma regra de saída que modifica o cabeçalho de localização HTTP na resposta de redirecionamento gerada pelo aplicativo web do servidor de conteúdo de back-end.
  • Last updated on