[This is preliminary documentation and subject to change]
This property contains flags, as listed in the Flags section below, that specify authentication persistence across requests on a connection.
| Attribute Name | Attribute Value |
| Data Type | DWORD |
| Attributes | INHERIT |
| Default Value | AuthPersistSingleRequestIfProxy |
| MetaFlagsEx | CACHE_PROPERTY_MODIFIED |
| User Type | IIS_MD_UT_FILE |
| StartingNumber | |
| EndingNumber | 0 |
| ID | 6031 |
This property is accessible at the following locations:
| Metabase Path | IIS Admin Object Type |
| /LM/W3SVC/2 | IIsWebServer |
| /LM/W3SVC/Info/Templates/Public Web Site | IIsWebServer |
| /LM/W3SVC/Info/Templates/Secure Web Site | IIsWebServer |
| /LM/W3SVC | IIsWebService |
| /LM/W3SVC/1/ROOT | IIsWebVirtualDir |
| /LM/W3SVC/1/ROOT/_vti_bin | IIsWebVirtualDir |
| /LM/W3SVC/1/ROOT/IISAdmin | IIsWebVirtualDir |
| /LM/W3SVC/1/ROOT/IISHelp | IIsWebVirtualDir |
| /LM/W3SVC/1/ROOT/MSADC | IIsWebVirtualDir |
| /LM/W3SVC/1/ROOT/Scripts | IIsWebVirtualDir |
| /LM/W3SVC/2/ROOT | IIsWebVirtualDir |
| /LM/W3SVC/2/ROOT/IISAdmin | IIsWebVirtualDir |
The following table lists additional information required only for code that uses the IIS Admin Base Object.
| Metabase identifier | MD_AUTHORIZATION_PERSISTENCE |
| Data type | DWORD |
| User type | IIS_MD_UT_FILE |
If the AuthPersistSingleRequest is set to TRUE, then authentication persists only for a single request. If AuthPersistSingleRequestIfProxy is set to TRUE, then authentication persists only for a single request if it is a proxy request and the request is not handled by Microsoft Proxy Server. (That is, if Proxy Server and IIS are running on the local computer, and the request is targeted to a remote server.) If AuthPersistSingleRequestAlwaysIfProxy is set to TRUE, then authentication is valid for a single request if the request is by proxy.
Important
Only one flag of can be TRUE at one
time. When one of these flags is set to TRUE using programmatic
methods or the UI, the other two flags are automatically set to
FALSE. The value of AuthPersistence always equals the value
of the flag that is set to TRUE. When configuring this property by
directly editing MetaBase.XML, you must ensure that only one flag
is set to true at a time.
| Name | Value | Metabase Bitmask Identifier | Description |
| AuthPersistSingleRequest | 64 | 0x00000040 |
MD_AUTH_SINGLEREQUEST | Setting this flag to
TRUE specifies that authentication will persist only across single
requests on a connection. IIS will reset the authentication at the
end of each request, and force re-authentication on the next
request of the session. |
| AuthPersistSingleRequest IfProxy | 128 | 0x00000080
|
MD_AUTH_SINGLEREQUEST IFPROXY | Setting this flag to
TRUE specifies that authentication will persist only across single
requests on a connection if the connection is by proxy. IIS will
reset the authentication at the end of the request if the current
authenticated request is by proxy and it is not the special case
where IIS is running MSPROXY. |
| AuthPersistSingleRequest AlwaysIfProxy | 256 | 0x00000100 |
MD_AUTH_SINGLEREQUEST ALWAYSIFPROXY | Setting this flag to
TRUE specifies that authentication is valid for a single request if
by proxy. IIS will reset the authentication at the end of the
request and force re-authentication on the next request if the
current authenticated request is by proxy of any type. |