ActiveDirectoryMembershipProvider Classe

Definição

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

Herança

Object

ProviderBase

MembershipProvider

ActiveDirectoryMembershipProvider

Exemplos

Os exemplos de código a seguir mostram o arquivo Web.config para um aplicativo ASP.NET configurado para usar uma ActiveDirectoryMembershipProvider instância. O primeiro exemplo usa os mapeamentos padrão para atributos do Active Directory e não dá suporte à segurança de redefinição de senha com pergunta e resposta nem à capacidade de chamar métodos de pesquisa. O segundo exemplo mostra todas as configurações de atributo permitidas para uma ActiveDirectoryMembershipProvider instância.

O primeiro exemplo é um arquivo de configuração simples usando mapeamentos padrão para atributos do 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>  

Este exemplo mostra todas as configurações de atributo disponíveis para uma instância do 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 e serverSearchTimeout o padrão é minutos. Para alterar as unidades, defina o valor do timeoutUnit atributo como um de "Dias", "Horas", "Minutos", "Segundos" ou "Milissegundos". Se o atributo não for especificado, o padrão será "Minutos".

Comentários

Essa classe é usada pelas Membership classes e MembershipUser para fornecer serviços de associação para um aplicativo ASP.NET usando um servidor AD (Active Directory) ou ADAM (Modo de Aplicativo do Active Directory).

Você deve criar uma entrada connectionStrings Element (ASP.NET Settings Schema) no arquivo Web.config que identifica o servidor do Active Directory, o domínio do Active Directory ou a partição de aplicativo ADAM a ser usada. O provedor só funcionará no escopo do domínio ou em um subescopo dentro de um domínio. A tabela a seguir lista as cadeias de conexão permitidas e o escopo usado.

A ActiveDirectoryMembershipProvider instância mapeia atributos de diretório para ActiveDirectoryMembershipUser propriedades. Os atributos padrão serão usados se nenhum mapeamento de atributo for feito no arquivo Web.config. Para obter mais informações sobre mapeamentos de atributo, consulte as propriedades individuais na documentação da ActiveDirectoryMembershipUser classe.

A tabela a seguir lista as ActiveDirectoryMembershipUser propriedades e seus mapeamentos de atributo padrão.

Quando as RequiresQuestionAndAnswer propriedades e EnablePasswordReset são true, a ActiveDirectoryMembershipProvider classe dá suporte à segurança de redefinição de senha exigindo que o usuário responda a uma pergunta predeterminada. Para dar suporte à pergunta e resposta, você deve definir os seguintes atributos de configuração usando o elemento add para provedores para associação (ASP.NET Esquema de Configurações) no arquivo de configuração do aplicativo.

Para obter mais informações sobre como usar a segurança de redefinição de senha, consulte a RequiresQuestionAndAnswer propriedade .

Conexões do Active Directory

Quando a ActiveDirectoryMembershipProvider classe é usada para se conectar a um servidor do Active Directory ou do ADAM (Modo de Aplicativo do Active Directory), o connectionProtection atributo definido usando o elemento add para provedores para associação (ASP.NET Esquema de Configurações) no arquivo de configuração do aplicativo pode restringir os tipos de operações que a ActiveDirectoryMembershipProvider classe pode executar na conexão. O connectionProtection atributo também determina os métodos que a ActiveDirectoryMembershipProvider instância usará para criar a conexão com o servidor Active Directory ou ADAM.

A tabela a seguir mostra o efeito do connectionProtection atributo ao se conectar a um Active Directory.

A tabela a seguir mostra o efeito do connectionProtection atributo ao se conectar a um servidor ADAM.

Configuração de ADAM

Ao usar um servidor ADAM, a instância ADAM deve conter um esquema que defina a User classe . Você pode importar a User classe com uma importação LDIF do MS-User.ldf arquivo disponível no diretório de instalação do ADAM.

A ActiveDirectoryMembershipProvider classe funcionará com um servidor ADAM configurado para usar as portas de rede padrão. A tabela a seguir mostra os padrões esperados para o servidor ADAM.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Introdução à associação ASP.NET
• Como usar a associação no ASP.NET 2.0