AuthenticationService Класс

  • Ссылка

Определение

Пространство имен:
System.Web.ApplicationServices
Сборка:
System.Web.Extensions.dll

Разрешает доступ к проверке подлинности форм ASP.NET как к веб-службе.

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
Наследование
Object
AuthenticationService
Атрибуты
AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

Комментарии

Объект AuthenticationService позволяет проверять подлинность пользователей с помощью службы Windows Communication Foundation (WCF). Служба проверки подлинности WCF используется, когда необходимо пройти проверку подлинности пользователей с помощью ASP.NET членства из приложения, которое находится за пределами веб-приложения, в котором хранятся учетные данные пользователя. Приложение должно иметь возможность отправлять и использовать сообщения в формате SOAP. AuthenticationService С помощью класса можно выполнять вход пользователей, выходить из системы, проверять учетные данные, проверка состояние проверки подлинности, настраивать проверку подлинности и задавать файл cookie проверки подлинности.

Класс AuthenticationService содержит четыре метода, к которым следует обращаться только через службу WCF: методы IsLoggedIn, Login, Logoutи ValidateUser . Чтобы вызвать эти методы, необходимо включить службу проверки подлинности на веб-сервере, а затем подключить к ней клиентское приложение, совместимое с WCF. Сведения о настройке службы проверки подлинности см. в разделе Практическое руководство. Включение службы проверки подлинности WCF.

Чтобы войти в систему, передайте учетные данные пользователя в Login метод . Если учетные данные действительны, AuthenticationService класс создает файл cookie для проверки подлинности. Если срок действия файла cookie проверки подлинности не истек, вы знаете, что учетные данные пользователя прошли проверку подлинности, и вам не нужно повторно проверять учетные данные. (Проверка подлинности без файлов cookie недоступна через AuthenticationService класс .)

может AuthenticationService вызывать два события: Authenticating и CreatingCookie. Это Authenticating событие возникает при проверке учетных данных пользователя. Создайте обработчик событий для события, Authenticating чтобы настроить способ проверки учетных данных пользователя. Это CreatingCookie событие возникает при установке файла cookie проверки подлинности после проверки учетных данных пользователя. Создайте обработчик событий для события, CreatingCookie чтобы настроить файл cookie проверки подлинности.

Метод ValidateUser проверяет учетные данные пользователя для проверки подлинности, но не возвращает билет проверки подлинности. Используйте, ValidateUser если пользователь ранее вошел в систему и необходимо проверка, что учетные данные по-прежнему действительны в начале нового сеанса приложения.

Пример использования службы проверки подлинности WCF из консольного приложения см. в разделе Пошаговое руководство. Использование служб приложений ASP.NET.

Конструкторы

AuthenticationService()

Инициализирует новый экземпляр класса AuthenticationService.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IsLoggedIn()

Определяет, прошел ли текущий пользователь проверку подлинности.
Login(String, String, String, Boolean)

Проверяет учетные данные пользователя и создает билет проверки подлинности (файл Cookie), если учетные данные оказываются действительными.
Logout()

Очищает билет проверки подлинности (файл Cookie) в браузере.
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
ValidateUser(String, String, String)

Проверяет подлинность учетных данных пользователя, не используя билет проверки подлинности.

События

Authenticating

Происходит при проверке учетных данных пользователя.
CreatingCookie

Происходит при установке файла Cookie для проверки подлинности.

Применяется к

См. также раздел