Notice du module Notification de connexion

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

DéclenchementÀ chaque ouverture de session
Contenu de l'e-mailIdentité, date/heure, IP, instance
Modes d'envoi3 (PHP mail, Dolibarr, SMTP)
Cœur Dolibarr0 modification

1. Présentation du module

Le module Notification de connexion (loginnotify) surveille les accès à votre Dolibarr : chaque fois qu'un utilisateur ouvre une session avec succès, vous recevez automatiquement un e-mail d'alerte. C'est un outil de suivi simple, particulièrement utile pour garder un œil sur qui entre dans une instance de démonstration ou de production, sans avoir à consulter de journal technique. Le module reste volontairement léger et discret : il ne modifie jamais le cœur de Dolibarr et s'appuie sur le mécanisme standard des déclencheurs. Il n'ajoute ni menu, ni rubrique, ni écran supplémentaire dans le travail quotidien, et ne demande aucune permission à distribuer aux utilisateurs : une fois activé et réglé par un administrateur, il fonctionne seul en arrière-plan. L'alerte reste par ailleurs sans conséquence sur l'usage de l'ERP : même si l'e-mail ne peut pas partir, l'ouverture de session de l'utilisateur aboutit normalement.

  • Recevez un e-mail automatique à chaque ouverture de session d'un utilisateur sur votre instance Dolibarr.
  • Idéal pour surveiller les accès d'une instance de démonstration ou de production sans effort quotidien.
  • Fonctionne en arrière-plan, sans rien changer aux habitudes ni à l'écran de connexion des utilisateurs.
  • Trois modes d'envoi au choix pour s'adapter à votre hébergement : fonction d'envoi du serveur, configuration d'e-mails de Dolibarr ou serveur SMTP dédié.
  • Un bouton d'essai permet de valider la messagerie avant de compter sur les alertes.
  • Aucune modification du cœur de Dolibarr et aucune table de données créée : installation propre et entièrement réversible.
  • Tous les réglages tiennent sur une seule page de configuration, réservée aux administrateurs.
  • Libellés et e-mails disponibles en cinq langues.

2. Une alerte par e-mail à chaque connexion

C'est la fonction centrale du module. Dès qu'un utilisateur ouvre une session dans Dolibarr, le module prépare et envoie un e-mail d'alerte vers l'adresse que vous avez choisie.

  • L'alerte part à chaque ouverture de session réussie, quel que soit le compte concerné.
  • Une seule alerte par session : la navigation qui suit, page après page, ne génère aucun e-mail supplémentaire.
  • Les tentatives de connexion refusées ne donnent lieu à aucune alerte : seules les connexions abouties sont signalées.
  • Les alertes portent sur les ouvertures de session dans l'interface de Dolibarr ; un accès par l'interface de programmation (API) ne déclenche pas d'e-mail.
  • L'utilisateur qui se connecte n'a rien à faire et ne voit aucun message : le module est totalement transparent pour lui.
  • La connexion n'est jamais bloquée par un incident d'envoi : même si l'e-mail ne peut pas partir, la session s'ouvre normalement.
  • Un interrupteur dans la configuration suspend ou relance les envois à tout moment, sans désinstaller le module.
  • Si le module est désactivé ou l'interrupteur coupé, plus aucun e-mail n'est envoyé.

3. Ce que contient l'e-mail d'alerte

Chaque message résume l'essentiel de la connexion, en clair, pour identifier immédiatement qui s'est connecté, quand et depuis où.

  • L'objet annonce une connexion utilisateur et reprend l'identifiant du compte concerné, ce qui permet de trier ou de filtrer facilement les alertes dans votre messagerie.
  • Une phrase d'introduction rappelle qu'une connexion vient d'être effectuée sur votre instance Dolibarr.
  • L'identité de la personne : son identifiant de connexion, suivi du nom complet enregistré dans sa fiche utilisateur.
  • La date et l'heure de la connexion, au format international (année, mois, jour, puis heure), telles que le serveur les a enregistrées.
  • L'adresse IP depuis laquelle la connexion a eu lieu.
  • L'adresse Internet de l'instance Dolibarr concernée, utile lorsque plusieurs instances sont surveillées dans la même boîte de réception.
  • Le message est envoyé en texte simple, sans pièce jointe ni image : il se lit aussi bien sur téléphone que sur ordinateur.
  • Le texte est rédigé dans la langue de la personne qui vient de se connecter.

4. Choix du ou des destinataires des alertes

Vous décidez librement qui reçoit les alertes de connexion. L'adresse se saisit sur la page de configuration du module.

  • Une adresse de réception unique suffit dans la plupart des cas : c'est elle qui recevra toutes les alertes.
  • Plusieurs destinataires sont possibles : il suffit de séparer les adresses par une virgule, séparateur reconnu par les trois modes d'envoi.
  • Lorsque le champ est encore vide, la page de configuration propose l'adresse e-mail de votre société enregistrée dans Dolibarr : il suffit de l'accepter en enregistrant.
  • Tant qu'aucune adresse n'a été enregistrée, le module reste silencieux : aucun e-mail n'est envoyé et les connexions se déroulent normalement.
  • Les adresses saisies sont nettoyées avant usage, afin qu'un espace ou un séparateur superflu n'empêche pas l'envoi.
  • Le destinataire peut être changé à tout moment : le nouveau réglage s'applique dès la connexion suivante.

