GCDS-felmeddelanden

Du kan stöta på följande felmeddelanden när du använder Google Cloud Directory Sync ( GCDS). Använd tabellen nedan för att felsöka.

Testa Log Analyzer

Verktyget kan identifiera de flesta problem inom några sekunder efter att du skickat dem.

Få information om aktivering av loggning på spårningsnivå.

Felmeddelanden och lösningar

Felmeddelande Beskrivning och lösning

Nätverksproblem: Det går inte att ansluta till den angivna LDAP-servern: Enkel bindning misslyckades: servernamn:636, orsak: SSLHandshakeException – Inga alternativa namn för ämne finns

Nätverksproblem: Det går inte att ansluta till den angivna LDAP-servern: Enkel bindning misslyckades: servernamn:636, orsak: SSLHandshakeException – inget DNS-namn för ämnets andra namn som matchar servernamnet hittades

Certifikatets namn (CN) och det alternativa ämnesnamnet (SAN) stämmer inte överens med namnet på LDAP-servern i GCDS-konfigurationsfilen.

Du kan åtgärda problemet genom att

  • Korrigera GCDS-konfigurationsfilen. Om du har lagt till LDAP-serverns IP-adress i GCDS-konfigurationen anger du även dess FQDN (fullständiga domännamn) (till exempel dc01.solarmora.com).
  • Lägg till ett SAN i certifikatet – se till att SAN innehåller namnet på LDAP-servern som du använder i GCDS-konfigurationen.

Som en tillfällig lösning kan du inaktivera identifiering av ändpunkter genom att lägga till en ny rad i filerna config-manager.vmoptions och sync-cmd.vmoptions i GCDS-installationsmappen. Ta bort radbrytningen innan du lägger till i filerna:

-Dcom.sun.jndi.ldap.object. disableEndpointIdentification=true

sun.security.provider.certpath.SunCertPathBuilder Exception: det gick inte att hitta en giltig certifieringssökväg till det begärda målet

ldap_simple_bind_s() failed: Stark autentisering krävs

Följ stegen i Felsöka certifikatrelaterade problem.

InvalidCipherTextException: Ogiltiga krypteringsparametrar. Salt-/iterations-/initieringsvektor

Om du kör GCDS på en dator som inte har ett grafiskt användargränssnitt kanske du inte har importerat nyckeln korrekt. Anvisningar finns i Hur auktoriserar jag GCDS på en dator utan GUI?

java.lang.RuntimeException: Encountered unrecoverable SQLException. Statusdatabasen angav sökväg-till-mapp\syncState\mappnamn

Leta reda på och radera mappen som anges i meddelandet. Starta sedan synkroniseringen igen.

java.sql.SQLException: Invalid checksum on Page

En annan process får åtkomst till cachemappen eller filerna samtidigt som GCDS.

Felsök genom att ladda ned och köra Microsofts Process Monitor och skapa ett filter. Använd Sökväg, Innehåller och sökväg-till-mapp\syncState i filteralternativen för att identifiera processerna som har åtkomst till mappen eller filerna.

Mer information finns i Process Monitor.

Ogiltig indata: query

Du har angett en ogiltig fråga i fältet Användarsökfråga. Ta bort sökfrågan eller se till att den följer sökriktlinjerna i Sök efter användare.

Mer information om användarnas sökfrågor finns i Utesluta data med uteslutningsregler och frågor.

SocketException – Connection reset

Om det här meddelandet visas när du ansluter till LDAP-servern har servern stängt anslutningen. Möjliga orsaker:

  • Du använder LDAP+SSL och LDAP-servern är inte konfigurerad för att godkänna de TLS-parametrar som GCDS har stöd för (till exempel chiffersviten). Se till att LDAP-servern har de senaste säkerhetsuppdateringarna och inställningarna.
  • En brandväggsregel blockerar anslutningen.
Det gick inte att hämta ett lås inom den begärda tiden

Så här felsöker du problemet:

  1. Kontrollera att enbart en instans av GCDS körs på datorn.

    Du kan bara köra en instans av GCDS åt gången med samma XML-fil.

  2. Starta om systemet för att säkerställa att inga andra processer får åtkomst till GCDS-cachedatabasen. Kör sedan synkroniseringen igen.
  3. Om problemet kvarstår letar du upp och byter namn på mappen SyncState och tvingar GCDS att skapa en ny cachedatabas. Du hittar mappen under användarprofilen (Windows) eller i hemkatalogen (Linux).
