Share via


basicAuthentication Element [IIS Settings Schema]

Note

For more information about the basicAuthentication element, see the following topic on the Microsoft IIS.net Web site: Basic Authentication <basicAuthentication>.

Specifies Basic authentication configuration.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute

Description

defaultLogonDomain

Optional String attribute.

Specifies the default logon domain for Basic authentication.

enabled

Optional Boolean attribute.

Specifies whether Basic authentication is enabled.

The default value is False.

logonMethod

Optional enum attribute.

The logonMethod attribute can be one of the following possible values. The default is ClearText.

For more information about these values, see LogonUser on the MSDN site.

ValueDescription
BatchThis logon type is intended for batch servers, where processes may be executing on behalf of a user without their direct intervention. The numeric value is 1.
ClearTextThis logon type preserves the name and password in the authentication package, which allows the server to make connections to other network servers while impersonating the client. The numeric value is 3.
InteractiveThis logon type is intended for users who will be interactively using the computer. The numeric value is 0.
NetworkThis logon type is intended for high performance servers to authenticate plaintext passwords. Credentials are not cached for this logon type. The numeric value is 2.

realm

Optional String attribute.

Specifies the realm for Basic authentication.

Child Elements

None.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

security

Specifies the section group that contains security-related sections.

authentication

Specifies the section group that contains authentication sections.

Remarks

For more information about the basicAuthentication element, see the following topic on the Microsoft IIS.net Web site: Basic Authentication <basicAuthentication>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0