5. Trois modes d'envoi au choix

Selon votre hébergement et votre configuration de messagerie, vous choisissez la manière dont les e-mails partent. Trois modes sont proposés pour couvrir la plupart des situations.

  • Mode fonction d'envoi du serveur (PHP mail) : le plus simple, l'e-mail part directement par le serveur qui héberge Dolibarr, sans réglage supplémentaire.
  • Mode configuration Dolibarr : le module réutilise les réglages d'e-mails déjà en place dans votre instance, donc le même moteur d'envoi que les autres messages de l'application.
  • Mode SMTP manuel : le module se connecte au serveur d'envoi que vous indiquez, indépendamment de la configuration d'e-mails de Dolibarr.
  • Repli automatique du premier mode : si la fonction d'envoi du serveur est indisponible ou si l'envoi échoue, le module bascule tout seul sur la configuration d'e-mails de Dolibarr pour maximiser les chances de livraison.
  • En mode configuration Dolibarr et en mode SMTP manuel, un échec est signalé et journalisé, sans nouvelle tentative par un autre moyen.
  • Une adresse d'expéditeur peut être imposée ; elle est utilisée par les trois modes.
  • À défaut d'expéditeur renseigné, le module reprend l'adresse e-mail de votre société définie dans Dolibarr et, en dernier recours seulement, une adresse technique construite sur le nom du serveur.

6. Paramètres du serveur d'envoi en mode SMTP manuel

Ce mode s'adresse aux installations qui doivent passer par un serveur d'envoi précis, différent de celui configuré dans Dolibarr. Tous les paramètres se saisissent sur la même page.

  • Hôte du serveur d'envoi : c'est le seul paramètre indispensable ; sans lui, aucun e-mail ne part et l'incident est journalisé.
  • Port du serveur : laissé vide ou invalide, le port 25 est utilisé.
  • Identifiant et mot de passe : l'authentification est activée dès que l'un des deux est renseigné.
  • Sécurité de la connexion : aucune, TLS ou SSL, au choix dans une liste déroulante.
  • Mode d'authentification : à renseigner uniquement si votre serveur l'exige ; la valeur « none » désactive explicitement l'authentification.
  • Dans ce mode, les adresses de destination peuvent être séparées par une virgule ou par un point-virgule.

7. L'e-mail de test, pour valider le réglage

Avant de compter sur les alertes, un second bloc en bas de la page de configuration permet d'envoyer immédiatement un message d'essai.

  • Un bouton envoie un e-mail de test vers l'adresse indiquée juste au-dessus de lui.
  • Le test reprend le contenu exact d'une alerte réelle, avec le compte, la date et l'heure et l'adresse IP de l'administrateur en train de faire l'essai.
  • Le test s'appuie sur les réglages déjà enregistrés : pour éprouver une nouvelle configuration, enregistrez la page avant de lancer l'essai.
  • Si le champ destinataire du bloc d'essai est laissé vide, c'est l'adresse de réception enregistrée qui est utilisée.
  • Un message de confirmation s'affiche en cas de succès, un message d'erreur en cas d'échec.
  • L'essai fonctionne même lorsque l'envoi automatique est désactivé : vous pouvez valider la messagerie avant d'armer les alertes.
  • Un avertissement prévient lorsque Dolibarr est réglé pour rediriger tous ses e-mails vers une adresse imposée, afin d'éviter toute confusion sur le destinataire réel.

8. Journalisation des erreurs d'envoi

Pour faciliter le diagnostic lorsqu'un e-mail ne part pas, le module peut consigner les incidents dans les journaux techniques de Dolibarr.

  • Option active par défaut : chaque échec d'envoi est écrit dans les journaux techniques de Dolibarr.
  • Y figurent également les bascules automatiques d'un mode d'envoi à l'autre et les configurations incomplètes, comme un serveur d'envoi non renseigné ou l'absence de destinataire valide.
  • Les messages consignés mentionnent l'adresse de destination concernée, afin d'identifier l'envoi en défaut.
  • Ces traces servent uniquement au diagnostic : elles n'affichent rien aux utilisateurs et ne bloquent jamais une connexion.
  • L'option peut être décochée si vous ne souhaitez aucune trace technique.

9. Une page de configuration unique, réservée aux administrateurs

