Documentation KSIDol > Modules KSIDol > Notification de connexion

Notice du module Notification de connexion

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

DeclenchementA chaque connexion reussie

Contenu de l'emailIdentite, date/heure, IP, instance

Modes d'envoi3 (PHP mail, Dolibarr, SMTP)

Coeur Dolibarr0 modification

1. Presentation du module

Le module Notification de connexion (loginnotify) surveille les acces a votre Dolibarr : chaque fois qu'un utilisateur se connecte avec succes, vous recevez automatiquement un email d'alerte. C'est un outil de suivi simple, particulierement utile pour garder un oeil sur qui entre dans une instance de demonstration ou de production, sans avoir a consulter de journal technique. Le module reste volontairement leger et discret : il ne modifie jamais le coeur de Dolibarr et s'appuie sur le mecanisme standard des declencheurs (triggers). Il n'ajoute ni menu, ni nouvelle rubrique, ni ecran supplementaire dans le travail quotidien : une fois active et regle par un administrateur, il fonctionne tout seul en arriere-plan.

Recevez un email automatique a chaque connexion d'un utilisateur a votre instance Dolibarr
Ideal pour surveiller les acces d'une demo ou d'une production sans effort
Fonctionne en arriere-plan, sans changer les habitudes des utilisateurs
Aucune modification du coeur de Dolibarr : installation propre et reversible
Reglage centralise sur une seule page de configuration reservee aux administrateurs

2. Notification automatique a chaque connexion

C'est la fonction centrale du module. Des qu'un utilisateur ouvre une session dans Dolibarr, le module s'active et prepare l'envoi d'un email d'alerte vers l'adresse que vous avez choisie.

L'alerte se declenche sur chaque connexion reussie, quel que soit l'utilisateur concerne
Le declenchement est entierement automatique : rien a faire pour l'utilisateur qui se connecte
Un interrupteur general permet d'activer ou de suspendre l'envoi des emails a tout moment
Si le module est desactive ou l'envoi coupe, la connexion se deroule normalement sans email

3. Contenu de l'email de notification

Chaque email recu resume l'essentiel de la connexion, en clair, pour vous permettre d'identifier tout de suite qui s'est connecte, quand et depuis ou.

L'objet indique la connexion et l'identifiant de l'utilisateur concerne
L'identite de l'utilisateur : son identifiant de connexion et son nom complet
La date et l'heure precises de la connexion
L'adresse IP depuis laquelle la connexion a eu lieu
L'adresse (URL) de l'instance Dolibarr concernee, utile si vous surveillez plusieurs instances

4. Choix de l'adresse de reception

Vous decidez librement qui recoit les alertes de connexion. L'adresse se regle sur la page de configuration du module.

Saisie d'une ou de plusieurs adresses email de destination (separees par une virgule ; le point-virgule n'est pleinement pris en charge qu'en mode SMTP manuel)
La page de configuration pre-remplit le champ destinataire avec l'email de la societe defini dans Dolibarr ; a l'execution, si aucune adresse de destination n'est enregistree, aucun email n'est envoye
Sans adresse valide, aucun email n'est envoye (la connexion reste, elle, normale)

5. Choix du mode d'envoi de l'email

Selon votre hebergement et votre configuration de messagerie, vous choisissez la maniere dont les emails partent. Trois modes sont proposes pour s'adapter a la plupart des situations.

Mode PHP mail() : envoi direct par la fonction de messagerie du serveur, le plus simple
Mode configuration Dolibarr : reutilise les reglages email deja parametres dans votre Dolibarr
Mode SMTP manuel : vous saisissez vos propres parametres de serveur d'envoi (hote, port, identifiant, mot de passe, securite TLS/SSL, mode d'authentification)
Une adresse d'expediteur personnalisee peut etre definie ; elle est utilisee quel que soit le mode d'envoi
Repli automatique : si l'envoi direct echoue ou n'est pas disponible, le module bascule vers la configuration email de Dolibarr pour maximiser les chances de livraison

6. Envoi d'un email de test

Pour verifier que tout est correctement regle avant de compter sur les alertes, la page de configuration propose un bouton de test.

Un bouton envoie immediatement un email de test vers l'adresse de reception indiquee
Un message de confirmation s'affiche en cas de succes, ou un message d'erreur si l'envoi echoue
Un avertissement previent lorsque Dolibarr est regle pour rediriger tous les emails vers une adresse imposee, afin d'eviter toute confusion sur le destinataire reel

7. Journalisation des erreurs

Pour faciliter le diagnostic si un email ne part pas, le module peut consigner les incidents d'envoi dans le journal de Dolibarr.

Option activable pour enregistrer les erreurs d'envoi dans les journaux techniques de Dolibarr
Aide l'administrateur ou le prestataire a comprendre un probleme de messagerie sans bloquer l'usage
Les alertes de repli (bascule d'un mode d'envoi a un autre) y sont egalement notees

8. Configuration et adaptation du module

Tous les reglages sont regroupes sur une page unique de configuration, accessible uniquement aux administrateurs depuis la liste des modules. Aucun reglage n'est demande aux utilisateurs.

Activer ou desactiver l'envoi des emails de connexion
Definir la ou les adresses de reception des alertes
Choisir le mode d'envoi (PHP mail, configuration Dolibarr ou SMTP manuel) et, le cas echeant, l'expediteur
Renseigner les parametres SMTP en mode manuel (hote, port, identifiant, mot de passe, securite, authentification)
Activer la journalisation des erreurs
Tester l'envoi et enregistrer la configuration

9. Liaisons avec Dolibarr

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

Utilisateurs Dolibarr : Le module s'appuie sur l'evenement natif de connexion des comptes utilisateurs Dolibarr. L'email reprend l'identifiant et le nom complet de la personne qui vient de se connecter, tels qu'ils sont enregistres dans sa fiche utilisateur.
Systeme d'emails de Dolibarr : Le mode d'envoi Dolibarr reutilise la configuration de messagerie deja parametree dans votre instance (le meme moteur d'envoi que les autres emails de Dolibarr). Ce mode sert aussi de solution de repli automatique si l'envoi direct echoue.
Fiche societe (parametres generaux) : En l'absence d'adresse de reception ou d'expediteur personnalise, le module reprend automatiquement l'adresse email de la societe definie dans les parametres generaux de Dolibarr, pour rester coherent avec le reste de l'application.
Journaux techniques de Dolibarr : Lorsque la journalisation est activee, les erreurs et les bascules d'envoi sont ecrites dans les journaux (syslog) natifs de Dolibarr, ce qui permet de diagnostiquer un probleme de messagerie via les outils standard de l'ERP.
Preferences d'envoi d'emails (redirection) : Le module respecte le reglage Dolibarr qui force la redirection de tous les emails vers une adresse unique : il en avertit l'administrateur sur la page de configuration pour eviter toute confusion sur le destinataire reel des alertes.