MyQ X Server
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish

Sincronização de usuários do LDAP

O MyQ X pode sincronizar usuários a partir de qualquer serviço de diretório compatível com LDAP. As fontes compatíveis incluem Active Directory, OpenLDAP, Novell, Google Workspace e Microsoft Entra ID Domain Services (via LDAPS). O MyQ pode se comunicar com até cinco servidores LDAP simultaneamente.

Este artigo descreve as configurações comuns a todas as fontes de sincronização LDAP. Para a preparação do diretório e requisitos específicos de cada fonte, consulte:

O OpenLDAP e o Novell utilizam a configuração LDAP comum descrita aqui. A sincronização com o Lotus Domino é suportada apenas para implantações legadas e deve ser habilitada explicitamente.

Para a sincronização do Microsoft Entra ID por meio do Microsoft Graph, consulte Sincronização de usuários do Microsoft Entra ID.


Pré-requisitos

  • Prepare o escopo do diretório, os mapeamentos de atributos, os grupos, a conta do diretório e a conexão de rede.

  • Configure o servidor LDAP em MyQ > Configurações > Servidores de autenticação.

  • Verifique se o MyQ consegue se conectar ao servidor LDAP.

  • Para LDAPS, verifique se o certificado do diretório é considerado confiável pelo servidor MyQ.

Recomenda-se o uso do LDAPS, pois ele protege as credenciais do diretório e os dados em trânsito. Ele geralmente utiliza a porta TCP 636. Utilize outro modo de segurança ou porta somente quando for compatível com o diretório e permitido pela política de segurança da sua organização.

Para obter orientações sobre a preparação, consulte Prepare for LDAP User Synchronization.

Crie uma fonte de sincronização LDAP

  1. Acesse MyQ > Configurações > Sincronização de usuários.

  2. Clique em +Adicionar.

  3. Selecione Adicionar fonte LDAP.

O painel de propriedades de sincronização LDAP é exibido.

  1. Configure a sincronização nas guias Geral, Usuários e Grupos.

  2. Salve as configurações em cada guia após fazer as alterações.

Após o salvamento, a fonte aparece na lista de fontes de sincronização.



Guia Geral

Fonte de sincronização LDAP, guia Geral, com parâmetros de conexão e Exportar para CSV após importação bem-sucedida

Utilize a guia Geral para selecionar o servidor LDAP e fornecer a conta que o MyQ utiliza para consultá-lo.

Configuração

Descrição

Ativado

Ative ou desative esta fonte de sincronização.

Servidor LDAP

Selecione o servidor LDAP adicionado como servidor de autenticação.

Usuário

Nome de usuário para acesso ao servidor LDAP.

Senha

Senha da conta de serviço.

Exportar para CSV após importação bem-sucedida

Quando ativada, o MyQ gera um arquivo CSV com os usuários importados após cada execução da sincronização.

Arquivo

Caminho do arquivo utilizando os parâmetros %app% e %datetime%, por exemplo, %app%\Data\Export\Users_LDAP_%datetime%.csv.

Utilize um formato de nome de usuário aceito pelo diretório. Se a conta pertencer a um subdomínio, pode ser necessário um nome de usuário qualificado pelo domínio. Por exemplo:

Administrator@cz.example.local

Após o salvamento de parâmetros de conexão válidos, o navegador LDAP é aberto no lado direito do painel. Utilize-o para navegar pelo diretório e arrastar objetos ou atributos do diretório para os campos nas guias Usuários e Grupos.


Guia “Usuários”

users-settings-sync-ldap-users.png


Utilize a guia Usuários para definir quais usuários serão importados, mapear atributos do diretório para propriedades do MyQ e controlar como os usuários existentes do MyQ serão atualizados.

DN de base

Adicione um ou mais DNs de base a partir dos quais o MyQ deve procurar usuários.

Para adicionar um DN de base:

  1. Clique em +Adicionar.

  2. Insira o nome distinto ou arraste o objeto de diretório desejado do navegador LDAP para o campo.

Por exemplo:

OU=Prague,DC=example,DC=com

É possível utilizar vários DNs de base para importar usuários de unidades organizacionais ou ramos de diretório distintos.

O DN de base correto depende da estrutura do diretório e do servidor LDAP. Em configurações nas quais as pesquisas devem começar na raiz do diretório, o DN de base pode ser deixado em branco.

