Compartir a través de

Clase1 AuthenticationSection

  • Artículo

Configura la autenticación de ASP.NET.

Sintaxis

class AuthenticationSection : ConfigurationSectionWithCollection

Métodos

En la tabla siguiente se enumeran los métodos que expone la clase AuthenticationSection.

Nombre Descripción
Add (Agregar) (Se hereda de ConfigurationSectionWithCollection).
Borrar (Se hereda de ConfigurationSectionWithCollection).
Get (Se hereda de ConfigurationSectionWithCollection).
GetAllowDefinition (Se hereda de ConfigurationSection).
GetAllowLocation (Se hereda de ConfigurationSection).
Remove (Se hereda de ConfigurationSectionWithCollection).
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 AuthenticationSection.

Nombre Descripción
Forms Un valor FormsAuthenticationConfiguration que configura la autenticación de formularios para la aplicación web.
Location (Se hereda de ConfigurationSection). Una propiedad clave.
Mode Un valor sint32 de lectura y escritura que especifica el modo de autenticación de la aplicación web. Los valores posibles se enumeran más adelante en la sección Comentarios.
Passport Un valor PassportAuthentication que contiene una dirección URL a la que se redirigirá la solicitud de autenticación.
Path (Se hereda de ConfigurationSection). Una propiedad clave.
SectionInformation (Se hereda de ConfigurationSection).

Subclases

Esta clase no contiene subclases.

Comentarios

En la siguiente tabla se describen los posibles valores de la propiedad Mode. El valor predeterminado es 1 (Windows).

Valor Palabra clave Descripción
0 None Especifica la inexistencia de autenticación.
1 Windows Especifica Windows como modo de autenticación. Este modo se aplica cuando ASP.NET usa los métodos de autenticación Básica, Implícita, Integrada de Windows (NTLM o Kerberos) o Asignación de certificado de cliente.
2 Passport Especifica la autenticación de red de Microsoft Passport como modo de autenticación.
3 Forms Especifica la autenticación de formularios ASP.NET como modo de autenticación.

Ejemplo

En el ejemplo siguiente se muestra el modo de autenticación del sitio web predeterminado. Si el modo de autenticación es Passport, se muestra la dirección URL de redireccionamiento. Si el modo es Forms, se muestra la información correspondiente.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the authentication section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "AuthenticationSection", oAuthSection  
  
' Display the path and location.  
WScript.Echo "Path: " & oAuthSection.Path  
WScript.Echo "Location: " & oAuthSection.Location  
WScript.Echo   
  
' Get the authentication mode and display it in text.  
strAuthMode = ModeText(oAuthSection.Mode)  
WScript.Echo "Authentication Mode: " &  _  
    "[ " & strAuthMode & " ]"  
  
' If the mode is Passport or Forms, display the   
' additional information.  
If strAuthMode = "Passport" Then  
  
    WScript.Echo "Passport URL: " & "[" & _  
        oAuthSection.Passport.RedirectUrl & "]"  
  
ElseIf strAuthMode = "Forms" then  
  
    DisplayFormsAuthSettings(oAuthSection.Forms)  
  
End If  
  
' Convert the Mode enumeration values to text.  
Function ModeText(enumValue)  
    Select Case enumValue  
        Case 0  
            ModeText = "None"  
        Case 1  
            ModeText = "Windows"  
        Case 2  
            ModeText = "Passport"  
        Case 3  
            ModeText = "Forms"  
        Case Else  
            ModeText = "Undefined enumeration value."  
    End Select  
End Function  
  
' Display the Forms authentication settings.  
Sub DisplayFormsAuthSettings(oFormsAuthConfig)  
    WScript.Echo vbCrLf & "Forms Authentication Settings"  
    WScript.Echo "-----------------------------"  
  
    WScript.Echo "Cookieless: [ " & _  
        CookielessText(oFormsAuthConfig.Cookieless) & " ]"  
  
    WScript.Echo "Default Url: [ " & _  
        oFormsAuthConfig.DefaultUrl & " ]"  
  
    WScript.Echo "Domain: [ " & _  
        oFormsAuthConfig.Domain & " ]"  
  
    WScript.Echo "EnableCrossAppRedirects: [" & _  
        oFormsAuthConfig.EnableCrossAppRedirects & " ]"  
  
    WScript.Echo "LoginUrl: [ " & _  
        oFormsAuthConfig.LoginUrl & " ]"  
  
    WScript.Echo "Name: [ " & _  
        oFormsAuthConfig.Name & " ]"  
  
    WScript.Echo "Path: [ " & _  
        oFormsAuthConfig.Path & " ]"  
  
    WScript.Echo "Protection: [ " & _  
        ProtectionText(oFormsAuthConfig.Protection) & " ]"  
  
    WScript.Echo "RequireSSL: [ " & _  
        oFormsAuthConfig.RequireSSL & " ]"  
  
    WScript.Echo "SlidingExpiration: [ " & _  
        oFormsAuthConfig.SlidingExpiration & " ]"  
  
    WScript.Echo "Timeout: [ " & _  
        oFormsAuthConfig.Timeout & " ]"  
  
    DisplayCredentials(oFormsAuthConfig.Credentials)  
  
End Sub  
  
' Convert the Cookieless enumeration values to text.  
Function CookielessText(enumValue)  
    Select Case enumValue  
        Case 0  
            CookielessText = "UseUri"  
        Case 1  
            CookielessText = "UseCookies"  
        Case 2  
            CookielessText = "AutoDetect"  
        Case 3  
            CookielessText = "UseDeviceProfile"  
        Case Else  
            CookielessText = "Undefined enumeration value."  
    End Select  
End Function  
  
' Convert the Protection enumeration values to text.  
Function ProtectionText(enumValue)  
    Select Case enumValue  
        Case 0  
            ProtectionText = "All"  
        Case 1  
            ProtectionText = "None"  
        Case 2  
            ProtectionText = "Encryption"  
        Case 3  
            ProtectionText = "Validation"  
        Case Else  
            ProtectionText = "Undefined enumeration value."  
    End Select  
End Function  
  
' Display the Forms authentication credentials.  
Sub DisplayCredentials(FA_Credentials)  
    WScript.Echo vbCrLf & "Forms Authentication Credentials"  
    WScript.Echo "--------------------------------"  
    WScript.Echo "Password Format: " & _  
        PwdFormatText(FA_Credentials.PasswordFormat) & VbCrLf  
  
    For Each FormsAuthUser In FA_Credentials.Credentials  
        WScript.Echo "    Name: [ " & FormsAuthUser.Name & " ]"  
        WScript.Echo "Password: [ " & _  
            FormsAuthUser.Password& " ]"  
        WScript.Echo  
    Next  
End Sub  
  
' Convert the PasswordFormat enumeration values to text.  
Function PwdFormatText(enumValue)  
    Select Case enumValue  
        Case 0  
            PwdFormatText = "Clear"  
        Case 1  
            PwdFormatText = "SHA1"  
        Case 2  
            PwdFormatText = "MD5"  
        Case Else  
            PwdFormatText = "Undefined enumeration value."  
    End Select  
End Function

Jerarquía de herencia

ConfigurationSection

ConfigurationSectionWithCollection

AuthenticationSection

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 BasicAuthenticationSection
Clase ClientCertificateMappingAuthenticationSection
Clase ConfigurationSectionWithCollection
Clase DigestAuthenticationSection
Clase FormsAuthenticationConfiguration
Clase FormsAuthenticationCredentials
Clase FormsAuthenticationUser
Clase IisClientCertificateMappingAuthenticationSection
Clase PassportAuthentication
Clase WindowsAuthenticationSection