Coffre fort

NsKeepass – Coffre-fort / Mot de passe

Documentation du module · version 23.0.5 · éditeur NSINFO

1. Présentation

NsKeepass ajoute à Dolibarr un coffre-fort de mots de passe : les identifiants de vos sites web, serveurs, messageries, équipements réseau ou logiciels sont rangés dans des fiches, avec les droits d'accès de Dolibarr et un historique dans l'agenda.

• Les mots de passe sont chiffrés dans la base de données et ne sont jamais affichés en clair sans une action de l'utilisateur.
• Chaque information se copie en un clic dans le presse-papiers, sur la fiche comme dans la liste.
• Un générateur crée des mots de passe robustes, avec la longueur et les caractères de votre choix.
• Les comptes sont classés par type de compte, chacun avec son icône.
• Le module ne modifie pas le Core de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

2.2 Installation

1. Installer et activer le module NSINFO (version 23.4.0 ou supérieure).
2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l'archive module_nskeepass-X.Y.Z.zip.
3. Dans la liste des modules, famille NSINFO, activer « Coffre-fort / Mot de passe ».
4. Attribuer les permissions aux utilisateurs ou groupes concernés.
5. Vérifier la configuration (roue crantée du module).

À l'activation, le module crée :

• les tables des mots de passe et du dictionnaire des types de comptes, avec dix types prédéfinis ;
• les trois permissions du module ;
• le menu principal Coffre-fort et ses entrées Mot de passe, Liste des mots de passe et Nouveau ;
• les événements automatiques de l'agenda, déjà cochés ;
• les onglets « Mots de passe » des fiches tiers et projet, affichés selon les options.

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module : cette opération enregistre les nouvelles colonnes, permissions, menus et événements de l'agenda. Les mots de passe, les types de comptes et les réglages sont conservés.

3. Configuration

3.1 Réglages du module

Page de réglages : Configuration > Modules, roue crantée du module. Réservée aux administrateurs. Onglets : Réglages, Numérotation, Attributs supplémentaires (champs ajoutés à la fiche mot de passe), ChangeLog et À propos (ces deux derniers fournis par le framework NSINFO).

3.2 Numérotation

L'onglet Numérotation des réglages choisit le modèle qui attribue la référence d'un nouveau mot de passe. Cliquer sur l'interrupteur du modèle voulu pour l'activer.

Avec les modèles Standard et Masque personnalisé, la référence n'est pas demandée à la création ; l'infobulle du modèle indique la prochaine valeur.

3.3 Types de comptes

Les types proposés dans le champ Type de compte se gèrent dans Configuration > Dictionnaires > Coffre-fort - Types de comptes.

Types fournis à l'installation :

Les types prédéfinis sont recréés à chaque activation du module s'ils ont été supprimés : pour ne plus les proposer, désactivez-les plutôt que de les supprimer.

3.4 Événements de l'agenda

Le module enregistre automatiquement un événement dans l'agenda de Dolibarr pour chaque action sur un mot de passe. Ces événements sont activés à l'installation et se règlent dans Configuration > Modules > Agenda > Événements automatiques :

Le module Dolibarr Agenda doit être activé.

4. Droits d'accès

5. Utilisation

5.1 Liste des mots de passe

Menu Coffre-fort (menu du haut) ou Coffre-fort > Liste des mots de passe.

• Recherche, filtres par colonne et tri, comme dans les autres listes de Dolibarr. Le filtre du type de compte est une liste de choix.
• Le mot de passe est masqué (••••••••), avec les boutons Afficher (œil) et Copier. Il ne fait pas l'objet d'une recherche.
• Chaque cellule renseignée dispose d'un bouton Copier (voir section 7).
• L'URL est cliquable et s'ouvre dans un nouvel onglet.
• Selon les options, les colonnes Tiers, Projet (affichée par défaut, avec le libellé du projet sous sa référence) et Version s'ajoutent.

5.2 Créer un mot de passe

