AuthenticationService Classe

Definição

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.

Aplica-se a

Ver também