Specifies a mapping from IIS site instance ID to logical, normalized request details. If not present the information is garnered from IIS as noted below.
This element is frequently used to allow virtualizing the port.
Attributes
The following attributes are available
Name | Type | Default | Description | Populated from if no appropriate <Site> |
---|---|---|---|---|
id | string | required | The IIS instance ID of the web site to protect. Listed in the IIS web site summary on newer versions, | N/A |
name | string | required | Canonical hostname of the web site. | The lowercase of the IIS site name |
port | integer | 80 | Logical port for requests to a non-SSL physical port | The port used to approach the webserver (for non SSL connections) |
scheme | string |
| Logical scheme of the web site (typically set to "https" when SSL acceleration is involved) | N/A |
sslport | integer | 443 | Logical port for requests to an SSL-enabled physical port. | The port used to approach the webserver (for SSL connections) |
useVariables | boolean | true | Controls whether attributes are passed the the application as Server Variables. | The default in the containing <ISAPI> element |
useHeaders | boolean | false | Controls whether attributes are passed as HTTP Headers. This setting should be avoided, but is present to provide a level of compatibility with applications developed against the old isapi_shib plugin. | The default in the containing <ISAPI> element |
Child Elements
Element | Cardinalty | Description |
---|---|---|
<Alias> | 0 more | Rarely-used child element that allows a web site to be accessed by alternate names without causing redirects to rewrite the hostname into the primary name. This requires that you duplicate any request map settings for each host you want to allow. |