ActiveDirectoryMembershipProvider Klasse

Definition

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

Vererbung

Object

ProviderBase

MembershipProvider

ActiveDirectoryMembershipProvider

Beispiele

Die folgenden Codebeispiele zeigen die Web.config-Datei für eine ASP.NET Anwendung, die für die Verwendung eines ActiveDirectoryMembershipProvider instance konfiguriert ist. Das erste Beispiel verwendet die Standardzuordnungen für Active Directory-Attribute und unterstützt weder die Sicherheit zum Zurücksetzen von Kennwörtern mit Frage-und-Antwort noch die Möglichkeit, Suchmethoden aufzurufen. Das zweite Beispiel zeigt alle Attributeinstellungen, die für eine ActiveDirectoryMembershipProvider instance zulässig sind.

Das erste Beispiel ist eine einfache Konfigurationsdatei, die Standardzuordnungen für Active Directory-Attribute verwendet.

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

Dieses Beispiel zeigt alle Attributeinstellungen, die für eine instance von ActiveDirectoryMembershipProviderverfügbar sind.

<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 und serverSearchTimeout standardmäßig minuten. Um die Einheiten zu ändern, legen Sie den timeoutUnit Attributwert auf "Tage", "Stunden", "Minuten", "Sekunden" oder "Millisekunden" fest. Wenn das Attribut nicht angegeben ist, lautet der Standardwert "Minutes".

Hinweise

Diese Klasse wird von den Membership Klassen und MembershipUser verwendet, um Mitgliedschaftsdienste für eine ASP.NET-Anwendung mithilfe eines Active Directory-Servers (AD) oder eines ADAM-Servers (Active Directory Application Mode) bereitzustellen.

Sie müssen einen ConnectionStrings-Elementeintrag (ASP.NET Einstellungsschema) in der Web.config-Datei erstellen, der den zu verwendenden Active Directory-Server, die Active Directory-Domäne oder die ADAM-Anwendungspartition identifiziert. Der Anbieter wird nur im Domänenbereich oder in einem Unterbereich innerhalb einer Domäne ausgeführt. In der folgenden Tabelle sind zulässige Verbindungszeichenfolgen und der verwendete Bereich aufgeführt.

Die ActiveDirectoryMembershipProvider instance ordnet Verzeichnisattribute Eigenschaften zuActiveDirectoryMembershipUser. Standardattribute werden verwendet, wenn in der Web.config-Datei keine Attributzuordnung durchgeführt wird. Weitere Informationen zu Attributzuordnungen finden Sie in den einzelnen Eigenschaften in der ActiveDirectoryMembershipUser Klassendokumentation.

In der folgenden Tabelle sind die ActiveDirectoryMembershipUser Eigenschaften und ihre Standardattributezuordnungen aufgeführt.

Wenn sowohl die RequiresQuestionAndAnswer -Eigenschaft als EnablePasswordReset auch die -Eigenschaft sind true, unterstützt die -Klasse die ActiveDirectoryMembershipProvider Sicherheit zum Zurücksetzen von Kennwörtern, indem der Benutzer eine vorab festgelegte Frage beantworten muss. Um die Frage und Die Antwort zu unterstützen, müssen Sie die folgenden Konfigurationsattribute festlegen, indem Sie das Element für Anbieter für die Mitgliedschaft hinzufügen (ASP.NET Einstellungsschema) in der Anwendungskonfigurationsdatei verwenden.

Weitere Informationen zur Verwendung der Kennwortzurücksetzungssicherheit finden Sie in der RequiresQuestionAndAnswer -Eigenschaft.

Active Directory-Verbindungen

Wenn die ActiveDirectoryMembershipProvider -Klasse zum Herstellen einer Verbindung mit einem Active Directory- oder ADAM-Server (Active Directory Application Mode) verwendet wird, kann das Attribut, das connectionProtection mithilfe des add Element for providers for membership (ASP.NET Settings Schema) in der Anwendungskonfigurationsdatei festgelegt wird, die Arten von Vorgängen einschränken, die die ActiveDirectoryMembershipProvider Klasse über die Verbindung ausführen kann. Das connectionProtection Attribut bestimmt auch die Methoden, die der ActiveDirectoryMembershipProvider instance zum Herstellen der Verbindung mit dem Active Directory- oder ADAM-Server verwendet.

Die folgende Tabelle zeigt die Auswirkungen des Attributs connectionProtection beim Herstellen einer Verbindung mit einem Active Directory.

Die folgende Tabelle zeigt die Auswirkungen des Attributs connectionProtection beim Herstellen einer Verbindung mit einem ADAM-Server.

ADAM-Konfiguration

Bei Verwendung eines ADAM-Servers muss die ADAM-instance ein Schema enthalten, das die User Klasse definiert. Sie können die User Klasse mit einem LDIF-Import der Datei importieren, die MS-User.ldf im ADAM-Installationsverzeichnis verfügbar ist.

Die ActiveDirectoryMembershipProvider -Klasse funktioniert mit einem ADAM-Server, der für die Verwendung der Standardnetzwerkports konfiguriert ist. Die folgende Tabelle zeigt die für den ADAM-Server erwarteten Standardwerte.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Einführung in ASP.NET Mitgliedschaft
• Vorgehensweise: Verwenden der Mitgliedschaft in ASP.NET 2.0