MailAgent

Der MailAgent ist eine Konsolenanwendung zur Auswertung von E-Mails für die Alarmierung. Es können beliebig viele Postfächer ausgewertet werden. Unterstützt werden IMAP und Microsoft Exchange. Pro Postfach kann ein Standort (API-Key) zugeordnet werden.

Download

Verarbeitungsmodi

Die Auswertung der E-Mails ist in folgenden Modi möglich:

Die direkte Auswertung nach Connect erfolgt mit regulären Ausdrücken (RegEx). Falls dieser Modus verwendet wird, muss auch der Abschnitt ConnectPatternOptions gepflegt werden.

Einrichtung

Voraussetzungen

Vor der Inbetriebnahme des MailAgents muss das Tool GnuPG for Windows (GPG4Win) installiert werden, wenn PGP-verschlüsselte Mails verarbeitet werden sollen.

1. Download unter gnupg.org/download
2. Installieren Sie GPG4Win (Standard-Installationsverzeichnis: C:\Program Files (x86)\GnuPG\bin)
3. Öffnen Sie Kleopatra (im Toolset enthalten)
4. Importieren Sie den öffentlichen und privaten Schlüssel
5. Stellen Sie eine Vertrauensstellung für die Schlüssel her

Authentifizierung

Der MailAgent unterstützt zwei Authentifizierungsmethoden:

Basic Authentication

Klassische Authentifizierung mit Benutzername und Passwort. Diese Methode funktioniert mit IMAP und Exchange (EWS).

O365 Modern Authentication

OAuth2-basierte Authentifizierung für Office 365 Postfächer. Diese Methode ist besonders empfohlen für O365-Umgebungen, da Microsoft die Basic Authentication schrittweise deaktiviert.

• Beim ersten Start wird für jedes konfigurierte O365-Postfach eine interaktive Browser-Anmeldung durchgeführt
• Die erhaltenen Tokens werden sicher verschlüsselt auf dem System gespeichert (Windows Data Protection API)
• Bei nachfolgenden Starts werden die gespeicherten Tokens automatisch verwendet und bei Bedarf erneuert
• Für O365-Authentifizierung muss nur der EMailUsername konfiguriert werden

Konfiguration

Die Konfiguration des MailAgents erfolgt in der appsettings.json-Datei im gleichen Verzeichnis.

Abschnitt MailAgentOptions

E-Mail-Einstellungen (EmailSettings)

Es können beliebig viele E-Mail-Accounts mit den zugehörigen Connect-Standorten hinterlegt werden:

"EmailSettings": [
  {
    "Name": "Standort 1",
    "ApiKey": "IhrConnectApiKey",
    "EMailHost": "imap.example.com",
    "EMailPort": 993,
    "EMailUsername": "alarm@example.com",
    "EMailPassword": "IhrPasswort",
    "EMailSubjectFilter": "ALARM",
    "EMailSenderFilter": "leitstelle@example.com",
    "AuthenticationType": "Basic"
  }
]

Allgemeine Einstellungen

Abschnitt ConnectPatternOptions

Hier werden die regulären Ausdrücke für die Extraktion der Einsatzdaten konfiguriert. Für jedes Feld wird die erste Capture-Group verwendet.

"ConnectPatternOptions": {
  "NumberPattern": "",
  "KeywordPattern": "Alarmstichwort:[^;]*;[^;]*;([^;]*);",
  "FactsPattern": "Alarmstichwort:[^;]*;[^;]*;[^;]*;([^;]*);",
  "StreetPattern": "Adresse:([^;]*)",
  "HouseNumberPattern": "Adresse:[^;]*;([^;]*)",
  "CityPattern": "Einsatzort:([^;]*);",
  "DistrictPattern": "Einsatzort:[^;]*;([^;]*);",
  "ZipCodePattern": "",
  "RicPattern": "Alarmierte Einheiten:([^;]*)",
  "ReporterNamePattern": "",
  "ReporterPhonePattern": "",
  "LatitudePattern": "",
  "LongitudePattern": "",
  "AdditionalProperties": [
    {
      "Name": "Einsatzart",
      "Pattern": "Alarmstichwort:([^;]*);"
    }
  ]
}

Unter AdditionalProperties können beliebig viele Zusatzinformationen angegeben werden.

Abschnitt Serilog

Konfiguration der Protokollierung:

"Serilog": {
  "MinimumLevel": "Information",
  "WriteTo": [
    {
      "Name": "File",
      "Args": {
        "path": "C:\\Logs\\MailAgent\\log.txt",
        "retainedFileCountLimit": 30
      }
    }
  ]
}

Gültige Log-Level: Debug, Information, Warning, Error, Critical

Inbetriebnahme

Als Windows-Dienst

1. Führen Sie die Batchdatei install.bat aus
2. Prüfen Sie in den Windows-Diensten, ob der automatische Start eingestellt ist

Als Anwendung

Starten Sie die MailAgent.exe direkt für manuellen Betrieb oder Tests.

Prozessoren im Detail

Text-Prozessor (PGP)

Der verschlüsselte text/plain Teil der Mail wird extrahiert und an GnuPG übergeben. Der entschlüsselte Text wird als Textdatei im konfigurierten Ausgabeverzeichnis abgelegt.

PDF-Prozessor (PGP)

Verarbeitet PGP-verschlüsselte E-Mails mit Base64-kodierten PDF-Anhängen. Die entschlüsselten und konvertierten Daten werden als PDF-Datei gespeichert. Danach erfolgt die Verarbeitung mit z.B. EM-OCR.

Connect-Prozessoren

Extrahieren den E-Mail-Inhalt und werten diesen mit den konfigurierten RegEx-Patterns aus. Die extrahierten Daten werden direkt an Connect übertragen.

Support

Bei Fragen oder Problemen:

• GitHub Issues
• Legacy Dokumentation