Benutzer-Werkzeuge

Webseiten-Werkzeuge


microsoft_exchange

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
microsoft_exchange [2019/05/14 11:56] – [Konfiguration] lwsystemsmicrosoft_exchange [2024/12/11 13:23] (aktuell) – [Fehlersuche] lwsystems
Zeile 15: Zeile 15:
 ===== benno-exchange ===== ===== benno-exchange =====
  
- +Die E-Mails in der Journaling Mailbox von Microsoft liegen in einem speziellen [[microsoft_exchange_journaling-mailbox|Format]] vor. 
-Das Programm //benno-exchange// läd die E-Mails aus der Journaling Mailbox per POP3 und konvertiert diese dann in das Standard E-Mail Format. Die für den Import aufbereitete E-Mail wird im Spoolverzeichnis von Benno MailArchiv gespeichert. +Das Programm //benno-exchange// läd diese E-Mails per POP3 und konvertiert diese dann in das Standard E-Mail Format. Die für den Import aufbereitete E-Mail wird im Spoolverzeichnis von Benno MailArchiv gespeichert. 
  
 ====== Installation ====== ====== Installation ======
Zeile 30: Zeile 30:
 Bei der Installation werden die für die Anbindung benötigten Parameter abgefragt und in die Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' eingetragen.  Bei der Installation werden die für die Anbindung benötigten Parameter abgefragt und in die Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' eingetragen. 
  
-==== tar.gz  ====+Das Paket installiert den Cron-Job ''/etc/cron.d/benno-exchange'' der die E-Mails in 5 Minuten Abständen vom POP3 Server läd und nach dem Speichern vom Server löscht. 
 +==== sonstige Linux-Distributionen ====
  
-Zur Installation wird die aktuellste Version des Tar-Archiv von //benno-exchange// heruntergeladen und im Root des Filesystems entpacktHierbei werden die folgenden Dateien und Verzeichnisse in das System kopiert. +Hier bietet sich die [[#Installation_aus_targz_paket|Installation aus einem .tar.gz Archiv]] an.
- +
-  * /usr/sbin/benno-exchange +
-  * /etc/cron.d/benno-exchange +
-  * /etc/benno-exchange/benno-exchange.conf +
-  * /usr/lib/benno-exchange/+
-  * /usr/share/doc/benno-exchange/+
- +
-Zusätzlich werden noch die folgenden Dateien und Verzeichnisse entpackt. Diese können direkt gelöscht werden. +
- +
-  * /install/ +
-  * /install/predoinst.sh +
-  * /install/doinst.sh +
-  * /install/delete.sh +
- +
-=== Abhängigkeiten === +
- +
-Zusätzlich werden noch die folgenden Perl-Module benötigt: +
- +
-  * //IO::Socket::SSL// +
-  * //Mail::POP3Client// +
-  * //MIME::Parser//+
  
-==== Konfiguration ====+===== Konfiguration =====
  
 In der Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' (///opt/benno-exchange/benno-exchange.conf// beim tar.gz Paket) werden die entsprechenden Parameter eingestellt. In der Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' (///opt/benno-exchange/benno-exchange.conf// beim tar.gz Paket) werden die entsprechenden Parameter eingestellt.
Zeile 63: Zeile 43:
 # Default settings # Default settings
 # #
-0 / -> false / true+TRUE:  yes YES true  TRUE   ok OK 
 +# FALSE: 0 no  NO  false FALSE
 # #
 # #
-# DEBUG      0 +# DEBUG             no 
-# delete     0 +# delete            no 
-# ssl        0 +# force_delete      = yes 
-# VERBOSE    0 +# force_delpop      = yes 
-# host       = localhost +# ssl               no 
-# port       = 110 +# VERBOSE           no 
-# inbox      = /srv/benno/inbox +# host              = localhost 
-# maxfiles   = 250 +# port              = 110 
-# numfetch   200 +# inbox             = /srv/benno/inbox 
-# type       = 2007 (für Exchange 2003 auf 2003 setzen, sonst Defaultwert 2007 lassen) +# numfetch          1000 
-# jcopy      0 +# type              = 2007 
-# runuser    = benno +# jcopy             no 
-# filemode   = 0640 +# runuser           = benno 
-# authmode   = BEST +# authmode          = BEST 
-# statusfile = '' +# statusfile        
-force_delete 0 +whitelist         /path/to/file       # email address | @domain 
-# extraheader_value = ''+# extraheader_name  = X-BENNO-GW 
 +# extraheader_value =  
 +# ssl_version                           # TLSv1 | TLSv11 | TLSv12 | TLSv13 
 +
 +# pass = </etc/benno-exchange/password    # read password from first line of file 
  
 host    = exchange.hostname host    = exchange.hostname
 user    = username user    = username
 pass    = password pass    = password
-delete 1 +delete yes 
-ssl     1+ssl     no
 </file> </file>
  
 +Beim Verbindungsaufbau wird die SSL Version dynamisch ausgehandelt. Daher wird die  Einstellung ssl_version nur bei speziellen Konfigurationen benötigt.
  
 Je nach Version des MS Exchange Servers werden die Journaling Mails in einem unterschiedlichen Format gespeichert. Mit "-t 2003" werden die Journaldateien von MS Exchange 2003 verarbeitet. Ohne Angabe von -t wird das Format der Version 2007 oder höher analysiert.  Je nach Version des MS Exchange Servers werden die Journaling Mails in einem unterschiedlichen Format gespeichert. Mit "-t 2003" werden die Journaldateien von MS Exchange 2003 verarbeitet. Ohne Angabe von -t wird das Format der Version 2007 oder höher analysiert. 
  
 ==== Fehlersuche ==== ==== Fehlersuche ====
 +
 +Beim  Aufruf per Cron werden Logmeldungen per Facility "mail" (LOG_MAIL) geloggt und in der Standardkonfiguration nach ''/var/log/mail.log'' geschrieben. Auf aktuellen Systeme, bei denen das Logging per systemd-journald durchgeführt wird, können die Logmeldungen mittels 
 +
 +  journalctl -ft benno-exchange
 +  
 +eingesehen werden.
  
 Beim Problemen mit der Abholung sollte das Programm mit dem Schalter //-v// direkt auf der Konsole aufgerufen werden. Eventuelle  Fehler werden dann direkt ausgegeben. Beim Problemen mit der Abholung sollte das Programm mit dem Schalter //-v// direkt auf der Konsole aufgerufen werden. Eventuelle  Fehler werden dann direkt ausgegeben.
Zeile 101: Zeile 94:
 /usr/sbin/benno-exchange -R benno -c /etc/benno-exchange/benno-exchange.conf -v /usr/sbin/benno-exchange -R benno -c /etc/benno-exchange/benno-exchange.conf -v
 </code> </code>
-====== Journaling Mailbox  ====== 
  
-===== Konvertierung der Journal E-Mail =====+Mit dem Kommandozeilenparameter //-D// werden Debug-Meldungen angezeigt. 
 +Bei Problemen mit der SSL-Verbindung zum Server sollte vor dem Aufruf die Umgebungsvariable //SSLDEBUG// gesetzt werden. Hier werden Angaben zum SSL-Handshake ausgegeben: 
 +<code bash> 
 +SSL_DEBUG=2 /usr/sbin/benno-exchange -R benno /etc/benno-exchange/benno-exchange.conf -v 
 +</code>
  
-Nach Einrichtung der Journaling Mailbox werden alle ein- und ausgehenden sowie interne E-Mails als Kopie in dieser Mailbox gespeichert. Die E-Mails werden hier in Form einer speziell formatierten "Journaling Mail" abgelegt. 
  
-Die E-Mails aus der Journaling Mailbox können nicht direkt archiviert werden, da die relevante E-Mail im Anhang der Journaling Mail zu finden ist. Zum Import der E-Mails muss die Journaling Mail konvertiert werden. Hierbei werden die relevanten Meta-Daten aus dem Body der Journaling Mail als X-MAILFROM bzw. X-RCPTTO Header übergeben. Die Konvertierung erfolgt automatisch durch //benno-exchange//.+====== Installation aus tar.gz Paket ======
  
-===== Struktur der Journal E-Mail  ===== 
  
-Im Body der Journaling Mail sind die Meta-Informationen  
  
-  * Absender  
-  * Empfänger (To, Cc und Bcc)  
-  * Message-ID 
  
-angegeben, während die ursprüngliche E-Mail //message/rfc822// im Anhang gespeichert ist.  
  
  
-==== MS Exchange 2007 2015  ====+Zur Installation wird die aktuellste Version des Tar-Archiv von //benno-exchange// heruntergeladen und im Root des Filesystems entpackt. Hierbei werden die folgenden Dateien und Verzeichnisse in das System kopiert.
  
-<code> +  * /usr/sbin/benno-exchange 
-# layer | type                +  * /etc/cron.d/benno-exchange 
-# ------+-------------------- +  * /etc/benno-exchange/benno-exchange.conf 
-# 0     | multipart/mixed     +  /usr/lib/benno-exchange/* 
-# 1         text/plain      +  /usr/share/doc/benno-exchange/*
-# 1         message/rfc822 +
-</code>+
  
-Die Journal E-Mail enthält die Envelope Daten ausschließlich im Format //text/plain.// +Zusätzlich werden noch die folgenden Dateien und Verzeichnisse entpackt. Diese können direkt gelöscht werden.
  
 +  * /install/
 +  * /install/predoinst.sh
 +  * /install/doinst.sh
 +  * /install/delete.sh
  
 +=== Abhängigkeiten ===
  
-==== MS Exchange 2003  ====+Zusätzlich werden noch die folgenden Perl-Module benötigt:
  
-Die Journal E-Mail von MS Exchange 2003 ist etwas anders aufgebaut. +  * //IO::Socket::SSL/
- +  * //Mail::POP3Client/
-<code> +  * //MIME::Parser//
-# layer | type +
-# ------+-------------------------- +
-# 0     | multipart/mixed +
-# 1         multipart/alternative +
-# 2             text/plain +
-# 2             text/html +
-# 1         message/rfc822 +
-</code>+
  
-Die Journal E-Mail besteht aus einem Body vom MIME-Type //multipart/mixed//. Dieser enthält einen Teil mit den Envelope-Informationen sowie einen Teil mit der eigentlichen E-Mail. Die Envelope-Informationen sind redundant im Format //text/plain// und //text/html// vorhanden.  
microsoft_exchange.1557835000.txt.gz · Zuletzt geändert: 2019/05/14 11:56 von lwsystems