AuthenticationService.Login(String, String, String, Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Vérifie les informations d'identification de l'utilisateur et crée un ticket d'authentification (cookie) si les informations d'identification sont valides.
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 -> boolPublic Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As BooleanParamètres
- username
- String
Le nom de l'utilisateur à valider.
- password
- String
Mot de passe de l'utilisateur spécifié.
- customCredential
- String
La valeur ou les valeurs à valider en plus de username et password, le cas échéant.
- isPersistent
- Boolean
Une valeur qui indique si le ticket d'authentification reste valide d'une session à une autre.
Retours
true si les informations d'identification de l'utilisateur sont valides ; sinon, false.
- Attributs
Exceptions
userName ou password est null.
Remarques
La Login méthode valide les informations d’identification de l’utilisateur via un fournisseur d’appartenance. Vous pouvez utiliser le fournisseur d’appartenance par défaut ou spécifier un fournisseur d’appartenance personnalisé au moment de l’exécution. La AuthenticationService classe passe userName et password à la méthode du ValidateUser fournisseur d’appartenance, mais ne réussit customCredentialpas . Si ValidateUser retourne true, AuthenticationService crée un ticket d’authentification en tant que cookie. Définissez le isPersistent paramètre sur true pour créer un ticket d’authentification qui dure au-delà de la session actuelle.
Notes
Utilisez toujours le service d’authentification avec la couche de sockets sécurisés (SSL, à l’aide du protocole HTTPS) pour protéger les données sensibles.
La Login méthode déclenche l’événement Authenticating et l’événement CreatingCookie . Créez un gestionnaire d’événements pour pour Authenticating personnaliser l’authentification, comme la vérification des valeurs dans customCredential ou la validation des informations d’identification via un fournisseur d’appartenance autre que par défaut. Les valeurs dans customCredential ne sont pas validées par le fournisseur d’appartenance par défaut. Pour personnaliser le cookie d’authentification, créez un gestionnaire d’événements pour CreatingCookie.
Notes
N’appelez pas la Login méthode à partir du code qui s’exécute sur le serveur web. Vous appelez la méthode uniquement dans le Login cadre d’un service WCF. Pour plus d’informations, consultez Authentification ASP.NET.
