Talvez as mensagens de erro a seguir apareçam quando você estiver usando o Google Cloud Directory Sync (GCDS). Consulte a tabela abaixo para resolver erros.
Testar o Log Analyzer
Essa ferramenta identifica a maioria dos problemas alguns instantes após o envio.
- Envie seus registros de rastreamento (como arquivos ZIP ou descompactados) para o Log Analyzer do Google Admin Toolbox.
- Para fazer a análise avançada de registros, envie arquivos descompactados para o Log Analyzer 2.
Saiba mais sobre como ativar o registro no nível do rastreamento.
Mensagens de erro e soluções
| Mensagem de erro | Descrição e solução |
|---|---|
|
Problema de rede: não é possível se conectar ao servidor LDAP especificado: falha na vinculação simples: servername:636, motivo: SSLHandshakeException - Nenhum nome alternativo de assunto presente Problema de rede: não é possível se conectar ao servidor LDAP especificado: falha na vinculação simples: servername:636, motivo: SSLHandshakeException - Nenhum nome DNS alternativo do assunto correspondente ao nome do servidor encontrado |
O nome comum (CN, na sigla em inglês) e o nome alternativo do assunto (SAN, na sigla em inglês) do certificado não correspondem ao nome do servidor LDAP no arquivo de configuração do GCDS. Para corrigir isso, faça o seguinte:
Como solução temporária, você pode desativar a identificação de endpoints adicionando uma nova linha aos arquivos config-manager.vmoptions e sync-cmd.vmoptions na pasta de instalação do GCDS. Remova a quebra de linha antes de adicionar aos arquivos: -Dcom.sun.jndi.ldap.object. disableEndpointIdentification=true |
|
sun.security.provider.certpath.SunCertPathBuilder Exception: não foi possível encontrar um caminho de certificado válido para o destino solicitado Falha de ldap_simple_bind_s(): autenticação forte necessária |
Siga as etapas em Resolver problemas relacionados a certificados. |
| InvalidCipherTextException: parâmetros de criptografia inválidos. Salt/Iteração/Vetor de inicialização |
Se você executa o GCDS em um computador que não tem uma GUI, talvez não tenha importado a chave corretamente. Confira as etapas em Como autorizo o GCDS em um computador sem GUI? |
| java.lang.RuntimeException: Encountered unrecoverable SQLException. O banco de dados de estado especificou "path-to-folder\syncState\folder-name" |
Localize e exclua a pasta identificada na mensagem. Em seguida, inicie a sincronização novamente. |
| java.sql.SQLException: Invalid checksum on Page |
Outro processo está acessando a pasta ou os arquivos de cache ao mesmo tempo que o GCDS. Para resolver problemas, faça o download e execute o Process Monitor da Microsoft e crie um filtro. Nas opções de filtro, use Path, Contains e path-to-folder\syncState para identificar os processos que acessam a pasta ou os arquivos. Para mais informações, acesse Process Monitor. |
| Entrada inválida: consulta |
Você inseriu uma consulta inválida no campo Consulta de pesquisa de usuários. Remova a consulta de pesquisa ou verifique se ela atende às diretrizes da página Pesquisar usuários. Para mais informações sobre as consultas de pesquisa dos usuários, acesse Omitir dados com regras de exclusão e consultas. |
| SocketException - Connection reset |
Se você receber essa mensagem quando estiver se conectando ao servidor LDAP, o servidor fechou a conexão. As possíveis razões são:
|
| Não foi possível obter um bloqueio dentro do período solicitado |
Para resolver esse problema:
|
| Erro 400: invalid_request: a versão do app que você está usando não inclui os recursos de segurança mais recentes para garantir sua proteção. Faça o download de uma fonte confiável e atualize para a versão mais recente e segura. |
Confirme que você está usando a versão mais recente do GCDS. Veja mais detalhes em Atualizar o GCDS. |
| java.sql.SQLException: não é possível criar o diretório <directory>. |
O GCDS exige permissão total para o diretório manter o banco de dados de estados de sincronização. Esse erro pode aparecer nestas situações:
|
| org.jdom.input. JDOMParseException :erro na linha 1: conteúdo não permitido em prolog |
O GCDS está tentando carregar um arquivo de configuração com uma codificação de caracteres não compatível. O GCDS usa como padrão a codificação de caracteres UTF-8. Use a mesma codificação para os arquivos de configuração, embora outras codificações sejam compatíveis. Para resolver o problema:
As codificações não compatíveis mais comuns são UTF-7 e UTF-8 BOM. |
| javax.net.ssl. SSLHandshakeException: conexão durante handshake |
Um problema na conexão de rede impediu o GCDS de concluir um handshake do Secure Sockets Layer (SSL) com o servidor do Google. Esse problema pode ocorrer quando um computador está roteando um pacote com muita lentidão ou o ISP perde o serviço temporariamente. O GCDS faz até três tentativas de concluir o handshake do SSL. Se a mensagem a seguir aparecer nos registros, é porque o GCDS concluiu o handshake nas tentativas seguintes e nenhuma outra ação será necessária: [usersyncapp.sync.FullSyncAgent] Nenhuma diferença detectada, nenhuma mudança necessária. Veja com o administrador da rede local o que pode estar causando a interrupção da rede. |
| Cota excedida para a solicitação atual |
Se você receber esse erro nos registros, isso significa que o GCDS está temporariamente impedido de usar as APIs do Google. O GCDS tenta executar as APIs novamente, e a sincronização vai continuar conforme o esperado. Se você receber o erro no relatório de resumo da sincronização e ela não for concluída corretamente, entre em contato com o suporte. Para mais detalhes, acesse Quais informações do GCDS eu preciso antes de entrar em contato com o suporte? |
| java.lang.RuntimeException: O escopo da regra de pesquisa LDAP desconhecido é "nulo" |
Uma regra em uma das seguintes seções do Gerenciador de configuração está vazia:
Para mais informações, acesse Configurar a sincronização com o Gerenciador de configuração. |
| Comprimento da compilação inválido para senha |
O método de criptografia para sincronização de senhas não foi configurado corretamente no Gerenciador de configuração, ou o servidor LDAP usa um método de criptografia incompatível com o GCDS. Os métodos compatíveis são texto simples, Base64, MD5 e SHA1. Para sincronizar senhas com o Microsoft Active Directory, use o Password Sync. Para mais informações, acesse Como sincronizar senhas? e Atualizar o GCDS. |
| 0 grupos aninhados |
O GCDS não está distinguindo corretamente usuários e grupos aninhados no seu servidor LDAP. Para resolver o problema:
|
| Suspender usuário |
O GCDS pode tentar fazer mudanças inesperadas se você fizer uma sincronização com um arquivo de configuração duplicado fora do Gerenciador de configuração. O novo arquivo de configuração acessa o mesmo cache que o original, e as inconsistências entre os dois podem levar à suspensão dos usuários. Para duplicar um arquivo de configuração do GCDS, use sempre a opção Salvar como no Gerenciador de configuração. Isso garante que o novo arquivo de configuração tenha um cache próprio. Para mais informações, acesse Trabalhar com arquivos de configuração. |
| Pulando um membro desconhecido |
Você está usando um arquivo de configuração XML do GCDS mais antigo, e o GCDS encontrou um membro do grupo que não está incluído nas regras de pesquisa de usuário da sua configuração. Inclua todos os participantes e proprietários do grupo nas regras de pesquisa de usuários, mesmo se você não quiser sincronizar essas pessoas com o domínio do Google. O GCDS precisa extrair os endereços de e-mail desses usuários para processar os grupos corretamente. Como alternativa, crie um novo arquivo de configuração XML em branco. O GCDS vai ativar a sincronização independente de grupo, o que obriga o GCDS a corrigir os participantes do grupo, sem considerar as regras de sincronização de usuários. Se você não tiver certeza, essa é a opção recomendada. Ao fazer qualquer mudança na configuração ou criar um novo arquivo de configuração, execute uma simulação e analise os resultados antes de fazer uma sincronização completa. Para mais informações, acesse Definir a lista de usuários. |
| com.google.data.client. GoogleServiceException: Invalid credentials |
A conta especificada no Gerenciador de configuração não é de um administrador, ou o nome de usuário e a senha estão incorretos. No Gerenciador de configuração, acesse Google Domain
Para mais informações, acesse Definir as configurações do domínio do Google. |
| com.google.gdata.util. ResourceNotFoundException: |
O atributo da chave de sincronização especificado na seção Contatos compartilhados do Gerenciador de configuração retorna valores vazios do servidor LDAP. Selecione um atributo do servidor LDAP que contenha o valor da chave de sincronização para cada recurso e nunca retorne uma cadeia de caracteres nula ou vazia. |
| As diferenças computadas excedem os limites de exclusão configurados, alterações não aplicadas |
O limite de exclusão ou suspensão definido no GCDS foi atingido. Altere a configuração dos Limites de exclusão no GCDS para evitar esse erro ou confira no registro de sincronização mais detalhes sobre o que foi excluído ou suspenso. Depois decida se você precisa alterar o limite. |
| InvalidEmail |
O GCDS está tentando criar um usuário ou alias de e-mail que exista em um domínio externo à sua Conta do Google. Tente estas opções:
|
| Limite de usuários do domínio atingido |
O GCDS está sincronizando mais usuários do que o número provisionado para sua conta. Tente estas opções:
|
| java.lang.RuntimeException: javax.naming.InvalidNameException: [LDAP: error code 34 - invalid DN] |
É possível que um DN de base especificado no Gerenciador de configuração aponte para um objeto que não existe no servidor LDAP. Confira o DN de base especificado nas seções de filtro de conexão LDAP, usuário, grupo, perfil e contatos compartilhados. Use um objeto já existente como o DN de base para cada um. |
| java.security.cert. CertPathValidatorException: revocation status check failed: no CRL found |
Outro serviço ou dispositivo de rede está impedindo o GCDS de entrar em contato com a autoridade de certificação para o certificado HTTPS usado para APIs. Verifique se há regras de firewall ou proxy que restrinjam as conexões do computador que executa o GCDS. Se for necessário usar um proxy para acessar a Web no computador que executa o GCDS, ele vai precisar ser configurado corretamente. Para contornar o problema, você pode desativar a verificação da lista de revogação de certificado. Para desativar a verificação da CRL, adicione estas linhas aos arquivos config-manager.vmoptions e sync-cmd.vmoptions no diretório de instalação do GCDS: Para mais informações, acesse Como o GCDS verifica listas de revogação de certificado. |
| javax.naming.directory. InvalidSearchFilterException: parênteses não balanceados; nome restante |
As consultas especificadas em uma ou mais das seguintes páginas do Gerenciador de configuração não têm parênteses balanceados:
|
| A exceção raiz é javax.naming. CommunicationException: servername:389 |
O GCDS não resolve o nome de servidor LDAP informado. Digite um nome de domínio totalmente qualificado para o servidor LDAP e confirme que o computador que executa o GCDS pode resolvê-lo. Observação:ao usar o Active Directory, use o nome totalmente qualificado do seu domínio como o nome do servidor. |
| O par SSL foi desligado de maneira incorreta |
Esse problema geralmente se deve ao tráfego forçado por um proxy. Se você estiver usando um proxy, será preciso definir as configurações de proxy do GCDS. Para que o GCDS possa se conectar a esses URLs e portas específicos, siga as etapas em Permitir acesso a URLs e portas. O software de segurança no computador local pode criar problemas de conexão. Peça ao administrador para desativar qualquer software de segurança na máquina cliente e tente novamente. |
| Você não tem autorização para acessar esta API |
Confirme que você ativou as APIs do Google. Para mais informações, acesse Autorizar sua Conta do Google. |
| Limite de usuários do domínio excedido |
Você tentou adicionar mais usuários do que o número de licenças. Entre em contato com seu representante de vendas para comprar mais licenças de usuário. ou mude suas consultas LDAP para sincronizar menos usuários. |
| java.lang.RuntimeException: Falha ao executar a consulta porque o objeto do DN de base: "DC=domain,DC=com" está ausente ou inacessível |
Comece verificando o nome do domínio na guia Configuração LDAP e em qualquer regra de pesquisa quando você tiver definido uma modificação do DN de base. Se isso não resolver o problema e você tiver certeza de que o DN é válido, talvez haja algo errado na resolução de DNS. Outras informações sobre erros podem aparecer no registro da seguinte forma:
Esses erros identificam que o nome de host está recusando a conexão ou excedendo o tempo limite. Tente executar uma pesquisa no DNS com esse nome de host e confirme se todos os endereços que estão sendo retornados são válidos e permitem conexões na porta configurada. Observação: esses erros podem ocorrer mesmo quando você especifica um nome de host ou endereço IP válido na configuração do GCDS. O Active Directory pode emitir uma resposta de referência LDAP, direcionando o GCDS para se conectar por um nome de host. Talvez esse seja o nome do host que não está sendo resolvido. Você pode evitar essas referências estabelecendo uma conexão com o servidor Active Directory por meio da porta do Catálogo Global, cujo número padrão é 3268. Consulte mais detalhes na documentação da Microsoft. |
| O caractere é inválido no local |
Algumas das informações no esquema personalizado não são válidas. Para verificar os limites que se aplicam ao esquema personalizado, acesse API Directory: campos de usuário personalizados. Se você tiver registros de nível de rastreamento ativados, também poderá ver a solicitação HTTP completa do esquema personalizado. |
| java.util.concurrent. ExecutionException: java.lang.OutOfMemoryError: GC overhead limit exceeded |
O limite de memória definido foi excedido. Esse evento causou a falha da sincronização. Para resolver esse problema, acesse E se os erros estiverem relacionados à memória?. |
| Falha ao se conectar ao servidor LDAP especificado |
O GCDS não consegue se conectar ao servidor LDAP. Verifique se:
|
| Problema de rede: não é possível se conectar ao servidor LDAP especificado |
O GCDS não encontrou o servidor LDAP. Confira se o computador que está usando o GCDS tem acesso ao host e à porta definidos. |
| Problema de autenticação: não é possível se conectar usando as credenciais fornecidas |
O servidor LDAP está rejeitando solicitações do GCDS devido a um problema de autenticação. Confira se o usuário autorizado e a senha estão corretos. Adicione o usuário autorizado usando o DN completo. Veja mais detalhes sobre como adicionar o usuário autorizado em Configurações de conexão LDAP. |
| Falha ao executar a consulta no DN de base <base-dn> |
O GCDS não consegue se conectar ao DN de base. Verifique se:
|
| Falha ao executar a consulta no DN de base <base-dn> com atributo: <attribute>, motivo: NameNotFoundException |
O GCDS não está recuperando informações do servidor LDAP. Verifique se:
|
|
O participante já existe |
Esse erro pode aparecer nestas situações:
Desmarque a caixa ou mude um dos nomes de usuário do alias. Se você também vir a mensagem "Erro ao adicionar o membro user-email-address ao grupo group-email-address devido ao conflito de endereços" nos registros, verifique se:
|
| Entrada inválida: INVALID_OU_ID |
O GCDS está tentando colocar um usuário em uma unidade organizacional que não existe na Conta do Google da sua organização. Ajuste as regras de pesquisa de usuário e tente de novo. Saiba mais em Regras de pesquisa de usuários. |
| A cota foi excedida para a métrica de cota "Consultas" e o limite "Consultas por minuto por usuário" do serviço "licensing.googleapis.com". "reason": "rateLimitExceeded" |
No arquivo XML de configuração do GCDS, verifique se o valor <maxResults> está definido como 500. Se necessário, mude para 500 e execute a sincronização novamente. |
Unidades organizacionais
Tema relacionado
Resolver problemas comuns do GCDS
Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas a que estão associados.