AuthenticationService.Login(String, String, String, Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Verifica as credenciais de usuário e cria um tíquete de autenticação (cookie) se as credenciais são válidas.
public:
bool Login(System::String ^ username, System::String ^ password, System::String ^ customCredential, bool isPersistent);
[System.ServiceModel.OperationContract]
public bool Login (string username, string password, string customCredential, bool isPersistent);
[<System.ServiceModel.OperationContract>]
member this.Login : string * string * string * bool -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean
Parâmetros
- username
- String
O nome de usuário a ser validado.
- password
- String
A senha do usuário especificado.
- customCredential
- String
O valor ou os valores a serem validados além de username
e password
, se houver.
- isPersistent
- Boolean
Um valor que indica se o tíquete de autenticação permanece válido entre diferentes sessões.
Retornos
true
se as credenciais do usuário forem válidas; caso contrário, false
.
- Atributos
Exceções
userName
ou password
é null
.
Comentários
O Login método valida as credenciais do usuário por meio de um provedor de associação. Você pode usar o provedor de associação padrão ou especificar um provedor de associação personalizado em tempo de execução. A AuthenticationService classe passa userName
e password
para o método do provedor de ValidateUser associação, mas não passa customCredential
. Se ValidateUser retornar true
, AuthenticationService criará um tíquete de autenticação como um cookie. Defina o isPersistent
parâmetro como true
para criar um tíquete de autenticação que dure além da sessão atual.
Observação
Sempre use o serviço de autenticação junto com a SSL (camada de soquetes seguros, usando HTTPS) para proteger dados confidenciais.
O Login método gera o Authenticating evento e o CreatingCookie evento. Crie um manipulador de eventos para Authenticating personalizar a autenticação, como verificar os valores em customCredential
ou validar credenciais por meio de um provedor de associação não padrão. Os valores em customCredential
não são validados pelo provedor de associação padrão. Para personalizar o cookie de autenticação, crie um manipulador de eventos para CreatingCookie.
Observação
Não chame o Login método do código que está sendo executado no servidor Web. Você chama o Login método apenas como parte de um serviço WCF. Para obter mais informações, consulte Autenticação ASP.NET.