AuthenticationService.Login(String, String, String, Boolean) Metodo
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.
Controlla le credenziali utente e crea un ticket di autenticazione (cookie) se le credenziali sono valide.
public:
bool Login(System::String ^ username, System::String ^ password, System::String ^ customCredential, bool isPersistent);
[System.ServiceModel.OperationContract]
public bool Login (string username, string password, string customCredential, bool isPersistent);
[<System.ServiceModel.OperationContract>]
member this.Login : string * string * string * bool -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean
Parametri
- username
- String
Nome utente da convalidare.
- password
- String
Password dell'utente specificato.
- customCredential
- String
Valori da convalidare oltre a username
e password
, se presenti.
- isPersistent
- Boolean
Valore che indica se il ticket di autenticazione resta valido per più sessioni.
Restituisce
true
se le credenziali utente sono valide; in caso contrario, false
.
- Attributi
Eccezioni
userName
o password
è null
.
Commenti
Il Login metodo convalida le credenziali utente tramite un provider di appartenenza. È possibile usare il provider di appartenenza predefinito o specificare un provider di appartenenza personalizzato in fase di esecuzione. La AuthenticationService classe passa userName
e password
al metodo del provider di ValidateUser appartenenza, ma non passa customCredential
. Se ValidateUser restituisce true
, AuthenticationService crea un ticket di autenticazione come cookie. Impostare il isPersistent
parametro su per true
creare un ticket di autenticazione che dura oltre la sessione corrente.
Nota
Usare sempre il servizio di autenticazione insieme al livello secure sockets (SSL, usando HTTPS) per proteggere i dati sensibili.
Il Login metodo genera l'evento e l'evento AuthenticatingCreatingCookie . Creare un gestore eventi per Authenticating personalizzare l'autenticazione, ad esempio controllare i valori in customCredential
o convalidare le credenziali tramite un provider di appartenenza non predefinito. I valori in customCredential
non vengono convalidati dal provider di appartenenza predefinito. Per personalizzare il cookie di autenticazione, creare un gestore eventi per CreatingCookie.
Nota
Non chiamare il Login metodo dal codice in esecuzione nel server Web. Si chiama il Login metodo solo come parte di un servizio WCF. Per altre informazioni, vedere autenticazione ASP.NET.