Elemento membership (Esquema de configuración de ASP.NET)

  • Artículo

Configura los parámetros para la administración y autenticación de cuentas de usuario utilizando la pertenencia a ASP.NET.

Se trata de un elemento nuevo en .NET Framework versión 2.0.

<membership
    defaultProvider="provider name"
    userIsOnlineTimeWindow="number of minutes"
    hashAlgorithmType="SHA1">
    <providers>...</providers>
</membership>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

defaultProvider

Atributo String opcional.

Nombre del proveedor de pertenencias predeterminado. Para obtener más información, vea Provider.

El valor predeterminado es AspNetSqlProvider.

userIsOnlineTimeWindow

Atributo String opcional.

Especifica el número de minutos transcurridos desde la marca de fecha y hora de la última actividad correspondiente a una cuenta de usuario durante los cuales se considera que el usuario está conectado.

El valor predeterminado es 15 minutos.

hashAlgorithmType

Atributo String opcional.

Especifica el nombre del algoritmo de cifrado que se utiliza para calcular los valores hash de la contraseña.

El valor de este atributo corresponde al atributo name de un elemento nameEntry de la sección de configuración cryptoNameMapping. Para obtener información sobre cómo especificar un algoritmo hash personalizado, vea Asignar nombres de algoritmo a clases de criptografía.

El tipo predeterminado es SHA1.

Elementos secundarios

Elemento

Descripción

providers

Elemento opcional.

Define una colección de proveedores de pertenencias.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

Para obtener información sobre cómo obtener acceso a los valores de configuración del elemento membership en el código de una aplicación, o sobre cómo modificarlos, vea MembershipSection.

Configuración predeterminada

En la versión 2.0 de .NET Framework, el siguiente elemento membership predeterminado se configura en el archivo Machine.config.

<membership>
      <providers>
        <add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
      </providers>

</membership>

Ejemplo

En el siguiente ejemplo de código se muestra cómo configurar una aplicación ASP.NET de manera que utilice el proveedor SqlMembershipProvider para almacenar y recuperar información de una cuenta de usuario.

<configuration>
    <connectionStrings>
        <add name="SqlServices" 
             connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial 
             Catalog=aspnetdb;" />
    </connectionStrings>
    <system.web>
        <membership 
             defaultProvider="SqlProvider"
             userIsOnlineTimeWindow="20">
             <providers>
                <remove name="AspNetSqlProvider" />
                <add name="SqlProvider"
                    type="System.Web.Security.SqlMembershipProvider"
                    connectionStringName="SqlServices"
                    enablePasswordRetrieval="false"
                    enablePasswordReset="true"
                    requiresQuestionAndAnswer="true"
                    passwordFormat="Hashed"
                    applicationName="/" />
            </providers>
        </membership>
    </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.MembershipSection

Miembro de configuración

Membership

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0

.NET Framework versión 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento <configuration>

Elemento providers para membership (Esquema de configuración de ASP.NET)

System.Configuration

System.Web.Configuration

Conceptos

Información general sobre la configuración de ASP.NET

Controles de servidor web ASP.NET y funciones del explorador

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Otros recursos

Administrar usuarios mediante pertenencia

Archivos de configuración de ASP.NET

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

API de configuración de ASP.NET