Connecter Dolibarr à un Active Directory / LDAP

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) ou 636 (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

  1. Ouvrez Accueil > Configuration > Modules/Applications.
  2. Recherchez le module LDAP (famille Interfaces) et activez-le.
  3. 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ètreValeur d’exempleRôle
LDAP_SERVER_HOSTldaps://dc01.exemple.localServeur primaire (nom ou adresse du contrôleur de domaine)
LDAP_SERVER_PORT636 (LDAPS) ou 389Port de l’annuaire
LDAP_SERVER_PROTOCOLVERSION3Version du protocole LDAP
LDAP_SERVER_TYPEactivedirectoryType de serveur (OpenLDAP ou Active Directory)
LDAP_SERVER_USE_TLSselon votre architectureChiffrement de la connexion
LDAP_SERVER_DNDC=exemple,DC=localDN de base de l’annuaire
LDAP_ADMIN_DN / LDAP_ADMIN_PASSsvc-dolibarr@exemple.local et son mot de passeCompte de service en lecture seule
LDAP_USER_DNOU=Utilisateurs,DC=exemple,DC=localBranche où se trouvent les utilisateurs
LDAP_FILTER_CONNECTION(&(objectClass=user)(objectCategory=person))Filtre de recherche des utilisateurs
LDAP_FIELD_LOGINsAMAccountNameAttribut 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

  1. Faites une copie de sauvegarde du fichier conf/conf.php de Dolibarr.
  2. 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.
  3. Ajoutez les paramètres de connexion à l’annuaire, comme ci-dessous.
  4. 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

  1. 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).
  2. Laissez le mot de passe Dolibarr vide ou aléatoire : c’est le mot de passe de l’annuaire qui sera vérifié.
  3. Ouvrez une fenêtre de navigation privée et connectez-vous avec un compte non administrateur.
  4. 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ômeCause probablePiste
Can’t contact LDAP serverRéseau, pare-feu, nom du serveur ou certificat LDAPSTester le port depuis le serveur web ; vérifier le certificat de confiance côté PHP/OpenLDAP
Invalid credentialsCompte de service ou mot de passe incorrectEssayer le format compte@domaine ou le DN complet
Connexion refusée pour un utilisateurIdentifiant absent de Dolibarr ou attribut de login différentAligner l’identifiant Dolibarr sur sAMAccountName (ou changer l’attribut)
Aucun utilisateur trouvéDN de base ou filtre trop restrictifContrô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).

Un projet Dolibarr ? Parlons-en.

Développement d’un module, paramétrage, migration ou simple question : nous vous répondons rapidement.

Powered by Joinchat