Propriedades

Mapeie atributos LDAP para propriedades de usuário do MyQ. Para atribuir um atributo, digite seu nome no campo de propriedade ou arraste-o do navegador LDAP e solte-o no campo. Quando existe um mapeamento padrão, ele é aplicado automaticamente – a propriedade “Nome de usuário” é a única que não pode ser alterada.

users-settings-sync-ldap-users-properties.png

Propriedade do MyQ

Mapeamento padrão

Observações

Nome de usuário

sAMAccountName para o Active Directory

O mapeamento do nome de usuário é determinado pelo tipo de fonte LDAP e não pode ser alterado.

Nome completo

cn para o Active Directory e o OpenLDAP


E-mail

e-mail para o Active Directory e o OpenLDAP


Alias

Nenhum

Aceita vários valores separados por vírgulas.

Número pessoal

Nenhum

Pode ser usado para associar uma identidade importada a um usuário existente do MyQ.

Cartão

Nenhum

Aceita vários valores separados por vírgulas. O comportamento da sincronização é configurável.

PIN

Nenhum

Aceita vários valores separados por vírgulas. O comportamento de sincronização é configurável.

Idioma

Nenhum

Mapeie um atributo que contenha abreviações de idiomas suportados, como en ou de.

Armazenamento do usuário

Nenhum

Destino de armazenamento associado ao usuário.

Observações

Nenhuma


As propriedades Alias, Cartão e PIN suportam vários valores separados por vírgulas. Por exemplo:

alias1,alias2,alias3

Nomes de atributos que contenham ponto-e-vírgula, como email;x-private, são suportados a partir do Print Server 10.2, patch 24. Em versões anteriores, um ponto-e-vírgula no nome de um atributo pode impedir que esse atributo seja sincronizado.

O uso de ponto-e-vírgula para separar vários valores foi descontinuado a partir do patch 24. Utilize vírgulas em seu lugar.

Sincronização de Cartão e PIN

Para as propriedades Cartão e PIN, selecione como a sincronização afeta os valores já armazenados no MyQ.

Modo

Comportamento

Não sincronizar

Não altera os valores existentes no MyQ.

Sincronização completa

Substitui os valores existentes pelos valores do diretório. Os valores existentes são removidos se o valor correspondente no diretório estiver vazio.

Sincronizar se não estiver vazio

Substitui os valores existentes somente quando o diretório fornecer um valor. Os valores existentes permanecem quando o valor do diretório estiver vazio.

Adicionar novo

Adiciona novos valores do diretório sem substituir ou remover os valores existentes.

Escolha o modo de acordo com se o diretório ou o MyQ é a fonte de referência para cartões e PINs.

Opções

users-settings-sync-ldap-users-options.png

Opção

Descrição

Desativar usuários ausentes

Desativa usuários importados anteriormente desta fonte quando eles não estiverem mais presentes nos resultados da sincronização.

Adicionar novos usuários

Importa novos usuários do diretório. Quando desativada, a sincronização atualiza os usuários correspondentes no MyQ, mas não cria contas.

Converter nome de usuário para letras minúsculas

Converte os nomes de usuário importados para letras minúsculas, evitando que contas separadas no MyQ sejam criadas apenas devido a diferenças entre maiúsculas e minúsculas.

Usar servidor de autenticação

Atribui o servidor LDAP de origem como servidor de autenticação para os usuários sincronizados. A autenticação por nome de usuário e senha é então realizada no LDAP, em vez de no banco de dados do MyQ.

Emparelhar pelo número pessoal

Utiliza um número pessoal sincronizado para associar uma identidade do diretório a uma conta MyQ existente. Isso permite que a conta existente seja mantida quando seu nome de usuário for alterado.

Ignorar fonte de sincronização

Permite que esta fonte considere e atualize usuários correspondentes, independentemente de qual fonte os tenha criado ou importado originalmente.

Anexar o nome de domínio ao nome de usuário

Armazena nomes de usuário em um formato qualificado por domínio, como username@domain.local. Utilize essa opção quando os domínios contiverem nomes de usuário que se sobreponham ou quando uma identidade qualificada por domínio for exigida por outros recursos.

Emparelhar pelo número pessoal

Utilize o recurso Emparelhar pelo número pessoal quando um número pessoal estável deva identificar a mesma pessoa após a alteração de seu nome de usuário.