Fel 400: ogiltig_begäran: Den version av appen som du använder innehåller inte de senaste säkerhetsfunktionerna. Ladda ned från en betrodd källa och uppdatera till den senaste och säkraste versionen.

Kontrollera att du använder den senaste versionen av GCDS. Mer information finns i Uppdatera GCDS.

java.sql.SQLException: Det går inte att skapa katalogen <directory>.

GCDS kräver full behörighet till katalogen för att behålla databasen för synkroniseringsstatus. Det här felet kan visas om:

  • GCDS körs som en annan användare än den som installerade GCDS
  • Behörigheterna har ändrats sedan installationen
org.jdom.input.
JDOMParseException:
Fel på rad 1: Innehållet tillåts inte i prolog

GCDS försöker läsa in en konfigurationsfil med en teckenkodning som inte stöds.

I GCDS används UTF-8 som standardteckenkodning. Vi rekommenderar att du använder samma kodning för dina konfigurationsfiler, även om andra kodningar stöds.

Så här löser du problemet:

  1. Ändra konfigurationsfilens kodning till UTF-8:
    1. Öppna en textredigerare.
    2. Spara filen med en annan kodning.
  2. Verifiera att innehållet i konfigurationsfilen är korrekt.
  3. Försök att ladda upp konfigurationsfilen på GCDS igen.

De vanligaste kodningar som inte stöds är UTF-7 och UTF-8 BOM.

javax.net.ssl.
SSLHandshakeException:
anslutning under handskakning

En nätverksanslutningsproblem förhindrade GCDS från att avsluta en SSL-handskakning(Secure Sockets Layer) med Google-servern. En dirigering av ett paket via en dator går för långsamt eller så kan ett tillfälligt avbrott i internetleverantörens tjänst orsaka det här problemet.

I GCDS görs upp till tre försök att automatiskt slutföra SSL-handskakningen. Om du ser följande meddelande i loggarna slutfördes handskakningen i GCDS på efterföljande försök och inga ytterligare åtgärder krävs: [usersyncapp.sync.FullSyncAgent] Inga skillnader upptäcktes, inga ändringar krävs.

Kontakta din lokala nätverksadministratör och ta reda på vad som kan orsaka att tidsgränserna nås i nätverket.

Kvoten har överskridits för den aktuella begäran

Om du får det här felet i loggarna betyder det att GCDS tillfälligt är blockerat från att använda Googles API:er. GCDS försöker igen med API:erna och synkroniseringen bör fortsätta som förväntat.

Kontakta supporten om du får felet i synkroniseringsöversikten och synkroniseringen inte slutfördes korrekt. Mer information finns i Vilken GCDS-information behöver jag innan jag kontaktar supporten?

java.lang.RuntimeException:
Okänd LDAP-sökregel med omfattning null

En regel i ett av följande avsnitt i Konfigurationshanteraren är tom:

  • LDAP-konfiguration följt av Organisationsenheter följt av Sökregler
  • LDAP-konfiguration följt av Användare följt av Användarsynkronisering
  • LDAP-konfiguration följt av Grupper följt av Gruppsökregler
  • LDAP-konfiguration följt av Användarprofiler följt av Synkronisering av användarprofiler
  • LDAP-konfiguration följt av Delade kontakter följt av Synkronisering av kontakter

Mer information finns i Konfigurera synkronisering med konfigurationshanteraren.

Ogiltig sammanfattningslängd för lösenord

Metoden för lösenordskryptering vid synkronisering av lösenord är inte korrekt konfigurerad i konfigurationshanteraren eller så används en krypteringsmetod på din LDAP-server som inte stöds i GCDS. De metoder som stöds är klartext, Base64, MD5 och SHA1. Om du vill synkronisera lösenord med Microsoft Active Directory använder du Lösenordssynkronisering.

Mer information finns i Hur synkroniseras lösenord? och Uppdatera GCDS.

0 kapslad(e) grupp(er)

GCDS skiljer inte mellan användare och kapslade grupper på LDAP-servern på rätt sätt. Så här löser du problemet:

  1. Lägg till följande rad i konfigurationsfilen i avsnittet <features>:
    GROUP_NESTED_GROUPS_AS_USERS
  2. Omge raden i <optional> taggar.
  3. Spara konfigurationsfilen och synkronisera.
