AuthenticationService Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Разрешает доступ к проверке подлинности форм 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
- Наследование
-
AuthenticationService
- Атрибуты
Комментарии
Объект 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 для проверки подлинности. |