Relier Dolibarr à un annuaire Active Directory (ou tout annuaire LDAP) permet à vos collaborateurs d’utiliser leur identifiant et leur mot de passe habituels, et de retrouver leurs comptes sans ressaisie. Deux mécanismes sont à distinguer : le module LDAP (connexion à l’annuaire, test, import des utilisateurs) et le paramétrage de l’authentification dans le fichier conf.php. Cette fiche couvre les versions Dolibarr V19 à V24.
Les intitulés des écrans peuvent légèrement varier selon la version de Dolibarr. Faites toujours une sauvegarde de conf.php avant modification et gardez un compte administrateur local pour ne pas vous enfermer dehors.
1. Prérequis
- L’extension PHP ldap est installée et activée sur le serveur web (à contrôler dans la page d’information PHP).
- Le serveur Dolibarr atteint le contrôleur de domaine : port
389(LDAP) ou636(LDAPS), pare-feu compris. - Un compte de service en lecture seule dans l’Active Directory, dédié à Dolibarr.
- Le DN de base de l’annuaire, par exemple
DC=exemple,DC=local, et l’unité d’organisation des utilisateurs.
2. Activer le module LDAP
- Ouvrez Accueil > Configuration > Modules/Applications.
- Recherchez le module LDAP (famille Interfaces) et activez-le.
- Cliquez sur l’icône d’engrenage du module pour ouvrir sa configuration.
3. Paramétrer la connexion à l’annuaire
Dans la configuration du module LDAP, renseignez les paramètres suivants (exemples pour Active Directory) :
| Paramètre | Valeur d’exemple | Rôle |
|---|---|---|
| LDAP_SERVER_HOST | ldaps://dc01.exemple.local | Serveur primaire (nom ou adresse du contrôleur de domaine) |
| LDAP_SERVER_PORT | 636 (LDAPS) ou 389 | Port de l’annuaire |
| LDAP_SERVER_PROTOCOLVERSION | 3 | Version du protocole LDAP |
| LDAP_SERVER_TYPE | activedirectory | Type de serveur (OpenLDAP ou Active Directory) |
| LDAP_SERVER_USE_TLS | selon votre architecture | Chiffrement de la connexion |
| LDAP_SERVER_DN | DC=exemple,DC=local | DN de base de l’annuaire |
| LDAP_ADMIN_DN / LDAP_ADMIN_PASS | svc-dolibarr@exemple.local et son mot de passe | Compte de service en lecture seule |
| LDAP_USER_DN | OU=Utilisateurs,DC=exemple,DC=local | Branche où se trouvent les utilisateurs |
| LDAP_FILTER_CONNECTION | (&(objectClass=user)(objectCategory=person)) | Filtre de recherche des utilisateurs |
| LDAP_FIELD_LOGIN | sAMAccountName | Attribut qui contient l’identifiant de connexion |
Utilisez le bouton de test de la connexion LDAP : il doit confirmer que Dolibarr se connecte à l’annuaire. Puis associez les champs de l’annuaire à ceux de Dolibarr (nom : sn, prénom : givenname, e-mail : mail) et testez la lecture d’un utilisateur.
Préférez LDAPS (port 636) à LDAP en clair : le mot de passe du compte de service et ceux des utilisateurs circulent sinon sans chiffrement.
4. Activer l’authentification par l’annuaire
- Faites une copie de sauvegarde du fichier
conf/conf.phpde Dolibarr. - Modifiez-le (il peut être en lecture seule : retirez temporairement la protection, puis rétablissez-la) et indiquez les modes d’authentification dans l’ordre où ils sont essayés.
- Ajoutez les paramètres de connexion à l’annuaire, comme ci-dessous.
- Enregistrez, puis testez avec un compte d’utilisateur existant (voir l’étape 5).
$dolibarr_main_authentication='dolibarr,ldap';
$dolibarr_main_auth_ldap_host='ldaps://dc01.exemple.local';
$dolibarr_main_auth_ldap_port='636';
$dolibarr_main_auth_ldap_version='3';
$dolibarr_main_auth_ldap_servertype='activedirectory';
$dolibarr_main_auth_ldap_login_attribute='sAMAccountName';
$dolibarr_main_auth_ldap_dn='DC=exemple,DC=local';
$dolibarr_main_auth_ldap_filter='';
$dolibarr_main_auth_ldap_admin_login='svc-dolibarr@exemple.local';
$dolibarr_main_auth_ldap_admin_pass='mot_de_passe_du_compte_de_service';
$dolibarr_main_auth_ldap_debug='false';
Avec dolibarr,ldap, Dolibarr essaie d’abord le mot de passe enregistré dans Dolibarr, puis l’annuaire : les comptes locaux (dont l’administrateur de secours) continuent de fonctionner. Le wiki Dolibarr donne l’ordre inverse (ldap,dolibarr) en exemple : choisissez l’ordre qui convient à votre politique.
Le mot de passe du compte de service est stocké en clair dans conf.php : limitez les droits de lecture de ce fichier et utilisez un compte dédié, sans droit d’écriture dans l’annuaire.
5. Créer les utilisateurs et tester
- Dans Utilisateurs & Groupes, créez les utilisateurs Dolibarr dont l’identifiant correspond exactement à l’attribut de connexion de l’annuaire (le module LDAP peut proposer de les créer depuis l’annuaire).
- Laissez le mot de passe Dolibarr vide ou aléatoire : c’est le mot de passe de l’annuaire qui sera vérifié.
- Ouvrez une fenêtre de navigation privée et connectez-vous avec un compte non administrateur.
- Contrôlez les droits du compte : l’authentification ne remplace pas les permissions Dolibarr, à attribuer utilisateur par utilisateur ou par groupe.
6. Dépannage
| Symptôme | Cause probable | Piste |
|---|---|---|
| Can’t contact LDAP server | Réseau, pare-feu, nom du serveur ou certificat LDAPS | Tester le port depuis le serveur web ; vérifier le certificat de confiance côté PHP/OpenLDAP |
| Invalid credentials | Compte de service ou mot de passe incorrect | Essayer le format compte@domaine ou le DN complet |
| Connexion refusée pour un utilisateur | Identifiant absent de Dolibarr ou attribut de login différent | Aligner l’identifiant Dolibarr sur sAMAccountName (ou changer l’attribut) |
| Aucun utilisateur trouvé | DN de base ou filtre trop restrictif | Contrôler le DN, l’unité d’organisation et le filtre |
Pour diagnostiquer, passez temporairement dolibarr_main_auth_ldap_debug à 'true', puis remettez-le à 'false' une fois le problème résolu.
Conseils et pièges
- Faites vos tests sur une instance de recette avant la production.
- Conservez au moins un compte administrateur Dolibarr local, hors annuaire.
- Si vous changez de domaine ou de structure d’unités d’organisation, mettez à jour le DN de base.
- Les caractères spéciaux d’un mot de passe doivent être correctement échappés dans
conf.php(guillemets simples).