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 do usuário

A sincronização de usuários é um método de importar e sincronizar periodicamente dados relacionados aos usuários no banco de dados do MyQ com dados de fontes externas, como o Microsoft Entra ID, servidores LDAP ou arquivos CSV. A importação de novos usuários é uma etapa opcional do processo de sincronização. Na configuração da sincronização, o(a) senhor(a) pode ativar ou desativar a importação de novos usuários; caso a desative, o MyQ atualizará apenas as contas dos usuários que já constam em seu banco de dados.

Esta seção fornece informações detalhadas sobre a sincronização. Ela descreve completamente os métodos de importação e sincronização disponíveis no MyQ e apresenta duas opções para executar as sincronizações:

As senhas dos usuários não são sincronizadas nem armazenadas no banco de dados do MyQ no caso de sincronizações via LDAP ou MS Entra ID.

Quais propriedades podem ser sincronizadas

Quando o MyQ sincroniza usuários a partir de um serviço de diretório ou arquivo CSV, ele mapeia os atributos de origem para as propriedades de usuário do MyQ. Nem todas as propriedades de usuário podem ser preenchidas por meio da sincronização, e nem todas as propriedades se comportam da mesma maneira entre as fontes de sincronização. Esta página resume quais propriedades podem ser sincronizadas, suas restrições e os mapeamentos padrão de atributos para cada tipo de fonte.

Propriedade do MyQ

Sincronizável

Restrições

Nome de usuário

Sim

Fixo por tipo de fonte – sempre sAMAccountName para LDAP/AD, sempre userPrincipalName para Entra ID (Graph API). Não pode ser alterado nas configurações da fonte de sincronização.

Nome completo

Sim

Sem restrições.

Aliases

Sim

Aceita-se vários valores, separados por vírgulas. Utilizado para identificar tarefas enviadas com identificadores diferentes do nome de usuário.

Número pessoal

Sim

Deve ser único para cada usuário. Utilizado para associar usuários entre fontes.

E-mail

Sim

Sem restrições.

E-mails alternativos

Sim

Aceita-se vários valores, separados por vírgulas.

Telefone

Não

Deve ser definido manualmente.

Departamento

Sim

Sem restrições.

Cartões

Sim

Modo de sincronização configurável: Não sincronizar / Sincronização completa / Sincronizar se não estiver vazio / Adicionar novo. São aceitos vários valores, separados por vírgulas.

PIN

Sim

Modo de sincronização configurável: mesmas opções que Cartões. No CSV, os valores de PIN devem estar no formato MD5 com hash. São aceitos vários valores, separados por vírgulas.

Idioma padrão

Sim

O valor deve ser uma abreviação de idioma suportada, por exemplo, en, hr.

Armazenamento do usuário

Sim

Sem restrições.

Observações

Sim

Sem restrições.

Personalizado (1-3)

Sim

Disponível para fontes Entra ID (Graph API) e CSV. Mapeie qualquer atributo não abrangido pelas propriedades padrão.

Utilizar servidor de autenticação

Sim

Definido no nível da fonte de sincronização – aplica-se a todos os usuários importados por essa fonte. Não é mapeado individualmente por usuário.

Fonte de sincronização

Automático

Definido pelo MyQ com base no nome da fonte de sincronização. Não configurável por usuário por meio da sincronização.

Avançado (identidade local)

Automático

Preenchido automaticamente para usuários híbridos do Entra ID a partir de `onPremisesSamAccountName` e `onPremisesDomainName`. Não é necessária nenhuma configuração.

Mapeamentos padrão de atributos por fonte

Quando existe um mapeamento padrão, o MyQ o aplica automaticamente. Propriedades sem valor padrão devem ser configuradas explicitamente nas configurações da fonte de sincronização.

Active Directory (LDAP)

Propriedade do MyQ

Atributo padrão do AD

Observações

Nome de usuário

sAMAccountName

Fixo.

Nome completo

cn


E-mail

mail


Todas as outras propriedades

(nenhuma)

Deve ser configurado explicitamente.

Normalmente configuradas explicitamente:

Propriedade MyQ

Atributo recomendado do AD

Observações

Alias

userPrincipalName

Mapeie aqui se a detecção de função retornar o UPN.

Alias

mailNickname ou mail

Faça o mapeamento aqui se a detecção de função retornar identificadores no formato de e-mail.

Número pessoal

employeeId

Útil para emparelhamento entre fontes.

Armazenamento do usuário

HomeDrive

Permite a função “Impressão Fácil de” / “Digitalização Fácil para” a pasta pessoal do usuário.

Cartão, PIN

Personalizado ou extensionAttribute

Analise a proteção de atributos confidenciais antes de ativar.

Microsoft Entra ID (API Graph)

Propriedade MyQ

Atributo padrão

Observações

Nome de usuário

userPrincipalName

Fixo.

Nome completo

displayName


E-mail

mail


Idioma

preferredLanguage


Departamento

department


Todas as outras propriedades

(nenhuma)

Deve ser configurado explicitamente.

Os atributos disponíveis para mapeamento explícito incluem employeeId, mailNickname, upnPrefix, onPremisesSamAccountName, onPremisesDomainName e extensionAttribute1 a extensionAttribute15. Qualquer atributo de recurso de usuário do Entra ID também pode ser digitado manualmente caso não conste na lista suspensa.

OpenLDAP

Propriedade MyQ

Atributo Padrão

Observações

Nome de usuário

uid

Fixo.

Nome completo

cn


E-mail

mail


Todas as outras propriedades

(nenhuma)

Deve ser configurado explicitamente. O esquema varia de acordo com a instalação – verifique os nomes dos atributos em seu diretório.

Novell eDirectory

Não há mapeamentos padrão. Todas as propriedades devem ser configuradas explicitamente. Utilize o navegador LDAP na guia “Geral” da fonte de sincronização para identificar os nomes dos atributos no seu diretório.

Google Workspace (LDAP seguro)

Propriedade do MyQ

Atributo típico

Observações

Nome de usuário

uid


Nome completo

cn


E-mail

mail


Todas as outras propriedades

(nenhuma)

Verifique os nomes dos atributos em relação ao seu diretório utilizando o navegador LDAP.

CSV

Todas as propriedades são mapeadas por nome de coluna (ou posição da coluna, caso não haja linha de cabeçalho).

Opções de modo de sincronização para cartões e PIN

Os modos de sincronização a seguir se aplicam às propriedades de cartões e PIN em todos os tipos de fonte que os suportam.

Modo

Comportamento

Não sincronizar

Os valores existentes no MyQ não são alterados.

Sincronização completa

Os valores existentes são substituídos pelos valores da fonte, incluindo a substituição por “vazio” caso o valor da fonte esteja vazio.

Sincronizar se não estiver vazio

Os valores existentes são substituídos apenas se o valor da fonte não estiver vazio. Padrão para CSV.

Adicionar novos

Novos valores da fonte são adicionados sem substituir os existentes.