Use the Request Restrictions dialog box to specify optional restrictions, such as the requested resource type or HTTP verb, for which you want a handler to process requests. Configure restrictions only if you have a specific need to limit the conditions under which a handler processes requests. When you do not configure restrictions, handlers will process requests regardless of the resource type requested and the HTTP verbs specified.

UI Element List

Element Name Description

Mapping

Configure options on this tab if you want to restrict the handler mapping to requests for specific resource types, such as for a file or a folder. If you do not configure options on this tab, the handler will process requests regardless of the resource type specified in the request.

Invoke handler only if request is mapped to

Select this check box on the Mapping tab if you want the handler mapping to apply only to requests for a specific resource type, such as a request for a file or a folder. If you select this check box, you must also specify the resource type by selecting an option under this check box.

File

Select this option if you want the handler to process requests for a specific file name or file name extension. For example, the ASPClassic handler processes requests for requests made for .asp files. This option is available only if you select the Invoke handler only if request is mapped to check box.

Folder

Select this option if you want the handler to process requests for a folder. You may want this restriction if you have a folder with content that you want a specific handler to process. This option is available only if you select the Invoke handler only if request is mapped to check box.

File or folder

Select this option if you want the handler to process requests for files and folders. This option is available only if you select the Invoke handler only if request is mapped to check box.

Verbs

Configure options on this tab if you want to restrict a handler mapping to specific HTTP verbs that clients provide in HTTP headers when they make requests.

All verbs

Select this option if you want the handler to process requests regardless of the verbs that the client specifies. This option is selected by default.

One of the following verbs

Select this option if you want the handler to process requests only when a client provides a specific HTTP verb or specific HTTP verbs in a request. In the corresponding text box, type the HTTP verb or verbs to which you want the handler mapping to apply. For example, type GET if you want the handler to process requests when a client uses the GET verb.

Access

Select one of the options on this tab to configure the access that this handler requires to run in a virtual directory. This setting (together with the feature's access policy that is set on the Edit Feature Permissions dialog box) determines whether a handler can run.

Important

Make sure that the required access setting for a handler is correct or else it may be possible for the handler to run unintentionally. For example, if you change the handler's required access from Execute to Read for ISAPI-dll handler, ISAPI extensions will be able to run even if only Read is enabled in the feature's access policy.

Select one of the following options:

  • None: The handler will run even when no access policy options are enabled.

  • Read: The handler will run when Read is enabled in the access policy.

  • Write: The handler will run when Write is enabled in the access policy.

  • Script: The handler will run when Scripts is enabled in the access policy. This is the default selection.

  • Execute: The handler will run when Execute is enabled in the access policy.

See Also