AuthenticationService.Login(String, String, String, Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.