Partager via

AuthenticationService Classe

  • Référence

Définition

Espace de noms:
System.Web.ApplicationServices
Assembly:
System.Web.Extensions.dll

Active l'accès à l'authentification par formulaire ASP.NET comme un 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 = class
Public Class AuthenticationService
Héritage
Object
AuthenticationService
Attributs
AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

Remarques

L’objet AuthenticationService vous permet d’authentifier des utilisateurs via un service Windows Communication Foundation (WCF). Vous utilisez le service d’authentification WCF lorsque vous devez authentifier les utilisateurs via ASP.NET appartenance à 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 des messages au format SOAP. Grâce à la AuthenticationService classe, vous pouvez connecter des utilisateurs, déconnecter des utilisateurs, valider les informations d’identification, vérifier l’état de l’authentification, 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 : les IsLoggedInméthodes , Login, Logoutet ValidateUser . 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 besoin de valider à nouveau les informations d’identification. (L’authentification sans cookie n’est pas disponible via la AuthenticationService classe.)

peut AuthenticationService 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 afin de 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 en cours de définition une fois que les informations d’identification de l’utilisateur ont été validées. Créez un gestionnaire d’événements pour l’événement CreatingCookie afin de 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 quand un utilisateur s’est déjà connecté 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 Procédure pas à pas : utilisation de ASP.NET Application Services.

Constructeurs

AuthenticationService()

Initialise une nouvelle instance de la classe AuthenticationService.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le 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 Object actuel.

(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 publier de ticket d'authentification.

Événements

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.

S’applique à

Voir aussi