AuthenticationService Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.ApplicationServices
Zestaw:
System.Web.Extensions.dll

Umożliwia dostęp do uwierzytelniania formularzy ASP.NET jako usługi sieci 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
Dziedziczenie
Object
AuthenticationService
Atrybuty
AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

Uwagi

Obiekt AuthenticationService umożliwia uwierzytelnianie użytkowników za pośrednictwem usługi Windows Communication Foundation (WCF). Używasz usługi uwierzytelniania WCF, gdy musisz uwierzytelniać użytkowników za pośrednictwem ASP.NET członkostwa z aplikacji spoza aplikacji internetowej, która przechowuje poświadczenia użytkownika. Aplikacja musi mieć możliwość wysyłania i korzystania z komunikatu w formacie SOAP. AuthenticationService Za pomocą klasy można logować użytkowników, logować użytkowników, logować użytkowników, weryfikować poświadczenia, sprawdzać stan uwierzytelniania, dostosowywać uwierzytelnianie i ustawiać plik cookie uwierzytelniania.

Klasa AuthenticationService zawiera cztery metody, do których należy uzyskać dostęp tylko za pośrednictwem usługi WCF: IsLoggedInmetody , Login, Logouti ValidateUser . Aby wywołać te metody, należy włączyć usługę uwierzytelniania na serwerze sieci Web, a następnie połączyć aplikację kliencką zgodną z programem WCF z usługą sieci Web. Aby uzyskać informacje o sposobie konfigurowania usługi uwierzytelniania, zobacz Instrukcje: włączanie usługi uwierzytelniania WCF.

Aby zalogować użytkowników, należy przekazać poświadczenia użytkownika do Login metody . Jeśli poświadczenia są prawidłowe, AuthenticationService klasa tworzy plik cookie uwierzytelniania. Jeśli plik cookie uwierzytelniania nie wygasł, wiesz, że poświadczenia użytkownika zostały uwierzytelnione i nie musisz ponownie weryfikować poświadczeń. (Uwierzytelnianie bez plików cookie nie jest dostępne za pośrednictwem AuthenticationService klasy).

Może AuthenticationService zgłaszać dwa zdarzenia: Authenticating i CreatingCookie. Zdarzenie Authenticating występuje, gdy poświadczenia użytkownika są weryfikowane. Utwórz procedurę obsługi zdarzeń Authenticating dla zdarzenia, aby dostosować sposób weryfikacji poświadczeń użytkownika. Zdarzenie CreatingCookie występuje, gdy plik cookie uwierzytelniania jest ustawiany po zweryfikowaniu poświadczeń użytkownika. Utwórz procedurę obsługi zdarzeń CreatingCookie dla zdarzenia, aby dostosować plik cookie uwierzytelniania.

Metoda ValidateUser sprawdza poświadczenia użytkownika na potrzeby uwierzytelniania, ale nie zwraca biletu uwierzytelniania. Użyj ValidateUser polecenia , gdy użytkownik wcześniej się zalogował i należy sprawdzić, czy poświadczenia są nadal prawidłowe na początku nowej sesji aplikacji.

Przykład użycia usługi uwierzytelniania WCF z poziomu aplikacji konsolowej można znaleźć w temacie Przewodnik: korzystanie z usług ASP.NET Application Services.

Konstruktory

AuthenticationService()

Inicjuje nowe wystąpienie klasy AuthenticationService.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
IsLoggedIn()

Określa, czy bieżący użytkownik jest uwierzytelniony.
Login(String, String, String, Boolean)

Sprawdza poświadczenia użytkownika i tworzy bilet uwierzytelniania (cookie), jeśli poświadczenia są prawidłowe.
Logout()

Czyści bilet uwierzytelniania (plik cookie) w przeglądarce.
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
ValidateUser(String, String, String)

Uwierzytelnia poświadczenia użytkownika bez wystawiania biletu uwierzytelniania.

Zdarzenia

Authenticating

Występuje, gdy poświadczenia użytkownika są weryfikowane.
CreatingCookie

Występuje, gdy plik cookie uwierzytelniania jest ustawiany.

Dotyczy

Zobacz też