MailSigger

Nach dem Herunterladen des mailsigger-0.4.tar.bz2 entpacken Sie das Archiv und kopieren die beiden Dateien mailsigger und mailsigger.py in das Verzeichnis /usr/local/bin. Dabei ist die Datei mailsigger ein Shellscript, welches aus der Postfix-Dokumentation entnommen wurde und den MTA mit dem Filter verbindet. Das Pythonprogramm mailsigger.py ist der eigentliche Filter und wird von dem Shellscript aufgerufen.

host:~ # wget http://www.karstenschulz.name/assets/downloads/mailsigger-0.4.tar.bz2
...
host:~ # tar xvjf mailsigger-0.4.tar.bz2
host:~ # cd mailsigger-0.4
host:~ # cp mailsigger* /usr/local/bin

Danach legen Sie einen Benutzer an, unter dessen Identität MailSigger arbeiten wird. Dieser Benutzer benötigt keine Shell.

host:~ # useradd -s /bin/false mailsigger

Nun können wir das Arbeitsverzeichnis anlegen.

MailSigger muss die zu bearbeitenden Mails im Dateisystem zwischenspeichern. Hierzu benötigt er ein Arbeitsverzeichnis mit Schreibrechten. Der Einfachheit halber kann MailSigger in diesem Verzeichniss auch die Protokolldatei ablegen. Damit niemand Unbefugtes Mails lesen kann, setzen wir die Berechtigung des Verzeichnisses sehr restriktiv.

host:~ # mkdir /var/spool/mailsigger
host:~ # chown mailsigger /var/spool/mailsigger
host:~ # chmod 0700 /var/spool/mailsigger

	Ort des Arbeitsverzeichnisses
	Falls Sie ein anderes Arbeitsverzeichnis benutzen wollen, müssen Sie dieses in dem Shellscript /usr/local/bin/mailsigger in der Variablen INSPECT_DIR deklarieren!

Damit sind die alle Komponenten installiert. Nun müssen verschiedene Parameter und der Postfix MTA konfiguriert werden.

Die einstellbaren Parameter befinden sich ziemlich am Anfang der Datei /usr/local/bin/mailsigger.py. Öffnen Sie sie in Ihrem Lieblingseditor:

#############################################################################
# please configure the following values:                                    #
#############################################################################

# configure different sig-files for different sender here:
SIGNATURE_RULES_FILE = '/etc/postfix/signature_rules'

# which encoding do you use in your different signature files?
SIGNATURE_ENCODING = 'utf-8'

# loglevel, one of ERROR or DEBUG (atm)
VERBOSITY = logging.DEBUG

# logfile
LOGFILE = '/var/spool/mailsigger/mailsigger.log'

#############################################################################
# end of configuration                                                      #
#############################################################################

In diesem Beispiel wird im Parameter SIGNATURE_RULES_FILE die Zuordnungstabelle von Absendern und deren Signaturdateien auf die Datei /etc/postfix/signature_rules festgelegt.

Da die Signaturen möglicherweise Zeichen enthalten, die nicht im ASCII-Code abgebildet werden können, muss mit dem Parameter SIGNATURE_ENCODING die Kodierung des Signaturtextes angegeben werden. Auf normalen Systemen ist das utf-8. Bei älteren Systemen wird als Kodierung oft auch iso-8859-1, und bei einigen Nischensystemen auch cp1252 benutzt. Schauen Sie in der Dokumentation Ihres Editors nach, in welcher Kodierung dieser Ihre Dateien abspeichert.

Der Parameter VERBOSITY legt die Menge der Meldungen fest, die in die Protokolldatei des Programms geschreiben werden soll. Momentan sind folgende Stufen sinnvoll:

Mit LOGFILE legen Sie den Namen der Protokolldatei fest. Zur Zeit wird nur das Protokollieren in eine Datei unterstützt.

	Schreibrechte für die Protokolldatei
	Achtung, die Benutzer-Id unter der der Filter in Ihrem System laufen wird, muss Schreibrechte auf die angegebene Protokolldatei haben! Außerdem muss er natürlich Leserechte für die Signaturdateien haben.

