AuthenticationService AuthenticationService AuthenticationService AuthenticationService Class

Определение

Разрешает доступ к проверке подлинности форм ASP.NET как к веб-службе.Enables access to ASP.NET forms authentication as a Web service.

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
type AuthenticationService = class
Public Class AuthenticationService
Наследование
AuthenticationServiceAuthenticationServiceAuthenticationServiceAuthenticationService
Атрибуты

Комментарии

AuthenticationService Объект позволяет выполнять проверку подлинности пользователей с помощью службы Windows Communication Foundation (WCF).The AuthenticationService object enables you to authenticate users through a Windows Communication Foundation (WCF) service. Служба проверки подлинности WCF используется при необходимости проверки подлинности пользователей с помощью ASP.NET членства из приложения, которое находится за пределами веб-приложения, в котором хранятся учетные данные пользователя.You use the WCF authentication service when you must authenticate users through ASP.NET membership from an application that is outside the Web application that stores the user credentials. Приложение должно иметь возможность отправки и использования сообщений в формате SOAP.The application must be able to send and consume message in the SOAP format. С помощью AuthenticationService класса можно входить в систему пользователей, записывать пользователей, проверять учетные данные, проверять состояние проверки подлинности, настраивать проверку подлинности и задавать файл cookie проверки подлинности.Through the AuthenticationService class, you can log users in, log users out, validate credentials, check authentication status, customize authentication, and set the authentication cookie.

Login IsLoggedIn ValidateUser LogoutКласс содержит четыре метода, доступ к которым должен осуществляться только через службу WCF: методы,, и. AuthenticationServiceThe AuthenticationService class contains four methods that you should access only through a WCF service: the IsLoggedIn, Login, Logout, and ValidateUser methods. Чтобы вызвать эти методы, включите службу проверки подлинности на веб-сервере, а затем подключите клиентское приложение, совместимое с WCF, к веб-службе.To call these methods, you enable the authentication service on a Web server and then connect a WCF-compatible client application to the Web service. Сведения о настройке службы проверки подлинности см. в разделе как Включите службупроверки подлинности WCF.For information about how to configure the authentication service, see How to: Enable the WCF Authentication Service.

Для входа пользователей в систему в Login метод передаются учетные данные пользователя.To log users on, you pass the user credentials to the Login method. Если учетные данные действительны, AuthenticationService класс создает файл cookie проверки подлинности.If the credentials are valid, the AuthenticationService class creates an authentication cookie. Если срок действия файла cookie для проверки подлинности не истек, вы узнаете, что учетные данные пользователя прошли проверку подлинности и вам не нужно повторно проверять учетные данные.If the authentication cookie has not expired, you know that the user's credentials have been authenticated and you do not have to validate the credentials again. (Проверка подлинности без файлов cookie недоступна через AuthenticationService класс.)(Cookie-less authentication is not available through the AuthenticationService class.)

Может вызывать два события: Authenticating и CreatingCookie. AuthenticationServiceThe AuthenticationService can raise two events: Authenticating and CreatingCookie. Это Authenticating событие возникает при проверке учетных данных пользователя.The Authenticating event occurs when the user credentials are being validated. Создайте обработчик Authenticating событий для события, чтобы настроить проверку учетных данных пользователя.Create an event handler for the Authenticating event to customize how user credentials are validated. Это CreatingCookie событие возникает, когда файл cookie проверки подлинности задается после проверки учетных данных пользователя.The CreatingCookie event occurs when the authentication cookie is being set after user credentials have been validated. Создайте обработчик CreatingCookie событий для события, чтобы настроить файл cookie для проверки подлинности.Create an event handler for the CreatingCookie event to customize the authentication cookie.

ValidateUser Метод проверяет учетные данные пользователя для проверки подлинности, но не возвращает билет проверки подлинности.The ValidateUser method checks user credentials for authentication, but it does not return an authentication ticket. Используйте ValidateUser , когда пользователь ранее вошел в систему, и необходимо убедиться, что учетные данные все еще действительны в начале нового сеанса приложения.Use ValidateUser when a user has previously logged in and you must check that the credentials are still valid at the start of a new application session.

Пример использования службы проверки подлинности WCF из консольного приложения см. в разделе Пошаговое руководство. Использование Службы приложенийASP.NET.For an example of using the WCF authentication service from a console application, see Walkthrough: Using ASP.NET Application Services.

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

AuthenticationService() AuthenticationService() AuthenticationService() AuthenticationService()

Инициализирует новый экземпляр класса AuthenticationService.Initializes a new instance of the AuthenticationService class.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsLoggedIn() IsLoggedIn() IsLoggedIn() IsLoggedIn()

Определяет, прошел ли текущий пользователь проверку подлинности.Determines whether the current user is authenticated.

Login(String, String, String, Boolean) Login(String, String, String, Boolean) Login(String, String, String, Boolean) Login(String, String, String, Boolean)

Проверяет учетные данные пользователя и создает билет проверки подлинности (файл Cookie), если учетные данные оказываются действительными.Checks user credentials and creates an authentication ticket (cookie) if the credentials are valid.

Logout() Logout() Logout() Logout()

Очищает билет проверки подлинности (файл Cookie) в браузере.Clears the authentication ticket (cookie) in the browser.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
ValidateUser(String, String, String) ValidateUser(String, String, String) ValidateUser(String, String, String) ValidateUser(String, String, String)

Проверяет подлинность учетных данных пользователя, не используя билет проверки подлинности.Authenticates user credentials without issuing an authentication ticket.

События

Authenticating Authenticating Authenticating Authenticating

Происходит при проверке учетных данных пользователя.Occurs when user credentials are being validated.

CreatingCookie CreatingCookie CreatingCookie CreatingCookie

Происходит при установке файла Cookie для проверки подлинности.Occurs when the authentication cookie is being set.

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

Дополнительно