Suivez les instructions de cet article pour connecter votre client LDAP au service LDAP sécurisé.
Important :
- Veillez à lire la documentation de votre fournisseur.
Les informations de cet article sur la connexion de votre client LDAP au service LDAP sécurisé sont fournies à titre de référence uniquement et peuvent être modifiées. En plus de ces instructions d'aide, veillez à lire la documentation de votre fournisseur pour connaître les étapes les plus récentes permettant de connecter votre client au service LDAP sécurisé. - Avant de commencer
Avant d'utiliser ces instructions, assurez-vous d'avoir déjà ajouté le client au service LDAP sécurisé, configuré les autorisations d'accès, téléchargé un certificat et une clé client et, éventuellement, créé des identifiants d'accès. - Test de connectivité :
avant de commencer ces étapes, vous pouvez effectuer un test de connectivité rapide à l'aide d'outils simples tels que ldapsearch, ADSI et ldp.exe. Vous pouvez également utiliser ces outils pour résoudre d'éventuelles erreurs rencontrées lors de la tentative de connexion de votre client LDAP au service. Pour obtenir des instructions, consultez Tester la connectivité LDAP sécurisée. - Comment terminer la configuration
Après avoir connecté le client LDAP en suivant les instructions de cette page, vous devez terminer la configuration de votre client LDAP en définissant l'état du service sur Activé dans la console d'administration Google. Pour obtenir des instructions, consultez 5. Définissez le paramètre "Clients LDAP" sur Activé.
Contenu de cet article
Cet article est composé des sections suivantes :
- Instructions de configuration de base : incluent des instructions génériques pour connecter les clients LDAP qui ne sont pas spécifiés dans cet article.
- Instructions de configuration pour des clients LDAP spécifiques : inclut des instructions pour connecter des clients LDAP spécifiques (tels qu'Atlassian Jira ou OpenVPN) au service LDAP sécurisé. La procédure varie en fonction du type de client.
- Instructions de configuration pour les applications Java : incluent des instructions génériques pour les applications basées sur Java qui offrent la fonctionnalité LDAP.
- Facultatif : Utilisez stunnel comme proxy : cette section inclut des instructions qui spécifient des considérations supplémentaires lors de la connexion de clients LDAP qui ne sont pas compatibles avec les certificats numériques.
Ces instructions supposent que les fichiers de clé et de certificat client que vous téléchargez sont appelés ldap-client.key et ldap-client.crt.
Instructions de configuration de base
Cette section inclut des instructions génériques pour connecter votre client LDAP au service LDAP sécurisé. Si votre client LDAP ne figure pas dans les instructions ci-dessous, veillez à consulter la documentation de cette application.
Remarque : Certains clients LDAP, tels qu'Atlassian Jira et SSSD, effectuent une recherche d'utilisateur pour obtenir plus d'informations sur un utilisateur lors de l'authentification. Pour vous assurer que l'authentification des utilisateurs fonctionne correctement pour ces clients LDAP, vous devez activer l'option Lire les informations utilisateur pour toutes les unités organisationnelles où l'option Valider les identifiants utilisateur est activée. (Pour obtenir des instructions, consultez Configurer les autorisations d'accès.)
Pour connecter le client LDAP au service LDAP sécurisé :
- Configurez votre client LDAP en définissant l'annuaire cloud comme serveur LDAP.
Importez le certificat sur votre client LDAP.
Le service LDAP sécurisé utilise les certificats client TLS comme principal mécanisme d'authentification. Pour commencer à importer le certificat dans le client LDAP, ouvrez les paramètres d'authentification ou d'annuaire du client LDAP, puis saisissez les informations du tableau ci-dessous.
Remarque : Pour en savoir plus sur la façon d'importer des certificats TLS et sur l'emplacement où les importer, veuillez consulter la documentation de votre fournisseur.
Le tableau suivant vous indique les informations de connexion de base :
|
Hostname (Nom d'hôte) |
ldap.google.com |
|---|---|
|
Ports |
389 pour LDAP avec StartTLS activé |
|
Base DN (Nom de domaine de base) |
Votre domaine au format DN. Exemple : dc=example,dc=com pour example.com |
|
Nom d'utilisateur et mot de passe |
En plus de l'authentification par certificat, certains clients LDAP exigent que vous saisissiez un nom d'utilisateur et un mot de passe. Si vous n'êtes pas dans ce cas-là, vous pouvez ignorer cette étape. Générez un nom d'utilisateur et un mot de passe dans la console d'administration Google. Pour obtenir des instructions, consultez la page Générer des identifiants d'accès. |
|
Fichiers de certificat et de clé client |
Utilisez le fichier de certificat et de clé téléchargé depuis la console d'administration Google. Si le client LDAP ne permet pas de s'authentifier avec un certificat client, consultez Utiliser stunnel comme proxy. IMPORTANT : Certains clients LDAP, tels qu'Apache Directory Studio, ne sont pas compatibles avec l'importation de certificats numériques. Pour résoudre ce problème, consultez la section Utiliser stunnel en tant que proxy. |
Instructions de configuration pour des clients LDAP spécifiques
ADSI Edit (Windows)
Suivez la procédure ci-dessous :
- Suivez les étapes 1 à 11 de ldp.exe (Windows) pour installer les certificats client.
- Accédez à Action > Connect to (Action > Se connecter à).
- Saisissez les paramètres de connexion suivants :
Nom : saisissez un nom pour votre connexion, par exemple Google LDAP.
Point de connexion : "Sélectionnez ou saisissez un nom unique ou un contexte d'attribution de noms"
Saisissez votre nom de domaine au format DN (par exemple, dc=example,dc=com pour example.com).
Ordinateur : "Sélectionnez ou saisissez un domaine ou un serveur"
ldap.google.com
Utiliser le chiffrement SSL : coché
- Cliquez sur Avancé…, puis saisissez les informations suivantes :
Spécifier les identifiants : coché
Nom d'utilisateur : nom d'utilisateur des identifiants d'accès dans la console d'administration
Mot de passe : mot de passe des identifiants d'accès dans la console d'administration
Numéro de port : 636
Protocole : LDAP
Authentification par liaison simple : coché
- Cliquez sur OK, puis de nouveau sur OK.
- Si la connexion aboutit, le contenu Active Directory s'affiche dans le volet de droite dans le format DN de base.
Apache Directory Studio
Pour utiliser Apache Directory Studio, connectez-vous via stunnel et utilisez des identifiants d'accès (nom d'utilisateur et mot de passe) générés dans la console d'administration Google. En supposant que les identifiants sont en place et que stunnel écoute sur le port 1389 de localhost, procédez comme suit :
- Cliquez sur File > New (Fichier > Nouveau).
- Sélectionnez LDAP Browser > LDAP Connection (Navigateur LDAP > Connexion LDAP).
- Cliquez sur Suivant.
- Saisissez les paramètres de connexion :
Nom de la connexion : choisissez un nom, par exemple Google LDAP.
Nom d'hôte : localhost
Port : 1389 (ou le port d'écoute/d'acceptation de stunnel)
Méthode de chiffrement : aucun chiffrement (remarque : si stunnel s'exécute à distance, il est recommandé de chiffrer la connexion entre stunnel et le client).
- Cliquez sur Suivant.
- Saisissez les paramètres d'authentification :
Méthode d'authentification : authentification simple
DN ou utilisateur à associer : nom d'utilisateur des identifiants d'accès dans la console d'administration
Mot de passe à associer : mot de passe des identifiants d'accès dans la console d'administration
- Cliquez sur Suivant.
- Saisissez le nom de domaine de base.
Il s'agit de votre nom de domaine au format DN (dc=example,dc=com pour example.com). - Cliquez sur Terminer.
Atlassian Jira
Atlassian Jira effectue une recherche d'utilisateur pour obtenir plus d'informations sur un utilisateur lors de l'authentification. Pour vous assurer que l'authentification des utilisateurs fonctionne correctement pour ce client LDAP, vous devez activer les options Lire les informations utilisateur et Lire les informations sur les groupes pour toutes les unités organisationnelles où l'option Valider les identifiants utilisateur est activée. Pour en savoir plus, consultez Configurer les autorisations d'accès.
Important : Les instructions ci-dessous peuvent entraîner la divulgation de keystorePassword aux utilisateurs et aux fichiers journaux. Prenez des précautions pour éviter tout accès non autorisé au shell local, au fichier journal et à la console d'administration Google. Au lieu de suivre les instructions ci-dessous, utilisez la méthode stunnel4 (consultez Facultatif : Utiliser stunnel comme proxy).
Remarque : Les instructions suivantes supposent que Jira est installé à l'adresse /opt/atlassian/jira.
Pour connecter un client Atlassian Jira au service LDAP sécurisé :
- Copiez le certificat et la clé sur le(s) serveur(s) Jira. (Il s'agit du certificat généré dans la console d'administration Google lorsque vous ajoutez le client LDAP au service LDAP sécurisé.)
Par exemple :
$ scp ldap-client.key user@jira-server:
- Convertissez le certificat et les clés au format Java KeyStore. Vous serez invité à saisir des mots de passe au cours de cette procédure. Pour plus de facilité, sélectionnez un mot de passe sécurisé et utilisez-le à chaque invite.
$ openssl pkcs12 -export -out jira-ldap.pkcs12 -in ldap-client.crt -inkey ldap-client.key
$ sudo /opt/atlassian/jira/jre/bin/keytool -v -importkeystore -srckeystore jira-ldap.pkcs12 -srcstoretype PKCS12 -destkeystore /opt/atlassian/jira/jira-ldap.jks -deststoretype JKS
- Configurez Jira de façon à utiliser le keystore nouvellement créé. Suivez les instructions ici pour ajouter des options :
"-Djavax.net.ssl.keyStore=/opt/atlassian/jira/jira-ldap.jks -Djavax.net.ssl.keyStorePassword=password"
Sur Linux :- Saisissez /opt/atlassian/jira/bin/setenv.sh.
- Recherchez le paramètre JVM_SUPPORT_RECOMMENDED_ARGS.
- Ajoutez "-Djavax.net.ssl.keyStore=/opt/atlassian/jira/jira-ldap.jks -Djavax.net.ssl.keyStorePassword=password", en remplaçant "password" par le mot de passe que vous avez sélectionné ci-dessus.
- Relancez Jira.
$ /opt/atlassian/jira/bin/stop-jira.sh
$ /opt/atlassian/jira/bin/start-jira.sh
- Connectez-vous à l'interface Web de Jira en tant qu'administrateur.
- Accédez à Paramètres > Gestion des utilisateurs. (Pour accéder aux paramètres, cliquez sur l'icône en forme de roue dentée en haut à droite.)
- Cliquez sur User Directories (Annuaires utilisateur).
- Cliquez sur Ajouter un annuaire.
- Choisissez LDAP comme type.
- Cliquez sur Suivant.
- Saisissez les valeurs suivantes :
Name (Nom)
LDAP sécurisé Google
Directory type (Type d'annuaire)
OpenLDAP
Hostname (Nom d'hôte)
ldap.google.com
Port
636
Use SSL (Connexion SSL)
Coché
Nom d'utilisateur
Générez un nom d'utilisateur et un mot de passe dans la console d'administration Google. Pour obtenir des instructions, consultez la page Générer des identifiants d'accès.
Mot de passe
Générez un nom d'utilisateur et un mot de passe dans la console d'administration Google. Pour obtenir des instructions, consultez la page Générer des identifiants d'accès.
Base DN (Nom de domaine de base)
Votre nom de domaine au format DN, par exemple, dc=example,dc=com pour example.com
Additional User DN (Nom distinctif d'utilisateur supplémentaire)
Facultatif. "ou=Users"
Additional Group DN (Nom distinctif de groupe supplémentaire)
Facultatif. "ou=Groups"
LDAP Permissions (Autorisations LDAP)
Lecture seule
Advanced Settings (Paramètres avancés)
Non modifié
User Schema Settings >
User Name Attribute (Paramètres de schéma utilisateur > Attribut de nom d'utilisateur)googleUid
User Schema Settings >
User Name RDN Attribute (Paramètres de schéma utilisateur > Attribut RDN de nom d'utilisateur)uid
Group Schema Settings >
Group Object Class (Paramètres de schéma de groupe > Classe d'objet de groupe)groupOfNames
Group Schema Settings >
Group Object Filter (Paramètres de schéma de groupe > Filtre d'objet de groupe)(objectClass=groupOfNames)
Membership Schema Settings >
Group Members Attribute (Paramètres de schéma d'appartenance > Attribut "Membres de groupe")member
Membership Schema Settings >
Use the User Membership Attribute (Paramètres de schéma d'appartenance > Utiliser l'attribut "Adhésion utilisateur")Coché - Attribuez un rôle à un groupe.
Avant qu'Atlassian Jira puisse autoriser un utilisateur à se connecter, celui-ci doit être membre d'un groupe ayant accès à Jira.
Pour attribuer un rôle à un groupe, procédez comme suit :- Accédez à Settings > Applications > Application access (Paramètres > Applications > Accès aux applications).
- Dans la zone de texte Sélectionner un groupe, saisissez le nom du groupe Google pour lequel vous souhaitez autoriser l'accès à Jira.
CloudBees Core/Jenkins
Pour savoir comment connecter CloudBees Core au service LDAP sécurisé, consultez Configure CloudBees Core with Google's Cloud Identity Secure LDAP.
FreeRADIUS
Suivez la procédure ci-dessous :
- Installez et configurez FreeRADIUS dans /etc/freeradius/3.0/.
Une fois FreeRADIUS installé, vous pouvez ajouter la configuration LDAP en installant le plug-in freeradius-ldap.
$ sudo apt-get install freeradius freeradius-ldap
- Copiez les fichiers de clé et de certificat du client LDAP dans /etc/freeradius/3.0/certs/ldap-client.key et /etc/freeradius/3.0/certs/ldap-client.crt, respectivement.
$ chown freeradius:freeradius
/etc/freeradius/3.0/certs/ldap-client.*
$ chmod 640 /etc/freeradius/3.0/certs/ldap-client.*
- Activez le module LDAP.
$ cd /etc/freeradius/3.0/mods-enabled/
$ ln -s ../mods-available/ldap ldap
- Modifiez /etc/freeradius/3.0/mods-available/ldap.
- ldap->server = 'ldaps://ldap.google.com:636'
- identity = nom d'utilisateur issu des identifiants de l'application
- password = mot de passe issu des identifiants de l'application
- base_dn = 'dc=domain,dc=com'
- tls->start_tls = no
- tls->certificate_file = /etc/freeradius/3.0/certs/ldap-client.crt
- tls->private_key_file = /etc/freeradius/3.0/certs/ldap-client.key
- tls->require_cert = 'allow'
- Commentez tous les champs du fil d'Ariane représentant la section "ldap -> post-auth -> update"
- Modifiez /etc/freeradius/3.0/sites-available/default.
Cette action entraîne la modification de la connexion du client FreeRadius. Si vous n'utilisez pas le client par défaut, veillez à mettre à jour le client concerné (client inner-tunnel ou client personnalisé) que vous avez configuré.
- Modifiez la section authorize pour ajouter le bloc suivant en bas après l'instruction du protocole d'authentification par mot de passe (PAP) :
if (User-Password) {
update control {
Auth-Type := ldap
}
}
- Dans la section authorize, activez LDAP en supprimant le signe "-" qui le précède.
#
# The ldap module reads passwords from the LDAP database.
ldap
- Modifiez la section authenticate en modifiant le bloc Auth-Type LDAP comme suit :
# Auth-Type LDAP {
ldap
# }
- Modifiez la section authenticate en modifiant le bloc Auth-Type PAP comme suit :
Auth-Type PAP {
# pap
ldap
}
- Modifiez la section authorize pour ajouter le bloc suivant en bas après l'instruction du protocole d'authentification par mot de passe (PAP) :
GitLab
Pour obtenir des informations sur la connexion de GitLab au service LDAP sécurisé, consultez l'article Google Secure LDAP relatif à la configuration pour GitLab.
Itopia/Ubuntu
Pour savoir comment connecter Itopia/Ubuntu au service LDAP sécurisé, consultez Configurer Google Cloud Identity LDAP sur Ubuntu 16.04 pour les connexions utilisateur.
Ivanti/LanDesk
Suivez la procédure ci-dessous :
- Sur votre serveur Web Ivanti, ouvrez OpenLDAPAuthenticationConfiguration.xml ou OpenLDAPSSLAuthenticationConfiguration.xml dans un éditeur de texte dans les deux dossiers suivants :
C:\ProgramData\LANDesk\ServiceDesk\servicedesk.Framework et C:\ProgramData\LANDesk\ServiceDesk\servicedesk.WebAccess (où servicedesk est le nom de l'instance). - Remplacez la valeur <Server> par ldap.google.com.
- Remplacez la valeur <Port> par le port 3268 pour le texte en clair avec StartTLS activé et par le port 3269 pour le port SSL/TLS (les valeurs par défaut sont 389 pour le port en texte clair et 636 pour le port SSL/TLS).
- Définissez la valeur <TestDN> sur votre nom de domaine au format DN. (par exemple, dc=example,dc=com pour example.com).
- Ajoutez la ligne suivante à ..ProgramData\LANDesk\ServiceDesk\ServiceDesk.Framework\tps.config et à ..ProgramData\LANDesk\ServiceDesk\WebAccess\tps.config :
<add key="AuthenticationProvider" value="Touchpaper.Integrations.OpenLDAPLogon.OpenLDAPAuthenticationProvider" />
ou la ligne suivante :
<add key="AuthenticationProvider" value="Touchpaper.Integrations.OpenLDAPSSLLogon.OpenLDAPSSLAuthenticationProvider" />
- Dans le centre de configuration d'Ivanti, ouvrez l'instance requise.
- À côté de l'application Service Desk Framework, cliquez sur Edit (Modifier).
La boîte de dialogue Edit Application (Modifier l'application) pour Service Desk Framework s'ouvre alors. - Dans le groupe Configuration parameters (Paramètres de configuration), sélectionnez Explicit only (Explicite uniquement) dans la liste Logon policy (Règles de connexion), puis cliquez sur OK.
- À côté de l'application Web Access, cliquez sur Modifier.
La boîte de dialogue Edit Application (Modifier l'application) pour Web Access s'ouvre alors. - Dans le groupe Paramètres de configuration, sélectionnez Explicite uniquement dans la liste Règle de connexion, puis cliquez sur OK.
Connectez-vous à l'aide du mot de passe réseau de l'utilisateur du domaine associé.
Journalisation des exceptions pour l'authentification du serveur LDAP
Si vous rencontrez des problèmes pour configurer l'authentification du serveur LDAP, vous pouvez activer la journalisation des exceptions pour vous aider à identifier le problème. Cette option est désactivée par défaut, et nous vous recommandons de la désactiver à nouveau lorsque vous avez terminé vos investigations.
Pour activer la journalisation des exceptions pour l'authentification du serveur LDAP :
- Ouvrez le fichier XML de configuration d'authentification approprié dans un éditeur de texte :
DirectoryServiceAuthenticationConfiguration.xml, OpenLDAPAuthenticationConfiguration.xml ou OpenLDAPSSLAuthenticationConfiguration.xml - Modifiez la ligne suivante :
<ShowExceptions>false</ShowExceptions>
par
<ShowExceptions>true</ShowExceptions>
- Enregistrez les modifications.
Ldp.exe (Windows)
Suivez la procédure ci-dessous :
- Convertissez les fichiers de clé et de certificat en un fichier au format PKCS12. À l'invite de commandes, saisissez les éléments suivants :
Si vous utilisez macOS ou Linux, utilisez les commandes suivantes :
openssl pkcs12 -inkey ldap-client.key -in ldap-client.crt -export -out ldap-client.p12
Saisissez un mot de passe pour chiffrer le fichier de sortie.
Si vous utilisez Windows, saisissez les commandes suivantes :
$ certutil -mergepfx ldap-client.crt ldap-client.p12
Important : Les deux fichiers (<CERT_FILE>.crt et <CERT_FILE>.key) doivent se trouver dans le même répertoire. Assurez-vous également que les fichiers key et crt portent le même nom (avec une extension différente). Dans cet exemple, nous utilisons les noms ldap-client.crt et ldap-client.key. - Accédez au panneau de configuration.
- Dans le champ de recherche, recherchez "certificat", puis cliquez sur Gérer les certificats utilisateur.
- Accédez à Action > All Tasks > Import… (Action > Toutes les tâches > Importer).
- Sélectionnez Current User (Utilisateur actuel), puis cliquez sur Next (Suivant).
- Cliquez sur Browse (Parcourir).
- Dans la liste déroulante File type (Type de fichier) en bas à droite de la boîte de dialogue, sélectionnez Personal Information Exchange (*.pfx;*.p12) (Échange d'informations personnelles [*.pfx;*.p12]).
- Sélectionnez le fichier ldap-client.p12 de l'étape 2, cliquez sur Ouvrir, puis sur Suivant.
- Saisissez le mot de passe de l'étape 2, puis cliquez sur Next (Suivant).
- Sélectionnez le magasin de certificats Personnel, cliquez sur Suivant, puis sur Terminer.
- Exécutez Ldp.exe.
- Accédez à Connexion > Se connecter…
- Saisissez les informations de connexion suivantes :
Serveur : ldap.google.com
Port : 636
Sans connexion : décoché
SSL : coché
- Cliquez sur OK.
- Accédez à View > Tree (Affichage > Arborescence).
- Saisissez le nom de domaine de base. Il s'agit de votre nom de domaine au format DN, par exemple dc=example,dc=com pour example.com.
- Cliquez sur OK.
- Si la connectivité est établie, LDP.exe affiche le contenu Active Directory (tous les attributs présents dans le DN de base, par exemple) dans le volet de droite.
Netgate/pfSense
Pour savoir comment connecter Netgate/pfSense au service LDAP sécurisé, consultez Configurer Google Cloud Identity comme source d'authentification.
OpenLDAP/ldapsearch (Linux)
Pour accéder à votre annuaire LDAP à partir de la ligne de commande, vous pouvez utiliser la commande OpenLDAP ldapsearch.
En supposant que vos fichiers de certificat et de clé client soient ldap-client.crt et ldap-client.key, que votre domaine soit example.com et que le nom d'utilisateur soit jsmith :
$ LDAPTLS_CERT=ldap-client.crt LDAPTLS_KEY=ldap-client.key ldapsearch -H ldaps://ldap.google.com -b dc=example,dc=com '(uid=jsmith)'
Cela définit les variables d'environnement pertinentes pour qu'elles pointent vers les clés client. Vous pouvez remplacer les autres options "ldapsearch" par les filtres souhaités, les attributs demandés, etc. Pour en savoir plus, consultez les pages de manuel ldapsearch ("man ldapsearch").
ldapsearch (macOS)
Suivez la procédure ci-dessous :
- Convertissez les fichiers de clé et de certificat en un fichier au format PKCS12. À l'invite de commande, saisissez les éléments suivants :
openssl pkcs12 -inkey ldap-client.key -in ldap-client.crt -export -out ldap-client.p12
Saisissez votre mot de passe pour chiffrer le fichier de sortie.
- Cliquez sur
en haut à droite de la barre de menu, puis saisissez Accès au trousseau d'accès.
- Ouvrez l'application Trousseaux d'accès, puis cliquez sur Système dans la liste de gauche.
- Cliquez sur l'option File (Fichier) dans la barre de menus située en haut à gauche, puis sélectionnez Import items (Importer des éléments).
- Accédez à l'emplacement du fichier ldap-client.p12 généré, sélectionnez-le, puis cliquez sur Ouvrir.
Si vous y êtes invité, saisissez votre mot de passe.
Un certificat portant le nom Client LDAP devrait maintenant apparaître dans la liste des certificats de la trousseau système. - Cliquez sur la flèche à côté du certificat client LDAP. Une clé privée s'affiche en dessous.
- Double-cliquez sur la clé privée.
- Dans la boîte de dialogue, sélectionnez l'onglet Access Control (Contrôle des accès), puis cliquez sur + en bas à gauche.
-
Dans la fenêtre qui s'ouvre, saisissez Commande+Maj+G pour ouvrir une nouvelle fenêtre, puis remplacez le texte existant par /usr/bin/ldapsearch.
-
Cliquez sur Go (Accéder).
Une fenêtre affichant "ldapsearch" en surbrillance s'ouvre. -
Cliquez sur Ajouter.
-
Cliquez sur Enregistrer les modifications, puis saisissez votre mot de passe si vous y êtes invité.
Vous pouvez désormais accéder à votre annuaire LDAP depuis la ligne de commande, à l'aide de la commande OpenLDAP ldapsearch.
-
En supposant que le fichier ldap-client.p12 que vous avez importé dans le trousseau plus tôt porte le nom LDAP Client, que votre domaine est example.com et que le nom d'utilisateur est jsmith, saisissez ce qui suit :
$ LDAPTLS_IDENTITY="LDAP Client" ldapsearch -H ldaps://ldap.google.com:636 -b dc=example,dc=com '(uid=jsmith)'
Les variables d'environnement pertinentes à faire pointer vers le certificat du client importé sont ainsi définies. Vous pouvez remplacer les autres options "ldapsearch" par les filtres souhaités, les attributs demandés, etc. Pour plus d'informations, reportez-vous aux pages relatives à "man ldapsearch" (man ldapsearch).
OpenVPN (version de la communauté)
Suivez la procédure ci-dessous :
- Si nécessaire, installez et configurez OpenVPN. Si vous l'avez déjà fait, ouvrez la page des paramètres dans OpenVPN.
La configuration générale d'un VPN dépasse le cadre de cet article d'aide. Une fois que vous en avez configuré un, vous pouvez ajouter une authentification et une autorisation utilisateur via LDAP. Vous devrez notamment installer le plug-in openvpn-auth-ldap.
$ sudo apt-get install openvpn openvpn-auth-ldap
- Copiez les fichiers de clé et de certificat du client LDAP dans /etc/openvpn/ldap-client.key et /etc/openvpn/ldap-client.crt.
- Créez un fichier /etc/openvpn/auth-ldap.conf contenant les informations suivantes (en supposant que example.com soit le nom de domaine) :
<LDAP>
URL ldaps://ldap.google.com:636 #
Timeout 15
TLSEnable false
TLSCACertDir /etc/ssl/certs
TLSCertFile /etc/openvpn/ldap-client.crt
TLSKeyFile /etc/openvpn/ldap-client.key
</LDAP>
<Authorization>
BaseDN "dc=example,dc=com"
SearchFilter "(uid=%u)" # (or choose your own LDAP filter for users)
RequireGroup false
</Authorization>
- Modifiez le fichier de configuration OpenVPN, qui porte un nom du type /etc/openvpn/server.conf ou similaire. En bas du fichier, ajoutez ce qui suit :
plugin /usr/lib/openvpn/openvpn-auth-ldap.so /etc/openvpn/auth-ldap.conf
verify-client-cert optional
- Redémarrez le serveur OpenVPN.
$ sudo systemctl restart openvpn@server
- Configurez les clients VPN pour qu'ils utilisent les noms d'utilisateur et les mots de passe des utilisateurs. Par exemple, dans une configuration client OpenVPN, ajoutez auth-user-pass à la fin du fichier de configuration client OpenVPN et démarrez le client OpenVPN :
$ openvpn --config /path/to/client.conf
- Suivez les instructions pour utiliser stunnel comme proxy.
OpenVPN Access Server (version commerciale)
Pour savoir comment connecter OpenVPN Access Server au service LDAP sécurisé, consultez Configurer Google Secure LDAP avec OpenVPN Access Server.
PaperCut MF et NG
Pour savoir comment connecter PaperCut au service LDAP sécurisé, consultez How to sync and authenticate Google Workspace and Google Cloud Identity users in PaperCut.
Puppet Enteprise
Pour savoir comment connecter Puppet Enterprise au service LDAP sécurisé, consultez Google Cloud Directory for PE.
Softerra LDAP Browser
Important : Avant de commencer, assurez-vous d'avoir installé Softerra LDAP Browser version 4.5 (4.5.19808.0) ou ultérieure. Consultez LDAP Browser 4.5.
Suivez la procédure ci-dessous :
- Convertissez les fichiers de clé et de certificat en un fichier au format PKCS12. À l'invite de commandes, saisissez les éléments suivants :
Si vous utilisez macOS ou Linux, utilisez les commandes suivantes :
openssl pkcs12 -inkey ldap-client.key -in ldap-client.crt -export -out ldap-client.p12
Saisissez un mot de passe pour chiffrer le fichier de sortie.
Si vous utilisez Windows, saisissez les commandes suivantes :
$ certutil -mergepfx ldap-client.crt ldap-client.p12
Important : Les deux fichiers (<CERT_FILE>.crt et <CERT_FILE>.key) doivent se trouver dans le même répertoire. Assurez-vous également que les fichiers key et crt portent le même nom (avec une extension différente). Dans cet exemple, nous utilisons les noms ldap-client.crt et ldap-client.key. - Dans Softerra LDAP Browser, installez la paire de clés.
- Accédez à Tools > Certificate Manager (Outils > Gestionnaire de certificats).
- Cliquez sur Import… (Importer).
- Cliquez sur Next (Suivant).
- Cliquez sur Browse (Parcourir).
- Dans la liste déroulante Type de fichier en bas à droite de la boîte de dialogue, sélectionnez Échange d'informations personnelles (*.pfx;*.p12).
- Sélectionnez le fichier ldap-client.p12 créé à l'étape 2 ci-dessus.
- Cliquez sur Open (Ouvrir), puis sur Next (Suivant).
- Saisissez le mot de passe de l'étape 2, puis cliquez sur Next (Suivant).
- Sélectionnez le magasin de certificats Personnel.
- Cliquez sur Suivant.
- Cliquez sur Terminer.
- Ajoutez un profil de serveur.
- Accédez à Fichier > Nouveau > Nouveau profil…
- Saisissez un nom pour le profil tel que Google LDAP.
- Cliquez sur Suivant.
Saisissez les informations suivantes :
Hôte : ldap.google.com
Port : 636
DN de base : nom de votre domaine au format DN. (par exemple, dc=example,dc=com pour example.com)
Utiliser une connexion sécurisée (SSL) : coché
- Cliquez sur Suivant.
- Sélectionnez External (SSL Certificate) (Externe [certificat SSL]).
- Cliquez sur Suivant.
- Cliquez sur Terminer.
Sophos Mobile
Pour savoir comment connecter Sophos Mobile au service LDAP sécurisé, consultez Connecting Sophos Mobile to Google Cloud Identity / Google Cloud Directory using Secure LDAP.
Splunk
Lorsque vous connectez Splunk au service LDAP sécurisé, veillez à utiliser Splunk version 8.1.4 ou ultérieure. Lorsque vous utilisez d'anciennes versions de Splunk, comme la version 8.1.3, un nombre excessif de requêtes LDAP peut être envoyé au serveur LDAP, ce qui peut entraîner l'épuisement rapide de votre quota LDAP. Pour en savoir plus sur les problèmes liés à la version 8.1.3 de Splunk, consultez Problèmes connus de Splunk.
Suivez la procédure ci-dessous :
- Copiez les fichiers de la clé et du certificat client LDAP dans /home/splunk/splunkadmin/etc/openldap/certs/ldap-client.key et /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.crt.
$ cat /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.crt /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.key > /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.pem
$ sudo chown $(splunkuser):$(splunkuser) /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.*
$ sudo chmod 644 /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.*
- Modifiez le fichier ldap.conf en ajoutant les configurations suivantes :
ssl start_tls
TLS_REQCERT never
TLS_CERT /home/splunkadmin/splunk/etc/openldap/certs/ldap.pem
TLS_KEY /home/splunkadmin/splunk/etc/openldap/certs/ldap.pem - Ajoutez les configurations suivantes dans le fichier /home/splunkadmin/.ldaprc de l'utilisateur :
TLS_CERT /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.pem
TLS_KEY /home/splunkadmin/splunk/etc/openldap/certs/ldap-client.pem
- Ajoutez la stratégie LDAP à l'aide de l'interface utilisateur Web Splunk. Saisissez les informations suivantes, puis cliquez sur Enregistrer :
|
Name |
LDAP sécurisé Google |
|---|---|
|
Organisateur |
ldap.google.com |
|
Port |
636 |
|
SSL activé |
Coché |
|
Ordre de connexion |
1 |
|
Lier le nom unique |
Saisissez les identifiants d'accès que vous avez générés dans la console d'administration Google. |
|
Mot de passe du DN de liaison |
Saisissez les identifiants d'accès que vous avez générés dans la console d'administration Google. |
|
Base DN (Nom de domaine de base) |
Nom de domaine au format DN (par exemple, dc=example,dc=com pour le domaine example.com) |
|
Filtre de base d'utilisateurs |
Saisissez le filtre de base d'utilisateurs pour la classe d'objet sur laquelle vous souhaitez filtrer les utilisateurs. |
|
Attribut du nom d'utilisateur |
uid |
|
Attribut "Nom réel" |
displayname |
|
Attribut d'adresse e-mail |
|
|
Attribut de mappage de groupe |
dn |
|
BaseDN du groupe |
Votre nom de domaine au format DN (par exemple, ou=Groups,dc=example,dc=com pour le domaine example.com) |
|
Filtre de recherche de groupe statique |
Saisissez le filtre de recherche de groupe statique pour la classe d'objet sur laquelle vous souhaitez filtrer vos groupes statiques. |
|
Attribut du nom de groupe |
cn |
|
Attribut de membre statique |
member |
SSSD (Red Hat Enterprise et CentOS)
SSSD effectue une recherche utilisateur pour obtenir plus d'informations sur celui-ci lors de son authentification. Pour vous assurer que l'authentification des utilisateurs fonctionne correctement pour ce client LDAP, vous devez activer les options Lire les informations utilisateur et Lire les informations sur les groupes pour toutes les unités organisationnelles où l'option Valider les identifiants utilisateur est activée. Pour en savoir plus, consultez Configurer les autorisations d'accès.
Pour connecter un client SSSD sur Red Hat 8 ou CentOS 8 au service LDAP sécurisé :
- Ajoutez le client SSSD au service LDAP sécurisé :
- Dans la console d'administration Google, accédez à Applications > LDAP > AJOUTER UN CLIENT.
Veillez à vous connecter avec votre compte professionnel, et non avec votre compte Gmail personnel. - Saisissez les informations sur le client, puis cliquez sur CONTINUER.
- Configurez les autorisations d'accès :
Vérifier des identifiants utilisateur : Tout le domaine
Lire les informations relatives à l'utilisateur : Tout le domaine
Lire les informations relatives au groupe : Activé - Cliquez sur AJOUTER UN CLIENT LDAP.
- Téléchargez le certificat généré.
- Cliquez sur ACCÉDER AUX INFORMATIONS DU CLIENT.
- Définissez l'état du service sur ACTIVÉ.
- Dans la console d'administration Google, accédez à Applications > LDAP > AJOUTER UN CLIENT.
- Installez les dépendances :
dnf install openldap-clients sssd-ldap
install -d --mode=700 --owner=sssd --group=root /etc/sssd/ldap
Décompressez le fichier ZIP du certificat et copiez les fichiers .crt et .key dans /etc/sssd/ldap
- (Facultatif) Testez avec ldapsearch :
LDAPTLS_REQCERT=never \
LDAPTLS_KEY=Google.key \
LDAPTLS_CERT=Google.crt \
ldapsearch -H ldaps://ldap.google.com:636/ \
-b dc=example,dc=com \
-D usertoverify@example.com \
-W \
'(mail=usertoverify@example.com)' \
mail dn
Lorsque vous y êtes invité, saisissez le mot de passe Google de l'utilisateur.
Remarque : L'utilisateur doit disposer d'une licence Google Workspace Enterprise ou Cloud Identity Premium. - Créez le fichier
/etc/sssd/sssd.confavec le contenu suivant :
[sssd]
services = nss, pam
domains = example.com[domain/example.com]
ldap_tls_cert = /etc/sssd/ldap/Google.crt
ldap_tls_key = /etc/sssd/ldap/Google.key
ldap_tls_reqcert = never
ldap_uri = ldaps://ldap.google.com
ldap_search_base = dc=example,dc=com
id_provider = ldap
auth_provider = ldap
ldap_schema = rfc2307bis
ldap_user_uuid = entryUUID - Mettez à jour les autorisations et les libellés SELinux :
chown 0:0 /etc/sssd/sssd.conf /etc/sssd/ldap/*
chmod 600 /etc/sssd/sssd.conf /etc/sssd/ldap/*
restorecon -FRv /etc/sssd
- Redémarrez SSSD :
systemctl restart sssd
- Testez :
ssh au serveur :ssh -l user@example.com {HOSTNAME}
Dépannage
- Vérifiez la version de SSSD (elle doit être supérieure ou égale à 1.15.2) :
# sssd --version
2.2.3
-
Sous RHEL/CentOS (ou toute autre distribution utilisant l'application forcée de SELinux), les fichiers de configuration et le fichier de certificat SSSD doivent se trouver dans un répertoire accessible par le rôle sssd_conf_t :
# egrep "object_r:sssd_conf_t" /etc/selinux/targeted/contexts/files/file_contextsVérifiez si le fichier /var/log/audit/audit.log contient des messages de refus de cache AVC (Access Vector Cache).
- Vérifiez que /etc/nsswitch.conf contient "sss" pour les entités passwd, shadow, group et netgroup :
passwd: files sss
shadow: files sss
group: files sss
netgroup: files sss
Ici, les fichiers locaux remplaceront les utilisateurs LDAP.
- Recherchez les erreurs de configuration dans /var/log/sssd.conf :
Exemple :
[sssd] [sss_ini_add_snippets] (0x0020): Config merge error: File /etc/sssd/sssd.conf did not pass access check. Skipping.Action : vous devez définir les autorisations du fichier .conf sur 600.
Exemple :
[sssd] [sss_ini_call_validators] (0x0020): [rule/allowed_domain_options]: Attribute 'ldap_groups_use_matching_rule_in_chain' is not allowed in section 'domain/{DOMAIN}'. Check for typos.[sssd] [sss_ini_call_validators] (0x0020): [rule/allowed_domain_options]: Attribute 'ldap_initgroups_use_matching_rule_in_chain' is not allowed in section 'domain/{DOMAIN}'. Check for typos.
Action: Remove the unsupported group match LDAP extensions from sssd.conf.
-
Recherchez des erreurs LDAP/network/auth dans le fichier /var/log/sssd_{DOMAINE}.log.
Exemple :[sssd[be[example.com]]] [sss_ldap_init_sys_connect_done] (0x0020): ldap_install_tls failed: [Connect error] [error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed (self signed certificate)]
Action: You need to add "ldap_tls_reqcert = never" to sssd.conf.
To increase verbosity of errors, add "debug_level = 9" in sssd.conf under the domain section and restart sssd.
SSSD (autres distributions Linux)
SSSD effectue une recherche utilisateur pour obtenir plus d'informations sur celui-ci lors de son authentification. Pour vous assurer que l'authentification des utilisateurs fonctionne correctement pour ce client LDAP, vous devez activer les options Lire les informations utilisateur et Lire les informations sur les groupes pour toutes les unités organisationnelles où l'option Valider les identifiants utilisateur est activée. Pour en savoir plus, consultez Configurer les autorisations d'accès.
Pour connecter un client SSSD au service LDAP sécurisé :
- Installez la version >= 1.15.2 de SSSD.
$ sudo apt-get install sssd
- En supposant que vos fichiers de certificat et de clé client sont nommés /var/ldap-client.crt et /var/ldap-client.key et que votre domaine est example.com, modifiez /etc/sssd/sssd.conf avec une configuration telle que :
[sssd]
services = nss, pam
domains = example.com[domain/example.com]
ldap_tls_cert = /var/ldap-client.crt
ldap_tls_key = /var/ldap-client.key
ldap_uri = ldaps://ldap.google.com
ldap_search_base = dc=example,dc=com
id_provider = ldap
auth_provider = ldap
ldap_schema = rfc2307bis
ldap_user_uuid = entryUUID
ldap_groups_use_matching_rule_in_chain = true
ldap_initgroups_use_matching_rule_in_chain = true
-
Modifiez la propriété et les autorisations du fichier de configuration :
$ sudo chown root:root /etc/sssd/sssd.conf
$ sudo chmod 600 /etc/sssd/sssd.conf -
Redémarrez SSSD :
$ sudo service sssd restart
Conseil : Si vous utilisez le module SSSD sur des ordinateurs Linux sans adresse IP externe sur Google Compute Engine, vous pouvez toujours vous connecter au service LDAP sécurisé à condition d'avoir activé l'accès interne aux services Google. Pour en savoir plus, consultez Configurer l'accès privé à Google.
macOS
Pour connecter le client macOS à des fins d'authentification du compte utilisateur à l'aide du service LDAP sécurisé, procédez comme suit :
Configuration requise
- macOS doit correspondre à la version Catalina 10.15.4 ou ultérieure.
- Un identifiant utilisateur super-administrateur Google est requis pour terminer l'étape 1 de la phase de préparation.
- Vous devez disposer des autorisations d'administrateur local pour effectuer cette configuration.
Contenu :
Les instructions de cette section expliquent comment configurer et tester manuellement l'authentification macOS à l'aide du service LDAP sécurisé.
Étape 1 : Intégrez macOS en tant que client LDAP dans la console d'administration Google
Pour obtenir des instructions, consultez Ajouter des clients LDAP ou regardez cette démonstration de LDAP sécurisé. Vous téléchargerez également un certificat client TLS généré automatiquement au cours de ce processus.
Étape 2 : Importez le certificat dans le trousseau système
- Copiez le certificat (le fichier ZIP téléchargé à l'étape 1) et la clé sur l'ordinateur macOS.
Conseil : Décompressez le fichier pour trouver les fichiers de certificat et de clé. - Importez la paire de clés dans le trousseau système :
-
Convertissez la clé et le certificat en un fichier PKCS 12 (p12). Exécutez la commande suivante dans le terminal :
openssl pkcs12 -export -out ldap-client.p12 -in ldap-client.crt -inkey ldap-client.key
Conseil : Notez le nom du fichier .p12.
Vous êtes invité par le système à saisir un mot de passe. Saisissez un mot de passe pour chiffrer le fichier p12. -
Ouvrez l'application Trousseaux d'accès.
-
Cliquez sur le trousseau Système.
-
Cliquez sur File > Import Items (Fichier > Importer des éléments).
-
Sélectionnez le fichier ldap-client.p12 créé ci-dessus.
-
Si vous y êtes invité, saisissez le mot de passe administrateur pour autoriser la modification du trousseau système.
-
Saisissez le mot de passe que vous avez créé ci-dessus pour déchiffrer le fichier .p12.
Remarque : Un nouveau certificat et une clé privée associée devraient apparaître dans la liste des clés. Le nom du certificat peut être LDAP Client (Client LDAP). Notez le nom du certificat pour l'étape suivante ci-dessous.
- Suivez l'étape 6 de la section ldapsearch (macOS) de cet article pour configurer le contrôle des accès à la clé privée afin d'ajouter les applications spécifiées ci-dessous. Si la clé privée ne s'affiche pas dans la catégorie Tous les éléments, essayez de passer à la catégorie Mes certificats et de trouver l'entrée de clé privée appropriée en développant le certificat correspondant.
L'application ldapsearch, telle qu'elle est spécifiée dans les instructions, n'est pertinente qu'en cas de dépannage, et non à d'autres fins. Il est généralement supprimé avant de donner aux utilisateurs l'accès à macOS.
Les trois applications suivantes doivent être ajoutées à la liste de contrôle d'accès :
/System/Library/CoreServices/Applications/Directory Utility
/usr/libexec/opendirectoryd
/usr/bin/dscl
-
-
Ajoutez une ligne au fichier /etc/openldap/ldap.conf en vous assurant que "LDAP Client" correspond exactement au nom du certificat affiché dans l'application macOS Trousseau d'accès après l'importation du fichier .p12 (le nom provient du nom commun de l'objet X.509 du certificat généré) :
sudo bash -c 'echo -e "TLS_IDENTITY\tLDAP Client" >> /etc/openldap/ldap.conf'
Étape 3 : Pointez l'appareil vers l'annuaire Google pour l'authentification
Ouvrez l'application Utilitaire d'annuaire pour créer un nœud d'annuaire LDAP :
- Cliquez sur le cadenas pour apporter des modifications, puis saisissez votre mot de passe.
- Sélectionnez LDAPv3, puis cliquez sur l'icône en forme de crayon pour modifier les paramètres.
- Cliquez sur New… (Nouveau).
- Saisissez ldap.google.com comme nom de serveur, sélectionnez Chiffrer à l'aide de SSL, puis cliquez sur Manuel.
- Sélectionnez le nouveau nom du serveur et cliquez sur Edit… (Modifier).
- Attribuez un nom descriptif à la configuration, par exemple Google Secure LDAP.
- Sélectionnez Chiffrer à l'aide de SSL et assurez-vous que le port est défini sur 636.
- Accédez à l'onglet Search & Mappings (Recherche et mises en correspondance).
- Sélectionnez RFC2307 dans la liste déroulante Accéder à ce serveur LDAPv3 à l'aide de.
- Lorsque vous y êtes invité, saisissez les informations du domaine dans Search Base suffix (Suffixe de base de recherche). Par exemple, saisissez
dc=zomato,dc=compour le nom de domaine zomato.com. - Cliquez sur OK.
- Configurez les attributs sous le type d'enregistrement Utilisateurs :
- Dans la section Types et attributs d'enregistrement, sélectionnez Utilisateurs, puis cliquez sur le bouton +.
- Dans la fenêtre pop-up, sélectionnez Types d'attributs,puis GeneratedUID,et cliquez sur OK pour fermer la fenêtre pop-up.
GeneratedUID doit s'afficher sous "Utilisateurs" une fois développé.
- Cliquez sur GeneratedUID, puis sur l'icône + dans la zone à droite.
- Saisissez apple-generateduid dans la zone de texte, puis cliquez sur Entrée.
- Sous le nœud Users (Utilisateurs), cliquez sur l'attribut NFSHomeDirectory.
- Dans l'écran de droite, remplacez la valeur de cet attribut par
#/Users/$uid$. - Cliquez sur OK et saisissez votre mot de passe pour enregistrer les modifications.
- Dans la fenêtre Utilitaire d'annuaire, configurez la nouvelle configuration LDAP :
- Accédez à l'onglet Règlement relatif à la recherche.
- Cliquez sur l'icône en forme de cadenas pour apporter des modifications, puis saisissez le mot de passe de l'utilisateur actuel lorsque vous y êtes invité.
- Dans la liste déroulante, faites passer l'option sélectionnée de Search Path (Chemin d'accès de recherche) à Custom path (Chemin d'accès personnalisé).
- Ouvrez l'onglet Authentication (Authentification), puis cliquez sur l'icône +.
- Sélectionnez
/LDAPv3/ldap.google.comdans la liste "Domaines de l'annuaire", puis cliquez sur Ajouter. - Cliquez sur le bouton Appliquer et saisissez votre mot de passe administrateur si vous y êtes invité.
- Exécutez les quatre commandes suivantes pour désactiver les mécanismes d'authentification DIGEST-MD5, CRAM-MD5, NTLM et GSSAPI SASL. macOS utilise Simple Bind pour s'authentifier à l'aide du service LDAP sécurisé Google :
sudo /usr/libexec/PlistBuddy -c "add ':module options:ldap:Denied SASL Methods:' string DIGEST-MD5" /Library/Preferences/OpenDirectory/Configurations/LDAPv3/ldap.google.com.plist
sudo /usr/libexec/PlistBuddy -c "add ':module options:ldap:Denied SASL Methods:' string CRAM-MD5" /Library/Preferences/OpenDirectory/Configurations/LDAPv3/ldap.google.com.plist
sudo /usr/libexec/PlistBuddy -c "add ':module options:ldap:Denied SASL Methods:' string NTLM" /Library/Preferences/OpenDirectory/Configurations/LDAPv3/ldap.google.com.plist
sudo /usr/libexec/PlistBuddy -c "add ':module options:ldap:Denied SASL Methods:' string GSSAPI" /Library/Preferences/OpenDirectory/Configurations/LDAPv3/ldap.google.com.plist
- Redémarrez pour actualiser la configuration d'OpenDirectory.
Étape 4 : Créez un compte mobile (pour vous connecter hors connexion)
Tout utilisateur Google Workspace ou Cloud Identity peut se connecter à l'aide d'un compte réseau (compte Google) à l'aide de son nom d'utilisateur et de son mot de passe. Ce processus de connexion nécessite une connexion réseau. Si un utilisateur doit se connecter avec ou sans connexion réseau, un compte mobile peut être créé. Un compte mobile vous permet d'utiliser le nom d'utilisateur et le mot de passe de votre compte réseau (compte Google) pour vous connecter, que vous soyez connecté ou non au réseau. Pour en savoir plus, consultez Créer et configurer des comptes mobiles sur Mac.
Pour créer un compte mobile pour les utilisateurs du service LDAP sécurisé :
-
Exécutez la commande suivante pour vous connecter au serveur LDAP sécurisé et configurer un chemin d'accès au répertoire personnel et des comptes mobiles :
sudo /System/Library/CoreServices/ManagedClient.app/Contents/Resources/createmobileaccount -n $uid -v
Conseil : Remplacez $uid par la partie nom d'utilisateur de l'adresse e-mail associée au compte Google de l'utilisateur. Par exemple, jdupond est la partie nom d'utilisateur de jdupond@solarmora.com. -
Lorsque vous êtes invité à saisir le nom d'utilisateur administrateur SecureToken, saisissez votre nom d'utilisateur administrateur, puis votre mot de passe à l'invite suivante. Cela ajoutera $uid à FileVault. Cette étape est nécessaire si le disque macOS est chiffré.
Étape 5 : (Facultatif) Définissez la préférence de l'écran de connexion
- Accédez à Préférences Système > Utilisateurs et groupes > Options de connexion en bas à gauche.
- Déverrouillez le cadenas en fournissant les identifiants de l'administrateur.
- Définissez Afficher la fenêtre de connexion en tant que sur Nom et mot de passe.
Étape 6 : Redémarrez votre appareil et connectez-vous
- Vérifiez que l'appareil est bien connecté à Internet. Si vous n'avez pas de connexion Internet, la connexion pour l'utilisateur LDAP sécurisé ne fonctionnera pas.
Remarque : Une connexion Internet n'est requise que pour la première connexion. Les connexions suivantes peuvent se faire sans accès à Internet. - Connectez-vous à l'appareil avec le compte utilisateur configuré pour utiliser Secure LDAP pour l'authentification.
Les instructions de cette section décrivent comment automatiser la configuration de l'appareil pour vos utilisateurs. Effectuez les étapes 1 et 2 ci-dessous sur le même appareil macOS sur lequel vous avez effectué la configuration manuelle lors de la phase de préparation.
Étape 1 : Créez un profil Mac avec un certificat à l'aide d'Apple Configurator 2
- Installez Apple Configurator 2 sur la machine sur laquelle vous avez configuré manuellement l'authentification macOS avec le service LDAP sécurisé.
- Ouvrez Apple Configurator 2, créez un profil, puis, dans la section "Certificate" (Certificat), cliquez sur "Configure" (Configurer) et importez le fichier .p12 généré précédemment.
Remarque : Assurez-vous que ce fichier .p12 est protégé par un mot de passe. Saisissez ce mot de passe dans la section "Password" (Mot de passe) du certificat.
- Enregistrez ce profil.
- (Pour les appareils équipés de processeurs M1 ou M2, ignorez cette étape et passez à l'étape 5. ) Ouvrez ce profil dans un éditeur de texte, puis ajoutez les lignes suivantes dans le premier tag <dict> :
<key>PayloadScope</key>
<string>System</string>
Ces lignes ont été ajoutées, car Apple Configurator n'est pas encore compatible avec les profils macOS.
- Dans le deuxième tag <dict> et parallèlement aux données de certificat, ajoutez les lignes suivantes :
<key>AllowAllAppsAccess</key>
<true/>
Vous aurez ainsi la garantie que ce certificat sera accessible à toutes les applications.
Étape 2 : Convertissez le fichier de configuration du répertoire (plist) au format XML.
Au cours de cette étape, vous allez extraire toutes les configurations manuelles que vous avez effectuées lors de l'étape 3 de la phase de préparation dans un fichier XML. Vous pouvez utiliser ce fichier et le profil Mac créé à l'étape 1 ci-dessus pour configurer automatiquement d'autres appareils macOS.
- Copiez le fichier /Library/Preferences/OpenDirectory/Configurations/LDAPv3/ldap.google.com.plist sur votre bureau ou ailleurs.
- Convertissez-le au format XML pour pouvoir l'inspecter dans n'importe quel éditeur de texte. Exécutez la commande suivante dans le terminal :
sudo plutil -convert xml1 <path>/ldap.google.com.plist
Vous pouvez accéder au fichier en tant que<path>/ldap.google.com.plist.
- Modifiez les autorisations du fichier ci-dessus afin de pouvoir ouvrir le fichier XML. Vérifiez qu'il n'est pas vide.
Étape 3 : Créez un script Python pour automatiser la configuration sur les appareils de vos utilisateurs finaux
Copiez le script Python ci-dessous et enregistrez-le en tant que fichier Python (fichier .py).
Remarque : Cet exemple de script est conçu pour être compatible avec la version 3.10.x de Python. Ce script est fourni en l'état. L'assistance Google ne peut pas vous aider pour les exemples de scripts.
Ldap_python_config.py
#!/usr/bin/python
from OpenDirectory import ODNode, ODSession, kODNodeTypeConfigure
from Foundation import NSMutableData, NSData
import os
import sys
# Reading plist
GOOGLELDAPCONFIGFILE = open(sys.argv[1], "r")
CONFIG = GOOGLELDAPCONFIGFILE.read()
GOOGLELDAPCONFIGFILE.close()
# Write the plist
od_session = ODSession.defaultSession()
od_conf_node, err = ODNode.nodeWithSession_type_error_(od_session, kODNodeTypeConfigure, None)
request = NSMutableData.dataWithBytes_length_(b' '*32, 32)
request.appendData_(NSData.dataWithBytes_length_(str.encode(CONFIG), len(CONFIG)))
response, err = od_conf_node.customCall_sendData_error_(99991, request, None)
# Edit the default search path and append the new node to allow for login
os.system("dscl -q localhost -append /Search CSPSearchPath /LDAPv3/ldap.google.com")
os.system("bash -c 'echo -e \"TLS_IDENTITY\tLDAP Client\" >> /etc/openldap/ldap.conf' ")
Étape 4 : Configurez automatiquement les appareils des utilisateurs finaux
Accédez aux autres appareils macOS que vous souhaitez configurer et procédez comme suit :
- Copiez le fichier de profil Mac généré à l'étape 1, le fichier de configuration XML généré à l'étape 2 et le script Python de l'étape 3 sur l'appareil.
- Pour installer la dépendance nécessaire au script, exécutez la commande suivante :
python3 -m pip install pyobjc-framework-opendirectory - Exécutez la commande suivante :
sudo python </path/to/saved_python_script> </path/to/ldap.google.com.plist generated in step 2> - Pour importer des certificats dans le trousseau système de macOS, double-cliquez sur le fichier de profil Mac généré à l'étape 1, puis saisissez vos identifiants d'administrateur local macOS lorsque vous y êtes invité. Vous serez ensuite invité à saisir le mot de passe .p12 que vous avez défini lors de la phase de préparation.
- Redémarrez l'ordinateur macOS.
- Créez des comptes mobiles en suivant les instructions de l'étape 4 de la phase de préparation, et définissez éventuellement des préférences supplémentaires décrites à l'étape 5 de la phase de préparation.
- Pour les utilisateurs qui se connectent à macOS à l'aide de leurs identifiants Google, le nom d'utilisateur de leur compte Workspace doit être différent de l'ID utilisateur de leur profil utilisateur macOS, sans quoi la connexion est bloquée.
- Lorsqu'un utilisateur commence à se connecter à macOS à l'aide des identifiants Google, la gestion des mots de passe utilisateur (réinitialisation ou récupération) doit se faire depuis le site Web Google (par exemple, à l'adresse myaccount.google.com ou dans la console d'administration Google). Si vous choisissez de gérer vos mots de passe à l'aide d'une solution tierce, assurez-vous que le dernier mot de passe est synchronisé avec Google.
- Si l'administrateur crée un nouvel utilisateur ou réinitialise le mot de passe d'un utilisateur existant en activant le paramètre Exiger la modification du mot de passe à la prochaine connexion, l'utilisateur ne peut pas se connecter à son Mac à l'aide du mot de passe temporaire défini par l'administrateur.
Solution : L'utilisateur doit se connecter à Google sur un autre appareil (par exemple, son appareil mobile ou un autre ordinateur de bureau), définir un mot de passe permanent, puis se connecter à macOS à l'aide du nouveau mot de passe. - La connexion Internet de l'appareil mac doit être opérationnelle, de sorte que l'adresse ldap.google.com soit accessible lors de la première connexion après la configuration ci-dessus. Les connexions ultérieures ne nécessitent pas d'accès à Internet si vous avez configuré un compte mobile.
- L'intégration du service LDAP sécurisé Google avec macOS est testée sur macOS Catalina, Big Sur et Monterey.
Si vous rencontrez des problèmes pour vous connecter au service LDAP sécurisé, suivez les instructions ci-dessous.
Étape 1 : Vérifiez la connexion.
Vérifiez la connexion à l'aide de "odutil".
Exécutez la commande odutil show nodenames dans le terminal.
Vérifiez que l'état de /LDAPv3/ldap.google.com est en ligne. S'il n'est pas en ligne, essayez l'option "telnet".
Vérifiez la connexion à l'aide de "nc".
Exécutez la commande suivante dans le terminal : nc -zv ldap.google.com 636
Si vous ne parvenez pas à vous connecter à Google avec cette approche, essayez de vous connecter à l'aide d'IPv4.
Vérifiez la connexion avec IPv4.
Vous pouvez modifier la configuration de votre appareil pour qu'il utilise le protocole IPv4 en procédant comme suit :
- Accédez à System Preferences > Network > Wi-Fi > Advanced (Préférences système > Réseau > Wi-Fi > Avancé).
- Dans le menu "Advanced" (Avancé), accédez à l'onglet TCP/IP.
- Dans le menu déroulant, remplacez Configurer IPv6 par Liaison locale uniquement.
- Cliquez sur OK, puis sur Appliquer pour enregistrer les modifications.
- Vérifiez l'authentification du service via une connectivité ldapsearch et une recherche valide.
Étape 2 : Vérifiez si vous pouvez voir les objets du répertoire.
- Ouvrez Utilitaire d'annuaire, puis l'onglet Éditeur d'annuaire.
- Sélectionnez le nœud /LDAPv3/ldap.google.com dans la liste déroulante.
- Vérifiez si vous pouvez voir les utilisateurs et les groupes de votre domaine Google.
Instructions de configuration pour les applications Java
La plupart des applications basées sur Java qui offrent des fonctionnalités LDAP peuvent être configurées pour s'authentifier avec des certificats client en installant vos certificats client dans le keystore de l'application. Les fichiers de configuration exacts varient selon les applications, mais le processus est généralement similaire. La configuration nécessite l'installation d'OpenSSL et d'un environnement d'exécution Java.
Convertissez le certificat et les clés au format Java KeyStore. Vous serez invité à saisir des mots de passe tout au long de cette procédure. Sélectionnez un mot de passe sécurisé et utilisez-le pour toutes les invites. En supposant que votre fichier de clé client soit nommé ldap-client.key :
Si vous utilisez macOS ou Linux, exécutez les commandes suivantes :
$ openssl pkcs12 -export -out java-application-ldap.pkcs12 -in ldap-client.crt -inkey ldap-client.keySi vous utilisez Windows, saisissez les commandes suivantes :
$ certutil -mergepfx ldap-client.crt java-application-ldap.pkcs12Important : Les deux fichiers (<CERT_FILE>.crt et <CERT_FILE>.key) doivent se trouver dans le même répertoire. Assurez-vous également que key et crt portent le même nom (avec les deux extensions différentes). Dans cet exemple, nous utilisons les noms ldap-client.crt et ldap-client.key.
Importez le certificat dans le keystore :
$ keytool -v -importkeystore -srckeystore java-application-ldap.pkcs12 -srcstoretype PKCS12 -destkeystore java-application-ldap.jks -deststoretype JKSLes propriétés Java peuvent être configurées de différentes manières selon l'application. Vous pouvez souvent les définir avec l'option -D sur la ligne de commande "java" utilisée pour le démarrer. Définissez les propriétés de Java pour votre application :
javax.net.ssl.keyStore = /<path-to>/java-application-ldap.jks javax.net.ssl.keyStorePassword = <password selected above>Configurez les paramètres de connexion LDAP de l'application en utilisant les informations fournies dans Instructions de configuration de base.
Facultatif : Utiliser stunnel comme proxy
Pour les clients qui ne proposent pas de méthode d'authentification auprès de LDAP avec un certificat client, utilisez stunnel comme proxy.
Configurez stunnel pour fournir le certificat client au serveur LDAP et configurez votre client pour qu'il se connecte à stunnel. Idéalement, vous exécuterez stunnel sur le ou les mêmes serveurs que votre application et n'écouterez que localement afin de ne pas exposer votre annuaire LDAP au-delà de ce serveur.
Suivez la procédure ci-dessous :
Installez Stunnel. Par exemple, sur Ubuntu :
$ sudo apt-get install stunnel4Créez un fichier de configuration /etc/stunnel/google-ldap.conf avec le contenu suivant (en supposant que ldap-client.crt est le certificat et ldap-client.key la clé) :
[ldap]
client = yes
accept = 127.0.0.1:1636
connect = ldap.google.com:636
cert = ldap-client.crt
key = ldap-client.keyPour activer stunnel, modifiez /etc/default/stunnel4 et choisissez ENABLED=1.
Redémarrez stunnel.
$ sudo /etc/init.d/stunnel4 restartConfigurez votre application pour qu'elle pointe vers ldap://127.0.0.1:1636.
Vous pouvez remplacer "1636" par n'importe quel port inutilisé si vous modifiez également la ligne accept dans le fichier de configuration ci-dessus. Vous devrez utiliser LDAP en texte brut sans StartTLS/SSL/TLS activé entre le client et stunnel, car ils communiquent localement.
Remarque : Si vous choisissez d'exécuter stunnel sur un serveur distinct, vous devez configurer vos pare-feu de sorte que seules les applications nécessaires puissent accéder à votre serveur stunnel. Vous pouvez également configurer stunnel pour qu'il écoute avec TLS afin que les données entre votre application et les serveurs stunnel soient chiffrées. Les détails de ces deux configurations dépendent de votre environnement.
Étapes suivantes
Après avoir connecté le client LDAP au service LDAP sécurisé, vous devez définir l'état du service sur Activé pour le client LDAP.
Pour connaître la suite de la procédure, consultez 5. Définissez le paramètre "Clients LDAP" sur Activé.
Remarque : Si nécessaire, vous pouvez utiliser des outils simples comme ldapsearch, ADSI ou ldp.exe pour résoudre les problèmes si vous rencontrez des erreurs lorsque vous essayez de connecter votre client LDAP au service. Pour obtenir des instructions, consultez Tests de connectivité et dépannage.