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

示例

以下代码示例演示配置为使用 ActiveDirectoryMembershipProvider 实例的 ASP.NET 应用程序的 Web.config 文件。 第一个示例使用 Active Directory 属性的默认映射，不支持通过问答进行密码重置安全性，也不支持调用搜索方法。 第二个 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 属性值设置为“天”、“小时”、“分钟”、“秒”或“毫秒”之一。 如果未指定属性，则默认值为“Minutes”。

注解

此类由 Membership 和 MembershipUser 类用于为使用 Active Directory (AD) 或 Active Directory 应用程序模式 (ADAM) 服务器的 ASP.NET 应用程序提供成员身份服务。

必须在标识要使用的 Active Directory 服务器、Active Directory 域或 ADAM 应用程序分区的 Web.config 文件中创建 connectionStrings 元素 (ASP.NET 设置架构 ) 条目。 提供程序仅在域范围或域内的子作用域中运行。 下表列出了允许的连接字符串和使用的范围。

实例将 ActiveDirectoryMembershipProvider 目录属性映射到 ActiveDirectoryMembershipUser 属性。 如果在 Web.config 文件中未执行任何属性映射，则使用默认属性。 有关属性映射的详细信息，请参阅类文档中的各个 ActiveDirectoryMembershipUser 属性。

下表列出了 ActiveDirectoryMembershipUser 属性及其默认属性映射。

当 和 EnablePasswordReset 属性均为 RequiresQuestionAndAnswertrue时，ActiveDirectoryMembershipProvider类通过要求用户回答预先确定的问题来支持密码重置安全性。 若要支持问题和答案，必须使用应用程序配置文件中成员 资格 (ASP.NET 设置架构) 的 add Element for provider 来设置以下配置属性。

有关使用密码重置安全性的详细信息，请参阅 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 架构。 可以使用 User ADAM 安装目录中可用文件的 LDIF 导入来导入 MS-User.ldf 类。

类 ActiveDirectoryMembershipProvider 将适用于配置为使用默认网络端口的 ADAM 服务器。 下表显示了 ADAM 服务器的预期默认值。

构造函数

属性

方法

事件

适用于

另请参阅

• ASP.NET 成员资格简介
• 如何：在 ASP.NET 2.0 中使用成员身份