O MyQ X sincroniza usuários do Active Directory (AD) utilizando o protocolo LDAP. A sincronização importa contas de usuário e associações a grupos, mantém-nas atualizadas à medida que o diretório sofre alterações e mapeia os atributos do diretório dos quais dependem a autenticação de tarefas e o login no terminal.
Orientações sobre quando utilizar esta fonte são fornecidas no Guia de Implantação. Consulte User Synchronization.
Consulte também:
Pré-requisitos
-
Um controlador de domínio do Active Directory acessível a partir do servidor MyQ via LDAPS (recomenda-se a porta 636) ou LDAP (porta 389).
-
Uma conta de serviço no AD com acesso somente leitura restrito às unidades organizacionais que você pretende sincronizar. Não é necessário acesso de gravação nem privilégios elevados no domínio.
-
Se estiver utilizando LDAPS (recomendado), o certificado da CA raiz emissora deve estar instalado no armazenamento de certificados do Windows no servidor MyQ para que ele possa verificar o certificado do AD. Em ambientes gerenciados, isso já pode estar sendo tratado pela Política de Grupo.
-
O DNS resolve corretamente o domínio do AD a partir do servidor MyQ.
Considerações importantes
Teste a detecção de tarefas antes de configurar a sincronização. O MyQ sempre mapeia o `sAMAccountName` para o campo de nome de usuário para usuários sincronizados via LDAP – isso não pode ser alterado. Se a detecção de tarefas retornar um valor diferente, mais comumente o `userPrincipalName` em ambientes com dispositivos associados ao Entra ID ou em configuração híbrida, a correspondência falhará, a menos que esse valor também esteja presente como um alias. Envie um trabalho de teste a partir de uma conta que ainda não exista no MyQ e verifique a entrada no log de descarte (Job discarded. User "x" not found.) – o valor entre aspas é exatamente o que sua sincronização deve inserir no campo de nome de usuário ou alias. Consulte Understanding Job Detection.
Campos com vários valores exigem transformação. Alguns ambientes armazenam vários identificadores — um número de cartão de identificação e um número pessoal, por exemplo — em um único atributo do AD, separados por um delimitador. O MyQ oferece suporte à transformação por expressões regulares nas configurações da fonte de sincronização para analisar esses valores. Consulte Transformar dados do usuário com RegEx.
Ambientes com vários domínios exigem a adição do domínio. Se usuários de vários domínios do AD forem sincronizados para a mesma instalação do MyQ, o mesmo sAMAccountName pode existir em mais de um domínio. Habilite a opção Anexar o nome do domínio ao nome de usuário em cada fonte de sincronização LDAP para gerar nomes de usuário exclusivos no formato username@domain. Para que a autenticação de tarefas funcione corretamente, o domínio também deve estar presente na tarefa de impressão. Consulte Multi-domain and Multi-tenant Environments.
A extensão do esquema é irreversível. Caso pretenda utilizar atributos personalizados de extensão do esquema para proteger valores confidenciais, como números de cartão ou PINs, teste a alteração no esquema em um ambiente de laboratório antes de aplicá-la à produção. Atributos personalizados adicionados ao esquema do AD não podem ser removidos.
Configure o servidor de autenticação
Acesse MyQ > Configurações > Servidores de autenticação e adicione um novo servidor LDAP para o domínio do AD. Defina a segurança como SSL e a porta como 636.
Caso seja utilizada uma conta de serviço de subdomínio, especifique o subdomínio no campo de nome de usuário. Por exemplo, se a conta Administrator reside em cz.testAD.local, mas se conecta a testAD.local, insira Administrator@cz.testAD.local.
Veja também: Configurações dos servidores de autenticação
Configure a fonte de sincronização
Acesse Configurações > Sincronização de usuários, clique em +Adicionar e selecione Adicionar fonte LDAP.
Para obter a referência completa de configuração, consulte Sincronização de usuários do LDAP. A seguir, abordamos os aspectos específicos do Active Directory.
Mapeamento padrão de atributos
O MyQ aplica esses mapeamentos padrão automaticamente para fontes do Active Directory. Todas as demais propriedades não possuem valor padrão e devem ser configuradas explicitamente.
|
Propriedade do MyQ |
Atributo padrão do AD |
|---|---|
|
Nome de usuário |
|
|
Nome completo |
|
|
|
|
Propriedades comumente configuradas explicitamente para o AD:
|
Propriedade do MyQ |
Atributo do AD |
Notas |
|---|---|---|
|
Alias |
|
Mapeie aqui se a detecção de tarefa retornar UPN em vez d |
|
Alias |
|
Mapeie aqui se a detecção de tarefa retornar identificadores no formato de e-mail. |
|
Número pessoal |
|
Útil para emparelhar usuários entre fontes de sincronização, inclusive durante a migração de AD para Entra ID. |
|
Cartão |
Personalizado ou |
Analise a proteção de atributos confidenciais antes de habilitar – consulte Considerações de segurança. |
|
PIN |
Personalizado ou |
A mesma consideração que para o cartão. |
|
Armazenamento do usuário |
|
Habilita o recurso “Impressão Fácil a partir de” e “Digitalização Fácil para” a pasta pessoal do usuário em terminais incorporados. |
Executar e agendar a sincronização
Para executar a sincronização imediatamente, acesse MyQ > Configurações > Sincronização de usuários, selecione a fonte e clique em Sincronizar agora. Se configurado corretamente, os usuários e grupos sincronizados aparecerão em MyQ > Usuários.
Para sincronizar automaticamente de acordo com uma programação, acesse MyQ > Configurações > Agendador de Tarefas e configure a tarefa “Sincronização de Usuários”.
Considerações de segurança
Utilize LDAPS
Todas as comunicações LDAP entre o MyQ e o AD devem utilizar LDAPS (LDAP sobre SSL/TLS) ou StartTLS. O LDAP simples transmite credenciais e dados do diretório em texto não criptografado. O uso do LDAPS pode ser exigido nas configurações do Servidor de Autenticação no MyQ.
Proteja atributos confidenciais do diretório
Por padrão, os atributos padrão do AD são legíveis por qualquer usuário autenticado do domínio. Se números de cartões de identificação, PINs ou outros identificadores confidenciais estiverem armazenados no AD e forem sincronizados com o MyQ, marque esses atributos como confidenciais antes de ativar a sincronização. Atributos confidenciais restringem o acesso de leitura a contas de administrador especificadas – a conta de serviço utilizada pelo MyQ para sincronização receberia acesso de administrador.
Para uma proteção mais robusta, armazene valores confidenciais em atributos de extensão de esquema personalizados, em vez de atributos padrão. A enumeração de atributos personalizados é menos previsível, e eles também podem ser marcados como confidenciais.
Aplique o princípio do privilégio mínimo à conta de serviço de sincronização
A conta de serviço utilizada para a sincronização LDAP deve ter acesso somente de leitura restrito às unidades organizacionais que estão sendo sincronizadas. Caso sejam utilizados atributos confidenciais, a conta de serviço deve receber explicitamente acesso de administrador apenas a esses atributos.