AuthenticationService Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente l'accesso all'autenticazione basata su form ASP.NET come servizio Web.
public ref class AuthenticationService[System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)]
[System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")]
[System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")]
public class AuthenticationService[<System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)>]
[<System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")>]
[<System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")>]
type AuthenticationService = classPublic Class AuthenticationService- Ereditarietà
-
AuthenticationService
- Attributi
Commenti
L'oggetto AuthenticationService consente di autenticare gli utenti tramite un servizio Windows Communication Foundation (WCF). Il servizio di autenticazione WCF viene usato quando è necessario autenticare gli utenti tramite ASP.NET'appartenenza da un'applicazione esterna all'applicazione Web in cui sono archiviate le credenziali utente. L'applicazione deve essere in grado di inviare e utilizzare messaggi nel formato SOAP. Tramite la AuthenticationService classe è possibile accedere agli utenti, disconnettere gli utenti, convalidare le credenziali, controllare lo stato di autenticazione, personalizzare l'autenticazione e impostare il cookie di autenticazione.
La AuthenticationService classe contiene quattro metodi a cui è necessario accedere solo tramite un servizio WCF: i IsLoggedInmetodi , LoginLogout, e ValidateUser . Per chiamare questi metodi, abilitare il servizio di autenticazione in un server Web e quindi connettere un'applicazione client compatibile con WCF al servizio Web. Per informazioni su come configurare il servizio di autenticazione, vedere Procedura: Abilitare il servizio di autenticazione WCF.
Per consentire agli utenti di accedere, passare le credenziali utente al Login metodo . Se le credenziali sono valide, la AuthenticationService classe crea un cookie di autenticazione. Se il cookie di autenticazione non è scaduto, si sa che le credenziali dell'utente sono state autenticate e non è necessario convalidare di nuovo le credenziali. L'autenticazione senza cookie non è disponibile tramite la AuthenticationService classe .
AuthenticationService Può generare due eventi: Authenticating e CreatingCookie. L'evento Authenticating si verifica quando vengono convalidate le credenziali utente. Creare un gestore eventi per l'evento Authenticating per personalizzare la modalità di convalida delle credenziali utente. L'evento CreatingCookie si verifica quando il cookie di autenticazione viene impostato dopo la convalida delle credenziali utente. Creare un gestore eventi per l'evento CreatingCookie per personalizzare il cookie di autenticazione.
Il ValidateUser metodo controlla le credenziali utente per l'autenticazione, ma non restituisce un ticket di autenticazione. Usare ValidateUser quando un utente ha effettuato l'accesso in precedenza ed è necessario verificare che le credenziali siano ancora valide all'inizio di una nuova sessione dell'applicazione.
Per un esempio di utilizzo del servizio di autenticazione WCF da un'applicazione console, vedere Walkthrough: Using ASP.NET Application Services.
Costruttori
| Nome | Descrizione |
|---|---|
| AuthenticationService() |
Inizializza una nuova istanza della classe AuthenticationService. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IsLoggedIn() |
Determina se l'utente corrente è autenticato. |
| Login(String, String, String, Boolean) |
Controlla le credenziali utente e crea un ticket di autenticazione (cookie) se le credenziali sono valide. |
| Logout() |
Cancella il ticket di autenticazione (cookie) nel browser. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| ValidateUser(String, String, String) |
Autentica le credenziali utente senza emettere un ticket di autenticazione. |
Eventi
| Nome | Descrizione |
|---|---|
| Authenticating |
Si verifica quando vengono convalidate le credenziali utente. |
| CreatingCookie |
Si verifica quando viene impostato il cookie di autenticazione. |
