AuthenticationService Klasse

Definition

Namespace:
System.Web.ApplicationServices
Assembly:
System.Web.Extensions.dll

Ermöglicht den Zugriff auf ASP.NET Formularauthentifizierung als Webdienst.

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
Vererbung
Object
AuthenticationService
Attribute
AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

Hinweise

Mit dem AuthenticationService-Objekt können Sie Benutzer über einen Windows Communication Foundation (WCF)-Dienst authentifizieren. Sie verwenden den WCF-Authentifizierungsdienst, wenn Sie Benutzer über ASP.NET Mitgliedschaft aus einer Anwendung authentifizieren müssen, die sich außerhalb der Webanwendung befindet, die die Benutzeranmeldeinformationen speichert. Die Anwendung muss in der Lage sein, Nachrichten im SOAP-Format zu senden und zu nutzen. Über die AuthenticationService Klasse können Sie Benutzer anmelden, Benutzer abmelden, Anmeldeinformationen überprüfen, Authentifizierungsstatus überprüfen, Authentifizierung anpassen und das Authentifizierungscookies festlegen.

Die AuthenticationService Klasse enthält vier Methoden, auf die Sie nur über einen WCF-Dienst zugreifen sollten: die IsLoggedIn, Login, , Logoutund ValidateUser Methoden. Um diese Methoden aufzurufen, aktivieren Sie den Authentifizierungsdienst auf einem Webserver und verbinden dann eine WCF-kompatible Clientanwendung mit dem Webdienst. Informationen zum Konfigurieren des Authentifizierungsdiensts finden Sie unter How to: Enable the WCF Authentication Service.

Um Benutzer anzumelden, übergeben Sie die Benutzeranmeldeinformationen an die Login Methode. Wenn die Anmeldeinformationen gültig sind, erstellt die AuthenticationService Klasse ein Authentifizierungscookies. Wenn das Authentifizierungscookies nicht abgelaufen ist, wissen Sie, dass die Anmeldeinformationen des Benutzers authentifiziert wurden und Sie die Anmeldeinformationen nicht erneut überprüfen müssen. (Die Cookie-lose Authentifizierung ist nicht über die AuthenticationService Klasse verfügbar.)

Dies AuthenticationService kann zwei Ereignisse auslösen: Authenticating und CreatingCookie. Das Authenticating Ereignis tritt auf, wenn die Benutzeranmeldeinformationen überprüft werden. Erstellen Sie einen Ereignishandler für das Authenticating Ereignis, um anzupassen, wie Benutzeranmeldeinformationen überprüft werden. Das CreatingCookie Ereignis tritt auf, wenn das Authentifizierungscookies festgelegt wird, nachdem Die Benutzeranmeldeinformationen überprüft wurden. Erstellen Sie einen Ereignishandler für das CreatingCookie Ereignis, um das Authentifizierungscookies anzupassen.

Die ValidateUser Methode überprüft die Benutzeranmeldeinformationen für die Authentifizierung, gibt jedoch kein Authentifizierungsticket zurück. Verwenden Sie diese Option ValidateUser , wenn sich ein Benutzer zuvor angemeldet hat und Sie überprüfen müssen, ob die Anmeldeinformationen zu Beginn einer neuen Anwendungssitzung noch gültig sind.

Ein Beispiel für die Verwendung des WCF-Authentifizierungsdiensts aus einer Konsolenanwendung finden Sie unter Walkthrough: Using ASP.NET Application Services.

Konstruktoren

Name Beschreibung
AuthenticationService()

Initialisiert eine neue Instanz der AuthenticationService-Klasse.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsLoggedIn()

Bestimmt, ob der aktuelle Benutzer authentifiziert ist.
Login(String, String, String, Boolean)

Überprüft Benutzeranmeldeinformationen und erstellt ein Authentifizierungsticket (Cookie), wenn die Anmeldeinformationen gültig sind.
Logout()

Löscht das Authentifizierungsticket (Cookie) im Browser.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ValidateUser(String, String, String)

Authentifiziert Benutzeranmeldeinformationen, ohne ein Authentifizierungsticket auszustellen.

Ereignisse

Name Beschreibung
Authenticating

Tritt auf, wenn Benutzeranmeldeinformationen überprüft werden.
CreatingCookie

Tritt auf, wenn das Authentifizierungscookies festgelegt wird.

Gilt für:

Weitere Informationen