O Thunderbird pode consultar um diretório LDAP para encontrar pessoas enquanto você navega na Agenda de Endereços ou escreve um e-mail. A expressão "sincronização LDAP" pode ser enganosa: essa configuração conecta o Thunderbird a um diretório compartilhado para pesquisas; ela não cria uma cópia bidirecional e offline dos contatos. Se você precisar que as alterações nos contatos sejam sincronizadas entre dispositivos, pergunte ao seu administrador se o serviço oferece CardDAV ou outro método de sincronização compatível.
Antes de começar, obtenha os detalhes de conexão com o administrador do diretório. Não tente adivinhar a base de pesquisa nem desative a criptografia para estabelecer uma conexão. O acesso LDAP pode expor nomes de funcionários, endereços de e-mail e outros dados da organização; portanto, use apenas um servidor e uma conta aprovados.
O que você deve obter do administrador do seu diretório.
| Contexto | O que significa | Exemplo |
| Nome do host | O nome totalmente qualificado do servidor LDAP, acessível a partir do seu computador ou rede. | ldap.example.org |
| Porto e segurança | A porta e o modo de criptografia exigidos pelo serviço. Siga as instruções exatas do administrador. | A porta 636 para LDAPS é uma configuração comum. |
| DN base | O ponto de partida na árvore de diretórios para pesquisas. DN significa nome distinto. | ou=Pessoas,dc=exemplo,dc=org |
| Vincular DN ou nome de usuário | A identidade que o Thunderbird usa para autenticação. Alguns diretórios permitem buscas anônimas e não exigem uma identidade de autenticação. | uid=tb-search,ou=Service,dc=example,dc=org |
| Senha | A senha para a identidade vinculada, caso a autenticação seja necessária. | Fornecido pelo seu administrador |
| Escopo ou limites da pesquisa | Quaisquer restrições sobre quais entradas podem ser pesquisadas ou retornadas. | Pessoas em um departamento |
Os exemplos são meramente ilustrativos. Um DN base válido para uma organização pode não retornar resultados em outra. O administrador também deve confirmar se sua conta tem permissão para pesquisar o diretório e se o certificado do servidor é confiável para o seu dispositivo.
Adicione o diretório LDAP
- Abra a Agenda de Endereços do Thunderbird. Dependendo do seu sistema operacional e layout, use o botão Agenda de Endereços, o menu Ferramentas ou o atalho de teclado exibido no Thunderbird.
- Na janela Catálogo de Endereços, escolha o comando para adicionar um novo catálogo de endereços ou diretório e selecione a opção de diretório LDAP. Em algumas versões, o comando está em Arquivo > Novo > Diretório LDAP . Os nomes dos menus podem variar conforme a versão do Thunderbird.
- Insira um nome facilmente reconhecível, como "Diretório da Empresa", para que você possa distinguir este servidor das listas de endereços locais.
- Insira o nome do host e o DN base do servidor LDAP exatamente como fornecidos pelo administrador. Não insira um endereço de e-mail no campo Nome do host.
- Configure a porta e a opção de conexão segura para corresponder ao servidor. A página de ajuda do Mozilla descreve a porta 389 como padrão e a porta 636 quando a opção de conexão segura SSL está selecionada. Sua organização pode usar uma porta ou configuração de segurança diferente, portanto, as instruções da sua organização têm prioridade.
- Insira o DN ou nome de usuário do Bind, se necessário. Se a pesquisa anônima for explicitamente permitida, deixe os campos de autenticação em branco. Salve as configurações do diretório.
O Thunderbird pode solicitar uma senha na primeira pesquisa. Insira a credencial para a identidade de vinculação LDAP, e não a senha da sua conta de e-mail. Armazene-a somente se o seu dispositivo estiver protegido e sua organização permitir o armazenamento de credenciais.
Selecione o diretório para pesquisa de endereço
Adicionar um diretório o torna disponível para o Thunderbird; isso pode não habilitá-lo automaticamente para todas as contas de e-mail. Para usá-lo ao compor uma mensagem, abra as Configurações da Conta , selecione a conta e abra Composição e Endereçamento . Na configuração de pesquisa de endereço, escolha as preferências globais de LDAP ou selecione o diretório para essa conta. A documentação de ajuda da conta do Thunderbird explica essa configuração e o link para as Preferências Globais de Endereçamento. Se a sua versão usar um nome diferente, procure no painel Composição e Endereçamento da conta e nas preferências globais de Composição ou Endereçamento.
Para a configuração global, abra as Configurações ou Preferências do Thunderbird e encontre os controles de Composição/Endereçamento. Habilite a pesquisa de endereços por meio de um servidor de diretório, se essa opção estiver disponível, e selecione o diretório LDAP que você adicionou. Se a conta oferecer seu próprio seletor de diretório, marque cada conta que deve usar LDAP. Isso é importante quando você tem várias identidades de e-mail: uma conta pode usar um diretório corporativo enquanto outra usa apenas catálogos de endereços locais.
Teste a conexão antes de confiar no recurso de preenchimento automático.
- Abra a Agenda de Endereços e selecione o diretório LDAP.
- Pesquise um colega usando um nome ou um fragmento de e-mail que o administrador confirme ser a correspondência correta.
- Verifique se o resultado mostra a pessoa e o endereço esperados. Não assuma que um resultado em branco significa que o servidor está fora do ar; a base de pesquisa, as permissões ou as regras de pesquisa do diretório podem ser a causa.
- Abra uma nova mensagem e digite um nome ou endereço conhecido no campo do destinatário. Aguarde algumas sugestões e selecione a entrada desejada.
- Confirme o endereço preenchido antes de enviar. O recurso de autocompletar auxilia na busca, não garantindo que uma entrada antiga ou ambígua no diretório ainda esteja correta.
Problemas comuns e o que verificar
| Sintoma | Primeiras verificações |
| Nenhum resultado encontrado na Agenda de Endereços | Verifique o nome do host, a grafia do DN base, o acesso à rede ou VPN e as permissões de pesquisa. Pergunte se o diretório requer um filtro de pesquisa ou uma base de pesquisa diferente. |
| A solicitação de senha se repete ou a autenticação falha. | Confirme o formato do Bind DN e a senha com o administrador. Um nome de usuário curto, um login no estilo de e-mail e um nome distinto completo não são intercambiáveis em todos os servidores. |
| Tempo limite de conexão excedido | Verifique se o servidor está acessível a partir da sua rede atual e se a porta necessária está liberada pelo firewall. Uma VPN pode ser necessária. |
| Falha na conexão segura | Confirme se o serviço espera LDAP com TLS, LDAPS ou outro protocolo. Peça ao administrador para verificar o certificado do servidor e a cadeia de certificados; não ignore os avisos de certificado. |
| A busca no diretório funciona, mas o preenchimento automático não. | Verifique as configurações de Composição e Endereçamento da conta e as preferências de endereçamento global. Certifique-se de que o diretório correto esteja habilitado para a conta que você está usando. |
| Apenas algumas pessoas aparecem | O diretório pode restringir as entradas visíveis, o escopo da pesquisa, os atributos retornados ou a quantidade de resultados. Consulte o administrador do diretório sobre essas limitações antes de alterar as configurações do Thunderbird. |
Saiba o que essa conexão faz — e o que ela não faz.
LDAP é um protocolo para acessar informações de diretório. A conexão LDAP do Thunderbird com a agenda de endereços destina-se à consulta de entradas de diretório; não deve ser tratada como um editor ou um cliente completo de sincronização de contatos. Em muitas organizações, os usuários podem pesquisar contatos, mas não podem criar ou alterar registros de diretório. As edições de contatos devem ser feitas por meio do processo de gerenciamento de diretório aprovado pela organização.
Se o seu objetivo é manter uma agenda de contatos pessoal sincronizada entre o Thunderbird e um telefone ou outro computador, verifique se o seu provedor oferece suporte ao CardDAV. CardDAV e LDAP são serviços diferentes, embora ambos possam fornecer informações de contato. Escolha o protocolo que o servidor realmente suporta em vez de inserir detalhes do CardDAV nas configurações do LDAP.
Lista de verificação de configuração
- Você possui o nome do host, o DN base, a porta, o modo de segurança e os detalhes de autenticação aprovados pelo administrador.
- O diretório LDAP aparece na Agenda de Endereços do Thunderbird.
- Uma busca de teste retorna o contato esperado.
- A conta de e-mail correta está configurada para usar o diretório para pesquisa de endereços.
- Uma sugestão de destinatário de teste é exibida, e você pode verificar o endereço selecionado antes de enviar.
A documentação do catálogo de endereços LDAP da Mozilla descreve os campos do diretório e um exemplo do Active Directory; observa-se, porém, que a documentação está incompleta e que os rótulos dos menus podem refletir uma interface mais antiga. Para opções atuais de pesquisa de endereços em nível de conta, consulte as Opções de Configuração de Contas do Thunderbird . O protocolo e o contexto de autenticação são definidos na especificação do protocolo LDAP e na especificação de autenticação e segurança LDAP da IETF .