Integração com Active Directory

Visão geral

A integração com o Active Directory (AD) conecta o Cloud PABX da Virtual-Call ao Microsoft Active Directory local da sua organização. Após a configuração, ela realiza a sincronização unidirecional de usuários, unidades organizacionais e grupos do AD para o PABX — criando e gerenciando ramais automaticamente e permitindo que os usuários sincronizados façam login no cliente UC da Virtual-Call com suas credenciais de domínio do AD.

Esta integração é ideal para organizações que utilizam um ambiente Active Directory local no Windows Server e desejam gerenciar os usuários do sistema telefônico de forma centralizada, sem necessidade de duplicar entradas de dados.

O que a integração oferece

• Sincronização de usuários: Usuários, unidades organizacionais (OUs) e grupos do Active Directory são sincronizados para o Cloud PABX. Os ramais são criados e atribuídos automaticamente para os usuários sincronizados.
• Gerenciamento automático de ramais: Quando um novo usuário é adicionado ao Active Directory, seu ramal no PABX é criado automaticamente. Quando um usuário é removido ou desativado no AD, seu ramal pode ser excluído automaticamente.
• Login com conta de domínio AD: Os usuários sincronizados podem fazer login no cliente UC da Virtual-Call usando suas credenciais de domínio AD, sem precisar de uma senha separada do PABX.
• Sincronização unidirecional: Alterações feitas no Active Directory (nome, e-mail, unidade organizacional) são refletidas automaticamente no PABX no próximo ciclo de sincronização.

Pré-requisitos

• Um ambiente Active Directory no Windows Server acessível pela internet (ou por meio de um túnel seguro)
• Uma conta de domínio AD com acesso de leitura ao diretório — as credenciais da conta devem ser inseridas como Distinguished Name (DN) ou User Principal Name (UPN)
• A conta AD deve ter permissões suficientes para ler informações de usuários, grupos e OUs no escopo de diretório desejado
• Acesso de administrador ao portal web do Cloud PABX da Virtual-Call

Visão geral da configuração

A integração é configurada inteiramente no portal web do Cloud PABX. Você precisará dos dados de conexão do controlador de domínio do seu Active Directory.

Parte 1: Conectar o PABX ao Active Directory

1. Faça login no portal web do Cloud PABX como administrador.
2. Acesse Integrações > Active Directory.
3. Insira os dados de conexão do seu AD:
   • Endereço do servidor: O endereço IP ou nome de host do seu controlador de domínio AD
   • Porta: Geralmente 389 (LDAP) ou 636 (LDAPS, para conexões criptografadas)
   • Nome de usuário: O Distinguished Name (DN) ou User Principal Name (UPN) da conta AD utilizada para acesso ao diretório (ex.: CN=svc-pbx,OU=ContasDeServico,DC=empresa,DC=com,DC=br)
   • Senha: A senha da conta acima
   • DN Base: O ponto de partida na árvore de diretórios para o escopo de sincronização (ex.: DC=empresa,DC=com,DC=br)
4. Clique em Testar conexão para verificar se o PABX consegue alcançar o servidor AD e autenticar com sucesso.
5. Clique em Salvar.

Parte 2: Configurar o escopo de sincronização

1. Em Sincronização de usuários, especifique quais usuários serão importados:
   • Todos os usuários: Sincronizar todos os usuários encontrados abaixo do DN Base
   • OUs ou grupos específicos: Limitar a sincronização a uma ou mais unidades organizacionais ou grupos de segurança
2. Configure a Regra de atribuição de ramal para definir como os números de ramal do PABX são atribuídos aos usuários sincronizados (ex.: numeração sequencial automática, ou mapeamento a partir de um atributo AD).
3. Opcionalmente, configure a opção Exclusão automática para remover automaticamente o ramal de um usuário quando ele for desativado ou excluído no Active Directory.
4. Clique em Salvar.

Parte 3: Executar a primeira sincronização

1. Clique em Sincronizar agora para iniciar a sincronização inicial.
2. O PABX se conectará ao Active Directory, recuperará os usuários configurados e criará seus ramais.
3. Revise o log de sincronização para confirmar que todos os usuários foram importados corretamente.

Após a sincronização inicial, as sincronizações subsequentes ocorrem automaticamente em intervalos regulares. As alterações no Active Directory serão refletidas no PABX conforme necessário.

Login com conta de domínio AD no Cliente UC

Assim que os usuários forem sincronizados, eles poderão utilizar sua conta de domínio AD para fazer login no cliente UC da Virtual-Call:

• Na tela de login do cliente UC, selecione Login com conta de domínio (ou similar, dependendo da versão do cliente).
• Insira o nome de usuário AD (formato UPN, ex.: usuario@empresa.com.br) e a senha do AD.
• O PABX autenticará as credenciais no Active Directory e realizará o login do usuário.

Novas Funcionalidades a partir da Versão 84.23.0.24

Sincronização de Avatar

Um novo campo de mapeamento Avatar está disponível na configuração de sincronização. Quando ativado, os avatares dos usuários são sincronizados automaticamente do Microsoft Active Directory para os ramais do PABX.

Edição Direta de Ramais Sincronizados

As informações de ramal dos usuários sincronizados agora podem ser editadas diretamente no PABX. Se você desativar o mapeamento de campos específicos, as informações correspondentes não serão mais sincronizadas e podem ser ajustadas manualmente.

Solução de problemas

• O teste de conexão falha.
  Verifique o endereço do servidor, a porta e as credenciais da conta. Certifique-se de que o controlador de domínio AD está acessível a partir do PABX (verifique as regras de firewall). Se estiver utilizando LDAPS (porta 636), certifique-se de que o certificado SSL do servidor é válido.
• Apenas alguns usuários são sincronizados.
  Verifique o DN Base e a configuração do escopo de sincronização. Usuários fora do UO ou grupo especificado não serão incluídos. Confirme que a conta de serviço tem acesso de leitura a todas as OUs relevantes.
• Os ramais não estão sendo criados automaticamente.
  Revise a configuração da regra de atribuição de ramal. Certifique-se de que há números de ramal disponíveis no intervalo configurado.
• O login com conta de domínio AD falha para os usuários.
  Certifique-se de que a conta AD do usuário está ativa e não está bloqueada. Confirme que o formato UPN está sendo utilizado para login. Verifique se o usuário foi sincronizado com sucesso (visível na lista de usuários do PABX).