Stäng av användare

GCDS kan försöka göra oväntade ändringar om du utför en synkronisering med en konfigurationsfil som har duplicerats utanför Konfigurationshanteraren. Den nya konfigurationsfilen använder samma cache som den ursprungliga konfigurationsfilen och inkonsekvenser mellan de två filerna kan leda till att användare stängs av.

Om du vill duplicera en GCDS-konfigurationsfil ska du alltid använda alternativet Spara som i konfigurationshanteraren. Det här säkerställer att den nya konfigurationsfilen har en egen cache.

Mer information finns i Arbeta med konfigurationsfiler.

Hoppar över okänd medlem

Du använder en äldre XML-konfigurationsfil för GCDS och i GCDS hittades en gruppmedlem som inte ingår i konfigurationens regler för användarsökning. Du ska inkludera alla gruppmedlemmar och ägare i dina användarsökregler, även om du inte vill synkronisera dessa användare med Google-domänen. GCDS måste extrahera e-postadresser för dessa användare för att grupper ska kunna behandlas korrekt.

Du kan också skapa en ny, tom XML-konfigurationsfil. I GCDS aktiveras då oberoende gruppsynkronisering och tack vare detta tvingas GCDS att behandla gruppmedlemmar oavsett synkroniseringsregler för användare. Om du är osäker är detta det rekommenderade alternativet.

Kör en simulering och granska resultaten innan du kör en fullständig synkronisering när du gör konfigurationsändringar eller när du skapar en ny konfigurationsfil.

Mer information finns i Definiera din användarlista.

com.google.data.client.
GoogleServiceException:
Ogiltiga användaruppgifter

Administratörskontot som du har angett i Konfigurationshanteraren är antingen inte ett administratörskonto eller så är användarnamn och lösenord fel.

I Konfigurationshanteraren öppnar du Google-domän följt av Inställningar och verifierar informationen om administratörskonto som anges i E-postadress för administratör.

Mer information finns i Definiera dina Google-domäninställningar.

com.google.gdata.util.
ResourceNotFoundException:

Nyckelattributet för synkronisering som anges i avsnittet Delade kontakter i Konfigurationshanteraren returnerar tomma värden från LDAP-servern. Välj ett attribut från LDAP-servern som innehåller synkroniseringsnyckelvärdet för varje resurs och som aldrig returnerar en sträng med null-värde eller en tom sträng.

Beräknade skillnader överskrider
konfigurerade raderingsgränser,
ändringar tillämpas inte

Gränsvärdet för borttagning eller avstängning i GCDS har nåtts. Ändra inställningen Borttagningsgräns i GCDS för att undvika detta fel, eller titta i synkroniseringsloggen för mer information om vad som har tagits bort eller stängts av och avgör om du behöver ändra gränsen.

InvalidEmail

Ett försök görs att skapa en användare eller ett e-postalias i GCDS som finns på en domän som inte är en del av ditt Google-konto. Testa något av följande:

  • I Konfigurationshanteraren öppnar du Användarkonton följt av Uteslutningsregler och skapar regler för uteslutning av användare på externa domäner.
  • Ändra reglerna för användarsökning så att användare på externa domäner inte ingår i sökresultat.
  • Lägg till den saknade domänen på ditt Google-konto som en sekundär domän.
Domänanvändargränsen har nåtts

I GCDS synkroniseras fler användare än kontot har tilldelats. Testa något av följande:

  • I Konfigurationshanteraren öppnar du Användarkonton följt av Sökregler och begränsar omfattningen av användarsökningen så att färre användare returneras.
  • Kontrollera att du har angett rätt unika namn i konfigurationshanteraren – det ska peka på roten som endast innehåller användare som ska importeras till Google-domänen.
  • Du kan även skaffa fler användarlicenser. Mer information finns i Köpa fler användarlicenser.
java.lang.RuntimeException:
javax.naming.InvalidNameException:
[LDAP: error code 34 - invalid DN]

Ett basnamn som har angetts i konfigurationshanteraren kan peka på ett objekt som inte finns på LDAP-servern. Kontrollera basnamnet som anges i filteravsnitten för LDAP-anslutning, användare, grupp, profil och delade kontakter. Använd ett befintligt objekt som basnamn för samtliga.

