KSIDol-Dokumentation > KSIDol-Module > Anmeldebenachrichtigung

Modulanleitung: Anmeldebenachrichtigung

Nicht-technische Bedienungsanleitung: wozu das Modul dient, wie man es verwendet und wie es mit Dolibarr zusammenspielt.

AuslösungBei jeder erfolgreichen Anmeldung

Inhalt der E-MailIdentität, Datum/Uhrzeit, IP, Instanz

Versandmodi3 (PHP mail, Dolibarr, SMTP)

Dolibarr-Kern0 Änderungen

1. Moduluberblick

Das Modul Anmeldebenachrichtigung (loginnotify) überwacht die Zugriffe auf Ihr Dolibarr: Jedes Mal, wenn sich ein Benutzer erfolgreich anmeldet, erhalten Sie automatisch eine Warn-E-Mail. Es ist ein einfaches Überwachungswerkzeug, besonders nützlich, um im Blick zu behalten, wer eine Demo- oder Produktivinstanz betritt, ohne ein technisches Protokoll einsehen zu müssen. Das Modul bleibt bewusst schlank und unauffällig: Es verändert niemals den Dolibarr-Kern und stützt sich auf den Standardmechanismus der Trigger (Auslöser). Es fügt weder ein Menü noch eine neue Rubrik oder einen zusätzlichen Bildschirm zur täglichen Arbeit hinzu: Einmal von einem Administrator aktiviert und eingerichtet, läuft es von selbst im Hintergrund.

Erhalten Sie automatisch eine E-Mail bei jeder Anmeldung eines Benutzers an Ihrer Dolibarr-Instanz
Ideal, um die Zugriffe einer Demo oder einer Produktivumgebung mühelos zu überwachen
Läuft im Hintergrund, ohne die Gewohnheiten der Benutzer zu ändern
Keine Änderung am Dolibarr-Kern: saubere und reversible Installation
Zentrale Einrichtung auf einer einzigen Konfigurationsseite, die Administratoren vorbehalten ist

2. Automatische Benachrichtigung bei jeder Anmeldung

Das ist die zentrale Funktion des Moduls. Sobald ein Benutzer eine Sitzung in Dolibarr öffnet, wird das Modul aktiv und bereitet den Versand einer Warn-E-Mail an die von Ihnen gewählte Adresse vor.

Die Warnung wird bei jeder erfolgreichen Anmeldung ausgelöst, unabhängig vom betroffenen Benutzer
Die Auslösung erfolgt vollständig automatisch: Der sich anmeldende Benutzer muss nichts tun
Ein Hauptschalter erlaubt es, den E-Mail-Versand jederzeit zu aktivieren oder auszusetzen
Ist das Modul deaktiviert oder der Versand abgeschaltet, verläuft die Anmeldung normal ohne E-Mail

3. Inhalt der Benachrichtigungs-E-Mail

Jede erhaltene E-Mail fasst das Wesentliche der Anmeldung klar zusammen, damit Sie sofort erkennen können, wer sich wann und von wo angemeldet hat.

Der Betreff nennt die Anmeldung und die Kennung des betroffenen Benutzers
Die Identität des Benutzers: seine Anmeldekennung und sein vollständiger Name
Das genaue Datum und die Uhrzeit der Anmeldung
Die IP-Adresse, von der aus die Anmeldung erfolgt ist
Die Adresse (URL) der betreffenden Dolibarr-Instanz, nützlich, wenn Sie mehrere Instanzen überwachen

4. Wahl der Empfängeradresse

Sie entscheiden frei, wer die Anmeldewarnungen erhält. Die Adresse wird auf der Konfigurationsseite des Moduls eingestellt.

Eingabe einer oder mehrerer Ziel-E-Mail-Adressen (durch Komma getrennt; das Semikolon wird nur im manuellen SMTP-Modus vollständig unterstützt)
Die Konfigurationsseite füllt das Empfängerfeld mit der in Dolibarr definierten Firmen-E-Mail-Adresse vor; zur Laufzeit wird keine E-Mail versendet, wenn keine Zieladresse gespeichert ist
Ohne gültige Adresse wird keine E-Mail versendet (die Anmeldung selbst bleibt normal)

5. Wahl des E-Mail-Versandmodus

Je nach Ihrem Hosting und Ihrer E-Mail-Konfiguration wählen Sie, auf welche Weise die E-Mails versendet werden. Drei Modi stehen zur Verfügung, um den meisten Situationen gerecht zu werden.

