AuthenticationService Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 = classPublic Class AuthenticationService- Vererbung
-
AuthenticationService
- Attribute
Hinweise
Mit AuthenticationService dem -Objekt können Sie Benutzer über einen Windows Communication Foundation-Dienst (WCF) 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, den Authentifizierungsstatus überprüfen, die Authentifizierung anpassen und das Authentifizierungscooky 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 Authentifizierungscooky. Wenn das Authentifizierungscooky 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.)
Die AuthenticationService kann zwei Ereignisse auslösen: Authenticating und CreatingCookie. Das Authenticating Ereignis tritt auf, wenn die Anmeldeinformationen des Benutzers überprüft werden. Erstellen Sie einen Ereignishandler für das Ereignis, um die Authenticating Überprüfung von Benutzeranmeldeinformationen anzupassen. Das CreatingCookie Ereignis tritt auf, wenn das Authentifizierungscooky nach der Überprüfung der Benutzeranmeldeinformationen festgelegt wird. Erstellen Sie einen Ereignishandler für das CreatingCookie Ereignis, um das Authentifizierungscooky anzupassen.
Die ValidateUser Methode überprüft die Anmeldeinformationen des Benutzers auf Authentifizierung, gibt jedoch kein Authentifizierungsticket zurück. Verwenden Sie 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 über eine Konsolenanwendung finden Sie unter Exemplarische Vorgehensweise: Verwenden 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. |
