Capacidade

Conexão LDAP/AD

Seu diretório corporativo já existe; o TR7 AAM não copia o usuário, conecta-se ao LDAP/AD e transforma a pertinência a grupos em política de acesso.

O TR7 LDAP / AD Bind torna a infraestrutura de diretório existente da organização uma parte nativa do gerenciamento de acesso. Autenticação de usuário, pertinência a grupos, acesso condicional, MFA e o fluxo de auditoria unificam-se em uma única plataforma; a necessidade de gerenciar separadamente a conexão LDAP de cada aplicação diminui. O TR7 AAM oferece dois métodos de bind distintos. No modo direct-bind, o nome de usuário é convertido diretamente em uma operação de bind LDAP via UPN, NetBIOS, UID, CN ou um padrão personalizado. No modo search-bind, o usuário é primeiro procurado com uma conta de serviço e, com o DN encontrado, a própria senha do usuário é validada. A consulta de pertinência a grupos é transferida para a sessão AAM e pode ser usada em políticas de acesso condicional. Decisões como qual grupo pode acessar qual aplicação, qual usuário requer MFA, qual backend é aberto apenas a membros de determinada OU ou grupo são alimentadas pela informação de diretório. Resultado: o TR7 AAM tira a integração LDAP/AD da condição de configuração dispersa por aplicação; com transporte seguro, failover de múltiplos servidores, política baseada em grupos e auditoria centralizada, eleva-a à camada de acesso corporativa.

5
Templates de bind LDAP suportados: UPN, NetBIOS, UID, CN, Personalizado
3
Métodos de balanceamento de carga: roundrobin, weighted, failover
3
Componentes do filtro automático de search-bind: userPrincipalName, sAMAccountName, cn

Se o diretório corporativo é central, o acesso à aplicação também deve conectar-se de forma central à mesma fonte de identidade.

A maioria das organizações gerencia a identidade do usuário em um diretório LDAP ou AD. Quando uma nova aplicação entra em operação, a mesma pergunta surge novamente: como essa aplicação se conectará ao diretório, como autenticará o usuário, qual informação de grupo lerá e onde tomará a decisão de acesso? Se essa conexão for feita separadamente em cada aplicação, a arquitetura de identidade rapidamente se dispersa.

A integração LDAP por aplicação gera dívida operacional. Cada aplicação carrega sua própria conta de serviço, endereço de conexão, filtro de busca, valor de timeout e configuração de validação de certificado. Quando o esquema do diretório muda, a estrutura de OU é movida, a senha da conta de serviço é rotacionada ou ocorre uma migração de domínio, essa alteração se propaga para muitas aplicações.

Do lado da segurança, o risco também cresce. O uso de LDAP sem criptografia pode levar ao transporte desprotegido de senhas na rede. As senhas de contas de serviço ficam armazenadas nas configurações das aplicações. A autorização baseada em grupos, por sua vez, dispersa-se pelo próprio código das aplicações; autenticação e política de acesso são aplicadas em sistemas diferentes com regras diferentes.

A auditoria e a visibilidade também se fragmentam. A informação sobre qual aplicação se conectou ao diretório com qual conta de serviço, qual usuário foi autenticado, qual grupo foi consultado e qual acesso foi negado costuma ficar enterrada nos logs das aplicações. As equipes de SOC e auditoria são forçadas a juntar logs dispersos em vez de um fluxo de identidade central.

O TR7 LDAP / AD Bind resolve esse problema na plataforma de acesso: métodos direct-bind e search-bind, transporte seguro LDAPS, consulta de pertinência a grupos, filtro de bind restriction, failover de múltiplos servidores e a política de acesso condicional do AAM unificam-se em uma única arquitetura.

Nossa abordagem

O TR7 AAM trata a conexão LDAP/AD não apenas como validação de senha, mas como um fluxo de busca de usuário, consulta de grupos, transporte seguro e geração de política de acesso.

Direct-bind e search-bind oferecem dois modelos de validação distintos

O direct-bind converte o nome de usuário no valor de bind principal por UPN, NetBIOS, UID, CN ou um padrão personalizado. O search-bind, por sua vez, procura a informação de DN do usuário com uma conta de serviço e, em seguida, faz a validação de bind com a própria senha do usuário.

A consulta de pertinência a grupos torna-se decisão de acesso condicional

No modo search-bind, a busca de grupos pode ser habilitada e as pertinências a grupos do usuário são adicionadas à sessão AAM. Essa informação de grupo pode ser usada em decisões de acesso à aplicação, exigência de MFA ou autorização baseada em backend.