Por exemplo, se o nome de usuário no diretório mudar de cat.stevens para yusuf.islam, o MyQ poderá atualizar a conta existente em vez de criar outra conta, desde que ambas as identidades tenham o mesmo número pessoal exclusivo.

Antes de ativar esta opção, confirme se os números pessoais estão:

  • Preenchidos para todos os usuários relevantes

  • Exclusivos em todo o escopo de sincronização

  • Estáveis ao longo de todo o ciclo de vida do usuário

  • Nunca sejam reatribuídos a outra pessoa

Ignorar fonte de sincronização

Por padrão, uma fonte de sincronização atualiza os usuários associados a essa fonte. Se outra fonte já possuir um nome de usuário ou alias correspondente, o MyQ poderá relatar um conflito em vez de atualizar esse usuário.

Ative a opção Ignorar fonte de sincronização quando a sincronização atual precisar atualizar usuários correspondentes, independentemente de sua fonte de sincronização original.

Isso pode ser útil durante migrações ou quando várias fontes gerenciam intencionalmente o mesmo conjunto de usuários. No entanto, isso altera o escopo dos usuários que a sincronização pode afetar.

Utilize a opção Ignorar fonte de sincronização juntamente com Desativar apenas usuários ausentes somente quando a fonte LDAP atual for autoritativa para todos os usuários afetados. Com ambas as opções ativadas, os usuários importados ou criados por meio de outras fontes poderão ser desativados caso estejam ausentes dos resultados LDAP atuais.

Filtro

Utilize um filtro LDAP para restringir quais objetos do diretório serão importados. Se o campo estiver vazio, o MyQ aplica o filtro padrão para o tipo de fonte LDAP selecionado.

users-settings-sync-ldap-users-filter.png

Exemplo de filtro

Corresponde a

(objectClass=*)

Todos os objetos.

(&(objectCategory=person)(objectClass=user)(!(cn=andy)))

Todos os objetos de usuário, exceto andy.

(sn=sm*)

Todos os objetos cujo sobrenome comece com sm.

(&(objectCategory=person)(objectClass=contact)((sn=Smith)(sn=Johnson)))

Objetos de contato cujo sobrenome seja Smith ou Johnson.

O curinga * pode ser usado com atributos de tipo string. Atributos de nome distinto, como memberOf, não suportam correspondência parcial com curinga e devem ser comparados usando o valor completo.

Por exemplo:

(memberOf=CN=Print Users,OU=Groups,DC=example,DC=com)

Escapar caracteres especiais

Quando um caractere especial fizer parte do valor de um atributo, e não da sintaxe do filtro LDAP, faça a escape da seguinte forma:

Caractere

Forma escapada

\

\5c

;

\3b

*

\2a

(

\28

)

\29

Null

\00

Transformação

Uma transformação de expressão regular pode analisar ou reformatar valores do diretório antes que o MyQ os armazene.

Utilize transformações quando, por exemplo:

  • Vários identificadores estiverem armazenados em um único atributo.

  • Um prefixo ou sufixo precise ser removido.

  • Um valor de origem precisa ser dividido em propriedades separadas do MyQ.

  • Um identificador precisa ser normalizado para o formato utilizado na detecção de tarefas ou na autenticação.


Guia “Grupos”

users-settings-sync-ldap-groups.png


Utilize a guia Grupos para importar grupos de diretório e definir como eles serão representados no MyQ.

A guia Grupos determina a estrutura e a composição dos grupos. Ela não determina quais usuários são importados; o escopo dos usuários é configurado na guia Usuários.

Configurações gerais de grupo

Configuração

Descrição

Não alterar o grupo padrão

Impede que a sincronização altere o grupo contábil padrão existente de um usuário.

Importar grupos para este grupo

Coloca todos os grupos importados por esta fonte abaixo de um grupo MyQ selecionado.

Nível de sincronização

Determina como as alterações na composição do grupo de diretório afetam as associações existentes no MyQ.

Um usuário pode pertencer a vários grupos, mas apenas um grupo pode ser seu grupo de contabilidade padrão. As atividades de impressão, cópia e digitalização são contabilizadas nesse grupo quando é utilizada a contabilidade baseada em grupos.

Nível de sincronização do grupo

Nível

Comportamento

Sincronização completa