In der Datei SIGNATURE_RULES_FILE legen Sie die Zuordnung zwischen einem Absender und die für diesen Absender anzuhängende Signatur fest. In unserem Beispiel wäre das die Datei /etc/postfix/signature_rules. Der Aufbau dieser Datei ist denkbar einfach:

# Absender              # anzuhängende Signaturdatei
boss@mycompany.com      /etc/postfix/boss-sig.txt
kurt@mycompany.com      /etc/postfix/kurt-sig.txt
no-sig@mycompany.com
@mycompany.com          /etc/postfix/sig-for-all.txt

Die Absender boss@mycompany.com und kurt@mycompany.com bekommen unter ihre ausgehenden Mails jeder seine eigene, individuelle Signatur aus der angegebenen Datei angehängt. Der Absender no-sig@mycompany.com bekommt keine Signatur angehängt und durch die letzte Regel bekommen alle anderen Absender aus der Domain mycompany.com die allgemeine Signatur aus der Datei /etc/postfix/sig-for-all.txt angehängt.

Kommentarzeilen werden mit einer Raute # an der ersten Stelle eingeleitet. Leere Zeilen sind ebenfalls erlaubt.

Das mitgelieferte Shellscript mailsigger ist aus dem hervorragenden FILTER_README.html der Postfix-Dokumentation entnommen worden. Es dient der Verbindung zwischen Postfix und externen Filterprogrammen, wie mailsigger.py eines ist.

#!/bin/sh

# Simple shell-based filter. It is meant to be invoked as follows:
#       /path/to/script -f sender recipients...

INSPECT_DIR=/var/spool/mailsigger
SENDMAIL="/usr/sbin/sendmail -G -i"

Bitte passen Sie die Zeilen mit den Shell-Variablen INSPECT_DIR und SENDMAIL Ihren Gegebenheiten an. INSPECT_DIR ist das oben eingestellte Arbeitsverzeichnis. Falls Sie eine Standardinstallation benutzen, sollten die voreingestellten Werte für Sie funktionieren. Wenn Sie unsicher sind, lesen Sie die Postfix-Dokumentation.

Nun muss Postfix diese neue Methode der Mailverarbeitung noch bekannt gemacht werden. In der Postfix-Terminologie handelt es sich bei MailSigger um einen neuen Transport. Deshalb konfigurieren wir einen neuen Transport mailsigger in der Datei /etc/postfix/master.cf:

# ==========================================================================
# service type  private unpriv  chroot  wakeup  maxproc command + args
#               (yes)   (yes)   (yes)   (never) (100)
# ==========================================================================
127.0.0.1:10025 inet    n       -       n       -       -       smtpd
        -o content_filter=
        -o local_recipient_maps=
        -o smtpd_helo_restrictions=
        -o smtpd_client_restrictions=
        -o smtpd_sender_restrictions=
        -o smtpd_recipient_restrictions=permit_mynetworks,reject_unauth_destination
        -o mynetworks=127.0.0.0/8

smtp-amavis     unix    -       -       n       -       2       smtp
        -o smtp_data_done_timeout=1200
        -o disable_dns_lookups=yes


mailsigger  unix  -       n       n       -       -       pipe
  flags=Rq user=mailsigger argv=/usr/local/bin/mailsigger -f ${sender} ${recipient}

192.168.0.1:smtp      inet  n       -       n       -       -       smtpd
        -o content_filter=mailsigger
127.0.0.1:smtp      inet  n       -       n       -       -       smtpd

Der neue Transport mailsigger ruft das Script /usr/local/bin/mailsigger unter der Benutzer-Id mailsigger auf

Durch diesen Transport werden alle Mails, die über den Socket 192.168.0.1:25 eingeliefert werden, durch MailSigger geschickt. Die IP-Adresse ist natürlich entsprechend anzupassen. Nehmen Sie als IP-Adresse den Socket, auf dem Ihre Clients die Mails zum Versenden einliefern. Alle Mails, die Ihre Clients durch diesen Transport abliefern, laufen so durch MailSigger und danach gegebenenfalls durch den Hauptfilter, den sie möglicherweise in der main.cf mit dem Postfix-Parameter content_filter festgelegt haben.