Intégrations

LDAP

Connecter les utilisateurs de votre site à un annuaire LDAP (Active Directory, OpenLDAP) pour l'authentification et l'attribution des rôles.

LDAP

Avec les Paramètres LDAP, vos utilisateurs se connectent avec leur identifiant et leur mot de passe de l'annuaire de l'entreprise. Dokos crée ou met à jour l'utilisateur à la connexion et peut lui donner des rôles selon ses groupes LDAP.

Prérequis

  • Avoir le rôle Responsable système.
  • Avoir l'URL du serveur LDAP et un compte de service (DN et mot de passe) qui peut lire les utilisateurs et les groupes.
  • Le serveur Dokos doit pouvoir joindre le serveur LDAP sur le réseau.

Configurer la connexion

  1. Ouvrez la recherche (Ctrl+K) et saisissez Paramètres LDAP. Le document se trouve aussi dans l'espace Intégrations, section Authentification.
  2. Choisissez le Serveur du répertoire : Active Directory, OpenLDAP ou Personnalisation.
  3. Remplissez la section Paramètres du serveur LDAP et la section Authentification LDAP (voir le tableau).
  4. Remplissez les chemins de recherche et les champs de correspondance.
  5. Cochez Activé, puis enregistrez.

À l'enregistrement, Dokos se connecte au serveur et lit les chemins de recherche. En cas d'erreur, un message « Misconfigured » indique le champ à corriger.

Quand LDAP est activé, la page de connexion affiche le bouton Se connecter avec LDAP.

Champs principaux

ChampRôle
Url du Serveur LDAPAdresse du serveur, par exemple ldap://annuaire.example.com:389. Obligatoire.
"Distinguished Name" (DN) de baseDN du compte de service. Obligatoire.
Mot de Passe pour la Base DNMot de passe du compte de service. Obligatoire.
Chaîne de Recherche LDAPFiltre de recherche de l'utilisateur. Il doit être entre parenthèses et contenir {0}, remplacé par l'identifiant saisi. Exemple : (sAMAccountName={0}). Obligatoire.
Chemin de recherche LDAP pour les utilisateursBranche de l'annuaire où chercher les utilisateurs. Obligatoire.
Chemin de recherche LDAP pour les groupesBranche de l'annuaire où chercher les groupes. Obligatoire.
Champ Email LDAP, Champ Nom d'utilisateur LDAP, Champ Prénom LDAPAttributs LDAP copiés dans l'utilisateur. Obligatoires.
Champ LDAP: deuxième prénom, nom, téléphone, mobileAttributs facultatifs copiés dans l'utilisateur.
Type d'utilisateur par défautType de l'utilisateur créé (par défaut « Utilisateur du site web »). Obligatoire.
Rôle utilisateur par défautRôle donné à l'utilisateur créé, si le type est « Utilisateur système ».
Ne pas créer de nouvel utilisateurSi coché, seuls les utilisateurs qui existent déjà dans Dokos peuvent se connecter.
SSL/TLS ModeOff ou StartTLS.
Requiert un certificat d'authentificationOui pour vérifier le certificat du serveur.
Lien vers le fichier de la clé privée, Lien vers un certificat de serveur, Lien vers le fichier de certificats CAChemins des fichiers sur le serveur Dokos, pour une connexion chiffrée.

Pour le Serveur du répertoire Personnalisation, l'Attribut de membre de groupe LDAP et la Classe d'objets de groupe sont obligatoires. La Recherche de groupe personnalisé, si vous la remplissez, doit contenir {0}.

Donner des rôles selon les groupes LDAP

Dans la section Mappings de groupe LDAP, ajoutez une ligne par groupe :

  • Groupe LDAP : nom du groupe dans l'annuaire.
  • Rôle de l'utilisateur : rôle Dokos donné aux membres de ce groupe.

À chaque connexion, Dokos met à jour les rôles de l'utilisateur selon ses groupes.

Exemple

Exemple fictif. L'annuaire Active Directory de l'entreprise est ldap://ad.example.local.

ChampValeur
Serveur du répertoireActive Directory
Url du Serveur LDAPldap://ad.example.local:389
DN de baseCN=svc-dokos,OU=Services,DC=example,DC=local
Chaîne de Recherche LDAP(sAMAccountName={0})
Chemin de recherche pour les utilisateursOU=Utilisateurs,DC=example,DC=local
Chemin de recherche pour les groupesOU=Groupes,DC=example,DC=local
Champ Email / Nom d'utilisateur / Prénommail / sAMAccountName / givenName
Type d'utilisateur par défautUtilisateur système
Mapping de groupeComptabilite → rôle de comptabilité de votre choix

Un membre du groupe Comptabilite se connecte avec son identifiant Windows. Dokos crée son utilisateur et lui donne ce rôle.