Share via

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

  • Referencia

Definición

Espacio de nombres:
System.Web.ApplicationServices
Ensamblado:
System.Web.Extensions.dll

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 -> 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 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

Boolean

Es true si las credenciales de usuario son válidas; en cualquier otro caso, es false.

Atributos
OperationContractAttribute

Excepciones

ArgumentNullException

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.

Se aplica a

Consulte también