Como baixar e usar a reescrita de URL 2.0 para IIS
Se você está procurando uma maneira de criar URLs fáceis de usar e de mecanismo de pesquisa para seus aplicativos da Web, considere o uso de Reescrita de URL 2.0 para IIS. O URL Rewrite 2.0 é um módulo que permite aos administradores da Web criar regras poderosas para implementar o comportamento de regravação de URL com base em vários critérios, como cabeçalhos HTTP, variáveis de servidor, expressões regulares e muito mais. Neste artigo, mostraremos como baixar, instalar e usar o URL Rewrite 2.0 para IIS.
download url rewrite 2.0
O que é URL Rewrite 2.0 e por que você precisa dele?
URL Rewrite 2.0 é uma versão incremental do módulo URL Rewrite para IIS que adiciona suporte para extensibilidade .NET e reescrita de resposta de saída. Pode ser usado para:
Implemente lógica de reescrita complexa usando provedores de reescrita escritos em .NET
Substitua os URLs gerados por um aplicativo da Web no HTML de resposta por um equivalente mais amigável ao usuário e ao mecanismo de pesquisa
Modifique os links na marcação HTML gerada por um aplicativo da Web por trás de um proxy reverso
Corrija o conteúdo de qualquer resposta HTTP usando correspondência de padrão de expressão regular
Modifique os cabeçalhos de solicitação e resposta HTTP e as variáveis do servidor IIS
Ao usar o URL Rewrite 2.0, você pode melhorar a usabilidade, o desempenho e a segurança de seus aplicativos da web.
Recursos e benefícios do URL Rewrite 2.0
O URL Rewrite 2.0 inclui os seguintes recursos principais:
Provedores de reescrita personalizados: os provedores de reescrita podem ser usados quando uma lógica de reescrita de URL não pode ser expressa em termos de padrões de expressão regular ou quando é necessário tomar decisões de reescrita com base em dados armazenados fora do arquivo web.config (por exemplo, banco de dados SQL ou arquivos de texto). Os provedores de reescrita do cliente podem ser implementados em qualquer linguagem .NET.
Mecanismo de reescrita de resposta baseada em regras: As regras de saída são usadas para expressar a lógica do que comparar partes da resposta e o que fazer se a comparação for bem-sucedida.O servidor da Web e os administradores do site podem usar regras de saída para definir a lógica complexa de regravação de respostas.
Reescrever dentro do conteúdo de tags HTML específicas: em vez de varrer toda a resposta para uma correspondência específica, a regra pode ser configurada para procurar apenas dentro de determinadas tags HTML, como
Pré-condições para regras de saída: Aplicar regras de reescrita em cada resposta é uma operação cara e não é necessária na maioria dos casos. Pré-condições são usadas para verificar os metadados de resposta para determinar se a avaliação de regras de saída deve ser aplicada.
Regravação de variáveis de servidor e cabeçalhos de solicitação HTTP: Várias variáveis de servidor IIS e cabeçalhos de solicitação HTTP podem ser definidos usando regras de regravação.
Regravação de cabeçalhos de resposta HTTP: As regras de regravação de saída podem ser usadas para modificar quaisquer cabeçalhos de resposta HTTP existentes ou para definir novos.
Lista de permissões para variáveis de servidor: Para impedir que as regras de reescrita distribuída modifiquem acidentalmente ou propositadamente as variáveis do servidor IIS que podem afetar a segurança ou o comportamento do tempo de execução de um aplicativo da Web, as variáveis de servidor modificáveis agora precisam ser explicitamente adicionadas à lista de permissões.
Função HtmlEncode: a reescrita de saída geralmente pode usar dados não confiáveis (por exemplo, parâmetros de string de consulta) como parte da URL reescrita. Para evitar ataques de script entre sites, a função HtmlEncode pode ser usada para codificar os dados antes de serem usados no URL reescrito.
Registro de URLs reescritos: o módulo pode ser configurado para registrar os URLs originais e reescritos para cada solicitação. Isso pode ser útil para fins de depuração e solução de problemas.
O URL Rewrite 2.0 oferece os seguintes benefícios:
SEO aprimorado: ao usar o URL Rewrite 2.0, você pode criar URLs mais descritivos e amigáveis que podem melhorar a classificação e a visibilidade do seu site nos mecanismos de pesquisa.
Experiência do usuário aprimorada: ao usar o URL Rewrite 2.0, você pode fornecer aos seus usuários URLs mais intuitivos e memoráveis que podem aumentar seu envolvimento e retenção.
Desenvolvimento de aplicativo da web simplificado: ao usar o URL Rewrite 2.0, você pode desacoplar a lógica do seu aplicativo da web da estrutura da URL, facilitando a manutenção e a atualização do seu código.
Maior segurança: ao usar o URL Rewrite 2.0, você pode impedir que usuários mal-intencionados explorem vulnerabilidades em seu aplicativo da Web, ocultando informações confidenciais da URL ou codificando dados não confiáveis antes de usá-los na URL.
Requisitos e compatibilidade do URL Rewrite 2.0
Para usar o URL Rewrite 2.0, você precisa ter o seguinte:
IIS 7 ou superior no Windows Server 2008 ou superior, ou Windows Vista ou superior
.NET Framework 2.0 ou superior
Privilégios de administrador no servidor
O URL Rewrite 2.0 é compatível com os seguintes módulos e recursos do IIS:
Roteamento de solicitação de aplicativo (ARR)
CGI rápido
Web Farm Framework (WFF)
Cache de Saída
Rastreamento de solicitação com falha
Como baixar e instalar URL Rewrite 2.0
Baixando URL Rewrite 2.0 do site oficial
Você pode baixar o URL Rewrite 2.0 no site oficial da Microsoft em . Existem duas versões disponíveis: uma para sistemas x86 e outra para sistemas x64. Certifique-se de baixar a versão correta para sua arquitetura de servidor.
Instalando URL Rewrite 2.0 usando o assistente de configuração
Para instalar o URL Rewrite 2.0 usando o assistente de configuração, siga estas etapas:
Execute o arquivo executável baixado como administrador.
Aceite o contrato de licença e clique em Avançar.
Selecione a pasta de destino e clique em Avançar.
Clique em Instalar para iniciar a instalação.
Clique em Concluir para concluir a instalação.
Verificando a instalação do URL Rewrite 2.0
Para verificar se o URL Rewrite 2.0 foi instalado com sucesso, siga estas etapas:
Abra o Gerenciador do IIS clicando em Iniciar > Ferramentas Administrativas > Gerenciador dos Serviços de Informações da Internet (IIS).
Selecione o nó do servidor no painel Conexões.
Na Visualização de recursos, procure o ícone Reescrita de URL na seção IIS. Se você o vir, o URL Rewrite 2.0 foi instalado com sucesso.
Como usar URL Rewrite 2.0 para IIS
Criando e gerenciando regras de reescrita usando o IIS Manager
Você pode criar e gerenciar regras de regravação usando o Gerenciador do IIS seguindo estas etapas:
Selecione o site ou aplicativo para o qual deseja criar uma regra de regravação no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
No painel Ações, clique em Adicionar regra(s) para abrir a caixa de diálogo Adicionar regra.
Selecione o modelo de regra que corresponda ao seu cenário, como Regra em branco, URL amigável ou Redirecionamento. Você também pode criar sua própria regra personalizada selecionando Regra personalizada.
Insira o nome e a descrição de sua regra nos campos Nome e Descrição.
Especifique o padrão e as condições para corresponder à URL de solicitação nas seções Match URL and Conditions. Você pode usar expressões regulares, curingas ou correspondências exatas para definir seu padrão e condições.
Especifique a ação a ser executada quando a regra for correspondida na seção Ação. Você pode optar por reescrever, redirecionar, anular ou executar uma ação personalizada na URL de solicitação.
Opcionalmente, você pode especificar configurações adicionais para sua regra na seção Configurações avançadas, como variáveis de servidor, mapas de regravação, log e pré-condições.
Clique em Aplicar para salvar sua regra.
Você pode editar, excluir, desabilitar ou testar suas regras selecionando-as na página do recurso URL Rewrite e usando as opções no painel Actions.
Criando e gerenciando regras de reescrita usando o arquivo web.config
Você também pode criar e gerenciar regras de regravação usando o arquivo web.config do seu site ou aplicativo. O arquivo web.config é um arquivo XML que armazena as definições de configuração do seu site ou aplicativo.Para criar e gerenciar regras de regravação usando o arquivo web.config, siga estas etapas:
Abra o arquivo web.config do seu site ou aplicativo usando um editor de texto ou uma ferramenta de desenvolvimento web como o Visual Studio.
Localize o seção no arquivo web.config. Se não existir, crie-o.
Dentro do seção, localize ou crie um seção. É aqui que você definirá suas regras de reescrita.
Dentro do seção, crie um seção. É aqui que você adicionará suas regras de reescrita.
Para cada regra de reescrita, crie um elemento com um atributo de nome que especifica o nome de sua regra. Dentro do elemento, especifique os seguintes subelementos:
: este elemento especifica o padrão para corresponder à URL de solicitação. Você pode usar expressões regulares, curingas ou correspondências exatas para definir seu padrão.
: Este elemento especifica uma lista de condições que devem ser atendidas para que a regra seja aplicada. Você pode usar operadores lógicos como AND e OR para combinar várias condições. Cada condição é definida por um elemento que especifica o valor de entrada a ser comparado, um atributo que especifica como compará-lo (como matchType ou padrão) e um atributo negate opcional que especifica se o resultado da comparação deve ser invertido.
: Este elemento especifica a ação a ser executada quando a regra é correspondida. Você pode optar por reescrever, redirecionar, anular ou executar uma ação personalizada na URL de solicitação. Você também pode especificar atributos adicionais como url, appendQueryString, redirectType, statusCode, statusReason, statusDescription etc., dependendo do tipo de ação.
Opcionalmente, você pode especificar configurações adicionais para sua regra usando outros subelementos dentro do elemento, como , , , e .
Salve seu arquivo web.config e reinicie seu site ou aplicativo para que as alterações entrem em vigor.
Você pode editar, excluir, desabilitar ou testar suas regras modificando-as no arquivo web.config e salvando-o.
Usando provedores de reescrita personalizados escritos em .NET
Se você precisar implementar lógica de reescrita complexa que não pode ser expressa em termos de padrões de expressão regular ou quando precisar tomar decisões de reescrita com base em dados armazenados fora do arquivo web.config (por exemplo, banco de dados SQL ou arquivos de texto), você pode usar provedores de reescrita personalizados escritos em .NET. Provedores de regravação personalizados são classes que implementam a interface IRewriteProvider e são registrados no arquivo web.config. Você pode usar provedores de reescrita personalizados em suas regras de reescrita usando a função RewriteProvider no padrão ou nos elementos de ação. Para usar provedores de reescrita personalizados escritos em .NET, siga estas etapas:
Crie um projeto de biblioteca de classes no Visual Studio e adicione uma referência ao assembly Microsoft.Web.Iis.Rewrite.dll.
Crie uma classe que implemente a interface IRewriteProvider e substitua os métodos Initialize e Rewrite. O método Initialize é chamado uma vez quando o provedor é carregado e pode ser usado para inicializar quaisquer configurações ou recursos específicos do provedor. O método Rewrite é chamado para cada solicitação que usa o provedor e recebe um valor de entrada e retorna um valor de saída com base na lógica do provedor.
Crie seu projeto e copie o assembly de saída para a pasta bin do seu site ou aplicativo.
Abra o arquivo web.config do seu site ou aplicativo e localize ou crie o seção dentro do seção.
Dentro do seção, crie um seção. É aqui que você registrará seus provedores de reescrita personalizados.
Para cada provedor de regravação personalizado, crie um elemento com um atributo name que especifica o nome do seu provedor. Dentro do elemento, especifique os seguintes atributos:
type: Este atributo especifica o nome do tipo totalmente qualificado de sua classe de provedor, incluindo o nome do assembly.
Quaisquer outros atributos customizados que você precise passar para sua classe de provedor.
Salve seu arquivo web.config e reinicie seu site ou aplicativo para que as alterações entrem em vigor.
Para usar seu provedor de reescrita customizado em suas regras de reescrita, use a função RewriteProvider no padrão ou nos elementos de ação de suas regras. A sintaxe da função RewriteProvider é a seguinte:
RewriteProvider(providerName, inputValue)
onde providerName é o nome do seu provedor registrado e inputValue é o valor a ser passado para o método Rewrite do provedor.
Usando regras de saída para reescrever conteúdo e cabeçalhos de resposta
Se precisar modificar o conteúdo ou os cabeçalhos da resposta HTTP gerada por seu aplicativo da web, você pode usar regras de saída para reescrevê-los com base em vários critérios. As regras de saída são semelhantes às regras de entrada, exceto que são aplicadas depois que a solicitação é processada pelo aplicativo da web e antes de ser enviada de volta ao cliente. Para usar regras de saída para reescrever o conteúdo e os cabeçalhos da resposta, siga estas etapas:
Selecione o site ou aplicativo para o qual deseja criar uma regra de saída no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
No painel Ações, clique em Adicionar regra(s) para abrir a caixa de diálogo Adicionar regra.
Selecione Regra de saída como modelo de regra e clique em OK.
Insira o nome e a descrição de sua regra nos campos Nome e Descrição.
Especifique o escopo de sua regra na seção Pré-condição. Você pode optar por aplicar sua regra a todas as respostas, respostas com tipos de conteúdo específicos, respostas com códigos de status específicos ou respostas que correspondam a uma pré-condição personalizada definida por você.
Especifique o padrão e as condições para corresponder ao conteúdo ou cabeçalhos da resposta na seção Correspondência. Você pode usar expressões regulares, curingas ou correspondências exatas para definir seu padrão e condições.
Especifique a ação a ser executada quando a regra for correspondida na seção Ação. Você pode optar por reescrever, excluir ou modificar o conteúdo ou os cabeçalhos da resposta. Você também pode especificar atributos adicionais, como valor, substituir ou anexar, dependendo do tipo de ação.
Opcionalmente, você pode especificar configurações adicionais para sua regra na seção Configurações avançadas, como variáveis de servidor, mapas de regravação, log e pré-condições.
Clique em Aplicar para salvar sua regra.
Você pode editar, excluir, desabilitar ou testar suas regras selecionando-as na página do recurso URL Rewrite e usando as opções no painel Actions.
Usando pré-condições e variáveis de servidor para regras de saída
Pré-condições são usadas para verificar os metadados de resposta para determinar se a avaliação de regras de saída deve ser aplicada. As pré-condições podem melhorar o desempenho e a segurança de suas regras de saída, evitando o processamento desnecessário de respostas que não precisam ser reescritas. Para usar pré-condições para regras de saída, siga estas etapas:
Selecione o site ou aplicativo para o qual deseja criar uma pré-condição no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
No painel Ações, clique em Adicionar condição prévia para abrir a caixa de diálogo Adicionar condição prévia.
Insira o nome de sua pré-condição no campo Nome.
Especifique o agrupamento lógico de sua pré-condição na seção Agrupamento Lógico. Você pode optar por atender a todas ou a qualquer uma das condições que definir.
Especifique as condições para sua pré-condição na seção Condições. Você pode usar vários atributos de resposta, como tipo de conteúdo, código de status, valor de cabeçalho, etc., para definir suas condições. Cada condição é definida por um elemento que especifica o valor de entrada a ser comparado, um atributo que especifica como compará-lo (como matchType ou padrão) e um atributo negate opcional que especifica se o resultado da comparação deve ser invertido.
Clique em OK para salvar sua pré-condição.
Para usar sua pré-condição em suas regras de saída, selecione-a na lista suspensa Pré-condição na seção Pré-condição de suas configurações de regra.
As variáveis do servidor são usadas para armazenar e recuperar informações sobre a solicitação e a resposta durante a regravação da URL.As variáveis do servidor podem ser usadas em regras de entrada e saída como valores de entrada ou valores de saída. Para usar variáveis de servidor para regras de saída, siga estas etapas:
Selecione o site ou aplicativo para o qual deseja usar uma variável de servidor no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
No painel Actions, clique em View Server Variables para abrir a caixa de diálogo Server Variables.
Para adicionar uma nova variável de servidor, clique em Adicionar no painel Ações e insira o nome de sua variável de servidor no campo Nome. Clique em OK para salvar a variável do servidor.
Para editar ou excluir uma variável de servidor existente, selecione-a na lista e use as opções no painel Ações.
Para usar sua variável de servidor em suas regras de saída, use a sintaxe SERVER_VARIABLE_NAME nos valores de entrada ou saída de suas configurações de regra.
Conclusão e perguntas frequentes
Neste artigo, mostramos como baixar, instalar e usar o URL Rewrite 2.0 para IIS. O URL Rewrite 2.0 é um módulo poderoso que permite criar e gerenciar regras de reescrita para seus aplicativos da web. Você pode usar o URL Rewrite 2.0 para melhorar o SEO, a usabilidade, o desempenho e a segurança de seus aplicativos da web. Você também pode usar URL Rewrite 2.0 para implementar lógica de reescrita complexa usando provedores de reescrita personalizados escritos em .NET ou usando regras de saída para reescrever conteúdo e cabeçalhos de resposta. Esperamos que você tenha achado este artigo útil e informativo. Se você tiver alguma dúvida ou comentário, sinta-se à vontade para entrar em contato conosco.
Aqui estão algumas perguntas frequentes sobre a reescrita de URL 2.0:
P: Como posso migrar minhas regras de regravação existentes de URL Rewrite 1.1 para URL Rewrite 2.0?
R: Você pode migrar suas regras de regravação existentes de URL Rewrite 1.1 para URL Rewrite 2.0 usando o recurso Import Rules no IIS Manager. Para fazer isso, siga estas etapas:
Selecione o site ou aplicativo para o qual deseja importar as regras de regravação no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
No painel Actions, clique em Import Rules para abrir a caixa de diálogo Import Rules.
Navegue até o arquivo web.config que contém suas regras de reconfiguração de URL Rewrite 1.1 e clique em OK.
Revise as regras importadas e faça as alterações ou ajustes necessários.
Clique em Aplicar para salvar suas regras importadas.
P: Como posso solucionar problemas com minhas regras de reescrita no URL Rewrite 2.0?
R: Você pode solucionar problemas com suas regras de regravação no URL Rewrite 2.0 usando o recurso Test Pattern no IIS Manager ou usando o recurso Failed Request Tracing no IIS. Para usar o recurso Padrão de teste, siga estas etapas:
Selecione o site ou aplicativo para o qual deseja testar as regras de regravação no painel Conexões.
Na Visualização de recursos, clique duas vezes no ícone Reescrita de URL.
Selecione a regra que deseja testar e clique em Editar no painel Ações.
Na caixa de diálogo Editar regra, clique em Padrão de teste para abrir a caixa de diálogo Padrão de teste.
Insira uma URL de solicitação de amostra no campo Dados de entrada e clique em Testar.
Revise os resultados do teste e veja se eles correspondem às suas expectativas.
Para usar o recurso Failed Request Tracing, siga estas etapas:
Habilite o rastreamento de solicitação com falha para seu site ou aplicativo seguindo .
Configure uma regra de rastreamento para seu site ou aplicativo seguindo .
Reproduza o problema que deseja solucionar enviando uma solicitação ao seu site ou aplicativo.
Abra o arquivo de log de rastreamento que é gerado pelo Failed Request Tracing e analise-o em busca de erros ou avisos relacionados ao URL Rewrite 2.0.
P: Como posso atualizar o URL Rewrite 2.0 para a versão mais recente?
R: Você pode atualizar o URL Rewrite 2.0 para a versão mais recente baixando e instalando-o em . Você não precisa desinstalar a versão anterior antes de instalar a nova. A nova versão substituirá a antiga. A nova versão preservará suas regras e configurações de reescrita existentes.
P: Como posso desinstalar o URL Rewrite 2.0 do meu servidor?
R: Você pode desinstalar o URL Rewrite 2.0 do seu servidor seguindo estas etapas:
Abra o Painel de Controle e clique em Programas e Recursos.
Selecione URL Rewrite 2.0 na lista de programas instalados e clique em Desinstalar.
Siga as instruções no assistente de desinstalação para concluir a desinstalação.
P: Onde posso encontrar mais informações e recursos sobre URL Rewrite 2.0?
R: Você pode encontrar mais informações e recursos sobre URL Rewrite 2.0 nos seguintes links:
: esta é a página de documentação oficial do URL Rewrite 2.0, onde você pode encontrar informações detalhadas sobre os recursos do módulo, configuração e cenários de uso.
: esta é a página de referência oficial para URL Rewrite 2.0, onde você pode encontrar a sintaxe e exemplos das regras de reescrita, condições, ações, funções, provedores e variáveis de servidor.
: Este é o fórum oficial do URL Rewrite 2.0, onde você pode fazer perguntas, compartilhar dicas e obter suporte de outros usuários e especialistas.
: Este é o blog de Ruslan Yakushev, gerente do programa URL Rewrite 2.0, onde você pode encontrar notícias, atualizações e tutoriais sobre o módulo.
0517a86e26
Comments