Modus PHP mail(): direkter Versand über die Mailfunktion des Servers, am einfachsten
Modus Dolibarr-Konfiguration: verwendet die bereits in Ihrem Dolibarr eingerichteten E-Mail-Einstellungen wieder
Manueller SMTP-Modus: Sie geben Ihre eigenen Parameter des Versandservers ein (Host, Port, Benutzername, Passwort, TLS/SSL-Sicherheit, Authentifizierungsmodus)
Eine benutzerdefinierte Absenderadresse kann festgelegt werden; sie wird unabhängig vom Versandmodus verwendet
Automatischer Rückfall: Schlägt der direkte Versand fehl oder ist er nicht verfügbar, wechselt das Modul zur E-Mail-Konfiguration von Dolibarr, um die Zustellchancen zu maximieren

6. Versand einer Test-E-Mail

Um zu prüfen, dass alles korrekt eingestellt ist, bevor Sie sich auf die Warnungen verlassen, bietet die Konfigurationsseite eine Test-Schaltfläche.

Eine Schaltfläche sendet sofort eine Test-E-Mail an die angegebene Empfängeradresse
Bei Erfolg wird eine Bestätigungsmeldung angezeigt, bei Fehlschlag eine Fehlermeldung
Eine Warnung erscheint, wenn Dolibarr so eingestellt ist, dass alle E-Mails an eine vorgegebene Adresse umgeleitet werden, um Verwechslungen über den tatsächlichen Empfänger zu vermeiden

7. Protokollierung der Fehler

Um die Diagnose zu erleichtern, wenn eine E-Mail nicht ausgeht, kann das Modul die Versandvorfälle im Protokoll von Dolibarr festhalten.

Aktivierbare Option, um Versandfehler in den technischen Protokollen von Dolibarr aufzuzeichnen
Hilft dem Administrator oder Dienstleister, ein E-Mail-Problem zu verstehen, ohne die Nutzung zu blockieren
Auch die Rückfallwarnungen (Wechsel von einem Versandmodus zu einem anderen) werden dort vermerkt

8. Konfiguration und Anpassung des Moduls

Alle Einstellungen sind auf einer einzigen Konfigurationsseite zusammengefasst, die nur für Administratoren über die Modulliste zugänglich ist. Von den Benutzern wird keine Einstellung verlangt.

Den Versand der Anmelde-E-Mails aktivieren oder deaktivieren
Die Adresse(n) für den Empfang der Warnungen festlegen
Den Versandmodus wählen (PHP mail, Dolibarr-Konfiguration oder manuelles SMTP) und gegebenenfalls den Absender
Die SMTP-Parameter im manuellen Modus eingeben (Host, Port, Benutzername, Passwort, Sicherheit, Authentifizierung)
Die Fehlerprotokollierung aktivieren
Den Versand testen und die Konfiguration speichern

9. Verknupfungen mit Dolibarr

Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.

Dolibarr-Benutzer : Das Modul stützt sich auf das native Anmeldeereignis der Dolibarr-Benutzerkonten. Die E-Mail übernimmt die Kennung und den vollständigen Namen der Person, die sich gerade angemeldet hat, so wie sie in ihrem Benutzerdatensatz gespeichert sind.
E-Mail-System von Dolibarr : Der Versandmodus Dolibarr verwendet die bereits in Ihrer Instanz eingerichtete E-Mail-Konfiguration wieder (dieselbe Versand-Engine wie die anderen E-Mails von Dolibarr). Dieser Modus dient auch als automatische Rückfalllösung, falls der direkte Versand fehlschlägt.
Firmendatensatz (allgemeine Einstellungen) : Fehlt eine Empfängeradresse oder ein benutzerdefinierter Absender, übernimmt das Modul automatisch die in den allgemeinen Einstellungen von Dolibarr definierte Firmen-E-Mail-Adresse, um mit dem Rest der Anwendung konsistent zu bleiben.
Technische Protokolle von Dolibarr : Wenn die Protokollierung aktiviert ist, werden Fehler und Versandwechsel in die nativen Protokolle (Syslog) von Dolibarr geschrieben, wodurch sich ein E-Mail-Problem über die Standardwerkzeuge des ERP diagnostizieren lässt.
E-Mail-Versandeinstellungen (Umleitung) : Das Modul respektiert die Dolibarr-Einstellung, die die Umleitung aller E-Mails an eine einzige Adresse erzwingt: Es weist den Administrator auf der Konfigurationsseite darauf hin, um Verwechslungen über den tatsächlichen Empfänger der Warnungen zu vermeiden.