---
title: "Integração com LDAP (Preview)"
description: "Integração do LDAP com o GrantID como provedor de identidade externo no login em aplicações, com as configurações do servidor LDAP a informar (Preview)."
canonical: "https://docs.lacunasoftware.com/articles/grant-id/on-premises/ldap"
locale: "pt-BR"
product: "GrantID"
last_updated: "2026-10-12"
---

# Integração com LDAP (Preview)

##  Login em aplicações

Para usar o LDAP no login em aplicações, configure-o como um provedor de identidade externo (External Identity Provider), informando os dados de um ou mais servidores LDAP:

![Configurações do provedor externo LDAP](https://docs.lacunasoftware.com/images/grant-id/ldap-externalprovider.png)

* Friendly Name: um nome que identifica aquele servidor. Se os seus usuários entram informando o nome de usuário no formato `name\user`, o friendly name deve corresponder à parte
antes da barra invertida.
* Host: o nome do host ou o endereço IP do servidor que será usado nas conexões LDAP.
* Use custom port: permite definir uma porta personalizada para a conexão LDAP com este servidor.
* Enable SSL: use esta opção se a conexão LDAP precisar usar SSL. Se nenhuma porta for definida e esta opção estiver marcada, a aplicação usa a porta `636`; caso contrário, usa a `389`.
* User DN: o Distinguished Name (DN) da conta que será usada para consultar os usuários.
* User DN password: a senha da conta que será usada para consultar os usuários.
* Search Base DN: o Distinguished Name (DN) do container dos usuários que serão consultados.
* Search Filter (opcional): um filtro LDAP para localizar os usuários. Por padrão (se esta configuração não for informada), os usuários são consultados pelo User Principal Name (UPN) **ou** pelo SAM Account Name.
* Mobile Phone Attribute (opcional): define o atributo LDAP usado para obter o número de telefone do usuário.

Você também pode configurar este provedor com a opção de redirecionamento automático (auto redirect), para que os usuários não possam usar nenhum outro método de autenticação ao entrar. Se escolher essa opção, recomendamos
desabilitar o cadastro nas configurações da aplicação e também desabilitar a edição de perfil nas configurações da assinatura.

Depois de configurar o LDAP, habilite o provedor nas configurações da aplicação:

![Configurações da aplicação para LDAP](https://docs.lacunasoftware.com/images/grant-id/ldap-applicationsetting.png)

## Configuração dos usuários

Para que o processo de login seja concluído com sucesso, os usuários precisam ter as informações obrigatórias preenchidas nas suas contas.
A lista abaixo define as informações obrigatórias e quais atributos LDAP a aplicação usa para obtê-las.

* Nome: o nome do usuário na aplicação é determinado pelo atributo LDAP `displayName`.
* E-mail: o e-mail do usuário. Esta informação precisa ser única e é determinada pelo atributo LDAP `mail`.
* Telefone (opcional): por padrão, a aplicação consulta no usuário um atributo chamado `Mobile` para obter o número de celular dele.
O nome do atributo pode ser alterado com a configuração opcional do servidor `Mobile Phone Attribute`.