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 = class
Public Class AuthenticationService
- Ereditarietà
-
AuthenticationService
- Attributi
Commenti
L'oggetto AuthenticationService consente di autenticare gli utenti tramite un servizio WINDOWS Communication Foundation (WCF). Si usa il servizio di autenticazione WCF quando è necessario autenticare gli utenti tramite ASP.NET appartenenza da un'applicazione esterna all'applicazione Web che archivia le credenziali utente. L'applicazione deve essere in grado di inviare e utilizzare il messaggio 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 che è necessario accedere solo tramite un servizio WCF: i IsLoggedInmetodi , , LogoutLogine ValidateUser . Per chiamare questi metodi, è possibile 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 accedere agli utenti, 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.
L'oggetto 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 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 e è necessario verificare che le credenziali siano ancora valide all'inizio di una nuova sessione dell'applicazione.
Per un esempio di uso del servizio di autenticazione WCF da un'applicazione console, vedere Procedura dettagliata: Uso di ASP.NET Servizi applicazioni.
Costruttori
AuthenticationService() |
Inizializza una nuova istanza della classe AuthenticationService. |
Metodi
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 l'oggetto 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 dell'oggetto Object corrente. (Ereditato da Object) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
ValidateUser(String, String, String) |
Autentica le credenziali utente senza rilasciare un ticket di autenticazione. |
Eventi
Authenticating |
Si verifica quando le credenziali utente vengono convalidate. |
CreatingCookie |
Si verifica quando il cookie di autenticazione viene impostato. |