Tous les réglages tiennent sur une seule page, ouverte depuis la liste des modules de Dolibarr. Aucun paramétrage n'est demandé aux utilisateurs.

  • La page s'ouvre depuis Accueil, Configuration, Modules/Applications : le module figure dans le groupe KSI et le bouton de configuration de sa ligne mène directement aux réglages.
  • L'accès est strictement réservé aux comptes administrateurs : toute autre personne est refusée par le contrôle d'accès standard de Dolibarr.
  • Un onglet unique, Paramètres, regroupe la totalité des réglages : il n'y a rien à chercher ailleurs dans Dolibarr.
  • Un tableau présente, dans l'ordre, l'adresse de réception, l'interrupteur d'envoi, le mode d'envoi, l'adresse d'expéditeur, les paramètres du serveur d'envoi et la journalisation.
  • Un bouton d'enregistrement unique sauvegarde l'ensemble des choix et affiche le message de confirmation standard de Dolibarr.
  • Les réglages sont pris en compte immédiatement, sans réactivation du module ni intervention technique.
  • En installation multi-sociétés, les réglages appartiennent à la société courante : chaque entité peut viser son propre destinataire.
  • Aucune permission n'est créée par le module : il n'y a aucun droit à attribuer aux utilisateurs.

10. Un module discret, sans empreinte dans Dolibarr

Le module a été conçu pour ne rien ajouter à l'interface quotidienne : en dehors de sa page de réglages, rien ne change dans votre Dolibarr.

  • Aucun menu, aucun onglet et aucun bouton supplémentaire dans l'application.
  • Aucune table de données créée : les réglages sont conservés dans les paramètres de Dolibarr.
  • Aucun document ni modèle de PDF, aucune tâche planifiée, aucun export supplémentaire.
  • Aucune modification du cœur de Dolibarr : le module utilise uniquement le mécanisme officiel des déclencheurs.
  • Aucun historique de connexions n'est conservé par le module : la trace, ce sont les e-mails reçus et, si l'option est active, les journaux techniques.
  • Aucune donnée commerciale n'est touchée : le module ne lit ni n'écrit vos tiers, devis, commandes, factures, produits ou écritures comptables.
  • Désinstallation propre : désactiver le module arrête les envois et efface ses réglages, paramètres du serveur d'envoi compris ; ils devront être ressaisis en cas de réactivation.

11. Disponible en cinq langues

Le module suit la langue de l'utilisateur Dolibarr.

  • Libellés de la page de configuration traduits en français, anglais, italien, espagnol et allemand.
  • Les cinq traductions couvrent l'intégralité des libellés du module : réglages, messages de confirmation, avertissements et contenu des e-mails.
  • Le texte de l'alerte suit la langue de la personne qui vient de se connecter, et non celle du destinataire.

12. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

  • Comptes utilisateurs et ouverture de session : Le module s'appuie sur l'événement natif de connexion des comptes utilisateurs de Dolibarr : il n'ajoute aucun écran de connexion et ne modifie en rien l'authentification. L'e-mail reprend l'identifiant et le nom complet de la personne tels qu'ils sont enregistrés dans sa fiche utilisateur, et le message est rédigé dans la langue choisie dans ses préférences.
  • Déclencheurs (triggers) de Dolibarr : L'envoi repose sur le mécanisme officiel des déclencheurs : aucun fichier du cœur n'est modifié et le module reste neutre vis-à-vis des autres modules qui écoutent le même événement. Le module ne renvoie jamais d'erreur bloquante au cœur, ce qui garantit qu'une ouverture de session aboutit même en cas de problème de messagerie.
  • Système d'e-mails de Dolibarr : Le mode « configuration Dolibarr » réutilise les réglages de messagerie déjà en place dans votre instance, avec le même moteur d'envoi que les autres e-mails de l'application. Ce mode sert également de solution de repli automatique lorsque l'envoi par la fonction du serveur échoue ou n'est pas disponible.
  • Fiche société (paramètres généraux) : L'adresse e-mail de votre société, définie dans les paramètres généraux de Dolibarr, est utilisée à deux endroits : la page de configuration la propose comme destinataire lorsque aucune adresse de réception n'a encore été saisie, et elle sert d'expéditeur par défaut lorsque aucune adresse d'expéditeur n'est renseignée.
  • Préférences d'envoi d'e-mails (redirection imposée) : Lorsque Dolibarr est réglé pour rediriger tous les e-mails sortants vers une adresse unique, par exemple sur une instance d'essai, la page de configuration du module en avertit l'administrateur afin d'éviter toute confusion sur le destinataire réel des alertes.
  • Journaux techniques de Dolibarr : Lorsque la journalisation est activée, les échecs d'envoi et les bascules de mode sont écrits dans les journaux natifs de Dolibarr : un problème de messagerie se diagnostique donc avec les outils standard de l'ERP, sans écran spécifique à apprendre.
  • Configuration Dolibarr et multi-sociétés : Les réglages du module sont mémorisés dans les paramètres (constantes) de Dolibarr, pour la société courante, ce qui reste compatible avec une installation multi-sociétés : chaque entité peut disposer de son propre destinataire et de son propre mode d'envoi.
  • Droits et administration : Le module n'ajoute aucune permission à distribuer : sa page de réglages est protégée par le statut d'administrateur de Dolibarr, et les utilisateurs n'ont accès à aucun écran du module. Le suivi des accès reste ainsi entre les mains des seuls administrateurs.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire