Installation

Das Installationsprogramm für enaio® mailarchiver finden Sie unter den Installationsdaten im Verzeichnis \Tools\OSMAILARCHIVER.

Wenn Sie das Installationsprogramm starten, dann wird die Anwendung in das von Ihnen angegebene Verzeichnis installiert. Sie geben ebenfalls eine E-Mail-Adresse (postmaster) an, an die Fehlermeldungen gesendet werden.

enaio® mailarchiver wird als Dienst unter der Bezeichnung 'enaio mailarchiver <version>' installiert und meldet sich als lokales Systemkonto an. Der Starttyp ist 'automatisch'.

Für den Einsatz von enaio® mailarchiver benötigen Sie den Lizenzschlüssel 'MAR'.

Die Konfigurationsdateien rules.xml und config.properties.default werden in das Verzeichnis \config installiert und müssen angepasst werden. Nach der Anpassung muss die Datei umbenannt und dort unter config.properties gespeichert werden.

Alle Aktionen werden im Installationsverzeichnis \logs protokolliert.

Auf dem Rechner, auf dem den Sie enaio® mailarchiver einsetzten, muss JDK 17 installiert sein. Der Pfad muss in die Datei wrapper.conf aus dem Verzeichnis \osmailarchiver\conf\ eingetragen werden.
Beispiel:
wrapper.java.command=C:/Program Files/Java/jdk-17/bin/java.exe

IMAP

Zum Abruf von E-Mails über IMAP wird die Komponente imapfetcher-<version>.jar verwendet. Sie wird in das Installations-Verzeichnis \ext\imapfetcher installiert.

Zur Einbindung muss der Dienst 'osmailarchiver' laufen und die Komponente muss über eine konfigurierte Properties-Datei aufgerufen werden.

Eine Properties-Datei mit der Bezeichnung imapfetcher.properties.sample wird mit installiert und muss angepasst werden.

Der Aufruf kann beispielsweise über die Eingabeaufforderung aus dem Verzeichnis der Komponente erfolgen:

java -Dlog4j.configurationFile=file:log4j2.xml -jar imapfetcher-<version>.jar imapfetcher.properties

Parameter der Properties-Datei

Parameter	Wert	Beschreibung
imap.authmode	basic oauth	Authentifizierung 'oauth' wird für O365 Exchange Online verwendet und erfordert die folgenden Zugangsdaten.
imap.oauth.mode	ropc ccfapp	Für 'imap.authmode' mit dem Parameter 'oauth' kann das Verfahren spezifiziert werden. 'ropc' (Default) verwendet das Legacy-Verfahren 'Resource Owner Password Credentials' (expliziter Benutzername und Passwort), um E-Mails klassisch über das IMAP-Protokoll abzurufen. Notwendig sind imap.user, imap.password, imap.oauth.tenant, imap.oauth.clientid und imap.oauth.clientsecret. 'ccfapp' nutzt den modernen 'Client Credentials Flow' (App ID und Client Secret) für den sicheren, passwortlosen Hintergrundzugriff auf Postfächer über die Microsoft Graph API. Notwendig sind imap.user, imap.oauth.tenant, imap.oauth.clientid und imap.oauth.clientsecret. imap.user ist die Mailboxaddresse, die aufgerufen werden soll.
imap.oauth.tenant imap.oauth.clientid imap.oauth.clientsecret		Tenant ID, Client ID und Client Secret aus der Azure App registration angeben.
imap.user imap.password imap.host imap.port		Anmeldedaten des IMAP-Benutzers, Server und Port angeben. Für O365 verwenden Sie den Host outlook.office365.com und Port 993. imap.user kann einerseits der Benutzer aber auch ein Postfach sein.
imap.sourcefolder imap.processedfolder		'sourcefolder' ist der Quellordner für den E-Mailabruf. Optional: 'processedfolder' ist ein Ordner, in dem verarbeitete E-Mails gespeichert werden können.
imap.finalaction	move delete	move: Verarbeitete E-Mails werden in den 'processedfolder' verschoben. delete: Verarbeitete E-Mails werden aus dem 'sourcefolder' gelöscht.
imap.maxfetch		Anzahl der E-Mails pro Abruf.
mailarchiver.host mailarchiver.port		Host und Port der enaio® mailarchiver-Installation. Defaultport: 25
mailarchiver.recipient		Technischer Benutzer für die SMTP-Zustellung an enaio® mailarchiver