A filiação a grupos no MyQ segue o diretório. Os usuários são adicionados e removidos dos grupos à medida que a filiação no diretório é alterada.

Sincronizar se não estiver vazio

Sincroniza as afiliações ao diretório, evitando que o usuário fique sem nenhum grupo.

Adicionar novo

Adiciona novas afiliações do diretório. As afiliações removidas do diretório permanecem no MyQ.

Grupos armazenados em um atributo de usuário

Utilize este método quando um atributo do usuário contiver o nome do grupo ou os valores a partir dos quais o nome do grupo deve ser criado.

Digite o nome do atributo ou arraste-o do navegador LDAP.

É possível combinar vários atributos. Por exemplo:

%attribute1%_%attribute2%

Se os atributos contiverem Prague e Sales, o MyQ criará o grupo:

Prague_Sales

Utilize barras verticais para criar uma hierarquia:

%attribute1%|%attribute2%

Isso resulta em:

Prague > Sales

Ative a opção Definir como padrão para tornar o grupo resultante o grupo de contabilidade padrão do usuário.

Grupo armazenado no DN do usuário

Utilize este método para derivar um grupo a partir de um componente de unidade organizacional no nome distinto do usuário.

Por exemplo:

CN=Anna Novak,OU=Sales,OU=Prague,DC=example,DC=com

Os componentes da unidade organizacional (OU) são contados da direita para a esquerda:

Componente da UO

Índice

Prague

1

Sales

2

Para importar Sales como grupo, defina o índice do componente da UO como 2.

Ative a opção Definir como padrão para tornar o grupo importado o grupo de contabilidade padrão do usuário.

Grupo em árvore armazenado no DN do usuário

Utilize este método para reproduzir uma hierarquia de unidades organizacionais a partir do nome distinto do usuário.

Por exemplo:

CN=Anna Novak,OU=Sales,OU=Prague,DC=example,DC=com

Para derivar a hierarquia:

Prague > Sales

remova:

  • O componente do usuário à esquerda: CN=Anna Novak

  • Os componentes de domínio à direita: DC=example,DC=com

Configure as opções Remover da esquerda e Remover da direita de acordo com o número de componentes que devem ser excluídos.

Pelo menos um componente deve ser removido de cada lado.

Ative Definir como padrão para tornar o grupo mais baixo na hierarquia importada o grupo de contabilidade padrão do usuário. Neste exemplo, o grupo padrão seria Sales.

Grupos armazenados no atributo memberOf

Utilize este método para importar grupos de segurança ou de distribuição referenciados pelo atributo memberOf do usuário.

users-settings-sync-ldap-memberof.png

Especifique um DN base dos grupos para restringir quais grupos serão considerados. O MyQ ignora grupos fora desse DN base.

O DN base dos grupos não precisa pertencer à mesma unidade organizacional que o DN base dos usuários.

Como o atributo memberOf pode conter vários grupos, a opção Definir como padrão não está disponível para este método.

Configure as seguintes opções quando necessário:

Opção

Descrição

Filtro

Restringe os grupos importados por meio de condições do tipo Attribute=Value. Insira uma condição por linha. Um grupo é aceito se satisfizer pelo menos uma condição. O caractere curinga * é suportado.

Importar grupos vazios

Importa grupos do DN base de grupos, mesmo quando nenhum usuário sincronizado os referencia por meio de memberOf.

Importar árvore de grupos

Preserva a estrutura hierárquica de grupos do diretório. Quando desativada, os grupos são importados como grupos separados e planos.

Por exemplo:

cn=*Print*

Isso aceita grupos cujo nome comum contenha Print.

Executar e validar a sincronização

Execute a fonte manualmente antes de agendá-la.

  1. Utilize um DN base restrito ou um filtro para o teste inicial, sempre que possível.

  2. Mantenha a opção Desativar usuários ausentes desativada.

  3. Execute a sincronização.

  4. Analise o log e os conflitos relatados.

  5. Verifique os usuários importados, as propriedades, os grupos, as associações a grupos e os grupos de contabilidade padrão.

  6. Teste a propriedade das tarefas e a autenticação de usuários, quando aplicável.

  7. Expanda o escopo somente após a confirmação de que os resultados estão corretos.

  8. Habilite a desativação de usuários somente após confirmar quais contas serão afetadas.

  9. Programe a sincronização recorrente.