ActiveDirectoryMembershipProvider Classe

Définition

public ref class ActiveDirectoryMembershipProvider : System::Web::Security::MembershipProvider

public class ActiveDirectoryMembershipProvider : System.Web.Security.MembershipProvider

type ActiveDirectoryMembershipProvider = class
    inherit MembershipProvider

Public Class ActiveDirectoryMembershipProvider
Inherits MembershipProvider

Héritage

Object

ProviderBase

MembershipProvider

ActiveDirectoryMembershipProvider

Exemples

Les exemples de code suivants montrent le fichier Web.config d’une application ASP.NET configurée pour utiliser une ActiveDirectoryMembershipProvider instance. Le premier exemple utilise les mappages par défaut pour les attributs Active Directory et ne prend pas en charge la sécurité de réinitialisation de mot de passe avec des questions-réponses ni la possibilité d’appeler des méthodes de recherche. Le deuxième exemple montre tous les paramètres d’attribut autorisés pour une ActiveDirectoryMembershipProvider instance.

Le premier exemple est un fichier de configuration simple utilisant des mappages par défaut pour les attributs Active Directory.

<configuration>
  <connectionStrings>
    <add name="ADService" connectionString="LDAP://ldapServer/" />
  </connectionStrings>
  <system.web>
    <membership defaultProvider="AspNetActiveDirectoryMembershipProvider">
      <providers>
        <add name="AspNetActiveDirectoryMembershipProvider"
          type="System.Web.Security.ActiveDirectoryMembershipProvider,
          System.Web, Version=2.0.3600, Culture=neutral,
          PublicKeyToken=b03f5f7f11d50a3a" />
      </providers>
    </membership>
  </system.web>
</configuration>

Cet exemple montre tous les paramètres d’attribut disponibles pour une instance de ActiveDirectoryMembershipProvider.

<configuration>
  <connectionStrings>
    <add name="ADService" connectionString="LDAP://ldapServer/" />
  </connectionStrings>
  <system.web>
    <membership
      defaultProvider="AspNetActiveDirectoryMembershipProvider">
      <providers>
        <add name="AspNetActiveDirectoryMembershipProvider"
          type="System.Web.Security.ActiveDirectoryMembershipProvider,
          System.Web, Version=1.0.3600, Culture=neutral,
          PublicKeyToken=b03f5f7f11d50a3a"
          connectionStringName="ADService"
          connectionUsername="UserWithAppropriateRights"
          connectionPassword="PasswordForUser"
          connectionProtection="Secure"
          enablePasswordReset="true"
          enableSearchMethods="true"
          requiresQuestionAndAnswer="true"
          applicationName="/"
          description="Default AD connection"
          requiresUniqueEmail="false"
          clientSearchTimeout="30"
          serverSearchTimeout="30"
          timeoutUnit="Minutes"
          attributeMapPasswordQuestion="department"
          attributeMapPasswordAnswer="division"
          attributeMapFailedPasswordAnswerCount="singleIntAttribute"
         attributeMapFailedPasswordAnswerTime="singleLargeIntAttribute"
         attributeMapFailedPasswordAnswerLockoutTime="singleLargeIntAttribute"
          attributeMapEmail = "mail"
          attributeMapUsername = "userPrincipalName"
          maxInvalidPasswordAttempts = "5"
          passwordAttemptWindow = "10"
          passwordAnswerAttemptLockoutDuration = "30"
          minRequiredPasswordLength="7"
          minRequiredNonalphanumericCharacters="1"
          passwordStrengthRegularExpression="
          @\"(?=.{6,})(?=(.*\d){1,})(?=(.*\W){1,})" />
        />
      </providers>
    </membership>
  </system.web>
</configuration>

clientSearchTimeout et serverSearchTimeout par défaut en minutes. Pour modifier les unités, définissez la valeur de l’attribut timeoutUnit sur « Jours », « Heures », « Minutes », « Secondes » ou « Millisecondes ». Si l’attribut n’est pas spécifié, la valeur par défaut est « Minutes ».

Remarques

Cette classe est utilisée par les Membership classes et MembershipUser pour fournir des services d’appartenance pour une application ASP.NET à l’aide d’un serveur Active Directory (AD) ou ADAM (Active Directory Application Mode).

Vous devez créer une entrée connectionStrings Element (ASP.NET Settings Schema) dans le fichier Web.config qui identifie le serveur Active Directory, le domaine Active Directory ou la partition d’application ADAM à utiliser. Le fournisseur opère uniquement au niveau de l’étendue du domaine ou dans un sous-étendue au sein d’un domaine. Le tableau suivant répertorie les chaînes de connexion autorisées et l’étendue utilisée.

L’instance ActiveDirectoryMembershipProvider mappe les attributs d’annuaire aux ActiveDirectoryMembershipUser propriétés. Les attributs par défaut sont utilisés si aucun mappage d’attribut n’est effectué dans le fichier Web.config. Pour plus d’informations sur les mappages d’attributs, consultez les propriétés individuelles dans la documentation de la ActiveDirectoryMembershipUser classe.

Le tableau suivant répertorie les ActiveDirectoryMembershipUser propriétés et leurs mappages d’attributs par défaut.

Lorsque les RequiresQuestionAndAnswer propriétés et EnablePasswordReset sont true, la classe prend en charge la ActiveDirectoryMembershipProvider sécurité de réinitialisation de mot de passe en demandant à l’utilisateur de répondre à une question prédéterminée. Pour prendre en charge la question et la réponse, vous devez définir les attributs de configuration suivants à l’aide de l’élément add pour les fournisseurs pour l’appartenance (schéma ASP.NET Paramètres) dans le fichier de configuration de l’application.

Pour plus d’informations sur l’utilisation de la sécurité de réinitialisation de mot de passe, consultez la RequiresQuestionAndAnswer propriété .

Connexions Active Directory

Lorsque la ActiveDirectoryMembershipProvider classe est utilisée pour se connecter à un serveur Active Directory ou ADAM (Active Directory Application Mode), l’attribut défini à l’aide connectionProtection de l’élément add pour les fournisseurs pour l’appartenance (schéma ASP.NET paramètres) dans le fichier de configuration de l’application peut restreindre les types d’opérations que la ActiveDirectoryMembershipProvider classe peut effectuer sur la connexion. L’attribut connectionProtection détermine également les méthodes que l’instance ActiveDirectoryMembershipProvider utilisera pour créer la connexion au serveur Active Directory ou ADAM.

Le tableau suivant montre l’effet de l’attribut lors de la connectionProtection connexion à un annuaire Active Directory.

Le tableau suivant montre l’effet de l’attribut lors de la connectionProtection connexion à un serveur ADAM.

Configuration d’ADAM

Lors de l’utilisation d’un serveur ADAM, l’instance ADAM doit contenir un schéma qui définit la User classe . Vous pouvez importer la User classe avec une importation LDIF du MS-User.ldf fichier disponible dans le répertoire d’installation ADAM.

La ActiveDirectoryMembershipProvider classe fonctionne avec un serveur ADAM configuré pour utiliser les ports réseau par défaut. Le tableau suivant présente les valeurs par défaut attendues pour le serveur ADAM.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Présentation de l’appartenance ASP.NET
• Guide pratique pour utiliser l’appartenance dans ASP.NET 2.0