Lenguaje

AuthenticationService.Login(String, String, String, Boolean) Método

Definición

Comprueba las credenciales de usuario y crea un vale de autenticación (cookie) si las credenciales son 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

Nombre de usuario que se va a validar.

password
String

Contraseña del usuario especificado.

customCredential
String

Valor o valores que se van a username validar además de y password, si los hay.

isPersistent
Boolean

Valor que indica si el vale de autenticación sigue siendo válido en todas las sesiones.

Devoluciones

true si las credenciales de usuario son válidas; de lo contrario, false.

Atributos

Excepciones

userName o password es null.

Comentarios

El Login método valida las credenciales de usuario a través de un proveedor de pertenencia. Puede usar el proveedor de pertenencia predeterminado o especificar un proveedor de pertenencia personalizado en tiempo de ejecución. La AuthenticationService clase pasa userName y password al método del ValidateUser proveedor de pertenencia, pero no pasa customCredential. Si ValidateUser devuelve true, AuthenticationService crea un vale de autenticación como una cookie. Establezca el isPersistent parámetro en true para crear un vale de autenticación que dure más allá de la sesión actual.

Note

Use siempre el servicio de autenticación junto con la capa de sockets seguros (SSL, mediante HTTPS) para proteger los datos confidenciales.

El Login método genera el Authenticating evento y el CreatingCookie evento . Cree un controlador de eventos para Authenticating personalizar la autenticación, como comprobar los valores de customCredential o validar las credenciales a través de un proveedor de pertenencia no predeterminado. El proveedor de pertenencia predeterminado no valida los valores de customCredential . Para personalizar la cookie de autenticación, cree un controlador de eventos para CreatingCookie.

Note

No llame al método desde el Login código que se ejecuta en el servidor web. Solo se llama al Login método como parte de un servicio WCF. Para obtener más información, consulte ASP.NET Authentication.

Se aplica a

Consulte también