WindowsAuthenticationSection Class

Article
05/20/2022

Configures Integrated Windows authentication.

Syntax

class WindowsAuthenticationSection : ConfigurationSectionWithCollection

Methods

The following table lists the methods exposed by the WindowsAuthenticationSection class.

Name	Description
Add	(Inherited from ConfigurationSectionWithCollection.)
Clear	(Inherited from `ConfigurationSectionWithCollection`.)
Get	(Inherited from `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Inherited from ConfigurationSection.)
GetAllowLocation	(Inherited from `ConfigurationSection`.)
Remove	(Inherited from `ConfigurationSectionWithCollection`.)
RevertToParent	(Inherited from `ConfigurationSection`.)
SetAllowDefinition	(Inherited from `ConfigurationSection`.)
SetAllowLocation	(Inherited from `ConfigurationSection`.)

Properties

The following table lists the properties exposed by the WindowsAuthenticationSection class.

Name	Description
`AuthPersistNonNTLM`	A read/write `boolean` value. `true` if IIS automatically reauthenticates every non-NTLM (for example, Kerberos) request, even those on the same connection; otherwise, `false`. The default is `false`. Note: A setting of `false` means that the client will be authenticated only once on the same connection. IIS will cache a token or ticket on the server for a TCP session that stays established.
`AuthPersistSingleRequest`	A read/write `boolean` value. `true` if IIS automatically reauthenticates every NTLM request, even those on the same connection; otherwise, `false`. The default is `false`. Note: A setting of `false` means that the client will be authenticated only once on the same connection. IIS will cache a token or ticket on the server for a TCP session that stays established.
`Enabled`	A read/write `boolean` value. `true` if Integrated Windows authentication is enabled; otherwise, `false`. The default is `false`.
`Location`	(Inherited from `ConfigurationSection`.) A key property.
`Path`	(Inherited from `ConfigurationSection`.) A key property.
`Providers`	An AuthenticationProviderSettings value that specifies security support providers that are used for Integrated Windows authentication.
`SectionInformation`	(Inherited from `ConfigurationSection`.)
`UseKernelMode`	A read/write `boolean` value. `true` if Integrated Windows authentication is done in kernel mode; otherwise, `false`. The default is `true`. Note: Using kernel mode improves authentication performance. However, if you want to use the Kerberos protocol in a Web farm, you may want to set this property to `false`.

Subclasses

This class contains no subclasses.

Inheritance Hierarchy

ConfigurationSection

ConfigurationSectionWithCollection

WindowsAuthenticationSection

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof

Share via