Elemento <clear> per schemeSettings (impostazioni URI)

Articolo
08/11/2011

Deseleziona tutte le impostazioni dello schema esistenti.

<clear/>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
Elemento <schemeSettings> (impostazioni URI)	Specifica come un oggetto Uri verrà analizzato per schemi specifici.

Note

Per impostazione predefinita, la classe System.Uri priva dei caratteri escape i delimitatori del percorso con codifica percentuale prima di eseguire la compressione del percorso. È stato implementato come meccanismo di sicurezza rispetto ad attacchi simili ai seguenti:

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

Se questo URI viene passato lungo i moduli che non gestiscono correttamente i caratteri codificati in percentuale, potrebbe verificarsi che il comando seguente venga eseguito dal server:

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

Per questo motivo, la classe System.Uri come prima cosa priva dei caratteri escape i delimitatori del percorso, quindi applica compressione del percorso. Il risultato di passare l'URL dannoso al costruttore di classe System.Uri è il seguente URI:

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

È possibile modificare questo comportamento predefinito per non consentire l'escape dei delimitatori del percorso con codifica percentuale utilizzando l'opzione di configurazione schemeSettings per uno specifico schema.

File di configurazione

L'elemento può essere utilizzato nel file di configurazione dell'applicazione o nel file di configurazione del computer (Machine.config).

Esempio

Nell'esempio di codice seguente viene mostrata una configurazione utilizzata dalla classe Uri che cancella tutte le impostazioni dello schema e quindi viene aggiunto il supporto per non eseguire l'operazione di escape dei delimitatori di percorso con codifica percentuale dello schema HTTP.

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