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

Sincronizar usuários do Google Workspace

O MyQ X sincroniza usuários do Google Workspace por meio do serviço Secure LDAP do Google, que fornece acesso somente leitura ao diretório do Google via LDAPS. A sincronização importa contas de usuário e associações a grupos, além de mapear atributos do diretório para as propriedades de usuário do MyQ.


Pré-requisitos

  • Privilégios de superadministrador no Google Workspace.

  • Uma assinatura do Google Workspace compatível com o serviço Secure LDAP.

  • O servidor MyQ deve ser capaz de estabelecer conexões LDAPS de saída (TCP 636) com o Google.

  • Conhecimento sobre quais usuários ou grupos o MyQ deve ter permissão para acessar.


Considerações importantes

Cada instância do servidor MyQ requer seu próprio certificado de cliente LDAP. O Google emite um certificado exclusivo para cada cliente LDAP. Caso você execute vários servidores MyQ — por exemplo, um servidor central e servidores locais —, cada um deve ter seu próprio cliente registrado no Google Admin com seu próprio certificado e credenciais.

Os certificados expiram e devem ser renovados. Os certificados de cliente LDAP do Google Workspace têm uma data de validade. Planeje a renovação dos certificados em seu calendário operacional. Quando um certificado expira, a sincronização falhará até que um novo certificado seja gerado e enviado ao MyQ.

As alterações nas permissões de acesso podem levar até 24 horas para entrar em vigor. Quando o(a) senhor(a) modifica as permissões de acesso do cliente LDAP no Google Admin Console, as alterações não são imediatas. Leve esse atraso em consideração durante a configuração inicial e os testes – se a sincronização não estiver apresentando os resultados esperados logo após uma alteração de permissão, aguarde e tente novamente antes de prosseguir com o diagnóstico de problemas.

O certificado do cliente deve estar no formato PEM. O MyQ exige que o certificado do cliente esteja no formato PEM (codificado em Base64, com cabeçalhos BEGIN CERTIFICATE). Se o certificado baixado do Google Admin estiver no formato binário DER, converta-o antes de enviá-lo para o MyQ, por exemplo, usando o OpenSSL: openssl x509 -inform der -in certificate.der -out certificate.pem

Não proteja a chave privada com uma senha. O MyQ não pode utilizar uma chave privada protegida por senha. Ao gerar credenciais no Google Admin, deixe a chave privada desprotegida.


Configure o cliente LDAP no Google Admin

Esta etapa é realizada inteiramente no Console de Administração do Google. Ela gera o certificado do cliente, a chave privada e as credenciais LDAP de que o MyQ precisa para se conectar.

  1. Faça login no Console de Administração do Google com uma conta de superadministrador.

  2. Acesse Aplicativos > LDAP e clique em Adicionar cliente.

  3. Insira um nome para o cliente (obrigatório) e uma descrição opcional. Clique em Continuar.

  4. Na página do cliente LDAP, clique em Permissões de acesso e configure o seguinte:

    Verificar credenciais do usuário – habilita a autenticação do usuário por meio do MyQ. Defina como “todos os usuários” ou como unidades organizacionais específicas.

    Ler informações do usuário – permite que o MyQ leia os atributos do usuário. Defina para todos os usuários ou para unidades organizacionais específicas e, em seguida, habilite o acesso a:

    • Atributos do sistema

    • Atributos personalizados públicos

    • Atributos personalizados privados

    Ler informações do grupo – permite que o MyQ leia a associação a grupos do diretório. Defina como Ativado.

  5. Clique em Adicionar cliente LDAP e aguarde enquanto o cliente é provisionado e um certificado é gerado. Isso pode levar alguns minutos.

  6. Baixe o pacote de certificados gerado. O arquivo ZIP contém:

    • O certificado do cliente (.crt ou .pem)

    • A chave privada (.key)

    Armazene esses arquivos em local seguro. Se o certificado estiver no formato DER, converta-o para PEM antes de prosseguir.

  7. Clique em Continuar para os detalhes do cliente.

  8. Clique em Credenciais de acesso e, em seguida, clique em Gerar novas credenciais. O nome de usuário e a senha gerados são exibidos apenas uma vez – guarde-os em local seguro antes de sair desta tela.

  9. Retorne à página de detalhes do cliente LDAP e defina o Status do serviço como Ativado para todos. Clique em Salvar.

O Google Workspace está agora configurado com o MyQ como cliente LDAP.


Configure o servidor de autenticação no MyQ

Acesse MyQ > Configurações > Servidores de autenticação e adicione um novo servidor LDAP para o Google Workspace.

Configuração

Valor

Segurança

SSL

Porta

636

Servidor

ldap.google.com

Usuário

O nome de usuário gerado no Google Admin (Etapa 1)

Senha

A senha gerada no Google Admin (Etapa 1)

Certificado do cliente

Carregue o arquivo .crt ou .pem baixado do Google Admin

Chave privada

Carregue o arquivo .key baixado do Google Admin


Configure a fonte de sincronização

Acesse MyQ > Configurações > Sincronização de usuários, clique em +Adicionar e selecione Adicionar fonte LDAP.

As informações a seguir abordam os aspectos específicos do Google Workspace.

DN de base

O DN de base para o Google Workspace utiliza os componentes do seu domínio do Google Workspace. Por exemplo, para o domínio example.com:

dc=example,dc=com

Mapeamento padrão de atributos

O Google Workspace expõe um esquema LDAP padrão. Os mapeamentos a seguir são comuns à maioria dos diretórios do Google Workspace, mas confirme os nomes dos atributos em relação ao seu diretório real usando o navegador LDAP na guia Geral.

Propriedade MyQ

Atributo típico do Google Workspace

Nome de usuário

uid

Nome completo

cn

E-mail

mail

Alias

(nenhum – configure explicitamente, se necessário)

Número pessoal

(nenhum – configure explicitamente, se necessário)


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

O LDAPS é obrigatório

O serviço Secure LDAP do Google opera exclusivamente por meio do LDAPS – o LDAP simples não é compatível. Certifique-se de que o servidor MyQ consiga acessar ldap.google.com na porta TCP 636 e que nenhuma regra de firewall bloqueie conexões de saída nessa porta.

Proteja os certificados e credenciais do cliente

O certificado do cliente, a chave privada e as credenciais geradas fornecem acesso de leitura ao seu diretório do Google. Armazene-os com segurança e limite o acesso ao servidor MyQ e aos seus administradores. Alterne as credenciais caso elas sejam expostas.

Aplique o princípio do privilégio mínimo por meio de permissões de acesso

No Google Admin, restrinja as permissões de acesso do cliente LDAP apenas às unidades organizacionais que o MyQ precisa ler. Conceder acesso a todos os usuários quando a sincronização abrange apenas um subconjunto da organização representa uma exposição desnecessária.