Classe AuthenticationSection1

Articolo
07/19/2023

Configura ASP.NET'autenticazione.

Sintassi

class AuthenticationSection : ConfigurationSectionWithCollection

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla AuthenticationSection classe .

Nome	Descrizione
Aggiungere	Ereditato da ConfigurationSectionWithCollection.
Cancella	Ereditato da `ConfigurationSectionWithCollection`.
Recupero	Ereditato da `ConfigurationSectionWithCollection`.
GetAllowDefinition	Ereditato da ConfigurationSection.
GetAllowLocation	Ereditato da `ConfigurationSection`.
Rimuovi	Ereditato da `ConfigurationSectionWithCollection`.
RevertToParent	Ereditato da `ConfigurationSection`.
SetAllowDefinition	Ereditato da `ConfigurationSection`.
SetAllowLocation	Ereditato da `ConfigurationSection`.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla AuthenticationSection classe .

Nome	Descrizione
`Forms`	Valore FormsAuthenticationConfiguration che configura l'autenticazione basata su form per l'applicazione Web.
`Location`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`Mode`	Valore di lettura/scrittura `sint32` che specifica la modalità di autenticazione per l'applicazione Web. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`Passport`	Valore PassportAuthentication che contiene un URL a cui verrà reindirizzata la richiesta di autenticazione.
`Path`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`SectionInformation`	Ereditato da `ConfigurationSection`.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Nella tabella seguente sono elencati i valori possibili per la Mode proprietà . Il valore predefinito è 1 (Windows).

Valore	Parola chiave	Descrizione
0	`None`	Non specifica alcuna autenticazione.
1	`Windows`	Specifica Windows come modalità di autenticazione. Questa modalità si applica quando ASP.NET utilizza i metodi di autenticazione basic, Digest, Integrated Windows (NTLM/Kerberos) o Mapping certificati client.
2	`Passport`	Specifica l'autenticazione di Microsoft Passport Network come modalità di autenticazione.
3	`Forms`	Specifica ASP.NET l'autenticazione basata su form come modalità di autenticazione.

Esempio

Nell'esempio seguente viene visualizzata la modalità di autenticazione per il sito Web predefinito. Se la modalità di autenticazione è Passport, viene visualizzato l'URL di reindirizzamento. Se la modalità è Forms, vengono visualizzate le informazioni corrispondenti.

' 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

Gerarchia di ereditarietà

Configurationsection

ConfigurationSectionWithCollection

AuthenticationSection

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedere anche

Classe AnonymousAuthenticationSection
Classe BasicAuthenticationSection
Classe ClientCertificateMappingAuthenticationSection
Classe ConfigurationSectionWithCollection
Classe DigestAuthenticationSection
Classe FormsAuthenticationConfiguration
Classe FormsAuthenticationCredentials
Classe FormsAuthenticationUser
Classe IisClientCertificateMappingAuthenticationSection
Classe PassportAuthentication
Classe WindowsAuthenticationSection

Condividi tramite