AuthenticationService Classe
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.
Permet d’accéder à ASP.NET l’authentification par formulaire en tant que service 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- Héritage
-
AuthenticationService
- Attributs
Remarques
L’objet AuthenticationService vous permet d’authentifier les utilisateurs via un service Windows Communication Foundation (WCF). Vous utilisez le service d’authentification WCF quand vous devez authentifier les utilisateurs via ASP.NET appartenance à partir d’une application qui se trouve en dehors de l’application web qui stocke les informations d’identification de l’utilisateur. L’application doit pouvoir envoyer et consommer un message au format SOAP. Par le biais de la classe, vous pouvez connecter des utilisateurs, déconnecter les utilisateurs, valider les informations d’identification, vérifier l’état de l’authentification AuthenticationService , personnaliser l’authentification et définir le cookie d’authentification.
La AuthenticationService classe contient quatre méthodes auxquelles vous devez accéder uniquement par le biais d’un service WCF : le , IsLoggedInles Loginméthodes et Logout les ValidateUserméthodes. Pour appeler ces méthodes, vous activez le service d’authentification sur un serveur Web, puis connectez une application cliente compatible WCF au service Web. Pour plus d’informations sur la configuration du service d’authentification, consultez Guide pratique pour activer le service d’authentification WCF.
Pour connecter des utilisateurs, vous transmettez les informations d’identification de l’utilisateur à la Login méthode. Si les informations d’identification sont valides, la AuthenticationService classe crée un cookie d’authentification. Si le cookie d’authentification n’a pas expiré, vous savez que les informations d’identification de l’utilisateur ont été authentifiées et que vous n’avez pas à valider à nouveau les informations d’identification. (L’authentification sans cookie n’est pas disponible via la AuthenticationService classe.)
Le AuthenticationService peut déclencher deux événements : Authenticating et CreatingCookie. L’événement Authenticating se produit lorsque les informations d’identification de l’utilisateur sont validées. Créez un gestionnaire d’événements pour l’événement pour personnaliser la Authenticating façon dont les informations d’identification de l’utilisateur sont validées. L’événement CreatingCookie se produit lorsque le cookie d’authentification est défini après la validation des informations d’identification de l’utilisateur. Créez un gestionnaire d’événements pour l’événement CreatingCookie pour personnaliser le cookie d’authentification.
La ValidateUser méthode vérifie les informations d’identification de l’utilisateur pour l’authentification, mais elle ne retourne pas de ticket d’authentification. Utilisez ValidateUser lorsqu’un utilisateur s’est connecté précédemment et que vous devez vérifier que les informations d’identification sont toujours valides au début d’une nouvelle session d’application.
Pour obtenir un exemple d’utilisation du service d’authentification WCF à partir d’une application console, consultez Walkthrough : Using ASP.NET Application Services.
Constructeurs
| Nom | Description |
|---|---|
| AuthenticationService() |
Initialise une nouvelle instance de la classe AuthenticationService. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsLoggedIn() |
Détermine si l’utilisateur actuel est authentifié. |
| Login(String, String, String, Boolean) |
Vérifie les informations d’identification de l’utilisateur et crée un ticket d’authentification (cookie) si les informations d’identification sont valides. |
| Logout() |
Efface le ticket d’authentification (cookie) dans le navigateur. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| ValidateUser(String, String, String) |
Authentifie les informations d’identification de l’utilisateur sans émettre de ticket d’authentification. |
Événements
| Nom | Description |
|---|---|
| Authenticating |
Se produit lorsque les informations d’identification de l’utilisateur sont validées. |
| CreatingCookie |
Se produit lorsque le cookie d’authentification est défini. |
