AuthenticationService Classe

Definição

Namespace:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Permite o acesso a autenticação de formulários do ASP.NET como um 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

Object

AuthenticationService

Atributos

AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

Comentários

O AuthenticationService objeto permite que você autentique usuários por meio de um serviço WCF (Windows Communication Foundation). Você usa o serviço de autenticação do WCF quando precisa autenticar usuários por meio de ASP.NET associação de um aplicativo que está fora do aplicativo Web que armazena as credenciais do usuário. O aplicativo deve ser capaz de enviar e consumir mensagens no formato SOAP. Por meio da AuthenticationService classe , você pode fazer logon dos usuários, fazer logoff dos usuários, validar credenciais, verificar o status da autenticação, personalizar a autenticação e definir o cookie de autenticação.

A AuthenticationService classe contém quatro métodos que você deve acessar somente por meio de um serviço WCF: os IsLoggedInmétodos , LoginLogout, e ValidateUser . Para chamar esses métodos, habilite o serviço de autenticação em um servidor Web e conecte um aplicativo cliente compatível com WCF ao serviço Web. Para obter informações sobre como configurar o serviço de autenticação, consulte Como habilitar o serviço de autenticação do WCF.

Para fazer logon dos usuários, passe as credenciais do usuário para o Login método . Se as credenciais forem válidas, a AuthenticationService classe criará um cookie de autenticação. 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. (A autenticação sem cookie não está disponível por meio da AuthenticationService classe .)

O AuthenticationService pode gerar dois eventos: Authenticating e CreatingCookie. O Authenticating evento ocorre quando as credenciais do usuário estão sendo validadas. Crie um manipulador de eventos para o Authenticating evento para personalizar como as credenciais do usuário são validadas. O CreatingCookie evento ocorre quando o cookie de autenticação está sendo definido após a validação das credenciais do usuário. Crie um manipulador de eventos para o CreatingCookie evento para personalizar o cookie de autenticação.

O ValidateUser método verifica as credenciais do usuário para autenticação, mas não retorna um tíquete de autenticação. Use ValidateUser quando um usuário tiver feito logon anteriormente e você precisar verificar se as credenciais ainda são válidas no início de uma nova sessão de aplicativo.

Para obter um exemplo de como usar o serviço de autenticação WCF de um aplicativo de console, consulte Passo a passo : usando ASP.NET Serviços de Aplicativos.

Construtores

AuthenticationService()

Inicializa uma nova instância da classe AuthenticationService.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsLoggedIn()	Determina se o usuário atual é autenticado.
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.
Logout()	Limpa o tíquete de autenticação (cookie) no navegador.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
ValidateUser(String, String, String)	Autentica as credenciais do usuário sem emitir um tíquete de autenticação.

Eventos

Authenticating	Ocorre quando as credenciais do usuário estão sendo validadas.
CreatingCookie	Ocorre quando o cookie de autenticação está sendo definido.

Confira também

• Visão geral do Serviço de Autenticação do Windows Communication Foundation