java.security.cert.
CertPathValidatorException:
revocation status check failed:
no CRL found

En annan tjänst eller nätverksenhet hindrar GCDS från att kontakta certifikatutfärdaren för HTTPS-certifikatet som används för API. Kontrollera om det finns brandväggs- eller proxyregler som kan begränsa anslutningar från datorn som kör GCDS.

Om en proxy krävs för att komma åt webben från datorn som kör GCDS måste den konfigureras korrekt.

Du kan kringgå problemet genom att inaktivera listan med återkallade (CRL) certifikat. Om du vill inaktivera CRL-kontroll lägger du till följande rader i filerna config-manager.vmoptions och sync-cmd.vmoptions i GCDS-installationskatalogen:
-Dcom.sun.net.ssl.checkRevocation=false
-Dcom.sun.security.enableCRLDP=false

Mer information finns i Så här kontrolleras listor med återkallade certifikat i GCDS.

javax.naming.directory.
InvalidSearchFilterException:
Unbalanced parenthesis; remaining name

De frågor som anges på en eller flera av följande sidor i konfigurationshanteraren har inte korrekta parenteser:

  • LDAP-konfiguration följt av Organisationsenheter följt av Sökregler
  • LDAP-konfiguration följt av Användare följt av Användarsynkronisering
  • LDAP-konfiguration följt av Grupper följt av Sökregler för grupper
  • LDAP-konfiguration följt av Användarprofiler följt av Synkronisering av användarprofiler
  • LDAP-konfiguration följt av Delade kontakter följt av Synkronisering av kontakter
Root exception is javax.naming.
CommunicationException:
servername:389

GCDS kan inte tolka det angivna LDAP-servernamnet. Kontrollera att du anger ett fullständigt kvalificerat domännamn för LDAP-servern och att det går att omvandla det på datorn som kör GCDS.

Obs! När du använder Active Directory ska du alltid använda din domäns fullständigt kvalificerade domännamn som servernamn.

SSL-peer stängdes av felaktigt

Detta problem beror oftast på att trafik tvingas genom en proxy. Om du använder en proxy måste du konfigurera proxyinställningar för GCDS.

Kontrollera att GCDS kan ansluta till dessa specifika webbadresser och portar genom att slutföra stegen i Tillåt åtkomst till webbadresser och portar.

Säkerhetsprogramvara på den lokala datorn kan skapa anslutningsproblem. Be administratören att inaktivera alla säkerhetsprogramvaror på klientdatorn och försök igen.

Du har inte behörighet att komma åt detta API

Kontrollera att du har aktiverat de API:er som krävs för Google.

Mer information finns i Auktorisera ditt Google-konto.

Domänanvändargränsen har överskridits

Du har försökt att lägga till fler användare än du har användarlicenser för. Kontakta säljaren och köp fler användarlicenser. Du kan även ändra dina LDAP-frågor för att synkronisera färre användare.

java.lang.RuntimeException: Det gick inte att köra frågan eftersom objektet på bas-DN: "DC=domain,DC=com" saknas eller är otillgängligt

Börja med att kontrollera DN både på fliken LDAP-konfiguration och någon av nasökregler där du har definierat en DN-basåsidosättning.

Om det inte löser problemet och du är säker på att DN är giltig kan problemet gälla DNS-upplösningen. Du kan se ytterligare felinformation i loggen som:

  • javax.naming.PartialResultException [Root exception is javax.naming.CommunicationException: domain.com:389 [Root exception is java.net.ConnectException: Connection refused: connect]]
  • javax.naming.PartialResultException [Root exception is javax.naming.CommunicationException: domain.com:389 [Root exception is java.net.ConnectException: Connection timed out: connect]]

Dessa fel identifierar att värdnamnet vägrar anslutningen eller att tidsgränsen nås. Testa att köra en DNS-sökning på detta värdnamn och se till att alla adresser som returneras är giltiga och tillåter anslutningar på porten du har konfigurerat.

Obs! Dessa fel kan uppstå även om du har angett ett giltigt värdnamn eller en giltig IP-adress i GCDS-konfigurationen. Active Directory kan utfärda ett LDAP-referenssvar som hänvisar GCDS till att ansluta via ett värdnamn. Denna referens kan vara till värdnamnet som inte kan tolkas. Du kan undvika dessa referenser genom att ansluta till Active Directory-servern med hjälp av Global Catalog-porten som är 3268 som standard. Mer information finns i Microsoft-dokumentationen.

