BasicAuthenticationSection (clase)
Configura la autenticación básica.
Sintaxis
class BasicAuthenticationSection : ConfigurationSection
Métodos
En la tabla siguiente se enumeran los métodos que expone la clase BasicAuthenticationSection.
| Nombre | Descripción |
|---|---|
| GetAllowDefinition | (Se hereda de ConfigurationSection). |
| GetAllowLocation | (Se hereda de ConfigurationSection). |
| RevertToParent | (Se hereda de ConfigurationSection). |
| SetAllowDefinition | (Se hereda de ConfigurationSection). |
| SetAllowLocation | (Se hereda de ConfigurationSection). |
Propiedades
La siguiente tabla muestra las propiedades que expone la clase BasicAuthenticationSection.
| Nombre | Descripción |
|---|---|
DefaultLogonDomain |
Valor de lectura y escritura string que especifica el dominio predeterminado que el servidor usa para autenticar a los usuarios cuando el cliente no especifica un dominio en el cuadro de diálogo de inicio de sesión. |
Enabled |
Valor boolean de lectura y escritura. true si la autenticación básica está habilitada; de lo contrario, false. El valor predeterminado es false. |
Location |
(Se hereda de ConfigurationSection). Una propiedad de clave. |
LogonMethod |
Enumeración de lectura y escritura sint32 que especifica el método de inicio de sesión predeterminado para un usuario local. El tipo de inicio de sesión determinará si el token resultante también se puede usar de forma remota. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Path |
(Se hereda de ConfigurationSection). Una propiedad de clave. |
Realm |
Valor de lectura y escritura string que contiene el nombre del dominio kerberos que usa el cliente para el almacenamiento en caché de credenciales. |
SectionInformation |
(Se hereda de ConfigurationSection). |
Subclases
Esta clase no contiene subclases.
Comentarios
La tabla siguiente contiene los posibles valores de la propiedad LogonMethod. El valor predeterminado es 3 (ClearText). Para obtener más información, consulte la función LogonUserEx.
| Valor | Palabra clave | Descripción |
|---|---|---|
| 0 | Interactive |
Este tipo de inicio de sesión está pensado para los usuarios que van a usar interactivamente el equipo. |
| 1 | Batch |
Este tipo de inicio de sesión está pensado para servidores por lotes, donde los procesos se pueden ejecutar en nombre de un usuario sin su intervención directa. Las credenciales no se almacenan en caché para este tipo de inicio de sesión. |
| 2 | Network |
Este tipo de inicio de sesión está diseñado para servidores de alto rendimiento para autenticar contraseñas de texto no cifrado. Las credenciales no se almacenan en caché para este tipo de inicio de sesión. |
| 3 | ClearText |
Este tipo de inicio de sesión conserva el nombre y la contraseña en el paquete de autenticación, lo que permite al servidor realizar conexiones a otros servidores de red al suplantar al cliente. |
Ejemplo
El siguiente ejemplo muestra la configuración de BasicAuthenticationSection para el sitio web predeterminado.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = _
GetObject("winmgmts:root\WebAdministration")
' Get the Basic authentication section for the default Web site.
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "BasicAuthenticationSection", oBasicAuth
' Display the path and location.
WScript.Echo "Basic Authentication Settings"
WScript.Echo "-----------------------------"
WScript.Echo "Path: " & oBasicAuth.Path
WScript.Echo "Location: " & oBasicAuth.Location
WScript.Echo
' Display the Enabled, DefaultLogonDomain, Realm, and
' LogonMethod properties.
WScript.Echo "Enabled: " & _
"[" & oBasicAuth.Enabled & "]"
WScript.Echo "DefaultLogonDomain: " & _
"[" & oBasicAuth.DefaultLogonDomain & "]"
WScript.Echo "Realm: " & "[" & oBasicAuth.Realm & "]"
WScript.Echo "LogonMethod: " & _
"[" & GetLogonMethodText(oBasicAuth.LogonMethod) & "]"
' Translate the LogonMethod enumeration values to text.
Function GetLogonMethodText(LogonMethodValue)
Select Case LogonMethodValue
Case 0
GetLogonMethodText = "Interactive"
Case 1
GetLogonMethodText = "Batch"
Case 2
GetLogonMethodText = "Network"
Case 3
GetLogonMethodText = "ClearText"
Case Else
GetLogonMethodText = "Undefined enumeration."
End Select
End Function
Jerarquía de herencia
BasicAuthenticationSection
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Archivo MOF | WebAdministration.mof |
Consulte también
Clase AnonymousAuthenticationSection
Clase AuthenticationSection
Clase ClientCertificateMappingAuthenticationSection
Clase DigestAuthenticationSection
Clase FormsAuthenticationConfiguration
Clase FormsAuthenticationCredentials
Clase FormsAuthenticationUser
Clase IisClientCertificateMappingAuthenticationSection
Clase PassportAuthentication
Clase WindowsAuthenticationSection
LogonUserEx