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 einer ActiveDirectoryMembershipProvider -Instanz konfiguriert ist. Im ersten Beispiel werden die Standardzuordnungen für Active Directory-Attribute verwendet, und es wird weder die Kennwortzurücksetzung mit Frage-und-Antwort-Sicherheit noch die Möglichkeit zum Aufrufen von Suchmethoden unterstützt. Das zweite Beispiel zeigt alle Attributeinstellungen, die für eine ActiveDirectoryMembershipProvider Instanz zulässig sind.

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

<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 Instanz 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 der Standardwert ist 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, ist 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 Settings Schema) 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 -Instanz ordnet Verzeichnisattribute Eigenschaften zu ActiveDirectoryMembershipUser . 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 die ActiveDirectoryMembershipProvider Instanz 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-Instanz 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