1. Menu Coffre-fort > Nouveau.
2. Renseigner les champs : tiers et projet (selon les options), type de compte, version (selon l'option), application, identifiant, mot de passe (saisi ou généré), adresse IP, URL, description. La référence n'est à saisir qu'avec le modèle de numérotation « Référence libre ».
3. Cliquer sur Créer.

Le mot de passe est créé directement à l'état actif : l'état n'est pas demandé à la création. Sa référence est attribuée selon le modèle de numérotation.

Depuis l'onglet « Mots de passe » d'un tiers ou d'un projet, le bouton Nouveau ouvre ce formulaire avec le tiers ou le projet déjà renseigné.

5.3 Champs de la fiche

5.4 Fiche et onglets

Pour la confidentialité, la fiche ne propose ni génération de documents, ni envoi par e-mail, ni objets liés.

5.5 États et actions

5.6 Onglets « Mots de passe » des tiers et des projets

Avec les options Activer le tiers et Activer la gestion de projet, un onglet Mots de passe s'ajoute sur la fiche du tiers et sur la fiche du projet, pour les utilisateurs ayant la permission Consulter les mots de passe.

• Le nom de l'onglet est suivi du nombre de mots de passe rattachés, dans une pastille dont la couleur se règle avec l'option Couleur du nombre de mots de passe.
• L'onglet liste les mots de passe rattachés, triés par application : référence (lien vers la fiche), type de compte, version, application, identifiant, mot de passe (masqué), adresse IP, URL et état. Sur la fiche tiers s'ajoute la colonne Projet (avec le libellé du projet sous sa référence), sur la fiche projet la colonne Tiers, selon les options.
• Le bouton Nouveau ouvre la création d'un mot de passe avec le tiers, ou le projet et son tiers, déjà renseignés ; après l'enregistrement, retour sur l'onglet.

Pour afficher ou copier un mot de passe, ouvrir sa fiche en cliquant sur la référence.

6. Le mot de passe

6.1 Générer un mot de passe

À la création et à la modification, le bouton Générer, à côté du champ Mot de passe, ouvre la fenêtre Générer un mot de passe :

Utiliser ce mot de passe remplit le champ Mot de passe ; Annuler ferme la fenêtre sans rien changer. Le mot de passe est généré dans le navigateur avec un tirage aléatoire sécurisé ; il n'est envoyé au serveur qu'à l'enregistrement de la fiche.

6.2 Afficher le mot de passe

• Sur la fiche et dans la liste : l'icône en forme d'œil affiche le mot de passe en clair. Un second clic le masque ; il est masqué automatiquement au bout de 30 secondes.
• Dans le formulaire : l'icône en forme d'œil, à côté du champ, affiche ou masque ce qui vient d'être saisi ou généré.

6.3 Modifier le mot de passe

En modification, le champ Mot de passe est vide (« Laisser vide pour conserver le mot de passe actuel ») : l'ancien mot de passe n'est jamais renvoyé au navigateur.

• Laisser le champ vide : le mot de passe actuel est conservé.
• Saisir ou générer un nouveau mot de passe : il remplace l'ancien à l'enregistrement.

Un mot de passe de plus de 256 caractères est refusé avec le message « Le mot de passe est trop long (256 caractères maximum) ».

7. Copier dans le presse-papiers

Chaque information renseignée (référence, application, identifiant, mot de passe, adresse IP, URL, description, projet…) est suivie d'un bouton Copier (icône presse-papiers), sur la fiche et dans la liste. Le type de compte et l'état n'en ont pas.

• Un message Copié dans le presse-papier confirme la copie.
• Pour le mot de passe, la valeur est demandée au serveur au moment du clic : elle n'est pas présente dans la page avant.
• Pour la description, c'est le texte sans mise en forme qui est copié.

8. Sécurité et confidentialité

• Les mots de passe sont chiffrés dans la base de données avec le chiffrement réversible de Dolibarr, à partir de la clé unique de votre instance.
• Ils ne figurent pas dans les pages : ils sont demandés au serveur uniquement lors d'un clic sur Afficher ou Copier, avec contrôle de la permission Consulter les mots de passe. Chaque demande est notée dans le journal technique de Dolibarr.
• Le mot de passe actuel n'est jamais renvoyé dans le formulaire de modification.
• Pas de génération de document, d'envoi par e-mail ni d'objets liés sur une fiche.

9. Limites connues et FAQ

Le menu Coffre-fort n'apparaît pas.

L'utilisateur doit avoir la permission Consulter les mots de passe. Après une mise à jour du module, le désactiver puis le réactiver.

L'onglet « Mots de passe » n'apparaît pas sur la fiche tiers ou projet.

Activer l'option Activer le tiers ou Activer la gestion de projet (module Projets requis pour la seconde), et vérifier que l'utilisateur a la permission Consulter les mots de passe.

La référence n'est pas demandée à la création.

C'est le fonctionnement des modèles de numérotation Standard et Masque personnalisé : la référence est attribuée automatiquement. Pour la saisir à la main, choisir le modèle « Référence libre » (3.2).

Les événements n'apparaissent pas dans l'agenda.

• Le module Agenda doit être activé.
• Les événements doivent être cochés dans la configuration de l'agenda (3.4).
• Ils sont déclarés à l'activation du module : après une mise à jour, le désactiver puis le réactiver.

Le bouton Copier ou Afficher du mot de passe ne fait rien.

Vérifier que l'utilisateur a la permission Consulter les mots de passe et, si possible, utiliser Dolibarr en https. Recharger la page si elle est ouverte depuis longtemps.

Un mot de passe affiche une chaîne vide après une migration.

La clé unique de l'instance a probablement changé : voir section 8.

La description n'est pas en texte enrichi.

L'éditeur CKEditor nécessite le module Dolibarr FCKeditor.

Autres limites

• Le libellé des dix types de comptes fournis provient des traductions du module : le modifier dans le dictionnaire n'a pas d'effet visible (3.3).
• Une fois un type choisi, la liste de choix n'affiche que son libellé, sans l'icône.
• Si le module « NSINFO » est désactivé après coup, la page de réglages du module n'est plus utilisable.