A conexão de diretório é protegida com transporte seguro LDAPS

O TR7 pode estabelecer uma conexão protegida por TLS via LDAPS. Ao configurar a validação de certificado e a política de certificado self-signed, o nível de segurança da conexão de diretório é definido de acordo com o padrão da organização.

Múltiplos servidores LDAP proporcionam failover e distribuição

Mais de um servidor LDAP/AD pode ser definido em uma única configuração. As conexões são distribuídas pelos métodos roundrobin, weighted ou failover; quando o servidor de diretório primário fica inacessível, um servidor alternativo pode ser acionado.

Capacidades

O LDAP / AD Bind conecta a validação de diretório corporativo ao fluxo AAM com templates de bind, filtros de busca, pertinência a grupos, transporte seguro e gerenciamento de múltiplos servidores.

O direct-bind adapta-se a diferentes estruturas de diretório com cinco templates de principal

No modo direct-bind, o nome de usuário é convertido no valor de bind principal por um dos templates UPN, NetBIOS, UID, CN ou custom. Em ambientes AD, os formatos UPN e NetBIOS são comuns; em diretórios OpenLDAP ou POSIX, os padrões UID e CN podem ser mais adequados. Com o padrão custom, é possível montar uma estrutura específica da organização como uid={{username}},ou=people,dc=company,dc=com. Essa flexibilidade facilita conectar diferentes esquemas de diretório a um único fluxo de validação AAM.

O search-bind primeiro procura o usuário e depois valida com a senha do usuário

No modo search-bind, o TR7 primeiro conecta-se ao diretório com uma conta de serviço e procura a informação de DN do usuário. Quando o usuário é encontrado, no segundo passo a operação de bind é feita com o DN e a senha do próprio usuário. Esse modelo é útil em ambientes em que os usuários estão em OUs diferentes, em que o DN não pode ser gerado diretamente a partir do nome de usuário ou em que se requer um filtro de busca mais controlado. A conta de serviço e a base DN de busca são gerenciadas de forma centralizada.

Com filtro de busca automático ou personalizado, a localização de usuário fica mais flexível

O filtro de search-bind no modo automático pode avaliar em conjunto os campos userPrincipalName, sAMAccountName e cn. No modo custom, o operador define seu próprio filtro LDAP; por exemplo, pode-se fazer uma busca mais restrita como (sAMAccountName={{username}}). Essa abordagem adapta-se a diferentes esquemas de diretório e formatos de nome de usuário. Para reduzir correspondências de usuário incorretas, o filtro deve ser definido o mais claramente possível.

Com o filtro de bind restriction, o acesso após um bind bem-sucedido é restringido

Mesmo que a senha do usuário esteja correta, pode não ser desejável que cada usuário do diretório acesse cada aplicação. Com o filtro de bind restriction, garante-se que apenas os usuários que satisfazem uma condição de OU, grupo ou atributo específica passem pelo fluxo de validação. Por exemplo, apenas os usuários do grupo VPN Users podem ser aceitos em determinado backend. Esse filtro avalia a autenticação em conjunto com o escopo de acesso.

A busca de pertinência a grupos adiciona sinal de política à sessão AAM

Quando ldapEnableGroupSearch está ativo, o TR7 pode consultar as pertinências a grupos usando o valor de DN do usuário. Com ldapGroupSearchBase e ldapGroupFilter define-se em qual região do diretório e com qual filtro os grupos serão procurados. A lista de grupos retornada é adicionada à sessão AAM. Os fluxos de acesso condicional podem tomar decisões diferentes de aplicação, MFA, permissão ou negação com base nessa informação de grupo.

A conexão LDAPS torna a validação de senha segura com TLS

Quando o LDAPS é usado, a conexão LDAP é protegida com TLS e tipicamente opera pela porta 636. O comportamento de validação do certificado do servidor pode ser configurado com ajustes como sslValidateCertificate e sslAllowSelfSigned. Em ambiente de produção, o LDAP sem criptografia não deve ser preferido. A segurança da conexão de diretório é um requisito fundamental para proteger dados sensíveis como a senha do usuário e a conta de serviço.

Os valores de timeout de conexão controlam respostas lentas do diretório

Os valores de timeout de conexão e de operação LDAP podem ser configurados. Se a conexão não puder ser estabelecida ou o servidor de diretório responder lentamente, o fluxo AAM não aguarda indefinidamente. Comportamento lento de domain controller em horários de pico ou latência de segmento de rede podem ser controlados com esses valores. As configurações de timeout devem ser planejadas em conjunto com a experiência do usuário e o comportamento de failover.

A sincronização da lista de usuários LDAP traz campos de perfil ao AAM

O TR7 pode buscar usuários sob uma base de busca específica e transferir valores de atributos como e-mail e telefone para o perfil de usuário local do AAM. Campos como queryMailField e queryPhoneField podem ser ajustados de acordo com o esquema da organização. Esse recurso ajuda no gerenciamento da lista de usuários e das informações de contato. Em ambiente de cluster, a busca da lista de usuários é restringida para rodar apenas no primary node.

Múltiplos servidores e failover tornam o acesso ao diretório resiliente

Mais de um servidor LDAP/AD pode ser definido no array hosts. O lbMethod pode ser selecionado como roundrobin, weighted ou failover. No modo failover, quando o servidor primário fica inacessível, ocorre a transição para o servidor alternativo. A abordagem de pool de conexões e circuit breaker reduz a chance de servidores continuamente falhos prejudicarem o fluxo.

A seleção de namespace proporciona acesso a diretórios em segmento de rede separado

Por qual namespace de rede se chegará ao servidor LDAP pode ser configurado. Isso é importante para domain controllers em segmento separado ou estruturas de diretório específicas de tenant. O tráfego de gerenciamento de acesso é transportado pela tabela de rotas correta e pelo isolamento de rede adequado. Em arquiteturas multi-tenant ou de data centers segregados, proporciona um controle de rede mais claro.

Profundidade operacional

O LDAP / AD Bind é operado em conjunto com o ciclo de vida da conexão, a segurança de filtros, a limpeza de conexões, o comportamento de search-bind, a restrição de cluster e a seleção de atributos.

01

Ciclo de vida do LdapManager

Quando as configurações LDAP são atualizadas, a informação de conexão é preparada novamente e o fluxo de validação roda com as novas configurações. A informação de conexão é gerada a partir dos parâmetros protocol, host, port, TLS e timeout. A aplicação das alterações de configuração dentro de um ciclo de vida centralizado garante consistência de configuração.

02

Escape de filtro LDAP

Antes de as entradas do usuário serem colocadas no filtro LDAP, os caracteres especiais são escapados. Valores como barra invertida, asterisco, parênteses e caractere nulo são escapados para reduzir o risco de LDAP injection. Esse comportamento é especialmente crítico em estruturas que usam filtro custom.

03

Limpeza de conexão

Depois de usada, a conexão LDAP tem o cliente limpo e os listeners removidos. Essa abordagem reduz conexões zombie e uso desnecessário de memória. O comportamento de keep-alive de longa duração deve ser usado apenas em modos especiais como a busca da lista de usuários.

04

Seleção de filtro de search-bind

O filtro de search-bind automático pode avaliar em conjunto os campos userPrincipalName, sAMAccountName e cn. No modo de filtro custom, o operador define seu próprio filtro LDAP. O filtro custom é poderoso; no entanto, como filtros incorretamente amplos podem levar a correspondências de usuário inesperadas, devem ser projetados com cuidado.

05

Pool de conexões

A estrutura de nova geração do pool do backend LDAP pode gerenciar as conexões de cliente LDAP com lógica de pool. Quando o LDAPS é selecionado, as opções de TLS são adicionadas ao estabelecimento da conexão. O tempo de DNS lookup personalizado e os valores de timeout de conexão ganham importância em redes lentas ou segmentadas.

06

Restrição de primary de cluster

A busca da lista de usuários é restringida para rodar apenas no primary node em ambiente de cluster. Esse comportamento impede que a mesma lista de usuários seja buscada simultaneamente por múltiplos nós e gere carga desnecessária. Já o fluxo de bind de autenticação continua funcionando de acordo com o modelo de conexão definido.

07

Seleção de atributos

Com o array ldapAttributes define-se quais campos retornam do diretório. Os campos padrão podem abranger valores como dn, cn, userPrincipalName, displayName, mail e telefone. Campos adicionais como department, employeeID ou atributos personalizados podem ser adicionados à lista conforme a necessidade da organização.

Em quais cenários é usado

Acesso AAM com identidade AD em toda a organização

Em uma grande organização, os funcionários acessam as aplicações via AAM com o nome de usuário e a senha AD existentes. As pertinências a grupos são transferidas para a política AAM; grupos de finanças, RH e TI podem ser direcionados a diferentes fluxos de aplicação ou MFA. Quando a política de senhas do AD muda, as aplicações não são atualizadas uma a uma.

