LDAP
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
- Ouvrez la recherche (Ctrl+K) et saisissez Paramètres LDAP. Le document se trouve aussi dans l'espace Intégrations, section Authentification.
- Choisissez le Serveur du répertoire : Active Directory, OpenLDAP ou Personnalisation.
- Remplissez la section Paramètres du serveur LDAP et la section Authentification LDAP (voir le tableau).
- Remplissez les chemins de recherche et les champs de correspondance.
- 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
| Champ | Rôle |
|---|---|
| Url du Serveur LDAP | Adresse du serveur, par exemple ldap://annuaire.example.com:389. Obligatoire. |
| "Distinguished Name" (DN) de base | DN du compte de service. Obligatoire. |
| Mot de Passe pour la Base DN | Mot de passe du compte de service. Obligatoire. |
| Chaîne de Recherche LDAP | Filtre 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 utilisateurs | Branche de l'annuaire où chercher les utilisateurs. Obligatoire. |
| Chemin de recherche LDAP pour les groupes | Branche de l'annuaire où chercher les groupes. Obligatoire. |
| Champ Email LDAP, Champ Nom d'utilisateur LDAP, Champ Prénom LDAP | Attributs LDAP copiés dans l'utilisateur. Obligatoires. |
| Champ LDAP: deuxième prénom, nom, téléphone, mobile | Attributs facultatifs copiés dans l'utilisateur. |
| Type d'utilisateur par défaut | Type de l'utilisateur créé (par défaut « Utilisateur du site web »). Obligatoire. |
| Rôle utilisateur par défaut | Rôle donné à l'utilisateur créé, si le type est « Utilisateur système ». |
| Ne pas créer de nouvel utilisateur | Si coché, seuls les utilisateurs qui existent déjà dans Dokos peuvent se connecter. |
| SSL/TLS Mode | Off ou StartTLS. |
| Requiert un certificat d'authentification | Oui 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 CA | Chemins 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.
| Champ | Valeur |
|---|---|
| Serveur du répertoire | Active Directory |
| Url du Serveur LDAP | ldap://ad.example.local:389 |
| DN de base | CN=svc-dokos,OU=Services,DC=example,DC=local |
| Chaîne de Recherche LDAP | (sAMAccountName={0}) |
| Chemin de recherche pour les utilisateurs | OU=Utilisateurs,DC=example,DC=local |
| Chemin de recherche pour les groupes | OU=Groupes,DC=example,DC=local |
| Champ Email / Nom d'utilisateur / Prénom | mail / sAMAccountName / givenName |
| Type d'utilisateur par défaut | Utilisateur système |
| Mapping de groupe | Comptabilite → 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.