RequestFilteringSection (clase)

Artículo
03/25/2024

Configura el examen de las solicitudes de dirección URL entrantes.

Sintaxis

class RequestFilteringSection : ConfigurationSectionWithCollection

Métodos

En la tabla siguiente se enumeran los métodos que expone la clase RequestFilteringSection.

Nombre	Descripción
Add (Agregar)	(Se hereda de ConfigurationSectionWithCollection).
Borrar	(Se hereda de `ConfigurationSectionWithCollection`).
Get	(Se hereda de `ConfigurationSectionWithCollection`).
GetAllowDefinition	(Se hereda de ConfigurationSection).
GetAllowLocation	(Se hereda de `ConfigurationSection`).
Remove	(Se hereda de `ConfigurationSectionWithCollection`).
RevertToParent	(Se hereda de `ConfigurationSection`).
SetAllowDefinition	(Se hereda de `ConfigurationSection`).
SetAllowLocation	(Se hereda de `ConfigurationSection`).

Propiedades

La siguiente tabla enumera las propiedades expuestas por la clase RequestFilteringSection.

Nombre	Descripción
`AllowDoubleEscaping`	Valor `boolean` de lectura y escritura. `true` si se permiten caracteres de escape dobles en las direcciones URL; de lo contrario, `false`. El valor predeterminado es `false`.
`AllowHighBitCharacters`	Valor `boolean` de lectura y escritura. `true` si se permiten caracteres no ASCII en las direcciones URL; de lo contrario, `false`. El valor predeterminado es `true`.
`DenyUrlSequences`	Valor UrlSequenceSettings que contiene secuencias de direcciones URL que se pueden usar para atacar un servidor web y, por lo tanto, se denegará.
`FileExtensions`	Valor FileExtensionsSettings de lectura y escritura que especifica extensiones de archivo que se pueden permitir o denegar en una solicitud.
`HiddenSegments`	Valor HiddenSegmentSettings que especifica segmentos cuyo contenido no se servirá al cliente. Nota: Un segmento es la parte de una dirección URL entre dos barras diagonales o la parte de la dirección URL después de la última barra diagonal. Por ejemplo, la dirección URL /segment1/segment2/segment3.asp has three segments: segment1, segment2 y segment3.asp. Nota: Los siguientes segmentos se bloquean de forma predeterminada: bin, App_code, App_GlobalResources, App_LocalResources, App_WebReferences, App_Data y App_Browsers.
`Location`	(Se hereda de `ConfigurationSection`). Una propiedad clave.
`Path`	(Se hereda de `ConfigurationSection`). Una propiedad clave.
`RequestLimits`	Valor RequestLimitsElement que especifica los límites de tamaño en las solicitudes HTTP entrantes.
`SectionInformation`	(Se hereda de `ConfigurationSection`).
`Verbs`	Valor VerbsSettings de lectura y escritura que especifica verbos HTTP para permitir o denegar. Nota: No se admiten caracteres comodín para verbos HTTP.

Subclases

Esta clase no contiene subclases.

Comentarios

Esta clase se integra en la funcionalidad de IIS 7 de la herramienta URLScan usada por versiones anteriores de IIS.

Nota:

Para que la funcionalidad de la clase RequestFilteringSection funcione, se debe instalar el módulo de filtrado de solicitudes (Modrqflt.dll).

Ejemplo

En el ejemplo siguiente se muestran todas las propiedades de la sección de filtrado de solicitudes en el archivo ApplicationHost.config.

' Connect to the WMI WebAdministration namespace.  
Set objWMIService = GetObject("winmgmts:root\WebAdministration")  
  
' Get the request-filtering section.  
Set oRequestFilteringSection = objWMIService.Get( _  
"RequestFilteringSection.Path='MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the path.  
WScript.Echo "[Request Filtering Path]"  
WScript.Echo oRequestFilteringSection.Path_  
WScript.Echo   
  
' Show the AllowDoubleEscaping property as "True" or "False."  
WScript.Echo "[AllowDoubleEscaping]"  
WScript.Echo CStr(oRequestFilteringSection.AllowDoubleEscaping)  
WScript.Echo   
  
' Show the AllowHighBitCharacters property as "True" or "False."  
WScript.Echo "[AllowHighBitCharacters]"  
WScript.Echo CStr(oRequestFilteringSection.AllowHighBitCharacters)  
WScript.Echo   
  
' List the denied URL sequences.  
WScript.Echo "[Denied Url Sequences]"  
For Each oSequence In _  
    oRequestFilteringSection.DenyUrlSequences.DenyUrlSequences  
    WScript.Echo oSequence.Sequence  
Next  
WScript.Echo   
  
' List the file extensions settings.  
WScript.Echo "[File Extensions]"  
  
' Show the AllowUnlisted property as "True" or "False."  
WScript.Echo "Allow unlisted file extensions: " & _  
    oRequestFilteringSection.FileExtensions.AllowUnlisted  
WScript.Echo  
  
' List each file extension and show whether it is allowed.  
For Each oFileExtension In _  
    oRequestFilteringSection.FileExtensions.FileExtensions  
    WScript.Echo "File extension: " & oFileExtension.FileExtension  
    WScript.Echo "File extension allowed: " & oFileExtension.Allowed  
    WScript.Echo  
Next  
WScript.Echo   
  
' List the hidden segments.  
WScript.Echo "[Hidden Segments]"  
For Each oHiddenSegment In _  
    oRequestFilteringSection.HiddenSegments.HiddenSegments  
    WScript.Echo oHiddenSegment.Segment  
Next  
WScript.Echo   
  
' Show the request limits settings.  
WScript.Echo "[Request Limits]"  
WScript.Echo "maxAllowedContentLength: " & _  
oRequestFilteringSection.RequestLimits.maxAllowedContentLength  
WScript.Echo "maxUrl: " & oRequestFilteringSection.RequestLimits.maxUrl  
WScript.Echo "maxQueryString: " & oRequestFilteringSection.RequestLimits.maxQueryString  
WScript.Echo   
  
' Show the header limits settings.  
WScript.Echo vbtab & "[Header Limits]"  
For Each oHeaderLimit In _  
    oRequestFilteringSection.RequestLimits.HeaderLimits.HeaderLimits  
    WScript.Echo vbtab & "Header: " & oHeaderLimit.Header  
    WScript.Echo vbtab & "Header size limit: " & oHeaderLimit.SizeLimit  
    WScript.Echo   
Next  
  
' List the verbs settings.  
WScript.Echo "[Verbs]"  
WScript.Echo "Allow unlisted verbs: " & oRequestFilteringSection.Verbs.AllowUnlisted  
WScript.Echo   
  
' List each verb and show whether it is allowed.  
For Each oVerb In oRequestFilteringSection.Verbs.Verbs  
    WScript.Echo "Verb: " & oVerb.Verb  
    WScript.Echo "Verb allowed: " & oVerb.Allowed  
    WScript.Echo  
Next

Jerarquía de herencia

ConfigurationSection

ConfigurationSectionWithCollection

RequestFilteringSection

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

ConfigurationSectionWithCollection (clase)
FileExtensionElement (clase)
FileExtensionsSettings (clase)
HeaderLimitsSettings (clase)
HiddenSegmentSettings (clase)
<requestFiltering>
RequestLimitsElement (clase)
UrlSequence (clase)
UrlSequenceSettings (clase)
VerbElement (clase)
VerbsSettings (clase)

Compartir a través de

RequestFilteringSection (clase)

Sintaxis

Métodos

Propiedades

Subclases

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

Consulte también

Comentarios

Recursos adicionales