Share via

Elemento <clear> para schemeSettings (Configurações de URI)

  • Artigo

Limpa todas as configurações de esquema existentes.

<configuration>
  <uri>
    <schemeSettings>
      <clear>

Syntax

<clear/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Nenhum.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
Elemento <schemeSettings> (Configurações de URI) Especifica como um Uri será analisado quanto a esquemas específicos.

Comentários

Por padrão, a classe System.Uri desfaz o escape de delimitadores de caminho codificados por porcentagem antes de executar a compactação do caminho. Isso foi implementado como um mecanismo de segurança contra ataques, como:

http://www.contoso.com/..%2F..%2F/Windows/System32/cmd.exe?/c+dir+c:\

Se esse URI for passado para os módulos que não manipulam corretamente os caracteres codificados por porcentagem, isso poderá resultar na execução do seguinte comando pelo servidor:

c:\Windows\System32\cmd.exe /c dir c:\

Por esse motivo, a classe System.Uri desfaz o escape de delimitadores de caminho e, em seguida, aplica a compactação de caminho. O resultado da passagem da URL mal-intencionada acima para o construtor de classe System.Uri resulta no seguinte URI:

http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\

Esse comportamento padrão pode ser modificado para não desfazer o escape de delimitadores de caminho codificados por porcentagem usando a opção de configuração schemeSettings para um esquema específico.

Arquivos de configuração

Esse elemento pode ser usado no arquivo de configuração do aplicativo ou no arquivo de configuração do computador (Machine.config).

Exemplo

O exemplo a Uri seguir mostra uma configuração usada pela classe que limpa todas as configurações de esquema e, em seguida, adiciona suporte para não escapar delimitadores de caminho codificados por porcentagem para o esquema http.

<configuration>  
  <uri>  
    <schemeSettings>  
      <clear/>  
      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>  
    </schemeSettings>  
  </uri>  
</configuration>

Confira também