AuthenticationService Classe
Definição
Permite o acesso a autenticação de formulários do ASP.NET como um serviço Web.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
[<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
- Herança
-
AuthenticationService
- Atributos
Comentários
O AuthenticationService objeto permite que você autentique usuários por meio de um serviço Windows Communication Foundation (WCF).The AuthenticationService object enables you to authenticate users through a Windows Communication Foundation (WCF) service. Você usa o serviço de autenticação do WCF quando deve autenticar usuários por meio da associação ASP.NET de um aplicativo que está fora do aplicativo Web que armazena as credenciais do usuário.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. O aplicativo deve ser capaz de enviar e consumir mensagens no formato SOAP.The application must be able to send and consume message in the SOAP format. Por meio da AuthenticationService classe, você pode registrar os usuários em log, validar as credenciais, verificar o status da autenticação, personalizar a autenticação e definir o cookie de autenticação.Through the AuthenticationService class, you can log users in, log users out, validate credentials, check authentication status, customize authentication, and set the authentication cookie.
A AuthenticationService classe contém quatro métodos que você deve acessar somente por meio de um serviço WCF: os IsLoggedIn Login métodos,, Logout e ValidateUser .The AuthenticationService class contains four methods that you should access only through a WCF service: the IsLoggedIn, Login, Logout, and ValidateUser methods. Para chamar esses métodos, você habilita o serviço de autenticação em um servidor Web e, em seguida, conecta um aplicativo cliente compatível com o WCF ao serviço Web.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. Para obter informações sobre como configurar o serviço de autenticação, consulte como habilitar o serviço de autenticação WCF.For information about how to configure the authentication service, see How to: Enable the WCF Authentication Service.
Para fazer logon de usuários, você passa as credenciais do usuário para o Login método.To log users on, you pass the user credentials to the Login method. Se as credenciais forem válidas, a AuthenticationService classe criará um cookie de autenticação.If the credentials are valid, the AuthenticationService class creates an authentication cookie. Se o cookie de autenticação não tiver expirado, você saberá que as credenciais do usuário foram autenticadas e não precisará validar as credenciais novamente.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. (A autenticação sem cookie não está disponível por meio da AuthenticationService classe.)(Cookie-less authentication is not available through the AuthenticationService class.)
O AuthenticationService pode gerar dois eventos: Authenticating e CreatingCookie .The AuthenticationService can raise two events: Authenticating and CreatingCookie. O Authenticating evento ocorre quando as credenciais do usuário estão sendo validadas.The Authenticating event occurs when the user credentials are being validated. Crie um manipulador de eventos para o Authenticating evento para personalizar como as credenciais do usuário são validadas.Create an event handler for the Authenticating event to customize how user credentials are validated. O CreatingCookie evento ocorre quando o cookie de autenticação está sendo definido depois que as credenciais do usuário são validadas.The CreatingCookie event occurs when the authentication cookie is being set after user credentials have been validated. Crie um manipulador de eventos para o CreatingCookie evento para personalizar o cookie de autenticação.Create an event handler for the CreatingCookie event to customize the authentication cookie.
O ValidateUser método verifica as credenciais do usuário para autenticação, mas não retorna um tíquete de autenticação.The ValidateUser method checks user credentials for authentication, but it does not return an authentication ticket. Use ValidateUser quando um usuário fez logon anteriormente e você deve verificar se as credenciais ainda são válidas no início de uma nova sessão de aplicativo.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.
Para obter um exemplo de como usar o serviço de autenticação do WCF a partir de um aplicativo de console, consulte Walkthrough: using ASP.NET Serviços de aplicativos.For an example of using the WCF authentication service from a console application, see Walkthrough: Using ASP.NET Application Services.
Construtores
| AuthenticationService() |
Inicializa uma nova instância da classe AuthenticationService.Initializes a new instance of the AuthenticationService class. |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| IsLoggedIn() |
Determina se o usuário atual é autenticado.Determines whether the current user is authenticated. |
| Login(String, String, String, Boolean) |
Verifica as credenciais de usuário e cria um tíquete de autenticação (cookie) se as credenciais são válidas.Checks user credentials and creates an authentication ticket (cookie) if the credentials are valid. |
| Logout() |
Limpa o tíquete de autenticação (cookie) no navegador.Clears the authentication ticket (cookie) in the browser. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |
| ValidateUser(String, String, String) |
Autentica as credenciais do usuário sem emitir um tíquete de autenticação.Authenticates user credentials without issuing an authentication ticket. |
Eventos
| Authenticating |
Ocorre quando as credenciais do usuário estão sendo validadas.Occurs when user credentials are being validated. |
| CreatingCookie |
Ocorre quando o cookie de autenticação está sendo definido.Occurs when the authentication cookie is being set. |