Table of Contents |
---|
Overview
The <RequestMap>
element is the root of the XML-based RequestMapper configuration (see the general documentation on this plugin for context). The root element is a globally applicable container that can apply settings to all requests.
Info |
---|
A special requirement of this root element is that it MUST contain an |
Apart from establishing default settings, its purpose is to act as a container for the rules you specify regarding virtual host, path, and/or query string matching to apply settings. The tree structure of the XML essentially maps to the tree structure of the URL space of your web server.
...
The element supports a large number of XML attributes corresponding to the content settings supported by the SP:
Include Page | ||||
---|---|---|---|---|
|
Child Elements
Access Control Elements
Include Page | ||||
---|---|---|---|---|
|
Nested Content Specifiers
The following elements are supported to narrow the matching process:
Name | Cardinality | Description |
---|---|---|
<Host> | 0 or more | Matches requests via the exact hostname (and optionally port and scheme). |
0 or more | Matches requests with a URL prefix matching a regular expression. The prefix contains everyting up until the slash following the hostname or port. |
The matching process is peformed by examining <
Host
>
elements in order, and then checking any <
HostRegex
>
elements in order, in separate passes (see the HowTo).
...
A somewhat non-trivial example shows a pair of virtual hosts with one bound to an <
ApplicationOverride
>
called admin
. The path "/secure" on the primary host is protected automatically, while the entire admin host is protected along with access control rule embedded in the configuration.
...