Tecknet är ogiltigt på plats

En del av informationen i det anpassade schemat är inte giltigt. Om du vill kontrollera vilka gränser som gäller för anpassat schema går du till Directory API: Anpassade användarfält.

Om du har aktiverat loggar på spårningsnivå kan du också se hela HTTP-begäran för det anpassade schemat.

java.util.concurrent.
ExecutionException: java.lang.OutOfMemoryError: GC
gränsen har överskridits

Den definierade minnesgränsen har överskridits. Den här händelsen gjorde att synkroniseringen misslyckades.

Lös problemet genom att gå till Vad ska jag göra om jag ser minnesrelaterade fel?

Det gick inte att ansluta till den angivna LDAP-servern

GCDS kan inte ansluta till LDAP-servern. Kontrollera följande:

  • Du använder rätt kommunikationsprotokoll. Om LDAP-servern kräver ett säkert protokoll, ska LDAP + SSL användas.
  • LDAP-servern är aktiv och har inga anslutningsproblem.
Nätverksproblem: Det går inte att ansluta till den angivna LDAP-servern

GCDS hittar inte LDAP-servern. Se till att datorn som kör GCDS har åtkomst till den angivna värden och porten.

Autentiseringsproblem: Det går inte att ansluta med de angivna referenserna

LDAP-servern avvisar GCDS-begäranden på grund av ett autentiseringsproblem.

Se till att den auktoriserade användaren och hans eller hennes lösenord är korrekt. Du bör lägga till den auktoriserade användaren med det fullständiga DN. Mer information om att lägga till den auktoriserade användaren finns i LDAP-anslutningsinställningarna.

Det gick inte att köra frågan på bas-DN <base-dn>

GCDS kan inte ansluta till basens unika namn. Kontrollera följande:

Det gick inte att köra frågan på Base DN <base-dn> för attributet: <attribute>, orsak: NameNotFoundException

GCDS hittar inte information från LDAP-servern. Kontrollera följande:

  • Objektet <base-dn> finns och är tillgängligt för den auktoriserade användaren. Mer information finns i LDAP-anslutningsinställningarna.
  • <attribute> för objektet <base-dn> finns på LDAP-servern.

Medlemmen finns redan

Det här felet kan visas om:

  • Du har en medlem vars primära LDAP-adress är en aliasadress i Google Workspace. Undvik om möjligt denna situation (använd till exempel ett annat användarnamn för aliaset).
  • Ett användarkonto har samma användarnamn för två aliasadresser. Och du har markerat rutan Ersätt domännamn i LDAP-e-postadresser på sidan Google-domänkonfiguration.

    Om du markerar rutan ändras LDAP-e-postadresserna så att de matchar domänen i fältet Alternativ e-postdomän.

Avmarkera rutan eller ändra ett av aliasnamnen.

Om du även får följande meddelande i loggarna: ”Error while adding member user-email-address to group group-email-address due to address collision” kontrollerar du följande:

  • GCDS uteslöt användaren med user-email-address från synkroniseringen baserat på dina uteslutningsregler. Kontrollera uteslutningsreglerna och försök igen. Mer information finns i Utelämna data med uteslutningsregler och frågor.
  • Du har uppdaterat användaren eller gruppen utanför GCDS. Rensa cacheminnet och försök igen.
Ogiltig indata: INVALID_OU_ID

GCDS försöker placera en användare i en organisationsenhet som inte finns i organisationens Google-konto. Justera reglerna för användarsökning och försök igen. Mer information finns i Sökregler för användare.

Kvoten har överskridits för kvotmätvärdet Sökfrågor och gränsen Sökfrågor per minut per användare för tjänsten licensing.googleapis.com "reason": "rateLimitExceeded"

Kontrollera att värdet för <maxResults> är inställt på 500 i XML-konfigurationsfilen för GCDS. Ändra vid behov till 500 och kör synkroniseringen igen.

Felsökning av vanliga GCDS-frågor


Google, Google Workspace och tillhörande märken och logotyper är varumärken som tillhör Google LLC. Alla andra företags- och produktnamn är varumärken som tillhör de företag som de är kopplade till.