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 del 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 -> boolPublic Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As BooleanParámetros
- username
- String
Nombre de usuario que se va a validar.
- password
- String
Contraseña para el usuario especificado.
- customCredential
- String
Valor o valores que se van a validar además de username y password, si los hubiera.
- isPersistent
- Boolean
Valor que indica si el vale de autenticación mantiene su validez entre sesiones.
Devoluciones
Es true si las credenciales de usuario son válidas; en cualquier otro caso, es 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 proveedor de ValidateUser pertenencia, pero no pasa customCredential. Si ValidateUser devuelve true, AuthenticationService crea un vale de autenticación como 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.
Nota
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 en customCredential o validar las credenciales a través de un proveedor de pertenencia no predeterminado. Los valores de customCredential no se validan mediante el proveedor de pertenencia predeterminado. Para personalizar la cookie de autenticación, cree un controlador de eventos para CreatingCookie.
Nota
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 autenticación de ASP.NET.
