Aide La plateforme Annuaire et SSO
Connecter Active Directory ou LDAP
Sur cette page
Présentation
Cet article couvre la section Connexion d’un import LDAP / Active Directory et ce qui est propre à LDAP ; les autres réglages sont communs à tous les imports. Cette source ne propose pas de SSO.
Accès réseau : qui interroge l’annuaire
| Votre organisation | Ce qu’il faut prévoir |
|---|---|
| Sans l’option de chiffrement | Nos serveurs se connectent depuis Internet : le nom du serveur doit se résoudre uniquement vers des adresses publiques (une adresse privée ou réservée est refusée), et le port 636 (LDAPS) ou 389 (StartTLS) doit être ouvert vers lui. Un annuaire joignable seulement depuis votre réseau interne ne peut pas être lu ainsi. |
| Avec le chiffrement côté client | Votre agent Bexxo Protected lit l’annuaire : sa machine doit joindre le serveur LDAP. C’est la seule façon de synchroniser un annuaire non joignable depuis Internet. |
TLS est obligatoire (ldaps ou starttls) : une connexion non chiffrée est refusée. Le certificat est vérifié sur le nom saisi : utilisez le nom qui figure dans le certificat, pas une adresse IP.
Remplir la section Connexion
Prévoyez un compte de service en lecture seule, qui peut lire sous les DN de base les personnes, les groupes et les attributs listés plus bas ; la connexion anonyme est refusée. Les champs facultatifs laissés vides (branches et filtres des utilisateurs et des groupes, port, attribut d’identifiant) prennent la valeur par défaut : le DN de base pour les branches, celle du type d’annuaire pour le reste. Les champs à renseigner avec soin :
| Champ | Contenu |
|---|---|
| Serveur (host) | Nom du serveur, sans ldap://, par exemple ldap.exemple.ch. |
| Port et Chiffrement | ldaps (636 par défaut) ou starttls (389 par défaut). |
| DN de connexion (bind DN) | DN complet du compte de service, par exemple CN=svc-bexxo,OU=Services,DC=exemple,DC=ch. |
| DN de base (base DN) | Point de départ des recherches, par exemple DC=exemple,DC=ch. |
| Type d’annuaire | ad (Active Directory) ou openldap : il fixe les valeurs par défaut ci-dessous. |
| Attribut d’identifiant | Attribut stable qui reconnaît une personne ou un groupe d’une synchronisation à l’autre. |
Type d’annuaire et valeurs par défaut
| Réglage | ad | openldap |
|---|---|---|
| Filtre des utilisateurs | (&(objectClass=user)(objectCategory=person)) | (objectClass=inetOrgPerson) |
| Filtre des groupes | (objectClass=group) | (objectClass=groupOfNames) |
| Attribut d’identifiant | objectGUID | entryUUID |
| Compte désactivé | Importé comme inactif (attribut userAccountControl). | Toutes les personnes sont importées comme actives. |
Un filtre LDAP personnalisé remplace le filtre par défaut : reprenez-y la classe d’objet, par exemple (&(objectClass=user)(objectCategory=person)(department=Vente)). Il s’applique avant les filtres de la section Filtres.
Ne changez pas l’attribut d’identifiant après une première synchronisation : les personnes déjà importées ne seraient plus reconnues. Une entrée sans cet attribut est ignorée et comptée dans un avertissement du journal.
Attributs lus et groupes
Seuls ces attributs, plus l’attribut d’identifiant, sont lus : ce sont les seuls utilisables dans la correspondance des champs et dans les filtres.
| Objet | Attributs |
|---|---|
| Personne | sn, givenName, cn, displayName, mail, mobile, telephoneNumber, preferredLanguage, dn, et accountEnabled (valeur calculée : true ou false) |
| Groupe | cn, displayName, description, member, dn |
Les appartenances sont lues dans l’attribut member des groupes. Le serveur doit accepter la pagination des résultats LDAP (« paged results »).
Au-delà d’environ 1500 membres, Active Directory ne renvoie member que par tranches et la synchronisation échoue plutôt que d’importer un groupe incomplet. Retenez des groupes plus petits ou réduisez le DN de base des groupes.
Tester et dépanner
Le test de connexion s’authentifie, puis cherche une personne sous le DN de base des utilisateurs, avec le filtre des utilisateurs.
| Situation | À vérifier |
|---|---|
| Échec du test, organisation non chiffrée | Le nom se résout-il vers une adresse publique, le port est-il ouvert depuis Internet, le certificat correspond-il au nom saisi ? |
| Échec avec un mot de passe correct | Le chiffrement correspond-il au port (ldaps : 636, starttls : 389) ? Le DN de connexion est-il complet ? |
| Le test réussit, mais personne n’est trouvé | Le DN de base et le filtre des utilisateurs correspondent-ils à vos comptes ? Le type d’annuaire est-il le bon ? |
| Entrées ignorées « faute d’identifiant stable » | L’attribut d’identifiant n’est pas lisible : videz le champ pour reprendre la valeur par défaut, ou donnez au compte de service le droit de le lire. |
| « Groupe(s) de périmètre introuvable(s) » | Le groupe n’existe plus sous le DN de base des groupes ou n’est plus retenu par leur filtre : retirez-le de Groupes importés. |
| Organisation chiffrée : l’agent ne répond pas dans les 10 minutes | L’agent est-il démarré, et sa machine joint-elle le serveur LDAP ? |
Vous n’avez pas trouvé la réponse ? Nous contacter