AuthenticationService Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Permite o acesso à autenticação de formulários ASP.NET como serviço 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
- Herança
-
AuthenticationService
- Atributos
Observações
O objeto AuthenticationService permite-lhe autenticar utilizadores através de um serviço Windows Communication Foundation (WCF). Utiliza-se o serviço de autenticação WCF quando tem de autenticar utilizadores através da adesão ao ASP.NET a partir de uma aplicação que está fora da aplicação Web que armazena as credenciais do utilizador. A aplicação deve ser capaz de enviar e consumir mensagens no formato SOAP. Através da AuthenticationService aula, pode iniciar sessão dos utilizadores, desconectar-se, validar credenciais, verificar o estado da autenticação, personalizar a autenticação e definir o cookie de autenticação.
A AuthenticationService classe contém quatro métodos aos quais deve aceder apenas através de um serviço WCF: os IsLoggedIn, Login, Logout, e ValidateUser métodos. Para chamar estes métodos, ativa-se o serviço de autenticação num servidor Web e depois liga-se uma aplicação cliente compatível com WCF ao serviço Web. Para informações sobre como configurar o serviço de autenticação, veja Como: Ativar o Serviço de Autenticação WCF.
Para iniciar sessão dos utilizadores, passa as credenciais do utilizador ao Login método. Se as credenciais forem válidas, a AuthenticationService classe cria um cookie de autenticação. Se o cookie de autenticação não tiver expirado, sabe que as credenciais do utilizador foram autenticadas e não precisa de validar as credenciais novamente. (A autenticação sem cookies não está disponível através da AuthenticationService turma.)
Podem AuthenticationService levantar dois eventos: Authenticating e CreatingCookie. O Authenticating evento ocorre quando as credenciais dos utilizadores estão a ser validadas. Crie um gestor de eventos para o Authenticating evento para personalizar a forma como as credenciais dos utilizadores são validadas. O CreatingCookie evento ocorre quando o cookie de autenticação está a ser definido após as credenciais do utilizador terem sido validadas. Crie um gestor de eventos para o CreatingCookie evento para personalizar o cookie de autenticação.
O ValidateUser método verifica as credenciais do utilizador para autenticação, mas não devolve um ticket de autenticação. ValidateUser Use quando um utilizador já fez login e deve verificar se as credenciais continuam válidas no início de uma nova sessão de aplicação.
Para um exemplo de utilização do serviço de autenticação WCF a partir de uma aplicação de consola, veja Walkthrough: Using ASP.NET Application Services.
Construtores
| Name | Description |
|---|---|
| AuthenticationService() |
Inicializa uma nova instância da AuthenticationService classe. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsLoggedIn() |
Determina se o utilizador atual está autenticado. |
| Login(String, String, String, Boolean) |
Verifica as credenciais do utilizador e cria um ticket de autenticação (cookie) se as credenciais são válidas. |
| Logout() |
Limpa o ticket de autenticação (cookie) no navegador. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| ValidateUser(String, String, String) |
Autentica as credenciais do utilizador sem emitir um ticket de autenticação. |
evento
| Name | Description |
|---|---|
| Authenticating |
Ocorre quando as credenciais dos utilizadores estão a ser validadas. |
| CreatingCookie |
Ocorre quando o cookie de autenticação está a ser definido. |