AuthenticationService Klasse

  • Referenz

Definition

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

Ermöglicht den Zugriff auf die 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 AuthenticationService dem -Objekt können Sie Benutzer über einen Wcf-Dienst (Windows Communication Foundation) 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, in der die Benutzeranmeldeinformationen gespeichert werden. 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, die Authentifizierung status überprüfen, die Authentifizierung anpassen und das Authentifizierungscookies festlegen.

Die AuthenticationService -Klasse enthält vier Methoden, auf die Sie nur über einen WCF-Dienst zugreifen sollten: die IsLoggedInMethoden , Login, Logoutund ValidateUser . 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 Vorgehensweise: Aktivieren des WCF-Authentifizierungsdiensts.

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 müssen die Anmeldeinformationen nicht erneut überprüfen. (Die cookielose Authentifizierung ist über die AuthenticationService -Klasse nicht verfügbar.)

Der 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 nach der Überprüfung der Benutzeranmeldeinformationen festgelegt wird. 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 ValidateUser , wenn sich ein Benutzer zuvor angemeldet hat und Sie zu Beginn einer neuen Anwendungssitzung überprüfen müssen, ob die Anmeldeinformationen noch gültig sind.

Ein Beispiel für die Verwendung des WCF-Authentifizierungsdiensts über eine Konsolenanwendung finden Sie unter Exemplarische Vorgehensweise: Verwenden von ASP.NET Application Services.

Konstruktoren

AuthenticationService()

Initialisiert eine neue Instanz der AuthenticationService-Klasse.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsLoggedIn()

Ermittelt, 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 des 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 auszugeben.

Ereignisse

Authenticating

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

Tritt auf, wenn das Authentifizierungscookie festgelegt wird.

Gilt für:

Weitere Informationen