%
% antispam.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Antispam %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das Antispam-Paket}

    Dieses Paket ist als Zusatzpaket zum Mail-Paket zu verstehen. Eingehende Nachrichten
    werden mit Hilfe dieses Programms, vor der Verteilung in die einzelnen Postf"acher, auf
    Spam-Inhalt "uberpr"uft und gegebenenfalls herausgefiltert. Diese Dokumentation wurde
    bereits auf die n"achste Version 1.8.12 abgestimmt. Nutzer vorheriger Version sollten
    die im jeweiligen Antispam-Paket enthaltene Dokumentation als Referenz verwenden.


\section{Die Einleitung}

    Was ist Spam?
    Von Spam spricht man, wenn eine Kopie einer Nachricht das Internet "uberflutet, mit
    dem Ziel so viele Empf"anger wie m"oglich zu erreichen, obwohl diese die Zusendung der
    Nachricht nicht verlangt haben. Meistens werden "uber Spam dubiose Produkte
    kommerziell beworben, die versprechen in 14 Tagen zum Million"ar zu werden, oder
    es werden nicht ganz legale Services angepriesen.

    An dieser Stelle kommt das Antispam-Paket ins Spiel!

    Wenn die "Uberpr"ufung auf Spam "uber den Parameter EXISCAN\_SPAMD\_ENABLED (Mail-Paket)
    aktiviert wurde, wird jede eingehende Nachricht nach diversen Regeln bewertet und
    bei der Identifikation als Spam als solche behandelt. Standardm"a"sig wird z.B.,
    in Abh"angigkeit von dem Parameter EXISCAN\_SPAMD\_ACTION (Mail-Paket) eine solche
    Nachricht an den User-Account 'spam@domain.de' weitergeleitet, um es dem Mail-Administrator
    zu erm"oglichen diese vor dem L"oschen noch einmal zu verifizieren. Durch diese Prozedur
    werden die E-Mail-Nutzer vor Nachrichten gesch"utzt, die sie normalerweise sowieso nicht
    empfangen wollen.


