Aller au contenu
Bexxo Aide

Aide La plateforme Annuaire et SSO

Connecter Active Directory ou LDAP

Pour les administrateurs Mis à jour le 13 novembre 2026

Connecter un annuaire Active Directory ou OpenLDAP installé dans vos locaux pour synchroniser les personnes et les groupes de l’organisation.
Sur cette page
  1. Présentation
  2. Accès réseau : qui interroge l’annuaire
  3. Remplir la section Connexion
  4. Attributs lus et groupes
  5. Tester et dépanner

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.

Les réglages communs à tous les importsSynchroniser l’annuaire et configurer le SSO

Accès réseau : qui interroge l’annuaire

Votre organisationCe qu’il faut prévoir
Sans l’option de chiffrementNos 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é clientVotre 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.

L’agent qui lit l’annuaire depuis votre réseauInstaller l’agent Bexxo Protected

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 :

ChampContenu
Serveur (host)Nom du serveur, sans ldap://, par exemple ldap.exemple.ch.
Port et Chiffrementldaps (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’annuairead (Active Directory) ou openldap : il fixe les valeurs par défaut ci-dessous.
Attribut d’identifiantAttribut stable qui reconnaît une personne ou un groupe d’une synchronisation à l’autre.

Type d’annuaire et valeurs par défaut

Réglageadopenldap
Filtre des utilisateurs(&(objectClass=user)(objectCategory=person))(objectClass=inetOrgPerson)
Filtre des groupes(objectClass=group)(objectClass=groupOfNames)
Attribut d’identifiantobjectGUIDentryUUID
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.

ObjetAttributs
Personnesn, givenName, cn, displayName, mail, mobile, telephoneNumber, preferredLanguage, dn, et accountEnabled (valeur calculée : true ou false)
Groupecn, 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éeLe 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 correctLe 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 minutesL’agent est-il démarré, et sa machine joint-elle le serveur LDAP ?

Vous n’avez pas trouvé la réponse ? Nous contacter