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.
Veja também:
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.
-
Faça login no Console de Administração do Google com uma conta de superadministrador.
-
Acesse Aplicativos > LDAP e clique em Adicionar cliente.
-
Insira um nome para o cliente (obrigatório) e uma descrição opcional. Clique em Continuar.
-
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.
-
-
Clique em Adicionar cliente LDAP e aguarde enquanto o cliente é provisionado e um certificado é gerado. Isso pode levar alguns minutos.
-
Baixe o pacote de certificados gerado. O arquivo ZIP contém:
-
O certificado do cliente (
.crtou.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.
-
-
Clique em Continuar para os detalhes do cliente.
-
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.
-
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 |
|
|
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 |
|
Chave privada |
Carregue o arquivo |
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 |
|
|
Nome completo |
|
|
|
|
|
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.