IdentitySection Class

Article
02/17/2023

Specifies whether an ASP.NET application should run as the application pool identity (the default), the IIS-authenticated user identity, or a custom configured identity.

Syntax

class IdentitySection : ConfigurationSection

Methods

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

Name	Description
GetAllowDefinition	(Inherited from ConfigurationSection.)
GetAllowLocation	(Inherited from `ConfigurationSection`.)
RevertToParent	(Inherited from `ConfigurationSection`.)
SetAllowDefinition	(Inherited from `ConfigurationSection`.)
SetAllowLocation	(Inherited from `ConfigurationSection`.)

Properties

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

Name	Description
`Impersonate`	A required read/write `boolean` value. `true` if client impersonation is used on each request; otherwise, `false`. The default is `false`.
`Location`	(Inherited from `ConfigurationSection`.) A key property.
`Password`	An optional read/write `string` value that specifies the password for a Web application if the `Impersonate` property is set to `true`. For more information, see the Remarks section.
`Path`	(Inherited from `ConfigurationSection`.) A key property.
`SectionInformation`	(Inherited from `ConfigurationSection`.)
`UserName`	An optional read/write `string` value that specifies the user name for a Web application if the `Impersonate` property is set to `true`. For more information, see the Remarks section.

Subclasses

This class contains no subclasses.

Remarks

The Password and UserName properties are stored in clear text in the configuration file. Although IIS does not transmit .config files in response to a user agent request, users who have proper credentials on the domain that contains the server can read .config files. For information about storing the UserName and Password values in encrypted form in the registry, see identity Element (ASP.NET Settings Schema).

Inheritance Hierarchy

ConfigurationSection

IdentitySection

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