ClientFormsAuthenticationMembershipProvider (Clase)

Puede usar los servicios de la aplicación cliente para validar a los usuarios mediante la autenticación de formularios. Para habilitar la autenticación de formularios, configure la aplicación para que utilice la clase ClientFormsAuthenticationMembershipProvider. Para obtener más información, vea Cómo: Configurar servicios de aplicaciones cliente.

Después de la configuración, puede validar a los usuarios llamando al método static Membership.ValidateUser, que llama internamente al método ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

La autenticación de formularios requiere que el usuario especifique sus credenciales a través de los controles de inicio de sesión proporcionados por la aplicación. Puede recuperar las credenciales y pasarlas al método Membership.ValidateUser. También puede pasar cadenas vacías o null para usar un proveedor de credenciales. Un proveedor de credenciales es una implementación IClientFormsAuthenticationCredentialsProvider especificada en el archivo de configuración de la aplicación. Normalmente el método IClientFormsAuthenticationCredentialsProvider.GetCredentials se implementa para mostrar un cuadro de diálogo de inicio de sesión y devolver un objeto ClientFormsAuthenticationCredentials rellenado. El uso de un proveedor de credenciales permite compartir un cuadro de diálogo único entre varias aplicaciones.

El método ClientFormsAuthenticationMembershipProvider.ValidateUser autentica a los usuarios a través del servicio de inicio de sesión indicado por la propiedad ServiceUri. El valor de la propiedad ServiceUri se recupera normalmente del archivo de configuración de la aplicación junto con otros valores de configuración. Para obtener más información, vea Cómo: Configurar servicios de aplicaciones cliente.

Si el usuario se autentica correctamente, el proveedor de servicios establece la propiedad staticThread.CurrentPrincipalen un nuevo objeto ClientRolePrincipal que contiene un nuevo objeto ClientFormsIdentity que contiene la información sobre el usuario. Si se ha configurado ClientRoleProvider para una aplicación, puede usar el objeto ClientRolePrincipal para recuperar la información sobre la función del usuario desde el servicio de funciones.

Puede recuperar una referencia a la instancia actual de ClientFormsAuthenticationMembershipProvider a través de la propiedad static Membership.Provider. Puede usar la referencia del proveedor de pertenencia para llamar al método ClientFormsAuthenticationMembershipProvider.ValidateUser directamente. Además, necesitará que la referencia del proveedor de pertenencia llame al método Logout, que no está disponible en la clase base MembershipProvider.

No puede usar la clase ClientFormsAuthenticationMembershipProvider para crear, eliminar o modificar información de pertenencia. Para crear, eliminar o modificar usuarios, debe cambiar la configuración del servicio de inicio de sesión en el servidor.

En el código de ejemplo siguiente se muestra cómo usar este método para validar al usuario mediante una implementación de IClientFormsAuthenticationCredentialsProvider.

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

.NET Framework

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos