membership, élément (Schéma des paramètres ASP.NET)

Configure des paramètres pour gérer et authentifier des comptes d'utilisateur à l'aide de l'appartenance d'ASP.NET.

Cet élément est une nouveauté de la version 2.0 du .NET Framework.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

defaultProvider

Attribut String facultatif.

Nom du fournisseur d'appartenances par défaut. Pour plus d'informations, consultez Provider.

La valeur par défaut est AspNetSqlProvider.

userIsOnlineTimeWindow

Attribut String facultatif.

Spécifie la durée, en minutes pendant laquelle l'utilisateur est considéré en ligne après l'horodatage de la dernière activité de ce compte d'utilisateur.

La valeur par défaut est 15 minutes.

hashAlgorithmType

Attribut String facultatif.

Spécifie le nom de l'algorithme de chiffrement utilisé pour hacher des valeurs de mot de passe.

La valeur de cet attribut correspond à l'attribut name d'un élément nameEntry de la section de configuration cryptoNameMapping. Pour plus d'informations sur la spécification d'un algorithme de hachage personnalisé, consultez Mappage de noms d'algorithmes à des classes de chiffrement.

La valeur par défaut est SHA1.

Éléments enfants

Élément

Description

providers

Élément facultatif.

Définit une collection de fournisseurs d'appartenances.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

Pour plus d'informations sur l'accès aux valeurs de configuration de l'élément membership dans le code d'application et leur modification, consultez MembershipSection.

Configuration par défaut

L'élément membership par défaut est configuré dans le fichier Machine.config de la version 2.0 du .NET Framework.

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

Exemple

L'exemple de code suivant montre comment configurer une application ASP.NET afin qu'elle utilise le fournisseur SqlMembershipProvider pour stocker et récupérer des informations sur les comptes d'utilisateur.

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

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.MembershipSection

Membre de configuration

Membership

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 2.0

Microsoft Visual Studio 2005

Voir aussi

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Référence

system.web, élément (Schéma des paramètres ASP.NET)

<configuration>, élément

providers, élément de membership (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

Concepts

Vue d'ensemble de la configuration ASP.NET

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Autres ressources

Gestion des utilisateurs à l'aide de l'appartenance

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

API de configuration ASP.NET