Passo 19
Ligar o cadastro de pessoas ao Active Directory: conexão, política de sincronização e departamentos
Em cliente com Active Directory, na implantação — antes de cadastrar pessoas à mão. Com o AD ligado, o RH continua cadastrando onde já cadastra, e o sistema acompanha.
Antes de começar
- O endereço do controlador de domínio e se ele aceita LDAPS (porta 636)
- Um usuário de serviço do domínio, só com permissão de leitura — nunca a conta de um administrador
- A Base DN do domínio e, se não forem todos, a OU ou o grupo de quem deve entrar
- Os departamentos do sistema já criados (guia Árvore de departamentos), para mapear os do AD
Passo a passo
- 01
Em Integrações, no grupo Identidade e Diretório, abra o Active Directory. É aqui que o cadastro de pessoas passa a seguir o domínio do cliente.
- 02
O servidor é o controlador de domínio, pelo nome ou pelo IP.
dc01.empresa.local - 03
Ligue o LDAPS sempre que o domínio aceitar. Sem ele, a senha do usuário de serviço trafega pela rede sem proteção. A porta muda para a 636.
- 04
O usuário de serviço é uma conta do domínio só para isto, com permissão de leitura. Não use a conta de um administrador: o sistema só precisa ler, e uma conta de leitura não faz estrago se vazar.
svc.avyd@empresa.local - 05
A senha fica guardada cifrada. Depois de salva, o campo aparece vazio: preencha só se for trocá-la.
- 06
A Base DN diz de onde o sistema começa a procurar. Com o domínio inteiro, entra todo mundo que é pessoa no AD.
DC=empresa,DC=local - 07
O filtro extra é opcional e serve para restringir: só um grupo, só uma OU. Num cliente com terceirizados no mesmo domínio, é ele que separa quem entra no cadastro.
- 08
Teste a conexão antes de qualquer outra coisa. Ele confere servidor, usuário e senha, e diz quantas contas enxergou — se o número não bate com o esperado, a Base DN ou o filtro estão errados.
Se o teste falha, a mensagem diz se o problema é rede, certificado do LDAPS ou credencial. Não adianta seguir antes de passar aqui.
- 09
Com o teste aprovado, salve a conexão. Este é o único Salvar da tela: dali para baixo, cada opção da política grava sozinha no momento em que você a muda.
- 10
Agora a política — e repare que ela não tem botão de salvar: cada opção vale assim que é mudada. Importar novas contas automaticamente faz quem é criado no AD virar pessoa no sistema na próxima sincronização, já no departamento certo.
- 11
AD é a fonte da verdade quer dizer que nome, e-mail, telefone e departamento passam a acompanhar o domínio. O RH manda no cadastro: uma correção feita à mão aqui é sobrescrita na sincronização seguinte.
- 12
Pedir a foto pela própria pessoa manda a cada importado o link para enviar o próprio rosto. É útil na implantação, mas ligue sabendo: sai uma mensagem para cada pessoa importada. Por isso ela fica desligada aqui.
- 13
Conta desativada ou apagada no AD: o recomendado é expirar o acesso. É o que faz o crachá de quem saiu da empresa parar de abrir a catraca no mesmo dia em que o RH desliga a conta.
- 14
No mapeamento, cada departamento do AD — pelo atributo Departamento ou por um trecho da OU — aponta para um departamento do sistema. Quem não casar com nenhum vai para o departamento padrão; com o padrão em Nenhum, essa conta não entra.
- 15
A sincronização roda sozinha uma vez por dia, na hora marcada aqui. Escolha um horário de pouco movimento. Com isso a integração está pronta; as contas em si se carregam e se vinculam no guia de importar contas do AD.
Vídeo em produção
Narrado pelo Max, com legenda. Enquanto isso, o passo a passo ao lado é o mesmo do vídeo.
Como conferir
Clique em Sincronizar Agora e abra o Histórico de sincronizações, no fim da página: a linha nova mostra quantos foram criados, atualizados e desativados. Depois abra Pessoas e confira se os importados estão nos departamentos mapeados.
Se der errado
- Testar Conexão falha
- Leia a mensagem: se é tempo esgotado, a rede não chega ao controlador de domínio; se fala em certificado, o LDAPS não confia no certificado do domínio; se fala em credencial, o usuário ou a senha estão errados — no formato usuario@dominio ou DOMINIO\usuario.
- O teste passa, mas vem gente demais ou de menos
- É a Base DN ou o filtro extra. Uma Base DN mais específica (a OU de colaboradores) ou um filtro por grupo resolve.
- Corrigi o nome de alguém e a correção sumiu
- Com AD é a fonte da verdade ligado, o domínio sobrescreve o cadastro na sincronização. A correção tem de ser feita no AD.
- Importados caíram todos no mesmo departamento
- Falta mapeamento: quem não casa com nenhuma regra vai para o departamento padrão. Confira se o valor do mapeamento é exatamente o texto do campo Departamento no AD.