AuthenticationService Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Umožňuje přístup k ověřování pomocí formulářů ASP.NET jako webové služby.
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
- Dědičnost
-
AuthenticationService
- Atributy
Poznámky
Objekt AuthenticationService umožňuje ověřovat uživatele prostřednictvím služby WCF (Windows Communication Foundation). Ověřovací službu WCF použijete, když musíte ověřovat uživatele prostřednictvím ASP.NET členství z aplikace, která je mimo webovou aplikaci, která ukládá přihlašovací údaje uživatele. Aplikace musí být schopná odesílat a přijímat zprávy ve formátu SOAP. AuthenticationService Prostřednictvím třídy můžete přihlásit uživatele, odhlásit uživatele, ověřit přihlašovací údaje, zkontrolovat stav ověřování, přizpůsobit ověřování a nastavit ověřovací soubor cookie.
Třída AuthenticationService obsahuje čtyři metody, ke kterým byste měli přistupovat pouze prostřednictvím služby WCF: IsLoggedInmetody , Login, Logouta ValidateUser . Chcete-li tyto metody volat, povolte ověřovací službu na webovém serveru a poté připojte klientskou aplikaci kompatibilní s WCF k webové službě. Informace o konfiguraci ověřovací služby najdete v tématu Postupy: Povolení ověřovací služby WCF.
Pokud chcete přihlásit uživatele, předáte metodě přihlašovací údaje Login uživatele. Pokud jsou přihlašovací údaje platné, AuthenticationService třída vytvoří ověřovací soubor cookie. Pokud platnost ověřovacího souboru cookie nevypršela, víte, že přihlašovací údaje uživatele byly ověřeny, a nemusíte je ověřovat znovu. (Ověřování bez souborů cookie není prostřednictvím AuthenticationService třídy k dispozici.)
Může AuthenticationService vyvolat dvě události: Authenticating a CreatingCookie. K Authenticating události dochází při ověřování přihlašovacích údajů uživatele. Vytvořte obslužnou rutinu Authenticating události pro událost, abyste mohli přizpůsobit způsob ověřování přihlašovacích údajů uživatele. Událost CreatingCookie nastane, když se ověřovací soubor cookie nastavuje po ověření přihlašovacích údajů uživatele. Vytvořte obslužnou rutinu události pro událost a CreatingCookie přizpůsobte ověřovací soubor cookie.
Metoda zkontroluje ValidateUser ověření přihlašovacích údajů uživatele, ale nevrátí lístek ověřování. Použijte ValidateUser , pokud se uživatel již dříve přihlásil a na začátku nové relace aplikace musíte zkontrolovat, zda jsou přihlašovací údaje stále platné.
Příklad použití ověřovací služby WCF z konzolové aplikace najdete v tématu Návod: Použití ASP.NET aplikačních služeb.
Konstruktory
AuthenticationService() |
Inicializuje novou instanci AuthenticationService třídy . |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
IsLoggedIn() |
Určuje, zda je aktuální uživatel ověřen. |
Login(String, String, String, Boolean) |
Zkontroluje přihlašovací údaje uživatele a vytvoří ověřovací lístek (soubor cookie), pokud jsou přihlašovací údaje platné. |
Logout() |
Vymaže lístek ověřování (soubor cookie) v prohlížeči. |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
ValidateUser(String, String, String) |
Ověřuje přihlašovací údaje uživatele bez vystavení lístku ověřování. |
Událost
Authenticating |
Vyvolá se při ověřování přihlašovacích údajů uživatele. |
CreatingCookie |
Vyvolá se při nastavování ověřovacího souboru cookie. |