Failover geográfico com múltiplos domain controllers

Em uma estrutura com dois domain controllers em dois data centers, o TR7 pode estabelecer conexão pelo método failover. Quando o servidor de diretório primário fica inacessível, ocorre a transição para o servidor alternativo. O fluxo de validação de usuário não fica dependente da falha de um único DC.

Restrição de acesso específica ao grupo de usuários VPN

Determinado backend pode ser aberto apenas aos usuários do grupo VPN Users. Mesmo que o bind seja bem-sucedido, o usuário que não passa pela condição bindRestrictionFilter é rejeitado. Assim, a validação de senha e a autorização de acesso à aplicação não são consideradas a mesma coisa.

Uso de UID bind com diretório OpenLDAP e POSIX

Organizações que usam OpenLDAP em vez de AD podem fazer a validação de usuário com os templates de bind UID ou CN. Em diretórios baseados em posixAccount, o mapeamento de e-mail, telefone e atributos personalizados pode ser transferido para o perfil AAM. Estabelecendo uma conexão segura com LDAPS, diretórios LDAP clássicos são incluídos no fluxo de acesso moderno.

Perguntas frequentes

Qual é a diferença fundamental entre direct-bind e search-bind?
O direct-bind converte o nome de usuário diretamente no valor de bind principal LDAP por UPN, NetBIOS, UID, CN ou um padrão personalizado; nenhum passo de busca adicional é necessário. O search-bind, por sua vez, primeiro conecta-se ao diretório com uma conta de serviço e procura a informação de DN do usuário, depois faz uma segunda operação de bind com o DN encontrado e a senha do usuário. O search-bind é mais adequado para ambientes em que os usuários estão em OUs diferentes ou em que o DN não pode ser gerado diretamente a partir do nome de usuário.
Como a informação de pertinência a grupos é usada na política de acesso?
Quando ldapEnableGroupSearch é habilitado, o TR7 consulta no diretório as pertinências a grupos do usuário cuja autenticação foi bem-sucedida. A lista de grupos retornada é adicionada à sessão AAM. Os fluxos de acesso condicional podem usar essa informação para determinar a qual aplicação será concedido acesso, se o MFA será obrigatório ou se o acesso a determinado backend será aprovado ou negado.
Para que serve o filtro de bind restriction?
O filtro de bind restriction condiciona o acesso a uma condição de diretório adicional, mesmo que a senha do usuário esteja correta. Por exemplo, quando se deseja que apenas usuários membros de uma OU ou grupo específico passem pelo fluxo de validação, esse filtro entra em ação. Essa abordagem cria uma camada extra de autorização ao avaliar a validação de senha no mesmo passo que o escopo de acesso.
Como o transporte seguro LDAPS é configurado?
Quando o valor de protocol é definido como ldaps, o TR7 estabelece uma conexão protegida por TLS tipicamente pela porta 636. Com sslValidateCertificate, a validação do certificado do servidor pode ser tornada obrigatória; já sslAllowSelfSigned determina se o uso de certificado self-signed será permitido. Em ambiente de produção, o uso de LDAP sem criptografia não é recomendado; a senha da conta de serviço e as credenciais do usuário não devem ser transportadas desprotegidas na rede.
Como múltiplos servidores LDAP/AD são definidos?
A configuração de múltiplos servidores é criada adicionando mais de uma entrada de servidor ao array hosts. Com o parâmetro lbMethod seleciona-se o método de balanceamento de carga roundrobin, weighted ou failover. No modo failover, quando o servidor primário fica inacessível, o TR7 transita automaticamente para o servidor alternativo. O mecanismo de pool de conexões e circuit breaker impede que servidores continuamente falhos afetem o fluxo.
A sincronização da lista de usuários roda apenas em um nó específico?
Sim. Em ambiente de cluster, a busca da lista de usuários roda apenas no primary node. Essa restrição impede que a mesma lista seja buscada simultaneamente por múltiplos nós e que se imponha carga desnecessária ao servidor de diretório. Já o fluxo de bind de autenticação continua funcionando em todos os nós do cluster de acordo com o modelo de conexão definido.

Torne seu diretório corporativo uma parte nativa do gerenciamento de acesso

Conexão LDAP/AD, política baseada em grupos, transporte seguro LDAPS e auditoria centralizada em uma única plataforma. Vamos guiá-lo por uma instalação ao vivo no seu próprio ambiente.