\section{Die Funktionen}

    Das Antispam-Paket besteht aus folgender Komponente:

    \begin{itemize}
        \item SpamAssassin - ist ein Prozess, der die Spam-Bewertung durchf"uhrt.\\
            (\url{http://www.spamassassin.org/})
    \end{itemize}

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt zur korrekten Funktion zwingend die installierten Pakete 'Mail',
    'Perl' und andere Perl-Funktionspakete.


\section{Die Installation}

    Das Antispam-Paket wird "uber das Setup-Men"u installiert. Wird eine "altere
    Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen
    Programmdateien installiert werden. Nach dem Installieren der Programmdateien
    wird direkt der Konfigurations-Editor gestartet um die Konfiguration anzupassen.
    Nach Beendigung dieses Schrittes werden die Konfigurationsdateien generiert
    und alle ben"otigten Programme gestartet.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm wird "uber 'Mail Services' -> 'Goto mail modules'
    angesprochen und ist wie folgt aufgebaut:

    \begin{itemize}
    \item Antispam interface
        \begin{itemize}
        \item View documentation: Anzeigen der Dokumentation
        \item Edit configuration: Bearbeiten der Konfiguration
        \item Advanced configuration file handling: Konfigurationen verwalten
        \item View configuration log file: Die Konfigurations-Logmeldungen anzeigen
        \item Show status: Status der Antispam-Komponenten anzeigen
        \item Stop service: Alle Antispam-Komponenten anhalten
        \item Start service: Alle Antispam-Komponenten starten
        \item Check mailbox: Spam-Postfach auf vorhandene Mails "uberpr"ufen
        \item Read messages: Eingegangene Spam-Mails lesen
        \item Show email addresses in AWL
        \item Add email address(es) to AWL whitelist
        \item Add email address(es) to AWL blacklist
        \item Force rules update: Regelaktualisierung ansto"sen
        \item View log file: Die Antispam-Logmeldungen anzeigen
        \item Return: Untermen"u verlassen
        \end{itemize}
    \item Return: Untermen"u verlassen
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration' ge"andert werden.
    Standardm"a"sig wird der Editor aufgerufen, der in der Environment-Konfiguration
    "uber die Variable 'EDITOR' festgelegt wurde.  Nachdem der Editor beendet wurde
    wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies best"atigt,
    werden "uber ein Skript die Anpassungen umgehend wirksam gemacht.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind folgende
    Parameter vorhanden; wer sie von Hand editieren will findet sie unter
    /etc/config.d/antispam.


\section{Die Parameter}

\begin{description}
    \config{START\_ANTISPAM}{START\_ANTISPAM}{STARTANTISPAM}
        F"ur die Aktivierung des Antispam-Programms muss diese Variable lediglich auf
        den Wert 'yes' gestellt werden. Die Einstellung 'no' deaktiviert das Antispam-Programm.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_ANTISPAM='no'}

    \config{ANTISPAM\_ALLOWED\_ADDRESSES}{ANTISPAM\_ALLOWED\_ADDRESSES}{ANTISPAMALLOWEDADDRESSES}
        "Uber diesen Parameter k"onnen IP-Adressen oder Netzwerke angegeben werden, denen es
        zus"atzlich zum lokalen Host erlaubt ist eine Verbindung zum Spam-Prozess aufzubauen.
        Es ist somit nicht notwendig auf allen Rechnern einen eigenen Spam-Prozess zu installieren.

        G"ultige Werte: IP-Adressen und/oder Netzwerke

        Beispiel: \texttt{ANTISPAM\_ALLOWED\_ADDRESSES='192.168.6.20,192.168.7.0/24'}

        Standardeinstellung: \texttt{ANTISPAM\_ALLOWED\_ADDRESSES=$''$}

     \config{ANTISPAM\_LISTEN\_ADDRESSES (Optionaler Parameter)}{ANTISPAM\_LISTEN\_ADDRESSES}{ANTISPAMLISTENADDRESSES}
        "Uber diesen Parameter kann eine IP-Adresse angegeben werden, auf welcher der Spam-Prozess
        Verbindungsanfragen entgegen nehmen soll. Wird der Parameter auf den Wert 'all' gesetzt,
        so werden auf allen Netzwerkanschl"ussen Verbindungsanfragen entgegen genommen. Wird der
        Parameter nicht gesetzt oder leer gelassen, so wird standardm"a"sig die Adresse '127.0.0.1'
        verwendet.

        G"ultige Werte: leer, all, IP-Adresse

        Beispiel: \texttt{ANTISPAM\_LISTEN\_ADDRESSES='192.168.0.20'}

        Standardeinstellung: \texttt{ANTISPAM\_LISTEN\_ADDRESSES=$''$}

    \config{ANTISPAM\_DNS\_AVAILABLE}{ANTISPAM\_DNS\_AVAILABLE}{ANTISPAMDNSAVAILABLE}
        Um die Funktionsf"ahigkeit von DNS zu pr"ufen wird standardm"a"sig versucht die Namen
        einiger Hosts im Internet aufzul"osen. Dies kann in einigen F"allen zu Fehlern f"uhren,
        weil z.B. die Netzwerkverbindung unterbrochen wurde und so vermutet wird, dass keine
        DNS-Aufl"osung m"oglich ist. "Uber diesen Parameter wird nun bestimmt, ob eine automatische
        Pr"ufung stattfinden soll (test), generell immer davon ausgegangen werden soll, dass DNS
        verf"ugbar (yes) bzw. nicht verf"ugbar (no) ist.

        G"ultige Werte: yes, no, test[: name1 name2]

        Standardeinstellung: \texttt{ANTISPAM\_DNS\_AVAILABLE='test'}

    \config{ANTISPAM\_ENABLE\_RBL\_CHECKS}{ANTISPAM\_ENABLE\_RBL\_CHECKS}{ANTISPAMENABLERBLCHECKS}
        Wird dieser Parameter auf 'yes' gesetzt, so wird bei einer "Uberpr"ufung zus"atzlich
        eine Verbindung zu RBL-Servern (Realtime Blackhole Lists) aufgebaut und gepr"uft, ob
        der Absender der Nachricht dort bereits als Spammer bekannt ist.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_ENABLE\_RBL\_CHECKS='yes'}

    \config{ANTISPAM\_ENABLE\_SPAMCOP}{ANTISPAM\_ENABLE\_SPAMCOP}{ANTISPAMENABLESPAMCOP}
        Wird dieser Parameter auf 'yes' gesetzt, so wird eine als Spam eingestufte Nachricht
        automatisch an SpamCop (\url{http://www.spamcop.net/}) zur Analyse weitergeleitet.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_ENABLE\_SPAMCOP='no'}

    \config{ANTISPAM\_MAILBOX\_FILE}{ANTISPAM\_MAILBOX\_FILE}{ANTISPAMMAILBOXFILE}
        Dieser Parameter legt den Postfachname und -pfad des Spam-Postfachs fest.
        Wird dieser Parameter nicht gef"ullt, so wird der Standardname 'spam' im
        Verzeichnis /var/spool/mail verwendet.

        G"ultige Werte: Postfachname optional inkl. Pfad

        Standardeinstellung: \texttt{ANTISPAM\_MAILBOX\_FILE=$''$}

    \config{ANTISPAM\_MAX\_CHILDREN}{ANTISPAM\_MAX\_CHILDREN}{ANTISPAMMAXCHILDREN}
        Dieser Parameter legt fest, wie viele Kindprozesse maximal gleichzeitig auf dem
        Server aktiviert werden sollen. Auf sehr langsamer Hardware ist es manchmal
        sinnvoll diesen Parameter anzupassen. Standardm"a"sig werden die systemspezifischen
        Einstellungen verwendet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{ANTISPAM\_MAX\_CHILDREN='0'}

    \config{ANTISPAM\_BAYES\_AUTO\_LEARN}{ANTISPAM\_BAYES\_AUTO\_LEARN}{ANTISPAMBAYESAUTOLEARN}
        Wird dieser Parameter auf 'yes' gesetzt, so werden Nachrichten mit einer hohen
        Spam-Wertung dem Bayes-Filter zugef"uhrt. Dieser wertet die zugef"uhrten Informationen
        aus und passt dann dynamisch seine Spam-Bewertung an.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_BAYES\_AUTO\_LEARN='yes'}

    \index{ANTISPAM\_BAYES\_LEARN\_FROM\_SPAM\_N}
    \config{ANTISPAM\_BAYES\_LEARN\_FROM\_SPAM\_x}{ANTISPAM\_BAYES\_LEARN\_FROM\_SPAM\_x}{ANTISPAMBAYESLEARNFROMSPAMx}
        "Uber diese Parameter k"onnen Postfachdateien mit vollst"andiger Pfadangabe angegeben
        werden, in denen 'Spam'-Nachrichten (schlecht) gesammelt werden. Falls z.B. bei jedem
        Anwender eine Datei gleichen Namens verwendet werden soll, so ist der Einsatz von
        Jokerzeichen m"oglich. Diese werden dann im vorgegebenen Zeitintervall zum Trainieren
        des Bayes-Filter verwendet.
        (Siehe \jump{ANTISPAMBAYESLEARNCRONSCHEDULE}{ANTISPAM\_BAYES\_LEARN\_CRON\_SCHEDULE})

        G"ultige Werte: Zahl bzw. Postfachname inkl. Pfad

        Beispiel:

        \texttt{ANTISPAM\_BAYES\_LEARN\_FROM\_SPAM\_N='1'\\
                ANTISPAM\_BAYES\_LEARN\_FROM\_SPAM\_1='/var/spool/mail/spam'}

    \index{ANTISPAM\_BAYES\_LEARN\_FROM\_HAM\_N}
    \config{ANTISPAM\_BAYES\_LEARN\_FROM\_HAM\_x}{ANTISPAM\_BAYES\_LEARN\_FROM\_HAM\_x}{ANTISPAMBAYESLEARNFROMHAMx}
        "Uber diese Parameter k"onnen Postfachdateien mit vollst"andiger Pfadangabe angegeben
        werden, in denen 'Ham'-Nachrichten (gut) gesammelt werden. Falls z.B. bei jedem Anwender
        eine Datei gleichen Namens verwendet werden soll, so ist der Einsatz von Jokerzeichen
        m"oglich. Diese werden dann im vorgegebenen Zeitintervall zum Trainieren des Bayes-Filter
        verwendet.
        (Siehe \jump{ANTISPAMBAYESLEARNCRONSCHEDULE}{ANTISPAM\_BAYES\_LEARN\_CRON\_SCHEDULE})

        G"ultige Werte: Zahl bzw. Postfachname inkl. Pfad

        Beispiel:

        \texttt{ANTISPAM\_BAYES\_LEARN\_FROM\_HAM\_N='1'\\
                ANTISPAM\_BAYES\_LEARN\_FROM\_HAM\_1='/home/frank/.imapmail/ham-archive'}

    \config{ANTISPAM\_BAYES\_LEARN\_CRON\_SCHEDULE}{ANTISPAM\_BAYES\_LEARN\_CRON\_SCHEDULE}{ANTISPAMBAYESLEARNCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall die angegebenen
        Spam- bzw. Ham-Postfachdateien f"ur das Training des Bayes-Filters ausgewertet werden
        sollen. Die f"unf Teilparameter haben dabei folgende Bedeutung:\\

        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag.\\

        D.h. bei Verwendung der Standardeinstellung wird jeweils am Sonntag um 03:05h
        der Vorgang angesto"sen. Wer N"aheres "uber die verwendete Befehlssyntax erfahren
        m"ochte, sollte "uber eine Internet-Suchmaschine nach 'man' und 'crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{ANTISPAM\_BAYES\_LEARN\_CRON\_SCHEDULE='5 3 * * 0'}

    \config{ANTISPAM\_AUTO\_WHITELIST}{ANTISPAM\_AUTO\_WHITELIST}{ANTISPAMAUTOWHITELIST}
        Wird dieser Parameter auf 'yes' gesetzt, so wird versucht, anhand der von einem
        Absender versandten Nachrichten und deren Spam-Bewertung, die Spam-Wertung der
        aktuell von diesem Absender empfangenen Nachricht einzustufen. D.h. wurden "uber
        einen l"angeren Zeitraum Nachrichten von einem Absender als 'Nicht-Spam' eingestuft,
        so kann mit hoher Wahrscheinlichkeit auch bei der aktuellen Nachricht davon ausgegangen
        werden, dass es sich nicht um Spam handelt, obwohl vielleicht der Spam-Schwellwert
        geringf"ugig "uberschritten wurde. Die Einstellung 'no' deaktiviert diese Funktion.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_AUTO\_WHITELIST='yes'}

     \config{ANTISPAM\_AUTO\_WHITELIST\_FACTOR}{ANTISPAM\_AUTO\_WHITELIST\_FACTOR}{ANTISPAMAUTOWHITELISTFACTOR}
        Wurde die automatische Whitelist-Funktion "uber den Parameter \jump{ANTISPAMAUTOWHITELIST}{ANTISPAM\_AUTO\_WHITELIST}
        aktiviert, so beeinflusst der hier definierte Faktor die Einstufung einer Nachricht
        als Spam. D.h. man hat einerseits den Durchschnittswert der Spam-Wertungen eines
        Absenders und andererseits den aktuell berechneten Spam-Wert. Die endg"ultige
        Bewertung ergibt sich danach aus folgender Formel:

        endg"ultige W. = aktuelle W. + (durchschnittliche W. - aktuelle W.) * Faktor

        Ein Faktor von '1' bedeutet, dass immer der Durchschnittswert verwendet wird.
        Ein Faktor von '0'  bedeutet, dass immer der aktuell berechnete Wert verwendet wird.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{ANTISPAM\_AUTO\_WHITELIST\_FACTOR='0.5'}

    \index{ANTISPAM\_BLACKLIST\_FROM\_N}
    \config{ANTISPAM\_BLACKLIST\_FROM\_x}{ANTISPAM\_BLACKLIST\_FROM\_x}{ANTISPAMBLACKLISTFROMx}
        "Uber diese Parameter k"onnen E-Mail-Adressen angegeben werden, die f"alschlicherweise sehr
        h"aufig als 'Nicht-Spam' klassifiziert werden, obwohl das Gegenteil der Fall ist. "Uber
        ANTISPAM\_BLACKLIST\_FROM\_N wird die Anzahl der Eintr"age festgelegt und "uber
        ANTISPAM\_BLACKLIST\_FROM\_x werden die einzelnen Eintr"age definiert. Eingaben wie z.B.
        '*@domain.de' oder '*.domain.de' sind ebenfalls zul"assig.

        G"ultige Werte: Zahl bzw. E-Mail-Adresse

        Beispiel:

        \texttt{ANTISPAM\_BLACKLIST\_FROM\_N='1'\\
                ANTISPAM\_BLACKLIST\_FROM\_1='spammer@spammershome.com'}

    \index{ANTISPAM\_WHITELIST\_FROM\_N}
    \config{ANTISPAM\_WHITELIST\_FROM\_x}{ANTISPAM\_WHITELIST\_FROM\_x}{ANTISPAMWHITELISTFROMx}
        "Uber diese Parameter k"onnen E-Mail-Adressen angegeben werden, die f"alschlicherweise sehr
        h"aufig als 'Spam' klassifiziert werden, obwohl das Gegenteil der Fall ist. "Uber
        ANTISPAM\_WHITELIST\_FROM\_N wird die Anzahl der Eintr"age festgelegt und "uber
        ANTISPAM\_WHITELIST\_FROM\_x werden die einzelnen Eintr"age definiert. Eingaben wie z.B.
        '*@domain.de' oder '*.domain.de' sind ebenfalls zul"assig.

        G"ultige Werte: Zahl bzw. E-Mail-Adresse

        Beispiel:

        \texttt{ANTISPAM\_WHITELIST\_FROM\_N='1'\\
                ANTISPAM\_WHITELIST\_FROM\_1='nospammer@whitejacket.com'}

    "Uber die nachfolgenden Parameter kann die Funktion zur automatisierten
    Aktualisierung der Spamregeln konfiguriert werden. Wird der Parameter
    \jump{ANTISPAMRULEUPDATE}{ANTISPAM\_RULE\_UPDATE='yes'} gesetzt, so wird
    einmal alle 24 Stunden nach aktualisierten Spamregeln gesucht. H"aufigere
    Pr"ufungen sind nicht zu empfehlen, da der eigene Rechner ansonsten von
    Aktualisierungen ausgeschlossen werden k"onnte.
    Falls neue Regeln herunter geladen wurden, wird mittels des zugeh"origen
    GnuPG-Schl"ussels gepr"uft ob die Archive unver"andert "ubertragen wurden.
    Danach werden die Regeln im Verzeichnis \texttt{/var/antispam/spamassassin/sa-update-files}
    entpackt und ein Neustart des spamd-Prozesses angefordert.\\
    Im Anschluss startet das im Hintergrund laufende \texttt{antispam-control}-
    Skript den Prozess wie gew"unscht neu.
    Da die eigentlichen Spamregeln hierdurch nicht "uberschrieben werden,
    ist es jederzeit m"oglich zur Ursprungskonfiguration zur"uck zu kehren
    ohne das Antispam-Paket neu installieren zu m"ussen.

    \config{ANTISPAM\_RULE\_UPDATE}{ANTISPAM\_RULE\_UPDATE}{ANTISPAMRULEUPDATE}
        Wird dieser Parameter auf den Wert 'yes' gesetzt, so aktiviert man die automatisierte
        Aktualisierung der Spamregeln. Setzt man den Parameter auf den Wert 'no', so werden
        keine Aktualisierungen herunter geladen.\\
        \achtung{Um diese Funktion nutzen zu k"onnen muss zuvor das GnuPG-Paket installiert werden!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_RULE\_UPDATE='no'}

    \config{ANTISPAM\_RULE\_CHANNEL\_N}{ANTISPAM\_RULE\_CHANNEL\_N}{ANTISPAMRULECHANNELN}
        "Uber diesen Parameter legt man die Anzahl der Kan"ale fest, welche automatisiert
        auf neue Spamregeln gepr"uft werden sollen.

        G"ultige Werte: Zahl

        Beispiel:

        \texttt{ANTISPAM\_RULE\_CHANNEL\_N='1'\\
                ANTISPAM\_RULE\_CHANNEL\_1\_ACTIVE='no'\\
                ANTISPAM\_RULE\_CHANNEL\_1\_NAME='updates.spamassassin.org'}

    \config{ANTISPAM\_RULE\_CHANNEL\_x\_ACTIVE}{ANTISPAM\_RULE\_CHANNEL\_x\_ACTIVE}{ANTISPAMRULECHANNELxACTIVE}
        Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird der "uber
        den Parameter \jump{ANTISPAMRULECHANNELxNAME}{ANTISPAM\_RULE\_CHANNEL\_x\_NAME}
        konfigurierte Kanal aktiviert, 'no' deaktiviert ihn.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_RULE\_CHANNEL\_1\_ACTIVE='no'}

    \config{ANTISPAM\_RULE\_CHANNEL\_x\_NAME}{ANTISPAM\_RULE\_CHANNEL\_x\_NAME}{ANTISPAMRULECHANNELxNAME}
        "Uber diesen Parameter legt man den Namen eines Kanals fest von welchem
        automatisiert Spamregeln herunter geladen werden sollen.

        G"ultige Werte: g"ultiger Kanalname

        Beispiel: \texttt{ANTISPAM\_RULE\_CHANNEL\_1\_NAME='updates.spamassassin.org'}

    \config{ANTISPAM\_RULE\_KEY\_N}{ANTISPAM\_RULE\_KEY\_N}{ANTISPAMRULEKEYN}
        "Uber diesen Parameter legt man die Anzahl der GnuPG-Schl"ussel fest, welche
        man automatisiert herunter laden m"ochte. Kanalinhalte die mit diesem Schl"ussel
        signiert wurden werden automatisch als vertrauensw"urdig eingestuft.

        G"ultige Werte: Zahl

        Beispiel:

        \texttt{ANTISPAM\_RULE\_KEY\_N='2'\\
                ANTISPAM\_RULE\_KEY\_1\_ACTIVE='no'\\
                ANTISPAM\_RULE\_KEY\_1\_URL='http://spamassassin.apache.org/updates/GPG.KEY'\\
                ANTISPAM\_RULE\_KEY\_1\_ID='5244EC45'}

    \config{ANTISPAM\_RULE\_KEY\_x\_ACTIVE}{ANTISPAM\_RULE\_KEY\_x\_ACTIVE}{ANTISPAMRULEKEYxACTIVE}
        Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird der "uber
        den Parameter \jump{ANTISPAMRULEKEYxURL}{ANTISPAM\_RULE\_KEY\_x\_URL}
        konfigurierte GnuPG-Schl"ussel herunter geladen und dem "uber den Parameter
        \jump{ANTISPAMRULEKEYxID}{ANTISPAM\_RULE\_KEY\_x\_ID} konfigurierten
        Schl"ussel-ID vertraut, 'no' deaktiviert sie.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_RULE\_KEY\_1\_ACTIVE='no'}

    \config{ANTISPAM\_RULE\_KEY\_x\_URL}{ANTISPAM\_RULE\_KEY\_x\_URL}{ANTISPAMRULEKEYxURL}
        "Uber diesen Parameter legt man die URL eines GnuPG-Schl"ussels fest, welcher
        automatisiert herunter geladen werden soll.

        G"ultige Werte: g"ultige GnuPG-URL

        Beispiel: \texttt{ANTISPAM\_RULE\_KEY\_1\_URL='http://spamassassin.apache.org/updates/GPG.KEY'}

    \config{ANTISPAM\_RULE\_KEY\_x\_ID}{ANTISPAM\_RULE\_KEY\_x\_ID}{ANTISPAMRULEKEYxID}
        Soll dem "uber den Parameter \jump{ANTISPAMRULEKEYxURL}{ANTISPAM\_RULE\_KEY\_x\_URL}
        herunter geladenen GnuPG-Schl"ussel vertraut werden, so muss dessen Schl"ussel-ID
        hier konfiguriert werden.

        G"ultige Werte: g"ultige GnuPG-ID

        Beispiel: \texttt{ANTISPAM\_RULE\_KEY\_1\_ID='5244EC45'}

    \config{ANTISPAM\_RULE\_CRON\_SCHEDULE}{ANTISPAM\_RULE\_CRON\_SCHEDULE}{ANTISPAMRULECRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall automatisiert
        nach Spamregelaktualisierungen gesucht werden soll. Die f"unf Teilparameter haben
        dabei folgende Bedeutung:\\

        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag. \\

        D.h. bei Verwendung der Standardeinstellung wird jeden Tag um 23:40h diese
        Pr"ufung durchgef"uhrt. Wer N"aheres "uber die verwendete Befehlssyntax erfahren
        m"ochte, sollte "uber eine Internet-Suchmaschine nach 'man' und 'crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{ANTISPAM\_RULE\_CRON\_SCHEDULE='40 23 * * *'}

    \config{ANTISPAM\_INFOMAIL}{ANTISPAM\_INFOMAIL}{ANTISPAMINFOMAIL}
        "Uber diesen Parameter kann der automatisierte Versand einer Mail an den Postmaster
        aktiviert werden, die "uber den Status des Spam-Postfaches informiert. Wird der
        Parameter auf den Wert 'no' gesetzt, so erfolgt keine Benachrichtigung.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{ANTISPAM\_INFOMAIL='yes'}

    \config{ANTISPAM\_INFOMAIL\_SUBJECT}{ANTISPAM\_INFOMAIL\_SUBJECT}{ANTISPAMINFOMAILSUBJECT}
        "Uber diesen Parameter wird der Text der Betreffzeile festgelegt, die "uber den Status
        des Spam-Postfaches informiert. Dieser Parameter wird nur ausgewertet, wenn zuvor
        ANTISPAM\_INFOMAIL='yes' gesetzt wurde.

        G"ultige Werte: Text

        Standardeinstellung: \texttt{ANTISPAM\_INFOMAIL\_SUBJECT='Spam mailbox status'}

    \config{ANTISPAM\_INFOMAIL\_BODY}{ANTISPAM\_INFOMAIL\_BODY}{ANTISPAMINFOMAILBODY}
        "Uber diesen Parameter wird der Text der Nachricht festgelegt, die "uber den Status
        des Spam-Postfaches informiert. An Stelle des '|'-Zeichens wird vor dem Versand der
        Nachricht das Ergebnis der Postfach"uberpr"ufung eingesetzt. Dieser Parameter wird nur
        ausgewertet, wenn zuvor ANTISPAM\_INFOMAIL='yes' gesetzt wurde.

        G"ultige Werte: Text inkl. '|'-Zeichen

        Standardeinstellung: \texttt{ANTISPAM\_INFOMAIL\_BODY='Result of the spam mailbox check:$\backslash$n$|$$\backslash$nPlease delete messages after verification!'}

     \config{ANTISPAM\_INFOMAIL\_CRON\_SCHEDULE}{ANTISPAM\_INFOMAIL\_CRON\_SCHEDULE}{ANTISPAMINFOMAILCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall eine "Uberpr"ufung
        des Spam-Postfaches erfolgen soll. Dieser Parameter wird nur ausgewertet, wenn zuvor
        ANTISPAM\_INFOMAIL='yes' gesetzt wurde. Die f"unf Teilparameter haben dabei folgende
        Bedeutung:\\

        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag.\\

        D.h. bei Verwendung der Standardeinstellung wird t"aglich um 07:03h eine "Uberpr"ufung
        durchgef"uhrt. Wer N"aheres "uber die verwendete Befehlssyntax erfahren m"ochte, sollte "uber
        eine Internet-Suchmaschine nach 'man' und 'crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{ANTISPAM\_INFOMAIL\_CRON\_SCHEDULE='3 7 * * *'}
\end{description}

\section{Das "Uberpr"ufen von Spam Nachrichten}

    Um als Spam klassifizierte Nachrichten zu "uberpr"ufen w"ahlt man den Men"upunkt 'Read messages'
    und l"asst sich die Betreffzeilen der Nachrichten anzeigen. Durch Eingabe der Nachrichtennummer
    kann man sich dann den Nachrichtentext anzeigen lassen und durch dr"ucken von 'd' die Nachricht
    gegebenenfalls l"oschen. Wurde eine Nachricht f"alschlicherweise als Spam eingestuft, so geht
    man wie folgt vor um diese trotzdem dem Empf"anger zuzustellen:\\
    \\
    \begin{itemize}
        \item[1] Eingeben von 'm <E-Mail-Adresse>' um eine Nachricht weiterzuleiten.
        \item[2] Eingabe der Betreffzeile.
        \item[3] Durch Eingabe von '\~m<Nummer der Nachricht>' oder '\verb+~+M<Nummer der Nachricht>' wird
                 die weiterzuleitende Nachricht ausgew"ahlt. Dabei wird mit '\verb+~+m' nur der Nachrichtentext
                 und mit '\verb+~+M' zus"atzlich auch die Kopfzeilen eingef"ugt.
        \item[4] Mit STRG-D wird die Nachricht abgeschlossen, mit STRG-C abgebrochen.
        \item[5] Falls gew"unscht Eingabe von CC und BCC-Empf"angern, sonst nur mit RETURN best"atigen.
    \end{itemize}

\section{Eine Test-Spam Nachricht senden}

    Will man testen ob der Spam-Filter korrekt funktioniert, so kann man sich selbst eine
    Nachricht von einem Mailaccount au"serhalb des eigenen Netzes mit folgender Zeichenkette,
    die keine Leerzeichen oder Zeilenumbr"uche enth"alt, zusenden:

\begin{verbatim}
XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X
\end{verbatim}

\section{Das Rollieren der Logdatei konfigurieren}

    Ab der Paketversion 1.1.2 werden die paketspezifischen Meldungen nicht mehr in die Datei
    /var/log/messages geschrieben, sondern es wird eine eigene Datei /var/log/antispam.log
    verwendet. Um sicher zu stellen, dass die Logdatei korrekt durch das Programm Logrotate
    aktiviert wird, sind folgende "Anderungen an der Base-Konfiguration, Men"u 'System admininstration
    -> Base configuration -> Edit base configuration', durchzuf"uhren:

    Beispiel:

\begin{verbatim}
START_SYSLOGD='yes'
SYSLOGD_DEST_N='2'
SYSLOGD_DEST_1='*.*;local7.none /var/log/messages'
SYSLOGD_DEST_1_LOGROTATE='/usr/sbin/service --quiet restart syslogd'
SYSLOGD_DEST_2='local7.* /var/log/antispam*.log'
SYSLOGD_DEST_2_LOGROTATE='/usr/sbin/service --quiet restart antispam'
\end{verbatim}

    Um die "Anderungen sofort zu aktivieren gibt man folgenden Befehl an der Konsole
    ein '/etc/init.d/syslogd restart' oder wartet einfach die n"achtliche Archivierung
    der Logdateien ab.

