ActiveDirectoryMembershipProvider クラス

定義

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

継承

Object

ProviderBase

MembershipProvider

ActiveDirectoryMembershipProvider

例

次のコード例は、インスタンスを使用するように構成された ASP.NET アプリケーションのWeb.config ファイルを ActiveDirectoryMembershipProvider 示しています。 最初の例では、Active Directory 属性の既定のマッピングを使用しており、質問と回答や検索メソッドを呼び出す機能を使用したパスワード リセット セキュリティはサポートされていません。 2 番目の例では、インスタンスに対して許可されているすべての属性設定を ActiveDirectoryMembershipProvider 示します。

最初の例は、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>  

この例では、 のインスタンス 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 既定値 serverSearchTimeout は 分です。 単位を変更するには、属性値を timeoutUnit "Days"、"Hours"、"Minutes"、"Seconds"、または "ミリ秒" のいずれかに設定します。 属性が指定されていない場合、既定値は "Minutes" です。

注釈

このクラスは、 クラスと MembershipUser クラスによって使用されMembership、Active Directory (AD) または Active Directory アプリケーション モード (ADAM) サーバーを使用して ASP.NET アプリケーションのメンバーシップ サービスを提供します。

使用する Active Directory サーバー、Active Directory ドメイン、または ADAM アプリケーション パーティションを識別する connectionStrings 要素 (ASP.NET 設定スキーマ) エントリをWeb.config ファイルに作成する必要があります。 プロバイダーは、ドメイン スコープ、またはドメイン内のサブスコープでのみ動作します。 次の表に、使用できる接続文字列と使用されるスコープを示します。

インスタンスは ActiveDirectoryMembershipProvider 、ディレクトリ属性をプロパティに ActiveDirectoryMembershipUser マップします。 既定の属性は、Web.config ファイルで属性マッピングが実行されない場合に使用されます。 属性マッピングの詳細については、クラスのドキュメントの個々のプロパティを ActiveDirectoryMembershipUser 参照してください。

次の表に、 ActiveDirectoryMembershipUser プロパティとその既定の属性マッピングを示します。

と EnablePasswordReset の両方のRequiresQuestionAndAnswerプロパティが の場合、ActiveDirectoryMembershipProviderクラスはtrue、ユーザーに事前に定義された質問に回答するように要求することで、パスワード リセット セキュリティをサポートします。 質問と回答をサポートするには、アプリケーション構成ファイルの メンバーシップのプロバイダーの add 要素 (ASP.NET 設定スキーマ) を使用して、次の構成属性を設定する必要があります。

パスワード リセット セキュリティの使用の詳細については、 プロパティを RequiresQuestionAndAnswer 参照してください。

Active Directory 接続

クラスを ActiveDirectoryMembershipProvider 使用して Active Directory または Active Directory アプリケーション モード (ADAM) サーバーに接続する場合、 connectionProtection アプリケーション構成ファイルの メンバーシップ (ASP.NET 設定スキーマ) のプロバイダーの add 要素 を使用して設定される属性によって、クラスが接続を介して実行できる操作の種類が ActiveDirectoryMembershipProvider 制限される場合があります。 属性は connectionProtection 、インスタンスが Active Directory または ADAM サーバーへの接続を作成するために使用するメソッド ActiveDirectoryMembershipProvider も決定します。

次の表は、Active Directory に connectionProtection 接続するときの 属性の効果を示しています。

次の表は、ADAM サーバーに connectionProtection 接続するときの 属性の効果を示しています。

ADAM 構成

ADAM サーバーを使用する場合、ADAM インスタンスには、 クラスを定義 User するスキーマが含まれている必要があります。 ADAM インストール ディレクトリで User 使用できるファイルの LDIF インポートを使用して MS-User.ldf 、 クラスをインポートできます。

クラスは ActiveDirectoryMembershipProvider 、既定のネットワーク ポートを使用するように構成された ADAM サーバーで動作します。 次の表に、ADAM サーバーに必要な既定値を示します。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• ASP.NET メンバーシップの概要
• 方法: ASP.NET 2.0 でメンバーシップを使用する