/
Mail-Überwachung
  • 2.30

    • Mail-Überwachung

    Owned by Simon Wheeler
    Last updated: 05.02.2024
    6 min read

    Mit diesem Plugin können Sie ein Email-Postfach überwachen und bei eingehenden Emails einen Alarm auslösen lassen.

    Neustart empfohlen

    Wenn Sie Änderungen an den Einstellungen des Input-Plugins vornehmen, empfehlen wir Ihnen anschließend, FE2 neu zu starten. Dadurch können eventuelle Fehler vermieden werden.

    Router

    Achten Sie darauf, ob Ihr Router eventuell automatisch nach einer eingestellten Zeit IMAP-Verbindungen trennt. Wenn ja, deaktivieren Sie diese Funktion oder ändern Sie das Zeitlimit.

    Inhalt

    Hinweise

    Wichtige Information

    Sie sollten aus Performance-Gründen das Postfach vor dem Start des Servers leeren. Dadurch wird die optimale Verarbeitungsgeschwindigkeit erzielt. Wollen Sie zum Beispiel den Ordner Unbekannt überwachen, sollte dieser vorher geleert werden. Jede eingehende Email im zu überwachenden Ordner, wird nach Überprüfung als gelesen markiert.

    Google Mail / Gmail

    Um ein Google Mail Konto überwachen zu können müssen Sie den Zugriff auf wenig sichere Apps hier aktivieren und auf dieser Seite ein App-Passwort vergeben.

    Office 365

    Voraussichtlich im März 2023 wird Microsoft Basic Authentication für den E-Mail Abruf endgültig deaktivieren. Aktuell ist es bereits deaktiviert, lässt sich aber von Administratoren temporär re-aktivieren. Ab dem o.g. Zeitpunkt ist der Zugriff ausschließlich über OAuth möglich.
    Ab FE 2 2.29 ist daher die Authentifizierung am Office 365 Postfach auf diese Weise integriert.
    Eine Anleitung zur Konfiguration finden Sie hier.

    Konfiguration

    Feld

    Erläuterung

    Pflichfeld

    Feld

    Erläuterung

    Pflichfeld

    Benutzername

    Der Benutzername Ihres zu überwachenden Email-Kontos

    Passwort

    Das Passwort Ihres zu überwachenden Email-Kontos

    Posteingangsserver

    Der Posteingangsserver Ihres Email-Anbieters (Liste von IMAP-Konten [1])

    Wichtig:

    Es muss zwingend ein IMAP Server verwendet werden.

    Port

    Welcher Port für die Verbindung verwendet werden soll. Standard wäre hier 993

    TLS

    Ob STARTTLS verwendet wird oder nicht. Standard ist hier aktiv.



    Ordner

    Der Ordner ihres Email-Kontos welches überwacht wird (z.B. INBOX für Posteingang, oder Unbekannt bei web.de)

    Reconnect in Minuten

    Um die Verbindung stabil zu halten, wird alle X Minuten die Verbindung zum Postfach neu aufgebaut. Standardmäßig sind dies alle acht Minuten, was in der Regel ausreichen sollte. Haben Sie Probleme beim Wiederverbinden, veringern Sie diese Zeit.



    Erlaubte Absender-Email

    Hier tragen Sie die Absenderadresse des Email-Kontos ein, welches Alarmierungen absetzen darf. Dadurch wird verhindert, dass jeder der Ihnen eine E-Mail schickt, einen Alarm auslösen kann.

    Sie können auch mit einem Stern (*@domain.de) auch gesamte Domains erlauben.

    Sollte mehrere Absenderadressen erlaubt sein, so muss je Absenderadresse eine neue Zeile verwendet werden.

    Ggf. sollten Sie auch die E-Mail-Adresse inklusive Anzeigetext als Absender mit aufnehmen, falls die E-Mail in dem entsprechenden Format verschickt wird:

    Leitstelle Musterhausen <alarm@musterhausen.de>

    Einheiten Trennzeichen im Betreff

    Wenn die zu alarmierende Einheit an Hand des Betreffs der Email erkannt werden soll, so kann hier ein Trennzeichen definiert werden, wie die unterschiedlichen Einheiten-Codes (falls es mehrere gibt), von einander getrennt werden. Standard;

    ;

    Zum Beispiel:

    1234567;7654321

    Hier wird der Strichpunkt als Trennzeichen verwendet. Alarmiert werden nun die beiden Einheiten mit den Codes 1234567 und 7654321

    Beachten Sie bitte:

    FE2 sucht eine Einheit mit der exakten Code-Übereinstimmung. Wenn Sie also im Betreff als Einheitencode “Testeinheit Alarm ausgelöst;1234567” stehen haben, müssen Sie eine Einheit mit dem Code “Testeinheit Alarm ausgelöst” und eine weitere mit dem Code “1234567” anlegen.



    Schlüsselwörter (optional)

    Hier können Sie den Alarmtext in seine Bestandteile zerlegen. Eine genaue Anleitung finden Sie hier .



    Zu alarmierende Einheit wählen

    Sie können zwischen zwei verschiedenen Modi wählen:

    Über Betreff

    In dieser Variante werden die zu alarmierenden Einheiten an Hand des Betreffs bestimmt

    Über Code-Zuweisung aus Mail-Inhalt

    Hier werden die zu alarmierenden Einheiten an Hand des Email-Inhaltes bestimmt. Dazu muss das Feld Code-Zuweisung entsprechend ausgefüllt sein



    Standard Einheiten

    Die Standard Einheiten, die alarmiert werden sollen, falls keine Zuordnung stattfinden kann. Standard-Codes werden nur im Modus Über Code-Zuweisung aus Mail-Inhalt berücksichtigt!



    Code-Zuweisung

    Hier steht eine Liste von Einheiten. Im hinteren Feld muss ein Stichwort angegeben werden. Wenn dieses Wort im Alarmtext vorkommt, wird die Einheit alarmiert. Diese Konfiguration greift nur, wenn als Modus Über Code-Zuweisung aus Mail-Inhalt gewählt wurde.

    Lesen Sie hier mehr über die Code-Zuweisung.



    Zeilenumbrüche entfernen

    Hier werden eventuell vorhandene Zeilenumbrüche aus der Email entfernt



    Anhänge verarbeiten

    Ist diese Funktion gewählt, werden Anhänge mit folgenden Dateityp automatisch eingelesen und zum Alarmtext hinzugefügt:

    .xml .pdf .tiff .tif .txt

    Die Anhänge werden auf der Festplatte in folgendem Ordner für die spätere Verwendung gespeichert:

    C:\ProgramData\Alamos GmbH\FE2\Config\data\mailAttachments

    Der Ordner muss ggf. von Zeit zu Zeit aufgeräumt werden sollte der Speicherplatz nicht mehr ausreichen.

    Zip-Anhänge

    Können fortan auch verarbeitet werden. Diese können die oben genannten Dateitypen und die im Punkt erwähnten Anhänge für mobile Endgeräte bereitstellen enthalten.



    Passwort für geschützte Zip Anhänge

    Hier kann das Passwort für geschützte Zip-Anhänge angegeben werden.

     

    Anhang XML nur als Text ablegen

    Wenn aktiviert, wird der Gesamte XML-Inhalt als ein langer Text abgelegt.
    Dieser wird entweder separat gespeichert oder an den Alarmtext angehängt (siehe Anhänge und Inhalt separat speichern).

    Ansonsten wird das XML in einzelne Parameter je XML-Tag zerlegt.

     

    Anhänge und Inhalt separat speichern

    Ist dieser Haken gesetzt, so wird der Alarmtext nicht aus Anhänge und Mail-Inhalt zusammen gesetzt sondern beide Werte werden getrennt gespeichert.



    Inhalt

    Sie können zwischen verschiedenen Inhalten wählen:

    Automatisch

    Hierbei wird versucht, den Inhalt automatisch zu erkennen. Text Anteile werden HTML Anteilen immer bevorzugt. Sollte secur. im Betreff stehen, wird die Email als secur. Alarmemail behandelt.

    HTML

    Wählen Sie HTML, wenn Sie HTML Emails empfangen und verarbeiten wollen. Hierbei werden dann die HTML Tags entfernt.

    Text

    Wählen Sie Text, wenn Sie ausschließlich Text-Emails verarbeiten wollen. Selbst wenn die Email einen HTML Teil enthält, wird immer der Text Anteil bevorzugt.

    Swissphone secur.

    Achtung

    Aktuell werden nur Swissphone Emails unterstützt, welche sowohl einen HTML als auch einen Text Anteil enthalten. Sollten Ihre Emails nur aus HTML bestehen, wählen Sie als Inhalt bitte HTML und nutzen Sie Schlüsselwörter um die Email zu zerlegen.

    Diese Auswahl kann bei bestimmten Formaten Probleme geben. In diesem Fall wählen Sie bitte “Unverändert weitergeben” aus und wählen an der/den alarmierten Einheit(en) unter “Einstellungen → Zerlegung” die Zerlegung “Secur-Mail ILS Heilbronn”

    Falls Sie Emails vom Swissphone Leitstellen-Programm erhalten, können Sie über diesen Inhalt-Typ die Email vollautomatisch zerlegen lassen und müssen keine Schlüsselwörter definieren.

    Unverändert weitergeben

    Wählen Sie Unverändert weitergeben, wenn Sie eine Email erhalten, deren HTML-Teil Sie verarbeiten wollen. Dieser wird dann unverändert ins message-Parameter übernommen (z.B. um ihn dann für eigene Zerlegungen zu nutzen).





    Plain-Text Authentifizierung deaktivieren (für Microsoft Exchange)

    Ist diese Funktion aktiv, wird die Plain-Text Authentifizierung deaktiviert. Dies ist zum Beispiel bei Verwendung eines IMAP Servers via Microsoft Exchange notwendig.



    Verspätete Emails ignorieren in Minuten

    Beim Eintreffen einer Email wird die Versanduhrzeit durch den Email-Server geprüft. Sollte der Versandzeitpunkt länger als die hier eingestellte Zeit in Minuten in der Vergangenheit liegen, so wird diese Email ignoriert. Der Wert 0 bedeutet, dass keine Überprüfung der Versandzeit stattfindet.



    Verarbeitung von Emails

    • Nur neue

      • Hierbei werden nur die Emails verarbeitet, welche neu eingegangen sind. Bereits ungelesene Emails im Postfach, welche nicht durch IMAP zugestellt werden, werden nicht verarbeitet

    • Alle ungelesene (Standard)

      • Hierbei werden alle Emails verarbeitet, welche ungelesen im Posteingang liegen. Dabei werden auch Emails berücksichtigt, welche eventuell via IMAP nicht zugestellt wurden



    Anhänge für mobile Endgeräte bereitstellen

    Ist dieser Haken aktiv, so werden gewisse Anhänge, innerhalb von FE2 gespeichert und können über den integrierten Web-Server von FE2 an externe Geräte freigegeben werden. Aktuell unterstützte Dateiformate:

    • .pdf
    • .jpeg/.jpg/.png

      Es werden aktuell bis zu 4 Anhänge unterstützt

    Mobile Endgeräte

    Unterstützte mobile Anwendungen können bei Erhalt dieses Alarms auf den Inhalt der Dateien zugreifen und so direkt innerhalb der Anwendung anzeigen. Diese Anhänge werden momentan nicht für aPager PRO bereitgestellt!

     

    Typ des Anhanges

    Wenn das Speichern der Anhänge für mobile Endgeräte aktiv ist, so kann hier der Typ ausgewählt werden. Aktuell unterstützte Typen

    • Laufkarte

      • Hierbei wird der Anhang als Laufkarte den mobilen Endgeräte bereitgestellt

    • Sonstiges

      • Für alle anderen Anhänge kann dieser Typ verwendet werden

     

    PGP-Verschlüsselung

    Sind Emails mittels PGP verschlüsselt, können diese bei Empfang entschlüsselt werden. Ein PGP Schlüsselpaar kann zum Beispiel hier generiert werden. Diese Funktion ist ab Version 2.22 verfügbar.

    Pfad des öffentlichen Schlüssels

    Vollständiger Pfad des öffentlichen PGP Schlüssels, z.B.

    C:\pgp\Name_mail@provider.de-0xE225455B3640D6BD-pub.asc

     

    Pfad des geheimen Schlüssels

    Vollständiger Pfad des private PGP Schlüssels

     

    Passwort des geheimen Schlüssels

    Passwort des privaten PGP Schlüssels

     

    S/MIME-Verschlüsselung

    Pfad des S/MIME-Zertifikats

    Pfad zum Zertifikat zur Entschlüsselung der Mail

    Dateiformat: .pfx oder .p12

     

    Passwort des S/MIME-Zertifikats

    Passwort zum Zertifikat

     

    Email-Format

    Die E-Mail, die einen Alarm auslösen soll, muss folgendermaßen formatiert sein:

    Feld

    Beschreibung

    Feld

    Beschreibung

    Betreff

    Im Modus:

    Über Betreff

    Hier stehen die zu alarmierenden Einheiten-Codes drin. Mehrere Codes werden durch das unter 'Einheiten-Trennzeichen gewählte Symbol getrennt (Standard ;)

    Über Code-Zuweisung aus Mail-Inhalt

    Hier kann der Betreff beliebig formatiert sein

    Text

    Hier steht der Alarmtext drin. Dieser wird dann als message Feld im Alarm gesetzt.

    Einsatz für Feuerwehr Mustermann. Zum Gerätehaus!

    Status ändern per Email

    Durch Senden einer Email mit einer Datei im Anhang, die status.json heißt, kann der Status eines Fahrzeuges geändert werden.

    Die Datei muss folgendermaßen aufgebaut sein:

    { "type": "STATUS", "address": "12345678", "data": { "status":"2" } }

    Als address muss die in FE2 hinterlegte Fahrzeugkennung angegeben sein, als status der Fahrzeugstatus.

    secur Alarm-Email

    Emails werden nur als secur Alarmemail erkannt, wenn im Betreff secur. AlarmMail enthalten ist!

    Sollten Sie Emails aus dem secur. Leitstellensystem erhalten, kann FE2 diese automatisch auswerten. Sie benötigen hierzu keine Schlüsselwort Zerlegung. Alle Parameter werden aus der Tabelle automatisch extrahiert und (soweit als möglich) im FE2 erwarteten Format (z.B. Stichwort als keyword) gespeichert. Sollten Parameter in FE2 nicht bekannt sein, werden diese mit dem Präfix secur_ im Alarm gespeichert (z.B. secur_Sondersignal).

    Related content