Deze functie wordt ondersteund in de volgende versies: Frontline Standard, Frontline Plus, Business Plus, Enterprise Standard, Enterprise Plus, Education Fundamentals, Education Standard, Education Plus en Enterprise Essentials Plus. Versies vergelijken
Voordat u de LDAP-client koppelt aan de Secure LDAP-service, kunt u optioneel een snelle connectiviteitstest uitvoeren met eenvoudige tools als ldapsearch, ADSI en ldp.exe. U kunt deze tools ook gebruiken om problemen op te lossen als u een foutmelding krijgt wanneer u uw LDAP-client koppelt aan de service.
Met de tests die in de gedeelten hieronder worden beschreven, kunt u nagaan of er een configuratieprobleem aan uw kant is, wat veelvoorkomende foutmeldingen zijn en hoe u deze problemen kunt oplossen.
Dit artikel bevat de volgende gedeelten:
- Connectiviteit verifiëren en een LDAP-query uitvoeren
Als u een LDAP-query uitvoert, kunt u bevestigen dat u verbinding kunt maken met Secure LDAP en query's kunt uitvoeren. - Voer zo nodig een eenvoudige connectiviteitstest uit
Als een LDAP-query mislukt, voert u een eenvoudige connectiviteitstest uit om de netwerktoegang en verificatie te testen.
Opmerking: Als u tijdens dit proces contact moet opnemen met Google Workspace-support of Cloud Identity Premium-support, moet u de uitvoer van de opdrachten opslaan. Verwijder alle persoonlijk identificeerbare informatie uit de uitvoer voordat u deze deelt met het supportteam.
De koppeling verifiëren en een LDAP-zoekopdracht uitvoeren
Nadat u de Secure LDAP-service heeft ingesteld in de Google Beheerdersconsole, kunt u een van deze 3 eenvoudige tools gebruiken om de connectiviteit met Secure LDAP te verifiëren: ldapsearch, ADSI of ldp.exe. Bekijk de gedeelten hieronder voor meer informatie en instructies.
ldapsearch
Gebruik het hulpprogramma ldapsearch vanaf een opdrachtregel om een eenvoudige LDAP-query te maken. Als de LDAP-zoekopdracht slaagt, betekent dit dat de LDAP-client en onderliggende TLS-sessie en TCP-koppeling naar behoren werken.
Zo test u de connectiviteit met ldapsearch:
- Maak een LDAP-configuratie en download het certificaat volgens de instructies in LDAP-clients toevoegen.
Opmerking: Zorg dat er minstens één gebruiker is in de organisatie-eenheid waarvoor u LDAP-clienttoegang autoriseert om de testomgeving te vereenvoudigen.
- Voer een LDAP-query uit. In dit voorbeeld wordt een query uitgevoerd voor een bepaalde gebruiker (ga naar OpenLDAP ldapsearch voor meer informatie).
LDAPTLS_CERT={crt_file} LDAPTLS_KEY={key_file} ldapsearch -H ldaps://ldap.google.com:636 -b dc={domain},dc={domain} '(mail={user_email})'Vervang de tijdelijke aanduidingen als volgt:
- {crt_file} De naam van het .crt-bestand
- {key_file} De bestandsnaam van het .key-bestand
- {domain} Elk deel van de domeinnaam, bijvoorbeeld: example.com wordt dc=example,dc=com
- {user_email}: Het primaire e-mailadres van een gebruiker in het domein.
Opmerkingen over het gebruik van ldapsearch
- Als er geen BindDN-waarde is ingevoerd, gebruikt ldapsearch de sleutel en het certificaat om de zoekopdracht te autoriseren.
- Als de BindDN-waarde een LDAP-gebruikersnaam is die u heeft gemaakt in de Beheerdersconsole, gebruikt ldapsearch de rechten van de LDAP-client zoals ingesteld in de Beheerdersconsole.
ldapsearch -H ldaps://ldap.google.com:636 -b dc={domain},dc={domain} -D {ldap_access_credentials_username} -W '(mail={user_email}) - Als de BindDN-waarde een e-mailadres of LDAP-DN van een Workspace-gebruiker is, gebruikt ldapsearch de inloggegevens van die gebruiker om te zoeken op basis van de rechten van die gebruiker.
ldapsearch -H ldaps://ldap.google.com:636 -b dc={domain},dc={domain} -D {workspace_username@domain} -W '(mail={user_email})'
ldapsearch gebruiken met stunnel
Als u stunnel moet gebruiken voor uw implementatie, volgt u deze stappen:
- Maak inloggegevens in de Beheerdersconsole om de gebruikersnaam en het wachtwoord te genereren die ldapsearch nodig heeft.
- Gebruik de volgende opdracht:
ldapsearch -x -D "{username}" -w {password} -H ldap://{stunnel_host}:{stunnel_port} -b dc={domain},dc={domain} '(mail={user_email})'Vervang de tijdelijke aanduidingen als volgt:
- {username}: De gebruikersnaam uit de gegenereerde inloggegevens in de Beheerdersconsole.
- {password} Wachtwoord van de gegenereerde inloggegevens in de Beheerdersconsole
- {stunnel_host}: Het IP-adres of de hostnaam van de machine waarop stunnel wordt uitgevoerd in uw netwerk.
- {stunnel_port}: de poort waarop stunnel wordt uitgevoerd, deze staat in uw stunnel-configuratie
- {user_email}: Het primaire e-mailadres van een gebruiker in het domein.
Succesvol scenario van de opdracht ldapsearch
Een geslaagde uitvoer van de opdracht ldapsearch geeft de gebruiker met het e-mailadres (zoals opgegeven bij het maken van de LDAP-client) weer in LDIF-indeling.
Voorbeeld:
# extended LDIF
#
# LDAPv3
# base <dc=example,dc=com> with scope subtree
# filter: (objectclass=*)
# requesting: ALL
#
# example.com
dn: dc=example,dc=com
objectClass: top
objectClass: domain
objectClass: dcObject
dc: example
# admin-group, Groups, example.com
dn: cn=admin-group,ou=Groups,dc=example,dc=com
objectClass: top
objectClass: groupOfNames
objectClass: posixGroup
cn: admin-group
displayName: admin-group
description:
gidNumber: 12345
member: uid=admin,ou=Users,dc=example,dc=com
memberUid: admin
googleAdminCreated: FALSE
# example-user, Users, example.com
dn: uid=example-user,ou=Users,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
objectClass: posixAccount
uid: example-user
googleUid: example-user
posixUid: example-user
cn: example-user
cn: FirstName LastName
sn: FirstName
displayName: FirstName LastName
givenName: FirstName
mail: example-user@example.com
uidNumber: 12345
gidNumber: 12345
homeDirectory: /home/example-user
loginShell: /bin/bash
gecos:
Mogelijke fouten
- De OpenLDAP-client en/of -bibliotheek zijn gecompileerd zonder SNI-ondersteuning
SNI (Server Name Indication) moet worden ondersteund door de LDAP-client (OpenLDAP in dit geval). Als SNI niet beschikbaar is, krijgt u misschien een foutmelding zoals deze:SASL/EXTERNAL authentication startedldap_sasl_interactive_bind_s: Unknown authentication method (-6)additional info: SASL(-4): no mechanism available:
Aanbeveling:- Als u MacOS gebruikt, is SASL standaard ingeschakeld. Dit kan worden overgeslagen met de optie '-x'.
- Voeg de optie
-d5toe aan ldapsearch en controleer de uitvoer voor de volgende regel:TLS certificate verification: depth: 0, err: 18, subject: /OU=No SNI provided; please fix your client.
-
ldapsearch retourneert status 0 (geslaagd), maar er worden geen gebruikers uitgevoerd
Als u de ldapsearch-optie-x(SASL-verificatie gebruiken) opgeeft met clientcertificaten, wordt de verificatie uitgevoerd, maar worden de gebruikers in het domein niet vermeld.
Aanbeveling: Verwijder de optie-xen probeer het opnieuw.
ADSI Edit (Windows)
- Volg stap 1-11 in ldp.exe (Windows) om de clientcertificaten te installeren.
- Ga naar Action > Connect to… (Actie > Koppelen aan).
- Voer de volgende verbindingsinstellingen in:
Naam: Typ een naam voor de verbinding, bijvoorbeeld Google LDAP.
Verbindingspunt: Selecteer of typ een DN (Distinguished Name) of naamgevingscontext
Voer uw domeinnaam in DN-indeling in (bijvoorbeeld dc=example,dc=com voor example.com).
Computer: Selecteer of typ een domein of server
ldap.google.com
Op SSL gebaseerde versleuteling gebruiken: Aangevinkt - Klik op Advanced... (Geavanceerd...) en voer de volgende gegevens in:
Specify credentials: (Inloggegevens invoeren:) Aangevinkt
Username: (Gebruikersnaam:) De gebruikersnaam van de inloggegevens uit de Beheerdersconsole
Password: (Wachtwoord:) Het wachtwoord van de inloggegevens uit de Beheerdersconsole
Port Number: (Poortnummer:) 636
Protocol: LDAP
Simple bind authentication: (Eenvoudige bind-verificatie:) Aangevinkt - Klik op OK en klik nogmaals op OK.
- Als de koppeling is geslaagd, wordt de directory-content in de base DN weergegeven in het rechtervenster.
ldp.exe (Windows)
- Installeer OpenSSL.
- Converteer de certificaat- en sleutelbestanden naar één bestand in PKCS12-indeling. Voer bij een opdrachtprompt het volgende in:
openssl pkcs12 -inkey ldap-client.key -in ldap-client.crt -export -out ldap-client.p12
Voer een wachtwoord in om het uitvoerbestand te versleutelen. - Ga naar het configuratiescherm.
- Zoek in het zoekvak naar certificaat en klik op Gebruikerscertificaten beheren.
- Ga naar Action > All Tasks > Import… (Actie > Alle taken > Importeren).
- Selecteer Current User (Huidige gebruiker) en klik op Next (Volgende).
- Klik op Browse… (Browsen).
- Selecteer in het dropdownmenu file type (bestandstype) rechtsonder in het dialoogvenster de optie Personal Information Exchange (*.pfx;*.p12).
- Selecteer het bestand ldap-client.p12 uit stap 2, klik op Openen en klik op Volgende.
- Voer het wachtwoord in uit stap 2 en klik op Next (Volgende).
- Selecteer de certificaatopslag Persoonlijk, klik op Volgende en klik op Voltooien.
- Voer Ldp.exe uit.
- Ga naar Verbinding > Verbinden...
- Voer de volgende verbindingsgegevens in:
Server: ldap.google.com
Poort: 636
Verbindingsloos: Uitgevinkt
SSL: Aangevinkt - Klik op OK.
- Ga naar View > Tree (Weergave > Structuur).
- Voer de base DN in. Dit is uw domeinnaam in DN-indeling (bijvoorbeeld dc=example,dc=com voor example.com).
- Klik op OK.
- Als de koppeling is geslaagd, wordt de directory-content in de base DN weergegeven in het rechtervenster.
Voer zo nodig een eenvoudige connectiviteitstest uit
Als u geen succesvol resultaat krijgt in De connectiviteit verifiëren en een LDAP-query uitvoeren, volgt u de instructies in dit gedeelte voor connectiviteitstests. Als ldapsearch de verwachte gebruiker niet retourneert en niet duidelijk aangeeft dat de onderliggende TLS-sessie is geslaagd, gebruikt u de OpenSSL-client om te controleren of de netwerklagen waarvan OpenLDAP afhankelijk is, werken zoals verwacht.
Zo voer je een eenvoudige connectiviteitstest uit:
Installeer de clienttool openssl voor uw besturingssysteem.
De meeste GNU/Linux-distributies gebruiken de pakketnaam 'openssl'. Bekijk informatie over andere besturingssystemen.
Maak een handmatige koppeling met de Secure LDAP-service met de openssl-client:
openssl s_client -connect ldap.google.com:636Controleer of de SSL-onderhandeling is geslaagd door te kijken of de volgende regel onderaan de uitvoer van de openssl-s_client staat:
Verify return code: 0 (ok)
Mogelijke foutmeldingen
OpenSSL-client/-bibliotheek ondersteunt geen SNI (Server Name Indication)
Tijdens de connectiviteitstest kan de volgende uitvoer worden geretourneerd:
Verify return code: 18 (self signed certificate)
Voor de Secure LDAP-service is een TLS-client vereist die een TLS-sessie ondersteunt en start met SNI (Server Name Indication). Als de TLS-client SNI niet ondersteunt, retourneert de TLS-server (ldap.google.com) een zelfondertekend certificaat dat niet door de CA-validatiecontroles komt. Dit geeft aan dat SNI is vereist.
U kunt controleren of dit geval is door te kijken of de volgende regel tegen het begin van de uitvoer van de OpenSSL-client staat:
depth=0 OU = "No SNI provided; please fix your client.", CN = invalid2.invalid
Deze fout kan worden veroorzaakt doordat u een OpenSSL-versie gebruikt waarin SNI niet wordt ondersteund, of doordat u een app gebruikt die de OpenSSL-bibliotheek gebruikt met SNI expliciet uitgeschakeld.
Verbinding geweigerd
Als de volgende uitvoer wordt geretourneerd (waarbij {timestamp} een UNIX-tijdstempel in microseconden is), wordt de TCP-verbinding actief geweigerd voordat de TLS-onderhandeling kan beginnen:
{timestamp}:error:0200206F:system library:connect:Connection refused:crypto/bio/b_sock2.c:110:
{timestamp}:error:2008A067:BIO routines:BIO_connect:connect error:crypto/bio/b_sock2.c:111:connect:errno=111
Dit kan de volgende oorzaken hebben:
- Een firewall op app- of systeemniveau op de lokale computer.
- Een firewall op hetzelfde fysieke netwerk of een netwerk upstream.
Gebruik tcptraceroute om te bepalen welke host de koppeling weigert (bijvoorbeeld tcptraceroute ldap.google.com 636).