%
% mail.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Mail %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Das Mail-Paket}

    Dieses Paket wurde initial von Frank Meyer
    zusammengestellt und wird von J"urgen Edner (E-MAIL \kmail{juergen@eisfair.org})
    weiterentwickelt.


\section{Die Einleitung}

    In diesem Paket wurden verschiedenste Komponenten zusammengestellt, die zusammen
    ein komplettes Mail-Paket ergeben. D.h. mittels Fetchmail k"onnen externe
    Mailkonten "uber das POP3- oder IMAP4-Protokoll abgeholt und "uber den lokalen
    SMTP-Server (Exim) weiter verteilt werden. Der SMTP-Server Exim nimmt E-Mails
    entgegen und speichert diese lokal oder sendet sie weiter an andere SMTP-Server.

    Damit die auf dem Server gespeicherten E-Mails von einem E-Mail-Klienten, wie
    z.B. Mozilla Thunderbird\textregistered , Microsoft Outlook\textregistered usw.,
    abgerufen werden k"oennen ist die separate Installation des mail-panda-
    (Panda-IMAP, Dateiformat: mbox/mbx) oder des mail-dovecot-Paketes (Dovecot-IMAP,
    Dateiformat: maildir) erforderlich. Die Konfiguration dieser Komponenten erfolgt
    dabei weiterhin "uber das mail-Paket.

    Eine einfache Art von Mailinglisten wurde ebenfalls integriert. Unter
    Zuhilfenahme von externen Zusatzkomponenten ist optional die "Uberpr"ufung der
    transferierten Nachrichten auf Viren (clamav-Paket) und/oder Spam (antispam-Paket)
    m"oglich.

\section{Die Funktionen}

    Das Mail-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
        \item Exim - wird zum Zustellen und Weiterleiten der E-Mail genutzt.\\
            (\url{http://www.exim.org/})
        \item Fetchmail - wird zum Abrufen von externen E-Mail verwendet.\\
            (\url{http://fetchmail.berlios.de/})
        \item Vacation - Ein Programm um Abwesenheitsnachrichten zu erzeugen.\\
            (\url{http://www.nongnu.org/vacation/})
    \end{itemize}

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt ein installiertes mail-panda- bzw. maildovecot-Paket
    um auf die bereitgestellten Mailboxen zuzugreifen, das perl-Paket um diverse
    Skripte bzw. die Abwesenheitsbenachrichtigung verwenden zu k"onnen. Um die
    Viren- und Spam-Funktion nutzen zu k"onnen m"ussen das clamav- bzw. antispam-Paket
    installiert werden.

\section{Die Installation}

    Das Mail-Paket wird "uber das Setup-Men"u installiert. Wird eine "altere
    Paketversion vorgefunden, so wird deren Konfiguration gesichert und das
    alte Paket deinstalliert bevor die neuen Programmdateien installiert und
    die Konfiguration "ubernommen wird. Danach wird direkt der Konfigurations-
    Editor gestartet um die Konfiguration eventuell anzupassen.\\
    Bei einer Neuinstallation wird automatisch die \textbf{basic}-
    Konfiguration, bei einem Update die \textbf{advanced}-
    Konfiguration ge"offnet. 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 ist wie folgt aufgebaut:

    \begin{itemize}
        \item Mail Service administration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration (basic): Bearbeiten der Basiskonfiguration
            \item Edit configuration (advanced): Bearbeiten der Komplettkonfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item View configuration log file: Die Konfigurations-Logmeldungen anzeigen
            \item Show Status: Status der Mail-Komponenten anzeigen
            \item Stop mail services: Alle Mail-Komponenten anhalten
            \item Start mail services: Alle Mail-Komponenten starten
            \item Toggle POP3/IMAP access: POP3/IMAP-Zugriff sperren/aktivieren
            \item Goto mail tools
            \begin{itemize}
                \item Check TLS certificates: Pr"ufen der TLS-Zertifikate
                \item Check receiver email address: Pr"ufen einer Empf"angeradresse
                \item Check sender email address: Pr"ufen einer Absenderadresse
                \item Check address rewrite rules: Pr"ufen der Adressumschreibregeln
                \item Read email: E-Mail des angemeldeten Anwenders lesen
                \item Send email: E-Mail als angemeldeter Anwender versenden
                \item Setup OAuth2 mail request: E-Mail-Abfrage mittels OAuth2\\
                    konfigurieren
                \item Force mail request: E-Mail-Abfrage manuell ansto"sen
                \item Force selective mail request: Selektive E-Mail-Abfrage\\
                    manuell ansto"sen
                \item Force queue run: E-Mail-Auslieferung manuell ansto"sen
                \item Process mail queue: Bearbeiten der Mail-Warteschlange
                \item View statistics: Allgemeine Statistiken anzeigen
                \item View fetchmail log file: Die Fetchmail-Logdatei anzeigen
                \item View main log file: Die Haupt-Logdatei anzeigen
                \item View reject log file: Die Logdatei "uber abgewiesene E-Mail anzeigen
                \item View panic log file: Die Logdatei f"ur schwere Exim-Fehler anzeigen
                \item Return: Untermen"u verlassen
            \end{itemize}
            \item Goto mail modules
            \begin{itemize}
                \item Return: Untermen"u verlassen
            \end{itemize}
            \item Return: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

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


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber die Men"upunkte `Edit configuration (basic)'
    oder `Edit configuration (advanced)' ge"andert werden. Bei Verwendung
    der basic-Konfiguration wird nur ein Teil der Konfigurationsparameter
    angezeigt, bei der advanced-Konfiguration werden alle Parameter angezeigt.
    \\
    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. Es ist zu beachten, dass einige Programme
    eigenst"andig bei erneuter Aktivierung die Konfigurationsdatei neu einlesen,
    somit f"uhrt ein Beantwortung dieser Abfrage mit `Nein' nur zu einem kurzen
    Aufschub der Aktivierung.


\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
    \texttt{/etc/config.d/mail}.

\section{Die Parameter}

\subsection{Die POP3-/IMAP-Server}
%---------------------------------

    POP3 und IMAP-Server dienen als Schnittstelle zum lokalen Postfach auf dem
    \eisfair-Server und erm"oglichen den Zugriff auf die eingegangenen Nachrichten.

\begin{description}
    \config{START\_MAIL}{START\_MAIL}{STARTMAIL}
        F"ur die Aktivierung des Mail-Paketes muss dieser Parameter auf
        den Wert `yes' gestellt werden. Die Einstellung `no' schaltet
        das Mail-Paket ab.

        G"ultige Werte: yes, no

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

    \config{START\_POP3}{START\_POP3}{STARTPOP3}
        F"ur die Aktivierung des POP3-Servers muss dieser Parameter lediglich auf
        den Wert `yes' gestellt werden. Die Einstellung `no' schaltet den POP3-
        Server ab.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_POP3='yes'}

    \config{START\_IMAP}{START\_IMAP}{STARTIMAP}
        F"ur die Aktivierung des IMAP4-Servers muss dieser Parameter lediglich
        auf den Wert `yes' gestellt werden. Die Einstellung `no' schaltet den
        IMAP4-Server ab.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_IMAP='yes'}
\end{description}


    Die folgenden Parameter sind nur relevant, wenn entweder START\_POP3='yes'
    oder START\_IMAP='yes' gesetzt wurden.


\begin{description}
    \config{POP3IMAP\_MAILBOX\_FORMAT (ADVANCED-Modus)}{POP3IMAP\_MAILBOX\_FORMAT}{POP3IMAPMAILBOXFORMAT}
        "Uber diesen Parameter wird gesteuert, welches Dateiformat zum Speichern
        von Nachrichten verwendet werden soll. Folgende Formate werden derzeit
        durch die Installation des mail-panda- (mbox/mbx) bzw. mail-dovecot-Paketes
        (maildir) unterst"utzt:

        \begin{description}
            \item[mbox]    - Bei dem mbox-Format handelt es sich um das "alteste,
                             verf"ugbare Format, welches jedoch keine gleichzeitigen
                             Mehrfachzugriffe und nur relativ langsame Dateizugriffe
                             erlaubt.
            \item[mbx]     - Das mbx-Format erm"oglicht zwar gleichzeitige
                             Mehrfachzugriffe auf eine Mailbox, erlaubt jedoch kein
                             Datei-Locking auf NFS-Mounts.
            \item[maildir] - Das maildir-Format speichert jede Nachricht in einer
                             separaten Datei und erm"oglicht so gleichzeitige
                             Mehrfachzugriffe, wodurch ein Dateizugriff allgemein
                             sehr schnell erfolgen kann.
        \end{description}

        G"ultige Werte: maildir, mbx, mbox

        Standardeinstellung: \texttt{POP3IMAP\_MAILBOX\_FORMAT='maildir'}

    \config{POP3IMAP\_TRANSPORT (ADVANCED-Modus)}{POP3IMAP\_TRANSPORT}{POP3IMAPTRANSPORT}
        "Uber diesen Parameter wird festgelegt, ob als Transport-Protokolle
        POP3/IMAP (default - unverschl"usselt), POP3/IMAP "uber TLS (tls -
        verschl"usselt) oder beides (both) verwendet werden soll. Bei
        Verwendung von TLS ist sicherzustellen, dass zuvor entsprechende
        Server-Zertifikate installiert werden. Siehe auch den Parameter
        \jump{SMTPSERVERTLSADVERTISEHOSTS}{SMTP\_SERVER\_TLS\_ADVERTISE\_HOSTS}.

        \hinweis{Standardm"a"sig erfolgte die Kommunikation mit dem POP3- bzw.
            IMAP-Dienst "uber eine unverschl"usselte Verbindung, welche sp"ater,
            durch die Einf"uhrung des STARTTLS-Befehls, um die M"oglichkeit
            einer Verbindungsverschl"usselung erweitert wurde. Um "uber diese
            TCP-Ports bzw. Protokolle kommunizieren zu k"onnen ist der Wert
            dieses Parameters auf `both' zu setzen.}

        G"ultige Werte: default, tls, both

        Standardeinstellung: \texttt{POP3IMAP\_TRANSPORT='default'}

    \config{POP3IMAP\_TLS\_CERT\_NAME (optionaler Parameter)(ADVANCED-Modus)}{POP3IMAP\_TLS\_CERT\_NAME}{POP3IMAPTLSCERTNAME}
        "Uber diesen Parameter legt man den bzw. die Namen der TLS-Zertifikate
        der POP3-/IMAP-Dienste fest, welche zum Aufbau einer gesicherten
        Verbindung verwendet werden sollen. Es wird empfohlen f"ur die
        Benennung der Dateien immer den vollst"andigen Domainnamen zu
        verwenden, da dies die Dateizuordnung erleichtert.

        \hinweis{Bei Verwendung zusammen mit dem mail-dovecot-Paket wird
            hierdurch sogar die Verwendung unterschiedlicher Zertifikate
            je nach Domainnamen m"oglich. Mehrere Namen m"ussen dabei
            jeweils durch einen Doppelpunkt voneinander getrennt werden.
            Der erste angegebene Domainname muss immer der Standardname
            sein, der verwendet wird falls ein E-Mail-Klient kein SNI
            unterst"utzt. Dass die angegebenen Dateien auch physikalisch
            im Zertifikatsverzeichnis des Servers existieren bzw.
            entsprechende symbolische Links auf ein Multi-Domain-Zertifikat
            gesetzt werden m"ussen, ist selbsredend.}

        Wird dieser Parameter nicht gesetzt, so werden standardm"a"sig
        Zertifikate mit den Namen `ipop3d.pem' bzw. `imapd.pem' verwendet.

        G"ultige Werte: Ein- oder mehrere Zertifikatsnamen

        Beispiel: \texttt{POP3IMAP\_TLS\_CERT\_NAME='mail-server.local.lan'}

    \config{POP3IMAP\_IDENT\_CALLBACKS (ADVANCED-Modus)}{POP3IMAP\_IDENT\_CALLBACKS}{POP3IMAPIDENTCALLBACKS}
        "Uber diesen Parameter wird festgelegt ob der POP3 und IMAP-Deamon einen
        Ident-Callback durchf"uhren soll. Falls der initiale Verbindungsaufbau
        beim Abruf von Nachrichten relativ lange dauern sollte, kann man diesen
        Parameter auf 'no' setzen. In diesem Fall werden jedoch keine Meldungen
        "uber einen erfolgreichen bzw. gescheiterten Verbindungsaufbau mehr in
        der Systemlogdatei gespeichert.

        G"ultige Werte: yes oder no

        Standardeinstellung: \texttt{POP3IMAP\_IDENT\_CALLBACKS='yes'}

    \config{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS (ADVANCED-Modus)}{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS}{MAILUSERUSEMAILONLYPASSWORDS}
        "Uber diesen Parameter wird gesteuert, ob eine separate Kennwortdatei f"ur
        POP3/IMAP verwendet werden soll. Die Verwendung separater Mail-Kennw"orter
        verhindert, dass die sonst verwendeten System-Kennw"orter bei Abfrage des
        lokalen POP3/IMAP-Postfaches unverschl"usselt "uber das Netzwerk geschickt
        werden, was die allgemeine Sicherheit des Servers erh"oht.

        G"ultige Werte: yes oder no

        Standardeinstellung: \texttt{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS='no'}

    \config{MAIL\_USER\_N (ADVANCED-Modus)}{MAIL\_USER\_N}{MAILUSERN}
        "Uber diesen Parameter wird die Anzahl der POP3/IMAP-Accounts angegeben,
        die auf diesem Rechner f"ur den E-Mail-Abruf eingerichtet werden sollen.
        Optional kann hier auch ein separates Mail-Kennwort eingerichtet werden.
        (siehe hierzu auch Parameter \jump{MAILUSERUSEMAILONLYPASSWORDS}{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS})

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{MAIL\_USER\_N='0'}

    \config{MAIL\_USER\_x\_ACTIVE (ADVANCED-Modus)}{MAIL\_USER\_x\_ACTIVE}{MAILUSERxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der zugeh"orige
        Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{MAIL\_USER\_1\_ACTIVE='no'}

    \config{MAIL\_USER\_x\_COMMENT (ADVANCED-Modus)}{MAIL\_USER\_x\_COMMENT}{MAILUSERxCOMMENT}
        Dies ist ein Kommentarfeld, welches die Identifizierung des Anwenders
        erleichtern soll.

        G"ultige Werte: beliebiger Text

        Beispiel: \texttt{MAIL\_USER\_1\_COMMENT='Dies ist ein E-Mail-Nutzer'}

%%  JED - show this description only in the help file
 %  \config{MAIL\_USER\_x\_USER}{MAIL\_USER\_x\_USER}{MAILUSERxUSER}
 %      Hier muss das auf diesem Rechner eingerichtete Mail-Benutzerkonto und
 %      das `optionale' Mail-Kennwort eingegeben werden. (siehe hierzu auch Parameter
 %      \jump{MAILUSERUSEMAILONLYPASSWORDS}{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS})
 %      Es ist unbedingt sicherzustellen, dass ein gleichlautendes System-Benutzerkonto
 %      existiert. Bei Verwendung eines optionalen Mail-Kennwort sollte sich dieses
 %      unbedingt von dem Systemkennwort UNTERSCHEIDEN um ein h"ochstes Ma"s an Sicherheit
 %      zu gew"ahrleisten!\\\\
 %      \achtung{Unbedingt Klein- / Gro"sschreibung beachten!\\
 %               Lokale Benutzer "uber das \eisfair-Setup-Men"u einrichten!}
 %
 %      G"ultige Werte: Benutzername bzw. Kennwort
 %
 %      Beispiel:
 %
 %      \texttt{MAIL\_USER\_1\_USER='username'\\
 %              MAIL\_USER\_1\_PASS='secret'}
 %
 %      {\textbf{Hinweis:}} Will man eine gro"se Anzahl von Benutzern anlegen,
 %      so ist es m"oglich diese "uber eine csv-Datei der aktuellen Konfigurationsdatei
 %      hinzuzuf"ugen. Hierzu kopiert man eine Datei `pop3imap.csv' in das Verzeichnis
 %      /var/spool/exim und ruft das Programm `/var/install/config.d/mail-update.sh import'
 %      auf.
 %
 %      Eine vorhandene Benutzerliste kann in eine Datei `pop3imap.csv', im Verzeichnis\\
 %      /var/spool/exim exportiert werden, indem man das Programm
 %      `/var/install/config.d/mail-update.sh export' aufruft.
 %
 %      Die csv-Datei muss wie folgt aufgebaut sein:\\\\
 %      \texttt{\#username,password,active\\
 %              user1,password1,yes\\
 %              user2,password2,no}

    \index{MAIL\_USER\_x\_USER}
    \config{MAIL\_USER\_x\_USER / MAIL\_USER\_x\_PASS (ADVANCED-Modus)}{MAIL\_USER\_x\_PASS}{MAILUSERxPASS}
        Hier muss das auf diesem Rechner eingerichtete Mail-Benutzerkonto und
        das `optionale' Mail-Kennwort eingegeben werden. (siehe hierzu auch Parameter
        \jump{MAILUSERUSEMAILONLYPASSWORDS}{MAIL\_USER\_USE\_MAILONLY\_PASSWORDS})
        Es ist unbedingt sicherzustellen, dass ein gleichlautendes System-Benutzerkonto
        existiert. Bei Verwendung eines optionalen Mail-Kennwort sollte sich dieses
        unbedingt von dem Systemkennwort UNTERSCHEIDEN um ein h"ochstes Ma"s an Sicherheit
        zu gew"ahrleisten!\\\\
        \achtung{Unbedingt Klein- / Gro"sschreibung beachten!\\
                 Lokale Benutzer "uber das \eisfair-Setup-Men"u einrichten!}

        G"ultige Werte: Benutzername bzw. Kennwort

        Beispiel:

        \texttt{MAIL\_USER\_1\_USER='username'\\
                MAIL\_USER\_1\_PASS='secret'}

    \config{MAIL\_USER\_x\_EMAIL\_N (ADVANCED-Modus)}{MAIL\_USER\_x\_EMAIL\_N}{MAILUSERxEMAILN}
        Optionaler Parameter: "Uber diesen Parameter wird auf Wunsch die Anzahl
        der E-Mail-Adressen festgelegt, die alternativ zum Mail-Benutzerkonto
        (\jump{MAILUSERxUSER}{MAIL\_USER\_x\_USER}) zur Anmeldung am Server
        genutzt werden sollen.\\\\
        \achtung{Diese Parameter kann nur zusammen mit dem mail-dovecot-Paket
                 genutzt werden!}

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{MAIL\_USER\_1\_EMAIL\_N='0'}

    \config{MAIL\_USER\_x\_EMAIL\_y (ADVANCED-Modus)}{MAIL\_USER\_x\_EMAIL\_y}{MAILUSERxEMAILy}
        Optionaler Parameter: "Uber diesen Parameter wird eine E-Mail-Adresse
        festgelegt, die alternativ zum Mail-Benutzerkonto (\jump{MAILUSERxUSER}
        {MAIL\_USER\_x\_USER}) zur Anmeldung am Server genutzt werden sollen.\\\\
        \achtung{Diese Parameter kann nur zusammen mit dem mail-dovecot-Paket
                 genutzt werden!}

        G"ultige Werte: vollst"andige E-Mail-Adresse

        Beispiel: \texttt{MAIL\_USER\_1\_EMAIL\_1='user@local.lan'}

        {\textbf{Hinweis:}} Will man eine gro"se Anzahl von Benutzern anlegen,
        so ist es m"oglich diese "uber eine csv-Datei der aktuellen Konfigurationsdatei
        hinzuzuf"ugen. Hierzu kopiert man eine Datei `pop3imap.csv' in das Verzeichnis
        /var/spool/exim und ruft das Programm `/var/install/config.d/mail-update.sh import'
        auf.

        Eine vorhandene Benutzerliste kann in eine Datei `pop3imap.csv', im Verzeichnis\\
        /var/spool/exim exportiert werden, indem man das Programm
        `/var/install/config.d/mail-update.sh export' aufruft.

        Die csv-Datei muss wie folgt aufgebaut sein:\\\\
        \texttt{\#username,password,active\\
                user1,password1,yes\\
                user2,password2,no}

\end{description}

\subsection{Die IMAP-Shared-/Public-Ordner}
%------------------------------------------

        "Uber die folgenden Parameter lassen sich IMAP-Ordner definieren, die
        von allen Anwendern gleichzeitig genutzt werden k"onnen. Dies ist z.B.
        sinnvoll um allgemeine Nachrichten an zentraler Stelle abzulegen.
        Shared-Ordner unterscheiden sich von Public-Ordnern nur die die
        Zugriffsberechtigungen, d.h. auf Public-Ordner k"onnen auch Anwender
        zugreifen, die nicht der "uber den Parameter IMAP\_SHARED\_PUBLIC\_USERGROUP
        festgelegten Benutzergruppe (Standardgruppe: 'users'), angeh"oren.\\
        Um eine Nachricht in einem solchen Ordner abzulegen, schickt man einfach
        eine Nachricht an den Ordner und verwendet als Adresse den Namen des
        Shared- bzw. Public-Ordners.\\
        Will man z.B. eine Nachricht im Ordner `Family-News' ablegen, so lautet
        dessen E-Mail-Adresse `family-news@lokal.lan'. Will man z.B. eine Nachricht
        im Ordner `Familie/Rechnungen' ablegen, so lautet dessen E-Mail-Adresse
        `familie/rechnungen@local.lan'.\\
        \\
        Anwender die den lokalen Domains angeh"oren k"onnen Nachrichten sowohl
        an Shared- als auch Public-Ordner schicken, externe Anwender sind nur
        berechtigt Nachrichten an Public-Ordner zu schicken. \\

        \hinweis{Es gilt zu beachten, dass alle Ordnernamen eindeutig sein
            m"ussen, d.h. es ist nicht zul"assig den gleichen Ordnernamen
            sowohl f"ur einen Shared- als auch einen Public-Ordner zu vergeben.}

\begin{description}
    \config{IMAP\_SHARED\_PUBLIC\_USERGROUP (ADVANCED-Modus)}{IMAP\_SHARED\_PUBLIC\_USERGROUP}{IMAPSHAREDPUBLICUSERGROUP}
        "Uber diesen Parameter kann die System- Benutzergruppe eingestellt werden,
        in die die `internen', vom IMAP-Daemon benutzten, Benutzerkonten
        \texttt{`imapshared'} und \texttt{`imappublic'} aufgenommen werden sollen.
        Wird dieser Parameter leer gelassen, so wird die Standardgruppe 'users'
        verwendet.

        G"ultige Werte: System-Benutzergruppe

        Standardeinstellung: \texttt{IMAP\_SHARED\_PUBLIC\_USERGROUP=$''$}

    \config{IMAP\_SHARED\_FOLDER\_N (ADVANCED-Modus)}{IMAP\_SHARED\_FOLDER\_N}{IMAPSHAREDFOLDERN}
        "Uber diesen Parameter wird die Anzahl der IMAP-Shared-Ordner angegeben,
        die auf diesem Rechner eingerichtet werden sollen. Diese sind "uber den
        virtuellen Ordner \texttt{`\#shared'} aus der IMAP-Anwendung abonnierbar.
        Standardm"a"sig haben alle Mitglieder der "uber \jump{IMAPSHAREDPUBLICUSERGROUP}{IMAP\_SHARED\_PUBLIC\_USERGROUP}
        eingestellten System-Benutzergruppe die Berechtigung in diesem
        Verzeichnis Ordner anzulegen und schreibend bzw. lesend auf diese zuzugreifen.
        (Berechtigungsmaske: Verzeichnis 0770, Ordner 0660)

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{IMAP\_SHARED\_FOLDER\_N='0'}

     \config{IMAP\_SHARED\_FOLDER\_x\_ACTIVE (ADVANCED-Modus)}{IMAP\_SHARED\_FOLDER\_x\_ACTIVE}{IMAPSHAREDFOLDERxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der zugeh"orige
        Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{IMAP\_SHARED\_FOLDER\_1\_ACTIVE='no'}

    \config{IMAP\_SHARED\_FOLDER\_x\_NAME (ADVANCED-Modus)}{IMAP\_SHARED\_FOLDER\_x\_NAME}{IMAPSHAREDFOLDERxNAME}
        "Uber diesen Parameter wird der Name eines IMAP-Shared-Ordner angegeben,
        der auf diesem Rechner eingerichtet werden soll. Wird vor dem Ordnernamen
        ein Unterverzeichnis angegeben, so wird dieses gegebenenfalls angelegt.
        Es ist darauf zu achten, dass der Name des IMAP-Shared-Ordner einmalig ist.
        Es ist nicht m"oglich den gleichen Namen f"ur IMAP-Shared-Ordner zu verwenden
        auch wenn diese in anderen Verzeichnissen liegen.

        G"ultige Werte: Ordnername

        Beispiel: \texttt{IMAP\_SHARED\_FOLDER\_1\_NAME='Family-News'}

    \config{IMAP\_SHARED\_FOLDER\_x\_USERGROUP (ADVANCED-Modus)}{IMAP\_SHARED\_FOLDER\_x\_USERGROUP}{IMAPSHAREDFOLDERxUSERGROUP}
        "Uber diesen Parameter kann eine individuelle Benutzergruppe eingestellt werden
        um den Zugriff auf den Ordner weiter einzuschr"anken. Wurde "uber den Parameter
        \jump{IMAPSHAREDPUBLICUSERGROUP}{IMAP\_SHARED\_PUBLIC\_USERGROUP} eine Gruppe
        festgelegt, so fungiert diese als Standardgruppe wenn "uber diesen Parameter
        keine festgelegt wurde.

        G"ultige Werte: System-Benutzergruppe

        Standardeinstellung: \texttt{IMAP\_SHARED\_FOLDER\_1\_USERGROUP=$''$}

    \config{IMAP\_PUBLIC\_FOLDER\_N (ADVANCED-Modus)}{IMAP\_PUBLIC\_FOLDER\_N}{IMAPPUBLICFOLDERN}
        "Uber diesen Parameter wird die Anzahl der IMAP-Public-Ordner angegeben,
        die auf diesem Rechner eingerichtet werden sollen. Diese sind "uber den
        virtuellen Ordner \texttt{`\#public'} aus der IMAP-Anwendung abonnierbar.
        Standardm"a"sig haben alle Mitglieder der "uber \jump{IMAPSHAREDPUBLICUSERGROUP}{IMAP\_SHARED\_PUBLIC\_USERGROUP}
        eingestellten System-Benutzergruppe und alle anderen Anwender die Berechtigung
        in diesem Verzeichnis Ordner anzulegen und schreibend bzw. lesend auf diese
        zuzugreifen. (Berechtigungsmaske: Verzeichnis 0777, Ordner 0666)

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{IMAP\_PUBLIC\_FOLDER\_N='0'}

     \config{IMAP\_PUBLIC\_FOLDER\_x\_ACTIVE (ADVANCED-Modus)}{IMAP\_PUBLIC\_FOLDER\_x\_ACTIVE}{IMAPPUBLICFOLDERxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der zugeh"orige
        Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{IMAP\_PUBLIC\_FOLDER\_1\_ACTIVE='no'}

    \config{IMAP\_PUBLIC\_FOLDER\_x\_NAME (ADVANCED-Modus)}{IMAP\_PUBLIC\_FOLDER\_x\_NAME}{IMAPPUBLICFOLDERxNAME}
        "Uber diesen Parameter wird der Name eines IMAP-Public-Ordner angegeben,
        der auf diesem Rechner eingerichtet werden soll. Wird vor dem Ordnernamen
        ein Unterverzeichnis angegeben, so wird dieses gegebenenfalls angelegt.
        Es ist darauf zu achten, dass der Name des IMAP-Public-Ordner einmalig ist.
        Es ist nicht m"oglich den gleichen Namen f"ur IMAP-Public-Ordner zu verwenden
        auch wenn diese in anderen Verzeichnissen liegen.

        G"ultige Werte: Ordnername

        Beispiel: \texttt{IMAP\_PUBLIC\_FOLDER\_1\_NAME='Announcments'}

    \config{IMAP\_PUBLIC\_FOLDER\_x\_USERGROUP (ADVANCED-Modus)}{IMAP\_PUBLIC\_FOLDER\_x\_USERGROUP}{IMAPPUBLICFOLDERxUSERGROUP}
        "Uber diesen Parameter kann eine individuelle Benutzergruppe eingestellt werden
        um den Zugriff auf den Ordner weiter einzuschr"anken. Wurde "uber den Parameter
        \jump{IMAPSHAREDPUBLICUSERGROUP}{IMAP\_SHARED\_PUBLIC\_USERGROUP} eine Gruppe
        festgelegt, so fungiert diese als Standardgruppe wenn "uber diesen Parameter
        keine festgelegt wurde.

        G"ultige Werte: System-Benutzergruppe

        Standardeinstellung: \texttt{IMAP\_PUBLIC\_FOLDER\_1\_USERGROUP=$''$}
\end{description}


\subsection{Postf"acher abrufen (Fetchmail)}
%-------------------------------------------

    "Uber die Fetchmail-Konfiguration wird eingestellt, ob und welche externe
    E-Mail-Konten ausgelesen werden sollen. Die E-Mails werden dann auf ein
    lokales Mail-Konto "ubertragen.

\begin{description}
    \config{START\_FETCHMAIL}{START\_FETCHMAIL}{STARTFETCHMAIL}
        Dieser Parameter bestimmt, ob Fetchmail gestartet werden soll oder
        nicht. Mit `yes' wird Fetchmail aktiviert, mit dem Wert `no' wird
        dieser Dienst abgeschaltet. In diesem Fall sind die folgenden
        Konfigurationsparameter irrelevant.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_FETCHMAIL='yes'}

    \config{FETCHMAIL\_PROTOCOL}{FETCHMAIL\_PROTOCOL}{FETCHMAILPROTOCOL}
        Verwendetes Protokoll zur "Ubertragung der E-Mails, normalerweise
        `pop3' oder `imap'.

        G"ultige Werte: imap, pop3, auto

        Standardeinstellung: \texttt{FETCHMAIL\_PROTOCOL='pop3'}

    \config{FETCHMAIL\_LIMIT}{FETCHMAIL\_LIMIT}{FETCHMAILLIMIT}
        Maximale Gr"o"se f"ur eine E-Mail in Bytes. "Uberschreitet eine E-Mail
        die angegebene Gr"o"se, so wird diese E-Mail nicht abgeholt. Wird dieser
        Parameter auf `0' gesetzt, so wird die Limit"uberpr"ufung deaktiviert
        (wird nicht empfohlen).  Der vorgegebene Wert entspricht einer Gr"o"se
        von 4MB. Wird kein Wert angegeben, so werden E-Mails bis zu einer
        Gr"o"se von 4MB akzeptiert.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_LIMIT='4M'}

    \config{FETCHMAIL\_WARNINGS}{FETCHMAIL\_WARNINGS}{FETCHMAILWARNINGS}
        "Uber diesen Parameter legt man fest, in welchem Intervall Warnmeldungen
        "uber `"ubergro"se' E-Mails, deren maximale Gr"o"se "uber den Parameter
        \jump{FETCHMAILLIMIT}{FETCHMAIL\_LIMIT} eingestellt wird, an den Postmaster
        geschickt werden sollen.
        Eine erste Benachrichtigung wird immer am Ende der Postfachabfrage, in
        deren Verlauf die "ubergro"se Nachricht erkannt wurde, verschickt. Danach
        werden diese Benachrichtigungen solange unterdr"uckt, bis die "uber diesen
        Parameter eingestellte Zeitspanne verstrichen ist. Um also nach 24 Stunden
        erneut informiert zu werden setzt man diesen Wert auf 86400 (Sekunden).

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_WARNINGS='86400'}

    \config{FETCHMAIL\_DAEMON}{FETCHMAIL\_DAEMON}{FETCHMAILDAEMON}
        Dieser Parameter gibt an, wie oft Fetchmail die konfigurierten
        Mail-Konten abfragen soll. Auch dieses Intervall wird in Sekunden
        angegeben. Der Wert `1800' bedeutet also ein Intervall von 30
        Minuten.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_DAEMON='1800'}

    \config{FETCHMAIL\_TIMEOUT}{FETCHMAIL\_TIMEOUT}{FETCHMAILTIMEOUT}
        Dieser Parameter legt fest wie lange auf eine Antwort vom abzurufenden
        Server gewartet werden soll, bevor ein Abbruch erfolgt. Die Angabe
        erfolgt in Sekunden.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_TIMEOUT='90'}

    \config{FETCHMAIL\_BOUNCE\_MAIL (optionaler Parameter)}{FETCHMAIL\_BOUNCE\_MAIL}{FETCHMAILBOUNCEMAIL}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so werden
        Fehlermeldungen welche beim Abruf oder der Zustellung einer
        Nachricht aufgetreten sind an den Absender einer Nachricht
        geschickt. Wird der Wert dieses Parameters auf `no' gesetzt,
        so wird statt dessen der Postmaster "uber eventuelle Probleme
        informiert.

        G"ultige Werte: yes oder no

        Standardeinstellung: FETCHMAIL\_BOUNCE\_MAIL='no'

    \config{FETCHMAIL\_BOUNCE\_SPAM (optionaler Parameter)}{FETCHMAIL\_BOUNCE\_SPAM}{FETCHMAILBOUNCESPAM}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird
        eine als Spam klassifizierte Nachricht an den Absender
        zur"uck geschickt. Da es beim Versand von Spamnachrichten
        jedoch "ublich ist die Absenderadresse zu f"alschen, ist
        der Wert des Parameters standardm"a"sig auf `no' gesetzt,
        wodurch eine Nachricht unwiderruflich vom Server gel"oscht
        wird.

        G"ultige Werte: yes oder no

        Standardeinstellung: FETCHMAIL\_BOUNCE\_SPAM='no'

    \config{FETCHMAIL\_BOUNCE\_SOFT (optionaler Parameter)}{FETCHMAIL\_BOUNCE\_SOFT}{FETCHMAILBOUNCESOFT}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird
        bei einem permanenten Zustellfehler eine Nachricht auf dem
        abgerufenen Server belassen als wenn nur ein tempor"arer
        Fehler aufgetreten w"are. Wird der Wert dieses Parameters auf
        `no' gesetzt, so wird eine Nachricht unwiderruflich vom Server
        gel"oscht. Dieser Parameter sollte deshalb nur nach reichlicher
        "Uberlegung und ausf"uhrlichen Tests der Abrufparameter umgestellt
        werden.

        G"ultige Werte: yes oder no

        Standardeinstellung: FETCHMAIL\_BOUNCE\_SOFT='yes'

    \config{FETCHMAIL\_N}{FETCHMAIL\_N}{FETCHMAILN}
        Anzahl der abzufragenden Mailkonten. Diese werden nun im folgenden
        konfiguriert. Die folgenden Variablen m"ussen dann jeweils f"ur jedes
        Mailkonto angegeben werden, also z.B. FETCHMAIL\_SERVER\_1,
        FETCHMAIL\_SERVER\_2 usw.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_N='1'}

     \config{FETCHMAIL\_x\_ACTIVE}{FETCHMAIL\_x\_ACTIVE}{FETCHMAILxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der zugeh"orige
        Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{FETCHMAIL\_1\_ACTIVE='no'}

    \config{FETCHMAIL\_x\_COMMENT}{FETCHMAIL\_x\_COMMENT}{FETCHMAILxCOMMENT}
        Dies ist ein Kommentarfeld, welches die Identifizierung des
        abzurufenden Servers erleichtern soll.

        G"ultige Werte: beliebiger Text

        Beispiel: \texttt{FETCHMAIL\_1\_COMMENT='Dies ist mein Server'}

    \config{FETCHMAIL\_x\_SERVER}{FETCHMAIL\_x\_SERVER}{FETCHMAILxSERVER}
        Hier wird der Domainname des abzurufenden POP3-/IMAP-Servers angegeben.
        Bei web.de w"are das zum Beispiel `mail.web.de'.

        G"ultige Werte: Servername

        Beispiel: \texttt{FETCHMAIL\_1\_SERVER='mail.domain.com'}

        {\textbf{Hinweis:}} Will man eine gro"se Anzahl von Accounts anlegen,
        so ist es m"oglich diese "uber eine csv-Datei der aktuellen
        Konfigurationsdatei hinzuzuf"ugen. Hierzu kopiert man eine Datei
        `fetchmail.csv' in das Verzeichnis /var/spool/exim und ruft das
        Programm `/var/install/config.d/mail-update.sh import' auf.

        Eine vorhandene Benutzerliste kann in eine Datei `fetchmail.csv',
        im Verzeichnis\\/var/spool/exim exportiert werden, indem man das
        Programm `/var/install/config.d/mail-update.sh export' aufruft.

        Die csv-Datei muss wie folgt aufgebaut sein:\\\\
        \texttt{\#server,active,username,password,forward,smtphost,imap\_folder,domain,envelope,server\_aka(s),local\_domain(s),protocol,port,auth,keep,fetchall,msg\_limit,ssl\_protocol,ssl\_transport,ssl\_fingerprint\\
                server1,no,username1,password1,forward-addr1,,,no,no,2:svr-aka1:svr-aka2,0,,port1,,no,yes,10,none,no,\\
                server2,no,username2,password2,forward-addr2,,,no,no,0,2:ldom1:ldom2,,port2,,no,yes,10,none,no,}

%%  JED - show this description only in the help file
 %  \config{FETCHMAIL\_x\_USER}{FETCHMAIL\_x\_USER}{FETCHMAILxUSER}
 %      Hier muss das Benutzerkonto zusammen mit dem zugeh"origen Kennwort auf
 %      dem entfernten POP3-/IMAP-Server eingetragen werden.
 %
 %      G"ultige Werte: Benutzername bzw. Kennwort
 %
 %      Beispiel:
 %
 %      \texttt{FETCHMAIL\_1\_USER='username'\\
 %              FETCHMAIL\_1\_PASS='secret'}

    \index{FETCHMAIL\_x\_USER}
    \config{FETCHMAIL\_x\_USER / FETCHMAIL\_x\_PASS}{FETCHMAIL\_x\_PASS}{FETCHMAILxPASS}
        Hier muss das Benutzerkonto zusammen mit dem zugeh"origen Kennwort auf
        dem entfernten POP3-/IMAP-Server eingetragen werden.

        G"ultige Werte: Benutzername bzw. Kennwort

        Beispiel:

        \texttt{FETCHMAIL\_1\_USER='username'\\
                FETCHMAIL\_1\_PASS='secret'}

    \config{FETCHMAIL\_x\_OAUTH2\_ID (optionaler Parameter)(ADVANCED-Modus)}{FETCHMAIL\_x\_OAUTH2\_ID}{FETCHMAILxOAUTH2ID}
        Wurde der Parameter \jump{FETCHMAILxAUTHTYPE}{FETCHMAIL\_x\_AUTH\_TYPE='oauth2'}
        gesetzt, so wird "uber diesen Parameter die OAuth2-Identifikation
        f"ur die Authentifizierung am entfernten POP3-/IMAP-Server gesetzt.

        G"ultige Werte: OAuth2-Identifikation

        Standardeinstellung: \texttt{FETCHMAIL\_x\_OAUTH2\_ID=$''$}

    \config{FETCHMAIL\_x\_OAUTH2\_SECRET (optionaler Parameter)(ADVANCED-Modus)}{FETCHMAIL\_x\_OAUTH2\_SECRET}{FETCHMAILxOAUTH2SECRET}
        Wurde der Parameter \jump{FETCHMAILxAUTHTYPE}{FETCHMAIL\_x\_AUTH\_TYPE='oauth2'}
        gesetzt, so wird "uber diesen Parameter das OAuth2-Geheimnis
        f"ur die Authentifizierung am entfernten POP3-/IMAP-Server gesetzt.

        G"ultige Werte: OAuth2-Geheimnis

        Standardeinstellung: \texttt{FETCHMAIL\_x\_OAUTH2\_SECRET=$''$}

    \config{FETCHMAIL\_x\_AUTH\_TYPE (ADVANCED-Modus)}{FETCHMAIL\_x\_AUTH\_TYPE}{FETCHMAILxAUTHTYPE}
        "Uber diesen Parameter wird die zu verwendende Authentifizierung
        eingestellt. Standardm"a"sig wird `any' verwendet. Dabei wird in
        folgender Reihenfolge versucht die E-Mails abzurufen: ohne Kennwort -
        maskiertes Kennwort - Klartextkennwort. Wird beim Aufbau der
        Verbindung zum Beispiel eine Fehlermeldung `SSL connection failed'
        angezeigt, so sollte man diesen Parameter auf `password' setzen
        um die Verwendung von SSL/STLS beim Verbindungsaufbau zu unterbinden.

        G"ultige Werte: leer bzw. any, password, cram-md5, oauth2

        Standardeinstellung: \texttt{FETCHMAIL\_x\_AUTH\_TYPE=$''$}

    \config{FETCHMAIL\_x\_FORWARD}{FETCHMAIL\_x\_FORWARD}{FETCHMAILxFORWARD}
        Diese Konfigurationsvariable gibt die E-Mail-Adresse an, wohin
        die E-Mails f"ur dieses Konto weitergeleitet werden sollen. Im
        allgemeinen ist dieses eine lokale E-Mail-Adresse, sodass der
        SMTP-Server Exim die E-Mails entgegenimmt. In diesem Fall ist
        dann nat"urlich auch START\_SMTP='yes' einzustellen, siehe unten.

        G"ultige Werte: vollst"andige E-Mail-Adresse

        Beispiel: \texttt{FETCHMAIL\_1\_FORWARD='user@local.lan'}

    \config{FETCHMAIL\_x\_SMTPHOST (ADVANCED-Modus)}{FETCHMAIL\_x\_SMTPHOST}{FETCHMAILxSMTPHOST}
        Hier kann man den SMTP-Host angeben, an welchen die E-Mails
        weitergeleitet werden sollen. Soll der lokale SMTP-Server
        verwendet werden, bleibt diese Variable leer.

        G"ultige Werte: leer bzw. SMTP-Hostname

        Beispiel: \texttt{FETCHMAIL\_1\_SMTPHOST=$''$}

    \config{FETCHMAIL\_x\_IMAP\_FOLDER (ADVANCED-Modus)}{FETCHMAIL\_x\_IMAP\_FOLDER}{FETCHMAILxIMAPFOLDER}
        Wurde der Parameter \jump{FETCHMAILxPROTOCOL}{FETCHMAIL\_x\_PROTOCOL='imap'}
        gesetzt, so k"onnen "uber diesen Parameter individuelle IMAP-Ordner
        angegeben werden die "uber Fetchmail abgerufen werden sollen. Wird
        der Parameter leer gelassen, so wird nur die Standard-Mailbox 'INBOX'
        abgerufen. Mehrere Ordnernamen m"ussen durch ein Komma voneinander
        getrennt eingegeben werden.

        G"ultige Werte: leer bzw. IMAP-Ordnernamen

        Beispiel: \texttt{FETCHMAIL\_1\_IMAP\_FOLDER=$''$}

    \config{FETCHMAIL\_x\_DOMAIN (ADVANCED-Modus)}{FETCHMAIL\_x\_DOMAIN}{FETCHMAILxDOMAIN}
        FETCHMAIL\_x\_DOMAIN bestimmt, ob die E-Mails vom Mailkonto
        des entfernten POP3-/IMAP-Servers f"ur eine komplette Domain
        verteilt werden sollen. Man spricht hier auch von einem
        Multi-Drop- oder Catchall-Postfach.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_DOMAIN='no'}

    \config{FETCHMAIL\_x\_ENVELOPE (ADVANCED-Modus)}{FETCHMAIL\_x\_ENVELOPE}{FETCHMAILxENVELOPE}
        Dieser Parameter legt fest, ob bei Verwendung eines Multi-Drop-Postfachs
        auch die Adressen im Nachrichtenumschlag "uberpr"uft werden sollen. In
        Ausnahmef"allen, wenn z.B. der urspr"ungliche Empf"anger einer Nachricht
        aus dem eigentlichen Nachrichtenkopf nicht mehr ersichtlich ist, kann es
        sinnvoll sein diesen Parameter auf den Wert 'yes' zu setzen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_ENVELOPE='no'}

    \config{FETCHMAIL\_x\_ENVELOPE\_HEADER (ADVANCED-Modus)}{FETCHMAIL\_x\_ENVELOPE\_HEADER}{FETCHMAILxENVELOPEHEADER}
        Beim Abruf eines Multi-Drop-Postfachs kann man "uber diesen Parameter
        festlegen, wie die Eintr"age im Nachrichtenumschlag gekennzeichnet sind
        die die originalen Empf"angeradressen beinhalten. Standardm"a"sig wird
        nach einem Eintrag `X-Envelope-To:' gesucht, jedoch kann es sein dass
        ein Internet-Provider die Angabe eines abweichenden Eintrags notwendig
        macht.\\
        Falls mehrere Eintr"age gleichen Namens im Kopf einer Nachricht vorhanden
        sind, kann durch eine vorangestellte Zahl bestimmt werden, wie viele
        Eintr"age "ubersprungen werden sollen.

        Beispiel um alle Received-Zeilen auszuwerten:

        \texttt{FETCHMAIL\_1\_ENVELOPE\_HEADER='Received:'\\
                FETCHMAIL\_1\_ENVELOPE\_HEADER='1 Received:'  - ignoriere die erste Received-Zeile}

        G"ultige Werte: g"ultiger Nachrichtenumschlageintrag

        Standardeinstellung: \texttt{FETCHMAIL\_x\_ENVELOPE\_HEADER=$''$}

     \config{FETCHMAIL\_x\_SERVER\_AKA\_N (ADVANCED-Modus)}{FETCHMAIL\_x\_SERVER\_AKA\_N}{FETCHMAILxSERVERAKAN}
        Dieser Parameter gibt an, wie viele alternative DNS Aliasnamen f"ur den
        E-Mail-Server "uber die Parameter FETCHMAIL\_x\_SERVER\_AKA\_y definiert
        worden sind. Es ist zu beachten, dass dieser und der folgende Parameter
        nur funktionsf"ahig sind, wenn FETCHMAIL\_x\_DOMAIN='yes' gesetzt wurde.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_x\_SERVER\_AKA\_N='0'}

    \config{FETCHMAIL\_x\_SERVER\_AKA\_y (ADVANCED-Modus)}{FETCHMAIL\_x\_SERVER\_AKA\_y}{FETCHMAILxSERVERAKAy}
        Bei der Abfrage eines Postfaches durchsucht Fetchmail den Nachrichtenkopf
        nach Aliasnamen des E-Mail-Servers. Definiert man nun "uber diesen Parameter
        alternative DNS Aliasnamen f"ur einen E-Mail-Server, so wird die "Uberpr"ufung
        beschleunigt und die Notwendigkeit von DNS-Anfragen reduziert.\\
        {\textbf{Hinweis:}} Wird z.B. ein Domain-Suffix `netaxs.com' konfiguriert,
        so trifft dieser auf alle auf diesen Suffix endenden Hostnamen, wie z.B.
        `pop3.netaxs.com' oder `mail.netaxs.com' zu.

        G"ultige Werte: Domainname

        Standardeinstellung: \texttt{FETCHMAIL\_x\_SERVER\_AKA\_y=$''$}

    \config{FETCHMAIL\_x\_LOCALDOMAIN\_N (ADVANCED-Modus)}{FETCHMAIL\_x\_LOCALDOMAIN\_N}{FETCHMAILxLOCALDOMAINN}
        Dieser Parameter gibt an, wie viele lokale Domains "uber die Parameter
        \jump{FETCHMAILxLOCALDOMAINy}{FETCHMAIL\_x\_LOCALDOMAIN\_y} definiert
        worden sind. Es ist zu beachten, dass dieser und der folgende Parameter
        nur funktionsf"ahig sind, wenn FETCHMAIL\_x\_DOMAIN='yes' gesetzt wurde.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_x\_LOCALDOMAIN\_N='0'}

    \config{FETCHMAIL\_x\_LOCALDOMAIN\_y (ADVANCED-Modus)}{FETCHMAIL\_x\_LOCALDOMAIN\_y}{FETCHMAILxLOCALDOMAINy}
        Bei einem E-Mail-Abruf wird die hier angegebenen Domain dazu genutzt um
        zu pr"ufen, ob es sich bei der Empf"anger-Domain in einer E-Mail um eine
        lokale oder nicht lokale Domain handelt. Nur wenn es zu einer "Ubereinstimmung
        kommt wird die E-Mail abgeholt.

        G"ultige Werte: Domainname

        Standardeinstellung: \texttt{FETCHMAIL\_x\_LOCALDOMAIN\_y=$''$}

    \config{FETCHMAIL\_x\_PROTOCOL (ADVANCED-Modus)}{FETCHMAIL\_x\_PROTOCOL}{FETCHMAILxPROTOCOL}
        Hier kann das verwendete Protokoll zur "Ubertragung der E-Mails, abweichend
        vom Standardprotokoll, welches "uber den Parameter\\
        \jump{FETCHMAILPROTOCOL}{FETCHMAIL\_PROTOCOL} festgelegt wurde, definiert
        werden. Dieser Parameter muss normalerweise nicht gesetzt werden!

        G"ultige Werte: leer bzw. imap, pop3, auto

        Standardeinstellung: \texttt{FETCHMAIL\_x\_PROTOCOL=$''$}

    \config{FETCHMAIL\_x\_PORT (ADVANCED-Modus)}{FETCHMAIL\_x\_PORT}{FETCHMAILxPORT}
        Hier kann der verwendete IP-Port zur "Ubertragung der E-Mails,
        abweichend vom Standard-Port des gew"ahlten Protokolls, definiert
        werden. Dieser Parameter muss normalerweise nicht gesetzt werden!

        G"ultige Werte: leer bzw. Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_x\_PORT=$''$}

    \config{FETCHMAIL\_x\_ACCEPT\_BAD\_HEADER (ADVANCED-Modus)}{FETCHMAIL\_x\_ACCEPT\_BAD\_HEADER}{FETCHMAILxACCEPTBADHEADER}
        "Uber diesen Parameter wird festgelegt, ob auch Nachrichten mit
        fehlerhaften E-Mail-Kopfzeilen herunter geladen werden sollen
        oder nicht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_ACCEPT\_BAD\_HEADER='no'}

    \config{FETCHMAIL\_x\_DNS\_LOOKUP}{FETCHMAIL\_x\_DNS\_LOOKUP}{FETCHMAILxDNSLOOKUP}
        "Uber diesen Parameter kann die Namensaufl"osung mittels DNS beim
        Abruf von Multi-Drop-Postf"acher werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_DNS\_LOOKUP='yes'}

    \config{FETCHMAIL\_x\_KEEP}{FETCHMAIL\_x\_KEEP}{FETCHMAILxKEEP}
        Mit diesem Konfigurationsparameter stellt man ein, ob die E-Mails nach
        der "Ubertragung auf dem entfernten POP3-/IMAP-Server erhalten bleiben
        sollen. Die Einstellung `yes' erh"alt die E-Mails auf dem entfernten
        Server, mit `no' werden sie nach der "Ubertragung gel"oscht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_KEEP='no'}

    \config{FETCHMAIL\_x\_FETCHALL}{FETCHMAIL\_x\_FETCHALL}{FETCHMAILxFETCHALL}
        Mit diesem Konfigurationsparameter stellt man ein, ob generell alle
        E-Mails vom entfernten POP3-/IMAP-Server abgeholt werden sollen, egal
        ob diese bereits abgerufen wurden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_FETCHALL='no'}

    \config{FETCHMAIL\_x\_MSG\_LIMIT (ADVANCED-Modus)}{FETCHMAIL\_x\_MSG\_LIMIT}{FETCHMAILxMSGLIMIT}
        "Uber diesen Parameter stellt man die maximale Anzahl der Nachrichten
        ein, die w"ahrend einer einzelnen Verbindung abgerufen bzw. weitergeleitet
        werden sollen. Setzt man den Parameter auf den Wert `0' so wird jede
        Begrenzung aufgehoben.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{FETCHMAIL\_x\_MSG\_LIMIT='0'}

    \config{FETCHMAIL\_x\_SSL\_PROTOCOL (ADVANCED-Modus)}{FETCHMAIL\_x\_SSL\_PROTOCOL}{FETCHMAILxSSLPROTOCOL}
        "Uber diesen Parameter bestimmt man, welches SSL/TLS-Protokoll bei
        einer Verbindung zum entfernten POP3-Server verwendet werden soll.
        Wird der Wert 'auto' gesetzt, so wird, basierend auf der Serverantwort,
        automatisch das sicherste Protokoll gew"ahlt.  Viele POP3-/IMAP-Server
        unterst"utzen z.B. mittlerweile die STLS-Funktion (tls1), welche eine
        verschl"usselte "Ubertragung des Kennwortes zul"asst.
        Alle Werte denen ein +-Zeichen folgt geben die minimal zu verwendende
        Protokollversion bei dem Aushandelvorgang vor.

        G"ultige Werte: auto, none, tls1+, tls1.1, tls1.1+, tls1.2, tls1.2+

        Standardeinstellung: \texttt{FETCHMAIL\_x\_SSL\_PROTOCOL='none'}

    \config{FETCHMAIL\_x\_SSL\_TRANSPORT (ADVANCED-Modus)}{FETCHMAIL\_x\_SSL\_TRANSPORT}{FETCHMAILxSSLTRANSPORT}
        Mit diesem Konfigurationsparameter aktiviert man die SSL/TLS-
        Protokollunterst"utzung, sodass die komplette Kommunikation zum
        entfernten POP3-/IMAP-Server verschl"usselt abl"auft. Voraussetzung
        f"ur die Nutzung dieser Funktion ist nat"urlich, dass der entfernte
        Server dies auch unterst"utzt.
        Zus"atzlich ist es hierf"ur erforderlich, dass man das SSL/TLS-
        Serverzertifikat des entfernten POP3-Servers und das zugeh"orige
        Root-Zertifikat im Verzeichnis \texttt{/usr/local/ssl/certs} ablegt
        und jeweils mit einem Hash-Wert versieht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{FETCHMAIL\_x\_SSL\_TRANSPORT='no'}

    \config{FETCHMAIL\_x\_SSL\_FINGERPRINT (ADVANCED-Modus)}{FETCHMAIL\_x\_SSL\_FINGERPRINT}{FETCHMAILxSSLFINGERPRINT}
        "Uber diesen Parameter kann man den SSL/TLS-Fingerprint (MD5-Hash)
        des entfernten POP3-/IMAP-Servers angeben. Bei einem Verbindungsaufbau
        vergleicht Fetchmail diesen Wert mit dem des POP3-/IMAP-Servers und
        unterbricht die Verbindung sobald ein Unterschied festgestellt wird.

        G"ultige Werte: leer bzw. Text

        Beispiel: \texttt{FETCHMAIL\_1\_SSL\_FINGERPRINT='E4:20:3C:CB:A3:00:80:C9'}

        Standardeinstellung: \texttt{FETCHMAIL\_x\_SSL\_FINGERPRINT=$''$}
\end{description}


\subsection{Der SMTP-Server (Exim)}
%----------------------------------

    Als SMTP-Server wird Exim eingesetzt. Er nimmt E-Mails "uber das SMTP-Protokoll
    entgegen und speichert sie entweder auf dem lokalen Server ab, wenn der
    Empf"anger der E-Mail ein lokaler Benutzer ist, oder leitet sie an einen
    anderen SMTP-Server, siehe auch Parameter \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_...},
    weiter.

    \index{innen}
    \index{au"sen}
    Der Begriff \texttt{`innen'} steht dabei in den folgenden Abs"atzen f"ur
    das lokale Netzwerk und deren Rechnern, der Begriff \texttt{`au"sen'}
    steht f"ur die `gro"se weite Welt' des Internets mit deren SMTP-Servern.

    Um Missbrauch vor Spamming vorzubeugen, ist die Konfiguration des SMTP-Servers
    mit Bedacht vorzunehmen. E-Mails, die nach \texttt{`au"sen'} weitergeleitet
    werden sollen, sollten auch nur von lokalen Rechnern (\texttt{`innen'})
    entgegengenommen werden. E-Mails, die von \texttt{`au"sen'} kommen, sollten
    lediglich lokal (\texttt{`innen'}) gespeichert werden k"onnen. Einem
    Missbrauch als sog. Mail-Relay ist auf jeden Fall vorzubeugen, d.h. das
    Entgegennehmen einer E-Mail von \texttt{`au"sen'} und Weiterleitung nach
    \texttt{`au"sen'} sollte im Normalfall unterbunden werden. Daf"ur muss in
    der Konfiguration eingestellt werden, was \texttt{`au"sen'} und was
    \texttt{`innen'} ist. Eine weitere M"oglichkeit der Absicherung ist ein
    Authentifizierungszwang. Auch dieser kann "uber die Standardkonfiguration
    eingestellt werden.

    \achtung{F"ur jedes lokale Mailkonto muss ein lokaler Benutzer "uber das
        EISFAIR-Setup-Men"u eingerichtet werden!}


\subsection{Die Grundeinstellungen}
%----------------------------------

\begin{description}
    \config{START\_SMTP}{START\_SMTP}{STARTSMTP}
        "Uber diesen Parameter wird der SMTP-Server (Port 25/587/tcp) aktiviert,
        sodass Nachrichten, "uber den E-Mail-Server versandt werdne k"onnen.
        Bei der Verwendung von Fetchmail ist der Wert dieses Parameters unbedingt
        auf `yes' zu setzen, wenn die abgeholten E-Mails lokal gespeichert werdeni
        sollen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_SMTP='yes'}

    \config{SMTP\_QUALIFY\_DOMAIN}{SMTP\_QUALIFY\_DOMAIN}{SMTPQUALIFYDOMAIN}
        Hier wird der Name der Domain angegeben, die bei ausgehenden E-Mails
        f"ur die Absender-Adresse verwendet werden soll, wenn diese nicht
        bereits eine Domain enth"alt. Dieses kann zum Beispiel der Fall sein,
        wenn man aus der Shell mit dem Programm `mail' eine E-Mail versendet.
        Hei"st der lokale Benutzer zum Beispiel `joe', wird die E-Mail mit
        der Absenderadresse joe@domain.de gesendet, wenn Joe das Programm
        `mail' aus der Shell aufgerufen hat. Im Normalfall verwendet man
        jedoch an seinem Arbeits-PC einen E-Mail-Klienten, welcher bereits
        die vollst"andige E-Mail-Absender-Adresse angibt. In diesem Fall wird
        der Wert dieses Konfigurationsparameters ignoriert. Hier sollte
        unbedingt als Domain ein g"ultiger Domain-Name eingetragen werden!

        G"ultige Werte: Domainname

        Beispiel: \texttt{SMTP\_QUALIFY\_DOMAIN='domain.de'}

    \config{SMTP\_HOSTNAME}{SMTP\_HOSTNAME}{SMTPHOSTNAME}
        Der `offizielle' Hostname des EISFAIR-Rechners, inklusiv der zugeh"origen
        Domain, der beim Versenden von E-Mails nach \texttt{`au"sen'} angegeben
        werden soll.

        G"ultige Werte: vollst"andiger Hostname

        Beispiel: \texttt{SMTP\_HOSTNAME='eis.domain.de'}

    \config{SMTP\_QUEUE\_INTERVAL}{SMTP\_QUEUE\_INTERVAL}{SMTPQUEUEINTERVAL}
        Intervall in Minuten, in welchem die Warteschlange (Queue) "uberpr"uft
        werden soll. Ein Sende-Auftrag einer E-Mail wird normalerweise sofort
        vorgenommen. Kann die E-Mail nicht versendet werden, weil beispielsweise
        der `gegnerische' SMTP-Server nicht erreichbar ist, bleibt die zu
        sendende E-Mail in der Warteschlange liegen. In regelm"a"sigen Abst"anden
        werden dann die Sende-Auftr"age nachgeholt. Mit SMTP\_QUEUE\_INTERVAL
        kann man das Intervall einstellen. Ein guter Wert ist 30 Minuten.
        "Uber den Parameter \jump{SMTPQUEUEOUTBOUNDMAIL}{SMTP\_QUEUE\_OUTBOUND\_MAIL}
        kann die die direkte Auslieferung ausgehender E-Mail verhindert werden.

        G"ultige Werte: Zahl

        Beispiel: \texttt{SMTP\_QUEUE\_INTERVAL='30'}

    \config{SMTP\_QUEUE\_OUTBOUND\_MAIL}{SMTP\_QUEUE\_OUTBOUND\_MAIL}{SMTPQUEUEOUTBOUNDMAIL}
        Wird dieser Konfigurationsparameter auf den Wert `no' gesetzt, so
        werden ausgehende E-Mail sofort verschickt und nicht bis zum n"achsten
        manuellen Pr"ufen der Sende-Warteschlange (Befehl: runq) zwischenspeichern.
        Interne E-Mail wird weiterhin sofort zugestellt. Dies ist hilfreich,
        wenn man selbst bestimmen will wann E-Mail verschickt werden soll.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_QUEUE\_OUTBOUND\_MAIL='no'}

   \config{SMTP\_QUEUE\_ACCEPT\_PER\_CONNECTION}{SMTP\_QUEUE\_ACCEPT\_PER\_CONNECTION}{SMTPQUEUEACCEPTPERCONNECTION}
        Nur wenn der Parameter  \jump{SMTPQUEUEOUTBOUNDMAIL}{SMTP\_QUEUE\_OUTBOUND\_MAIL='no'}
        gesetzt wurde kann "uber diesen Parameter eingestellt werden wie viele
        Nachrichten w"ahrend eine SMTP-Session "ubertragen werden sollen.
        Ein Indiz f"ur einen zu gering gew"ahlten Wert ist z.B. das geh"aufte
        Auftreten der Meldung 'no immediate delivery' in den Logdateien.
        In diesem Fall sollte man den Parameter auf z.B. auf den Wert '30'
        setzen.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_QUEUE\_ACCEPT\_PER\_CONNECTION='10'}

     \config{SMTP\_MAIL\_TO\_UNKNOWN\_USERS (ADVANCED-Modus)}{SMTP\_MAIL\_TO\_UNKNOWN\_USERS}{SMTPMAILTOUNKNOWNUSERS}
        Mit diesem Parameter wird festgelegt wie der SMTP-Server auf eingehende
        E-Mail, die an unbekannte Empf"anger geschickt wurde, reagieren soll.
        Wird der Parameter auf `bounce' gesetzt, so wird automatisch eine
        Antwortnachricht an den Mail-Sender geschickt (Standard).
        Wird der Parameter auf `copy' gesetzt, so wird automatisch eine
        Antwortnachricht an den Mail-Sender und eine Kopie an den Postmaster
        geschickt.
        Wird der Parameter jedoch  auf `forward' gesetzt, so wird keine
        Nachricht an den Mail-Sender sondern nur eine Nachricht an den
        Postmaster geschickt.

        G"ultige Werte: bounce, copy, forward

        Standardeinstellung: \texttt{SMTP\_MAIL\_TO\_UNKNOWN\_USERS='bounce'}

     \config{SMTP\_ALLOW\_EXIM\_FILTERS (ADVANCED-Modus)}{SMTP\_ALLOW\_EXIM\_FILTERS}{SMTPALLOWEXIMFILTERS}
        Wird dieser Parameter gesetzt, so interpretiert Exim Eintr"age in der
        .forward-Datei, die mit `\#Exim filter' beginnen, als Filter-Befehle.
        Die Filter-Datei wird mit den Zugriffsrechten des Anwenders ausgef"uhrt.
        Es ist zu beachten, dass durch die Aktivierung dieses Parameters ein
        Anwender unter Umst"anden Zugriff auf Dateien und Funktionen erhalten
        kann, die f"ur ihn normalerweise gesperrt sind.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_ALLOW\_EXIM\_FILTERS='no'}

    \config{SMTP\_CHECK\_RECIPIENTS}{SMTP\_CHECK\_RECIPIENTS}{SMTPCHECKRECIPIENTS}
        ADVANCED-Modus: "uber diesen Parameter kann festgelegt werden, wie viele
        Empf"anger pro versendeter Nachricht gleichzeitig adressiert werden k"onnen.
        Wird dieser Parameter nicht gesetzt, so wird ein Standardwert von 100
        angenommen. Setzt man den Parameter auf den Wert '0', so wird die
        "Uberpr"ufung deaktiviert.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_CHECK\_RECIPIENTS=$''$}

    \config{SMTP\_CHECK\_SPOOL\_SPACE (ADVANCED-Modus)}{SMTP\_CHECK\_SPOOL\_SPACE}{SMTPCHECKSPOOLSPACE}
        "Uber diesen Parameter kann festgelegt werden, wie viel Platz mindestens
        vorhanden sein muss, damit Exim noch E-Mails entgegen nehmen kann. Wird
        dieser Parameter nicht gesetzt, so wird ein Standardwert von 10MB angenommen.
        Setzt man den Parameter auf den Wert '0', so wird die "Uberpr"ufung deaktiviert.

        G"ultige Werte: Speicherangabe

        Standardeinstellung: \texttt{SMTP\_CHECK\_SPOOL\_SPACE=$''$}

    \config{SMTP\_CHECK\_SPOOL\_INODES (ADVANCED-Modus)}{SMTP\_CHECK\_SPOOL\_INODES}{SMTPCHECKSPOOLINODES}
        "Uber diesen Parameter kann festgelegt werden, wie viele freie
        Verzeichniseintr"age (Inodes) mindestens vorhanden sein m"ussen, damit
        Exim noch E-Mails entgegen nehmen kann. Wird dieser Parameter nicht
        gesetzt, so wird ein Standardwert von 100 angenommen. Setzt man den
        Parameter auf den Wert '0', so wird die "Uberpr"ufung deaktiviert.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_CHECK\_SPOOL\_INODES=$''$}

    \config{SMTP\_CHECK\_LINE\_LENGTH (optionaler Parameter)}{SMTP\_CHECK\_LINE\_LENGTH}{SMTPCHECKLINELENGTH}
        "Uber diesen Parameter kann festgelegt werden, ob die L"ange der Kopfzeilen
        (RFC2047) bzw. Nachrichtenzeilen (RFC2045), die nicht-ASCII-Zeichen enthalten,
        gepr"uft werden sollen oder nicht. Das Deaktivieren dieser Pr"ufungen kann
        in seltenen F"allen erforderlich sein um Nachrichten von Systemen empfangen
        zu k"onnen, die gegen genannten RFC versto"sen.

        G"ultige Werte:
        \begin{description}
            \item[header+body] - Kopf- und Nachrichtenzeilen werden gepr"uft (\textbf{Standard})
            \item[header]      - Nur Kopfzeilen werden gepr"uft
            \item[body]        - Nur Nachrichtenzeilen werden gepr"uft
            \item[no]          - Es werden weder Kopf- noch Nachrichtenzeilen gepr"uft
        \end{description}

        Standardeinstellung: \texttt{SMTP\_CHECK\_LINE\_LENGTH=$''$}

    \config{SMTP\_LIMIT}{SMTP\_LIMIT (ADVANCED-Modus)}{SMTPLIMIT}
        "Uber diesen Parameter kann die maximale Gr"o"se f"ur eine beim SMTP-Server
        eingehende Nachricht festgelegt werden. "Uberschreitet eine E-Mail die
        angegebene Gr"o"se, wird diese E-Mail zur"uckgewiesen. Wird dieser Parameter
        auf `0' gesetzt, so wird die Limit"uberpr"ufung deaktiviert (Dies wird nicht
        empfohlen!). Ein Wert von '10M' setzt ein Limit von 10MB. Wird kein Wert
        angegeben, so werden standardm"a"sig E-Mails bis zu einer Gr"o"se von 50MB
        akzeptiert.

        G"ultige Werte: Gr"o"senangabe

        Standardeinstellung: \texttt{SMTP\_LIMIT=$''$}

    \config{SMTP\_REMOVE\_RECEIPT\_REQUEST (ADVANCED-Modus)}{SMTP\_REMOVE\_RECEIPT\_REQUEST}{SMTPREMOVERECEIPTREQUEST}
        Enth"alt eine Nachricht, welche "uber das Internet empfangen wurde, eine
        Anfrage f"ur die R"ucksendung einer Lesebest"atigung, so kann diese durch
        Setzen dieses Parameters aus der Nachricht entfernt werden. Zur Information
        des Nachrichtenempf"angers wird dem eigentlichen Nachrichtentext eine
        Information "uber die Entfernung einer solchen Anfrage vorangestellt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_REMOVE\_RECEIPT\_REQUEST='no'}

    \config{SMTP\_SERVER\_TRANSPORT (ADVANCED-Modus)}{SMTP\_SERVER\_TRANSPORT}{SMTPSERVERTRANSPORT}
        "Uber diesen Parameter wird festgelegt, ob als Transport-Protokoll SMTP
        (default - unverschl"usselt), SMTP "uber TLS (tls - verschl"usselt) oder
        beides (both) verwendet werden soll. Bei Verwendung von TLS ist
        sicherzustellen, dass zuvor entsprechende Server- Zertifikate installiert
        wurden.

        G"ultige Werte: default, tls, both

        Standardeinstellung: \texttt{SMTP\_SERVER\_TRANSPORT='default'}

    \config{SMTP\_TLS\_CERT\_NAME (optionaler Parameter)(ADVANCED-Modus)}{SMTP\_TLS\_CERT\_NAME}{SMTPTLSCERTNAME}
        "Uber diesen Parameter legt man den bzw. die Namen der TLS-Zertifikate
        des SMTP-Dienstes fest, welche zum Aufbau einer gesicherten
        Verbindung verwendet werden sollen. Es wird empfohlen f"ur die
        Benennung der Dateien immer den vollst"andigen Domainnamen zu
        verwenden, da dies die Dateizuordnung erleichtert.

        \hinweis{Bei Verwendung zusammen mit dem mail-dovecot-Paket wird
            hierdurch sogar die Verwendung unterschiedlicher Zertifikatei
            je nach Domainnamen m"oglich. Mehrere Namen m"ussen dabei
            jeweils durch einen Doppelpunkt voneinander getrennt werden.
            Der erste angegebene Domainname muss immer der Standardname
            sein, der verwendet wird falls ein E-Mail-Klient kein SNI
            unterst"utzt. Dass die angegebenen Dateien auch physikalisch
            im Zertifikatsverzeichnis des Servers existieren bzw.
            entsprechende symbolische Links auf ein Multi-Domain-Zertifikat
            gesetzt werden m"ussen, ist selbsredend.}

        Wird dieser Parameter nicht gesetzt, so wird standardm"a"sig ein
        Zertifikat mit dem Namen `exim.pem' verwendet.

        G"ultige Werte: Ein- oder mehrere Zertifikatsnamen

        Beispiel: \texttt{SMTP\_TLS\_CERT\_NAME='mail-server.local.lan'}

    \config{SMTP\_SERVER\_TLS\_ADVERTISE\_HOSTS (ADVANCED-Modus)}{SMTP\_SERVER\_TLS\_ADVERTISE\_HOSTS}{SMTPSERVERTLSADVERTISEHOSTS}
        "Uber diesen Parameter wird angegeben f"ur welche Hosts die Verwendung
        des STARTTLS-Befehls erm"oglicht werden soll. Nur wenn der angegebene
        Domainfilter mit der Absenderdomain "ubereinstimmt wird es einem E-Mail-Klienten
        erm"oglicht eine verschl"usselte Verbindung aufzubauen. Mehrere Eintr"age
        m"ussen durch ein `:' voneinander getrennt werden.\\

        Dieser Befehl wird nur verwendet, wenn zuvor \jump{SMTPSERVERTRANSPORT}{SMTP\_SERVER\_TRANSPORT}
        auf `tls' oder `both' gestellt wurde.

        \achtung{Diese Parameter sollte nur von erfahrenen Personen genutzt
            werden, die sich sehr gut mit SSL/TLS-Zertifikaten auskennen.}

        G"ultige Werte: Domainfilter

        Beispiel: \texttt{SMTP\_SERVER\_TLS\_ADVERTISE\_HOSTS='*domain.de'}

        Standardeinstellung: \texttt{SMTP\_SERVER\_TLS\_ADVERTISE\_HOSTS=$''$}

    \config{SMTP\_SERVER\_TLS\_VERIFY\_HOSTS (ADVANCED-Modus)}{SMTP\_SERVER\_TLS\_VERIFY\_HOSTS}{SMTPSERVERTLSVERIFYHOSTS}
        "Uber diesen Parameter wird angegeben welche Hosts sich durch ein eigenes
        Zertifikat ausweisen m"ussen. Falls das von einem E-Mail-Klienten "ubermittelte
        Zertifikat nicht mit einem auf dem Server abgelegten Klientenzertifikat
        "ubereinstimmt wird die Nachrichten"ubermittlung abgebrochen. Dieser
        Parameter muss mit einem gro"sen Ma"s an Sorgfalt gesetzt werden, da es
        sonst dazu f"uhren kann, dass E-Mail von dem eigenen oder auch `externen'
        SMTP-Servern nicht mehr entgegen genommen wird. Eintr"age wie z.B. `*',
        `localhost' oder `127.0.0.1' sollten also auf jeden Fall unterbleiben.
        Mehrere Eintr"age m"ussen durch ein `:' voneinander getrennt werden.\\
        Dieser Befehl wird nur verwendet, wenn zuvor \jump{SMTPSERVERTRANSPORT}{SMTP\_SERVER\_TRANSPORT}
        auf `tls' oder `both' gestellt wurde.

        \achtung{Diese Parameter sollte nur von erfahrenen Personen genutzt
            werden, die sich sehr gut mit SSL/TLS-Zertifikaten auskennen.}

        G"ultige Werte: Domainfilter

        Beispiel: SMTP\_SERVER\_TLS\_VERIFY\_HOSTS='*domain.de'

        Standardeinstellung: \texttt{SMTP\_SERVER\_TLS\_VERIFY\_HOSTS=$''$}

    \config{SMTP\_SERVER\_TLS\_TRY\_VERIFY\_HOSTS (ADVANCED-Modus)}{SMTP\_SERVER\_TLS\_TRY\_VERIFY\_HOSTS}{SMTPSERVERTLSTRYVERIFYHOSTS}
        "Uber diesen Parameter wird angegeben f"ur welche Hosts versucht werden
        soll eine Authentifizierung "uber ein Zertifikat durchzuf"uhren. Falls
        das von einem E-Mail-Klienten "ubermittelte Zertifikat nicht mit einem
        auf dem Server abgelegten Klientenzertifikat "ubereinstimmt wird trotzdem
        eine sichere Nachrichten"ubermittlung zugelassen. Eintr"age wie z.B. `*',
        `localhost' oder `127.0.0.1' sollten also auf jeden Fall unterbleiben.
        Mehrere Eintr"age m"ussen durch ein `:' voneinander getrennt werden.\\
        Dieser Befehl wird nur verwendet, wenn zuvor \jump{SMTPSERVERTRANSPORT}{SMTP\_SERVER\_TRANSPORT}
        auf `tls' oder `both' gestellt wurde.

        \achtung{Diese Parameter sollte nur von erfahrenen Personen genutzt
            werden, die sich sehr gut mit TLS-Zertifikaten auskennen.}

        G"ultige Werte: Domainfilter

        Beispiel: SMTP\_SERVER\_TLS\_TRY\_VERIFY\_HOSTS='*domain.de'

        Standardeinstellung: \texttt{SMTP\_SERVER\_TRY\_TLS\_VERIFY\_HOSTS=$''$}

    \config{SMTP\_SERVER\_SSMTP}{SMTP\_SERVER\_SSMTP}{SMTPSERVERSSMTP}
        "Uber diesen Parameter kann die Unterst"utzung f"ur das SSMTP-Protokoll
        (Port 465/tcp) aktiviert werden. Hierzu muss diese Variable lediglich
        auf den Wert `yes' gestellt werden. Die Einstellung `no' schaltet den
        SSMTP-Server ab.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_SERVER\_SSMTP='no'}

    \config{SMTP\_SERVER\_SSMTP\_LISTEN\_PORT}{SMTP\_SERVER\_SSMTP\_LISTEN\_PORT}{SMTPSERVERSSMTPLISTENPORT}
        "Uber diesen Parameter wird ein vom Standard abweichender TCP-Port
        festgelegt, auf dem Exim auf eingehende SSMTP-Verbindungen h"ort.
        Es ist zu beachten, dass f"ur den angegebenen Port auch ein Eintrag
        in der Datei /etc/services existieren sollte. Wird dieser Parameter
        nicht gesetzt, so wird automatisch 'ssmtp' angenommen.

        \achtung{Dieser Parameter sollte nur in Ausnahmef"allen ver"andert werden!}

        G"ultige Werte: Portname bzw. Zahl

        Standardeinstellung: \texttt{SMTP\_SERVER\_SSMTP\_LISTEN\_PORT=$''$}

    \config{SMTP\_IDENT\_CALLBACKS (ADVANCED-Modus)}{SMTP\_IDENT\_CALLBACKS}{SMTPIDENTCALLBACKS}
        "Uber diesen Parameter wird festgelegt, ob der Exim-Daemon einen Ident
        Callback f"ur die "uber die Parameter \jump{SMTPRELAYFROMHOSTx}SMTP\_RELAY\_FROM\_HOST\_..
        definierten Hosts durchf"uhren soll. Falls der initiale Verbindungsaufbau
        beim Abruf von Nachrichten relativ lange dauern sollte, kann man diesen
        Parameter auf 'no' setzen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_IDENT\_CALLBACKS='yes'}

%%  JED - show this description only in the help file
 %  \config{SMTP\_LOCAL\_DOMAIN\_N}{SMTP\_LOCAL\_DOMAIN\_N}{SMTPLOCALDOMAINN}
 %      "Uber diesen Parameter gibt man die Anzahl der lokalen Domains, f"ur
 %      welche E-Mails zur lokalen Speicherung entgegengenommen werden sollen,
 %      an. Es k"onnen auch Hostnamen angegeben werden. Der Wert `@' ist dabei
 %      etwas Besonderes: er steht f"ur den offiziellen Hostnamen des
 %      EISFAIR-Servers, also den Wert der Variablen \jump{SMTPHOSTNAME}{SMTP\_HOSTNAME}. Zus"atzlich
 %      sollte der Hostname `localhost' in der Liste erscheinen.
 %
 %      G"ultige Werte: Zahl bzw. @, Host- und Domainnamen
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_LOCAL\_DOMAIN\_N='3'\\
 %              SMTP\_LOCAL\_DOMAIN\_1='@'\\
 %              SMTP\_LOCAL\_DOMAIN\_2='localhost'\\
 %              SMTP\_LOCAL\_DOMAIN\_3='domain.de'}

    \index{SMTP\_LOCAL\_DOMAIN\_N}
    \config{SMTP\_LOCAL\_DOMAIN\_N /SMTP\_LOCAL\_DOMAIN\_x}{SMTP\_LOCAL\_DOMAIN\_x}{SMTPLOCALDOMAINx}
        "Uber diesen Parameter gibt man die Anzahl der lokalen Domains, f"ur
        welche E-Mails zur lokalen Speicherung entgegengenommen werden sollen,
        an. Es k"onnen auch Hostnamen angegeben werden. Der Wert `@' ist dabei
        etwas Besonderes: er steht f"ur den offiziellen Hostnamen des
        EISFAIR-Servers, also den Wert der Variablen \jump{SMTPHOSTNAME}{SMTP\_HOSTNAME}. Zus"atzlich
        sollte der Hostname `localhost' in der Liste erscheinen.

        G"ultige Werte: Zahl bzw. @, Host- und Domainnamen

        Beispiel:

        \texttt{SMTP\_LOCAL\_DOMAIN\_N='3'\\
                SMTP\_LOCAL\_DOMAIN\_1='@'\\
                SMTP\_LOCAL\_DOMAIN\_2='localhost'\\
                SMTP\_LOCAL\_DOMAIN\_3='domain.de'}

    \config{SMTP\_LISTEN\_PORT}{SMTP\_LISTEN\_PORT}{SMTPLISTENPORT}
        "Uber diesen Parameter wird ein vom Standard abweichender TCP-Port bzw.
        werden vom Standard abweichende TCP-Ports festgelegt, auf welchen Exim
        eingehende Verbindungen entgegen nimmt. Wird mehr als ein TCP-Port
        angegeben, so M"ussen die Eintr"age durch Doppelpunkte voneinander
        getrennt werden. Wird dieser Parameter nicht gesetzt, so nimmt Exim
        standardm"a"sig Verbindungen auf den TCP-Ports `smtp' (25/tcp) und
        `submission' (587/tcp) entgegen. Es ist zu beachten, dass f"ur den/die
        angegebenen TCP-Port(s) jeweils ein Eintrag in der Datei /etc/services
        existieren sollte.

        \achtung{Dieser Parameter sollte nur in Ausnahmef"allen ver"andert werden!}

        G"ultige Werte: ein oder mehrere Portnamen bzw. Zahlen

        Standardeinstellung: \texttt{SMTP\_LISTEN\_PORT=$''$}
\end{description}

\subsection{Eingehende E-Mail}
%----------------------------

\begin{description}
%%  JED - show this description only in the help file
 %  \config{SMTP\_RELAY\_TO\_DOMAIN\_N}{SMTP\_RELAY\_TO\_DOMAIN\_N}{ SMTPRELAYTODOMAINN}
 %      Hier werden diejenigen Domains angegeben, f"ur welche der SMTP-Server
 %      ein `eingehendes Relais' sein soll. SMTP\_RELAY\_TO\_DOMAIN\_N gibt dabei
 %      die Anzahl der Domains an. Diese Domains werden dann in den Variablen
 %      SMTP\_RELAY\_TO\_DOMAIN\_1, SMTP\_RELAY\_TO\_DOMAIN\_2 usw. eingetragen.
 %      Im Normalfall ist Relaying nicht notwendig, sodass dieser Wert auf `0'
 %      gesetzt werden kann. Soll der \eisfair-Server jedoch als MX-Backup oder
 %      als E-Mail-Gateway f"ur bestimmte Domains eingesetzt werden, dann k"onnen
 %      diese Domains hier angegeben werden.
 %
 %      \achtung{Man sollte den SMTP-Server nur im Ausnahmefall als Relais
 %          verwenden, weil er sonst f"ur Spamming missbraucht werden k"onnte!}
 %
 %      G"ultige Werte: Zahl bzw. @, Host- und Domainnamen
 %
 %      Standardeinstellung: \texttt{SMTP\_RELAY\_TO\_DOMAIN\_N='0'}
 %
 %      Beispiel: \texttt{SMTP\_RELAY\_TO\_DOMAIN\_1='domain.de'}

    \index{SMTP\_RELAY\_TO\_DOMAIN\_N}
    \config{SMTP\_RELAY\_TO\_DOMAIN\_N / SMTP\_RELAY\_TO\_DOMAIN\_x}{SMTP\_RELAY\_TO\_DOMAIN\_x}{ SMTPRELAYTODOMAINx}
        Hier werden diejenigen Domains angegeben, f"ur welche der SMTP-Server
        ein `eingehendes Relais' sein soll. SMTP\_RELAY\_TO\_DOMAIN\_N gibt dabei
        die Anzahl der Domains an. Diese Domains werden dann in den Variablen
        SMTP\_RELAY\_TO\_DOMAIN\_1, SMTP\_RELAY\_TO\_DOMAIN\_2 usw. eingetragen.
        Im Normalfall ist Relaying nicht notwendig, sodass dieser Wert auf `0'
        gesetzt werden kann. Soll der \eisfair-Server jedoch als MX-Backup oder
        als E-Mail-Gateway f"ur bestimmte Domains eingesetzt werden, dann k"onnen

        diese Domains hier angegeben werden.

        \achtung{Man sollte den SMTP-Server nur im Ausnahmefall als Relais
            verwenden, weil er sonst f"ur Spamming missbraucht werden k"onnte!}

        G"ultige Werte: Zahl bzw. @, Host- und Domainnamen

        Standardeinstellung: \texttt{SMTP\_RELAY\_TO\_DOMAIN\_N='0'}

        Beispiel: \texttt{SMTP\_RELAY\_TO\_DOMAIN\_1='domain.de'}
\end{description}

\subsection{Ausgehende E-Mail}
%----------------------------

    Um sich vor Spamming zu sch"utzen, leitet der SMTP-Server nur dann ausgehende
    E-Mails an externe, meistens im Internet befindliche, SMTP-Server weiter, wenn
    er diese zuvor von E-Mail-Klienten empf"angt die sich in bestimmten Netzen bzw.
    auf bestimmten Hosts befinden. Die hierzu ben"otigen Konfigrationsangaben k"onnen
    im Folgenden eingestellt werden. Ausnahmen oder eine alternative Regelung
    k"onnen "uber \jump{SMTPAUTHTYPE}{SMTP\_AUTH\_TYPE} eingestellt werden.

\begin{description}
%%  JED - show this description only in the help file
 %  \config{SMTP\_RELAY\_FROM\_HOST\_N}{SMTP\_RELAY\_FROM\_HOST\_N}{SMTPRELAYFROMHOSTN}
 %      "Uber die Parameter SMTP\_RELAY\_FROM\_HOST\_x werden diejenigen Netze
 %      oder Hosts angegeben, von denen ausgehende E-Mails verschickt werden
 %      d"urfen. Im Allgemeinen ist dies der localhost, also 127.0.0.1 und das
 %      interne LAN. Dabei werden Netze mit in der Notation x.x.x.x/N angegeben.
 %      N ist die Anzahl der gesetzten Bits der Netzmaske, z.B. 24. Dies entspricht
 %      dann der Netzmaske 255.255.255.0.
 %
 %      Schaltet man zus"atzlich die Authentifizierung (s. SMTP\_AUTH\_TYPE) ein,
 %      k"onnen auch E-Mails von \texttt{`au"sen'} nach \texttt{`au"sen'} unter
 %      Angabe einer Kennung und eines Kennwortes verschickt werden.
 %
 %      \achtung{Man sollte den SMTP-Server nur im Ausnahmefall als Relais
 %          verwenden, weil er sonst f"ur Spamming missbraucht werden k"onnte!}
 %
 %      G"ultige Werte: Zahl bzw. IP-Adressen und IP-Netze
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_RELAY\_FROM\_HOST\_N='2'               \# zwei Eintr"age\\
 %              SMTP\_RELAY\_FROM\_HOST\_1='127.0.0.1'       \# localhost\\
 %              SMTP\_RELAY\_FROM\_HOST\_2='192.168.6.0/24'  \# internes LAN}

    \index{SMTP\_RELAY\_FROM\_HOST\_N}
    \config{SMTP\_RELAY\_FROM\_HOST\_N / SMTP\_RELAY\_FROM\_HOST\_x}{SMTP\_RELAY\_FROM\_HOST\_x}{SMTPRELAYFROMHOSTx}
        "Uber die Parameter SMTP\_RELAY\_FROM\_HOST\_x werden diejenigen Netze
        oder Hosts angegeben, von denen ausgehende E-Mails verschickt werden
        d"urfen. Im Allgemeinen ist dies der localhost, also 127.0.0.1 und das
        interne LAN. Dabei werden Netze mit in der Notation x.x.x.x/N angegeben.
        N ist die Anzahl der gesetzten Bits der Netzmaske, z.B. 24. Dies entspricht
        dann der Netzmaske 255.255.255.0.

        Schaltet man zus"atzlich die Authentifizierung (s. SMTP\_AUTH\_TYPE) ein,
        k"onnen auch E-Mails von \texttt{`au"sen'} nach \texttt{`au"sen'} unter
        Angabe einer Kennung und eines Kennwortes verschickt werden.

        \achtung{Man sollte den SMTP-Server nur im Ausnahmefall als Relais
            verwenden, weil er sonst f"ur Spamming missbraucht werden k"onnte!}

        G"ultige Werte: Zahl bzw. IP-Adressen und IP-Netze

        Beispiel:

        \texttt{SMTP\_RELAY\_FROM\_HOST\_N='2'               \# zwei Eintr"age\\
                SMTP\_RELAY\_FROM\_HOST\_1='127.0.0.1'       \# localhost\\
                SMTP\_RELAY\_FROM\_HOST\_2='192.168.6.0/24'  \# internes LAN}
\end{description}

\subsection{Ausgehende E-Mail - Authentifizierung}
%------------------------------------------------

    Das Senden von E-Mails "uber den \eisfair-SMTP-Server kann prinzipiell
    mit einer Authentifizierung (Angabe Kennung/Kennwort) gesch"utzt werden.
    Auch wenn "uber\\
    \jump{SMTPRELAYFROMHOSTx}{SMTP\_RELAY\_FROM\_HOST\_x} das Aussenden von
    E-Mails nur auf bestimmte Netze beschr"ankt ist, empfiehlt es sich,
    zus"atzlich einen Kennwortschutz zu hinterlegen. Praktisch ist dies
    auch, wenn man von \texttt{`au"sen'} den E-Mail-Server als Relais benutzen
    m"ochte.

\begin{description}
    \config{SMTP\_AUTH\_TYPE}{SMTP\_AUTH\_TYPE}{SMTPAUTHTYPE}
        Mit dem Parameter SMTP\_AUTH\_TYPE wird angegeben, ob und wie eine
        solche Zugangskennung verwendet werden soll.

        Es werden 5 Typen unterschieden:

        \begin{description}
            \item[none]    - Keine Authentifizierung
            \item[user]    - Kennungen/Passw"orter der \eisfair-Benutzer verwenden
            \item[server]  - Globale Kennung/Kennwort verwenden
            \item[user\_light]   - wie 'user', jedoch ohne die explizite
                                   Pr"ufung der Absenderdomain.
            \item[server\_light] - wie 'server', jedoch ohne die explizite
                                   Pr"ufung der Absenderdomain.
        \end{description}

        G"ultige Werte: none, user, server, user\_light, server\_light

        Standardeinstellung: \texttt{SMTP\_AUTH\_TYPE='user'}

%%  JED - show this description only in the help file
 %  \config{SMTP\_AUTH\_USER}{SMTP\_AUTH\_USER}{SMTPAUTHUSER}
 %      Soll die globale Kennung verwendet werden (Typ `server'), muss
 %      hier eine globale Benutzerkennung mit einem zugeh"origen Kennwort
 %      angegeben werden.
 %
 %      F"ur jeden anderen Authentifizierungstyp werden diese beiden
 %      Parameter ignoriert und k"onnen daher leer bleiben.
 %
 %      G"ultige Werte: Benutzername bzw. Kennwort
 %
 %      Standardeinstellung:
 %
 %      \texttt{SMTP\_AUTH\_USER=$''$\\
 %              SMTP\_AUTH\_PASS=$''$}
 %

    \index{SMTP\_AUTH\_USER}
    \config{SMTP\_AUTH\_USER / SMTP\_AUTH\_PASS}{SMTP\_AUTH\_PASS}{SMTPAUTHPASS}
        Soll die globale Kennung verwendet werden (Typ `server'), muss
        hier eine globale Benutzerkennung mit einem zugeh"origen Kennwort
        angegeben werden.

        F"ur jeden anderen Authentifizierungstyp werden diese beiden
        Parameter ignoriert und k"onnen daher leer bleiben.

        G"ultige Werte: Benutzername bzw. Kennwort

        Standardeinstellung:

        \texttt{SMTP\_AUTH\_USER=$''$\\
                SMTP\_AUTH\_PASS=$''$}
\end{description}

\index{Smarthost}
\subsection{Ausgehende E-Mail - Smarthost}
%----------------------------------------------------------

    Ausgehende E-Mails werden normalerweise direkt an den E-Mail-Server
    weitergesendet, welcher f"ur die angesprochene Domain als sogenannter
    Mail-Exchanger (MX) im DNS eingetragen ist. Ist jedoch \eisfair
    "uber eine Einwahlverbindung oder einen (V)DSL-Anschluss ohne feste
    IP-Adresse am Internet angeschlossen, kann es vorkommen, dass bestimmte
    Mail-Exchanger die Annahme und Weiterleitung der E-Mail verweigern, da
    im Falle von Einwahlverbindungen oder einem (V)DSL-Anschluss die
    Authentizit"at nicht "uberpr"uft werden kann.

    Deshalb sollte man bei einer dynamischen IP-Adresse (W"ahlverbindung)
    besser einen sogenannten Smarthost angeben, i.a. den E-Mail-Server
    des verwendeten Providers.

\begin{description}
    \config{SMTP\_SMARTHOST\_ONE\_FOR\_ALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL}{SMTPSMARTHOSTONEFORALL}
        Wird dieser Parameter auf `yes' und der Parameter SMTP\_SMARTHOST\_N
        auf `1' gesetzt, so wird jede ausgehende E-Mail "uber ein und den
        selben Smarthost verschickt. Wird dieser Parameter auf `no' gesetzt,
        so kann, entweder abh"angig von der E-Mail-Adresse des Absenders,
        oder der Zieldomain ein anderer Smarthost definiert werden.\\
        Siehe hierzu auch \jump{SMTPSMARTHOSTROUTETYPE}{SMTP\_SMARTHOST\_ROUTE\_TYPE}.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='yes'}

    \config{SMTP\_SMARTHOST\_DOMAINS (ADVANCED-Modus)}{SMTP\_SMARTHOST\_DOMAINS}{SMTPSMARTHOSTDOMAINS}
        "Uber diesen Parameter k"onnen Domains definiert werden, f"ur die
        E-Mails "uber einen Smarthost versandt werden sollen. Alle anderen
        E-Mails werden direkt zugestellt. Dieser Parameter ist nur in
        Funktion, wenn zuvor \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='yes'}
        gesetzt und ein Smarthost "uber \jump{SMTPSMARTHOSTN}{SMTP\_SMARTHOST\_N='1'}
        festgelegt wurde.

        G"ultige Werte: Domainliste

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_DOMAINS=$''$}

     \config{SMTP\_SMARTHOST\_ROUTE\_TYPE (ADVANCED-Modus)}{SMTP\_SMARTHOST\_ROUTE\_TYPE}{SMTPSMARTHOSTROUTETYPE}
        Wurde der Parameter \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'}
        gesetzt und ist die Anzahl der "uber \jump{SMTPSMARTHOSTN}{SMTP\_SMARTHOST\_N}
        definierten Smarthosts gr"o"ser als 1, dann wird "uber diesen Parameter
        festgelegt nach welchem Kriterium ein Smarthost gesucht bzw. gefunden
        werden soll. Zur Auswahl stehen die E-Mail-Absenderadresse eines Anwenders
        oder die E-Mail-Domain an die eine Nachricht geschickt werden kann.

        G"ultige Werte: 'addr' or 'domain'

        Standardeinstellung:  \texttt{SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'}

    \config{SMTP\_SMARTHOST\_N}{SMTP\_SMARTHOST\_N}{SMTPSMARTHOSTN}
        Dieser Parameter gibt die Anzahl der konfigurierten Smarthosts an,
        deren Einstellungen "uber die folgenden Parameter festgelegt werden.
        Wird dieser Parameter auf den Wert `0' gesetzt, so wird immer der
        Mail-Exchanger der jeweils angesprochenen Domain in der E-Mail-Adresse
        verwendet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_N='0'}

    \config{SMTP\_SMARTHOST\_x\_HOST}{SMTP\_SMARTHOST\_x\_HOST}{SMTPSMARTHOSTxHOST}
        "Uber diesen Parameter wird der zu verwendende Smarthost (SMTP-Server)
        festgelegt. Optional ist auch die Angabe eines Backup-Smarthost m"oglich,
        welcher dann durch einen Doppelpunkt getrennt, angegeben werden muss.

        G"ultige Werte: vollst"andiger SMTP-Hostname

        Beispiel: \texttt{SMTP\_SMARTHOST\_1\_HOST='mail.gmx.net'}

    \config{SMTP\_SMARTHOST\_x\_PORT (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_PORT}{SMTPSMARTHOSTxPORT}
        "Uber diesen Parameter wird festgelegt welcher TCP-Port f"ur ausgehende
        Verbindungen genutzt werden soll. Wird der Parameter `uucp' gesetzt, so
        wird bei installiertem uucp-Paket dieses zum Mailtransfer verwendet.
        Wird nichts angegeben, so wird 'smtp' verwendet.

        G"ultige Werte: TCP-Portname (smtp, uucp usw.) bzw. Nummer

        Standardeinstellung:  \texttt{SMTP\_SMARTHOST\_1\_PORT=$''$}

    \config{SMTP\_SMARTHOST\_x\_AUTH\_TYPE}{SMTP\_SMARTHOST\_x\_AUTH\_TYPE}{SMTPSMARTHOSTxAUTHTYPE}
        Die meisten E-Mail-Server verlangen eine Anmeldung (Authentifizierung),
        z.B.  die E-Mail-Server eines ISPs. Hier kann eingestellt werden, welche
        Form der Kennwort"ubertragung gew"ahlt werden soll:

        \begin{description}
            \item[none]     - keine besondere Anmeldung
            \item[md5]      - Anmeldung "uber MD5-verschl"usseltes Kennwort
            \item[login]    - Unverschl"usselte "Ubertragung (meist von MS-Servern
                              verwendet)
            \item[plain]    - Unverschl"usselte "Ubertragung: Standard
        \end{description}

        G"ultige Werte: none, md5, login, plain

        Der Typ der Authentifizierung kann sehr leicht herausgefunden
        werden, und zwar fragt man dazu den E-Mail-Server selbst, wie
        er es denn gerne am liebsten h"atte. Am Beispiel von GMX sieht
        das beispielsweise folgenderma"sen aus:

        \begin{verbatim}
hydra joerg $ telnet mail.gmx.de smtp
Trying 213.165.65.60...
Connected to mail.gmx.de.
Escape character is '^]'.
220 {mp003-rz3} GMX Mailservices ESMTP
EHLO www.microsoft.de
250-{mp003-rz3} GMX Mailservices
250-AUTH=LOGIN CRAM-MD5 PLAIN
250-AUTH LOGIN CRAM-MD5 PLAIN
250-PIPELINING
250 8BITMIME
QUIT
221 {mp003-rz3} GMX Mailservices
Connection closed by foreign host.
        \end{verbatim}

        Daraus ist sofort zu ersehen, dass GMX die Methoden 'login',
        'cram-md5' und 'plain' unterst"utzt, wobei md5 oder login zu
        favorisieren sind.

    \config{SMTP\_SMARTHOST\_x\_ADDR (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_ADDR}{SMTPSMARTHOSTxADDR}
        Wurde der Parameter \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'}
        gesetzt und ist die Anzahl der "uber \jump{SMTPSMARTHOSTN}{SMTP\_SMARTHOST\_N}
        definierten Smarthosts gr"o"ser 1, dann muss "uber diesen Parameter
        jeweils die E-Mail-Adresse des Absenders konfiguriert werden dessen
        E-Mail "uber den zugeh"origen Smarthost geschickt werden soll. Wird
        einmalig nur ein `*' eingetragen, so wird hierdurch ein Standardeintrag
        konfiguriert, der verwendet wird wenn kein passender Adresseintrag
        gefunden wurde.

        G"ultige Werte: E-Mail-Adresse

        Beispiel: \texttt{SMTP\_SMARTHOST\_1\_ADDR='user@local.lan'}

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_1\_ADDR=$''$}

    \config{SMTP\_SMARTHOST\_x\_DOMAIN (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_DOMAIN}{SMTPSMARTHOSTxDOMAIN}
        "Uber diesen Parameter wird die E-Mail-Domain konfiguriert, deren
        Nachrichten "uber einen dedizierten Smarthost geschickt werden sollen.
        Wird einmalig nur ein `*' eingetragen, so wird hierdurch ein
        Standardeintrag konfiguriert, der verwendet wird wenn keine passende
        Domain gefunden wurde.\\
        Voraussetzung f"ur die Verwendung dieses Parameters ist, dass die Parameter\\
        \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'} und\\
        \jump{SMTPSMARTHOSTROUTETYPE}{SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'}
        gesetzt und die Anzahl der "uber SMTP\_SMARTHOST\_N definierten Smarthosts
        gr"o"ser 1 ist.

        G"ultige Werte: Domainname oder `*'

        Beispiel: \texttt{SMTP\_SMARTHOST\_1\_DOMAIN='local.lan'}

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_1\_DOMAIN=$''$}

%%  JED - show this description only in the help file
 %  \config{SMTP\_SMARTHOST\_x\_USER}{SMTP\_SMARTHOST\_x\_USER}{SMTPSMARTHOSTxUSER}
 %      Wird eine Anmeldung verlangt bevor E-Mails an den Smarthost "ubertragen
 %      werden d"urfen, so kann "uber diese Parameter die Benutzerkennung und
 %      das Kennwort festgelegt werden. Bei \jump{SMTPSMARTHOSTxAUTHTYPE}{SMTP\_SMARTHOST\_x\_AUTH\_TYPE}='none'
 %      werden diese Variablen ignoriert.
 %
 %      G"ultige Werte: Benutzername bzw. Kennwort
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
 %              SMTP\_SMARTHOST\_1\_USER='ichbins'\\
 %              SMTP\_SMARTHOST\_1\_PASS='geheim'}

    \index{SMTP\_SMARTHOST\_x\_USER}
    \config{SMTP\_SMARTHOST\_x\_USER / SMTP\_SMARTHOST\_x\_PASS}{SMTP\_SMARTHOST\_x\_PASS}{SMTPSMARTHOSTxPASS}
        Wird eine Anmeldung verlangt bevor E-Mails an den Smarthost "ubertragen
        werden d"urfen, so kann "uber diese Parameter die Benutzerkennung und
        das Kennwort festgelegt werden. Bei \jump{SMTPSMARTHOSTxAUTHTYPE}{SMTP\_SMARTHOST\_x\_AUTH\_TYPE}='none'
        werden diese Variablen ignoriert.

        G"ultige Werte: Benutzername bzw. Kennwort

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
                SMTP\_SMARTHOST\_1\_USER='ichbins'\\
                SMTP\_SMARTHOST\_1\_PASS='geheim'}

    \config{SMTP\_SMARTHOST\_x\_FORCE\_AUTH (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_FORCE\_AUTH}{SMTPSMARTHOSTxFORCEAUTH}
        Wird dieser Parameter auf `yes' gesetzt, so werden nur nach einer
        erfolgreichen Authentifizierung E-Mails zum entfernten SMTP-Server
        "ubertragen, ansonsten schl"agt eine "Ubermittlung fehl.
        Wird der Parameter auf `no' gesetzt, so wird zwar eine
        Authentifizierung versucht, jedoch f"uhrt ein Fehlschlag nicht
        zum Abbruch der "Ubermittlung, da diese dann ohne Authentifizierung
        erfolgt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_1\_FORCE\_AUTH='no'}

    \config{SMTP\_SMARTHOST\_x\_FORCE\_TLS (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_FORCE\_TLS}{SMTPSMARTHOSTxFORCETLS}
        Wenn ein entfernter SMTP-Server angibt TLS zu unterst"utzen
        (STARTTLS), so wird bei gesetztem Parameter `yes' versucht
        eine sichere Verbindung zum entfernten SMTP-Server aufzubauen.
        Hierzu wird das Server-Zertifikat mit dem lokal gespeicherten
        Zertifikat verglichen. Bei einer "Ubereinstimmung findet eine
        "Ubermittlung von E-Mails zum entfernten SMTP-Server statt,
        ansonsten wird die Verbindung unterbrochen. Dieser Parameter
        sollte nur aktiviert werden, wenn man vorher Server- und
        Root-Zertifikate im Verzeichnis /usr/local/ssl/certs abgelegt
        hat und zugeh"orige Hash-Werte generiert hat.\\
        Wenn ein entfernter SMTP-Server angibt TLS zu unterst"utzen
        (STARTTLS), so wird bei gesetztem Parameter `no' versucht
        eine sichere Verbindung zum entfernten SMTP-Server aufzubauen.
        Schl"agt der Aufbau einer gesicherten Verbindung fehl, so wird
        versucht die "Ubermittlung von E-Mails "uber eine ungesicherte
        Verbindung fortzusetzen.\\
        Wenn ein entfernter SMTP-Server angibt TLS zu unterst"utzen
        (STARTTLS), so wird bei gesetztem Parameter `ignore' nicht
        versucht eine sichere Verbindung zum entfernten SMTP-Server
        aufzubauen sondern einzig die "Ubermittlung von E-Mails "uber
        eine ungesicherte Verbindung versucht.

        G"ultige Werte: yes, no, ignore

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_1\_FORCE\_TLS='no'}

    \config{SMTP\_SMARTHOST\_x\_FORCE\_OCSP (ADVANCED-Modus)}{SMTP\_SMARTHOST\_x\_FORCE\_OCSP}{SMTPSMARTHOSTxFORCEOCSP}
        Wenn der Parameter \jump{SMTPSMARTHOSTxFORCETLS}{SMTP\_SMARTHOST\_x\_FORCE\_TLS='yes'}
        f"ur einen entfernten SMTP-Server gesetzt wurde der das OCSP-Stapling
        unterst"utzt, so kann mittels dieses Parameters darauf bestanden werden,
        dass nur bei einer erfolgreichen Pr"ufung der bereitgestellten
        OCSP-Informationen eine Verbindung aufgebaut wird. Im Fehlerfall
        wird eine ausgehende Verbindung sofort beendet.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_SMARTHOST\_1\_FORCE\_OCSP='no'}
\end{description}


    Es ergeben sich nunmehr f"unf verschiedene Smarthost-Varianten die
    an Hand von Beispielen im Folgenden kurz beschrieben werden:

    \begin{itemize}
        \item[1] Es wird kein Smarthost verwendet, alle E-Mails werden
                 direkt zugestellt.

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='yes'\\
                SMTP\_SMARTHOST\_DOMAINS=$''$\\
                SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'\\
                \\
                SMTP\_SMARTHOST\_N='0'}

        \item[2] Es wird ein Smarthost, normalerweise der des ISP, f"ur
                 die Zustellung der E-Mails verwendet.

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='yes'\\
                SMTP\_SMARTHOST\_DOMAINS=$''$\\
                SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'\\
                \\
                SMTP\_SMARTHOST\_N='1'\\
                SMTP\_SMARTHOST\_1\_ADDR=$''$\\
                SMTP\_SMARTHOST\_1\_DOMAIN=$''$\\
                SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
                SMTP\_SMARTHOST\_1\_HOST='mail.epost.de'\\
                SMTP\_SMARTHOST\_1\_USER='userid1'\\
                SMTP\_SMARTHOST\_1\_PASS='passwd1'}

        \item[3] Es wird nur f"ur E-Mails an die angegebene Domain ein
                 Smarthost verwendet, alle anderen E-Mails werden direkt
                 zugestellt.

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='yes'\\
                SMTP\_SMARTHOST\_DOMAINS='t-online.de'\\
                SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'\\
                \\
                SMTP\_SMARTHOST\_N='1'\\
                SMTP\_SMARTHOST\_1\_ADDR=$''$\\
                SMTP\_SMARTHOST\_1\_DOMAIN=$''$\\
                SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
                SMTP\_SMARTHOST\_1\_HOST='mail.epost.de'\\
                SMTP\_SMARTHOST\_1\_USER='userid1'\\
                SMTP\_SMARTHOST\_1\_PASS='passwd1'}

        \item[4] Es werden f"ur verschiedene Ziel-Domains jeweils unterschiedliche
                 Smarthosts verwendet.

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'\\
                SMTP\_SMARTHOST\_DOMAINS=$''$\\
                SMTP\_SMARTHOST\_ROUTE\_TYPE='domain'\\
                \\
                SMTP\_SMARTHOST\_N='2'\\
                SMTP\_SMARTHOST\_1\_ADDR=$''$\\
                SMTP\_SMARTHOST\_1\_DOMAIN='aol.com'\\
                SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
                SMTP\_SMARTHOST\_1\_HOST='mail.epost.de'\\
                SMTP\_SMARTHOST\_1\_USER='userid1'\\
                SMTP\_SMARTHOST\_1\_PASS='passwd1'\\
                \\
                SMTP\_SMARTHOST\_2\_ADDR=$''$\\
                SMTP\_SMARTHOST\_2\_DOMAIN='t-online.de'\\
                SMTP\_SMARTHOST\_2\_AUTH\_TYPE='login'\\
                SMTP\_SMARTHOST\_2\_HOST='smtp.gmx.net'\\
                SMTP\_SMARTHOST\_2\_USER='userid2'\\
                SMTP\_SMARTHOST\_2\_PASS='passwd2'}

        \item[5] Es wird f"ur jeden lokalen Mail-Anwender ein eigener
                 Smarthost verwendet.

        Beispiel:

        \texttt{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'\\
                SMTP\_SMARTHOST\_DOMAINS=$''$\\
                SMTP\_SMARTHOST\_ROUTE\_TYPE='addr'\\
                \\
                SMTP\_SMARTHOST\_N='2'\\
                SMTP\_SMARTHOST\_1\_ADDR='user1@local.lan'\\
                SMTP\_SMARTHOST\_1\_DOMAIN=$''$\\
                SMTP\_SMARTHOST\_1\_AUTH\_TYPE='md5'\\
                SMTP\_SMARTHOST\_1\_HOST='mail.epost.de'\\
                SMTP\_SMARTHOST\_1\_USER='userid1'\\
                SMTP\_SMARTHOST\_1\_PASS='passwd1'\\
                \\
                SMTP\_SMARTHOST\_2\_ADDR='user2@local.lan'\\
                SMTP\_SMARTHOST\_2\_DOMAIN=$''$\\
                SMTP\_SMARTHOST\_2\_AUTH\_TYPE='login'\\
                SMTP\_SMARTHOST\_2\_HOST='smtp.gmx.net'\\
                SMTP\_SMARTHOST\_2\_USER='userid2'\\
                SMTP\_SMARTHOST\_2\_PASS='passwd2'}
    \end{itemize}

\begin{description}
    \config{SMTP\_UPDATE\_IGNORE\_HOSTS (ADVANCED-Modus)}{SMTP\_UPDATE\_IGNORE\_HOSTS}{SMTPUPDATEIGNOREHOSTS}
        Wird dieser Parameter auf 'yes' gesetzt und der Parameter
        \jump{SMTPSMARTHOSTONEFORALL}{SMTP\_SMARTHOST\_ONE\_FOR\_ALL='no'}
        wurde gesetzt, so wird in regelm"a"sigen Intervallen die Liste deri
        TLD's (top level domains) aktualisiert, f"ur die Wildcard-DNS-Eintr"age
        gesetzt wurden. Hierdurch wird verhindert, dass E-Mail an nicht
        existierende Domains an die jeweiligen Wildcard-DNS-Hosts "ubermittelt
        wird. Zus"atzliche Informationen sind u.a. hier zu finden:
        \url{http://CERT.Uni-Stuttgart.DE/ticker/article.php?mid=1145}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{SMTP\_UPDATE\_IGNORE\_HOSTS='no'}

    \config{SMTP\_UPDATE\_IGNORE\_HOSTS\_CRON\_SCHEDULE (ADVANCED-Modus)}{SMTP\_UPDATE\_IGNORE\_HOSTS\_CRON\_SCHEDULE}{SMTPUPDATEIGNOREHOSTSCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall
        eine "Uberpr"ufung der zu ignorierenden Hosts durchgef"uhrt werden
        soll, die Wildcard-TLDs darstellen. Diese Funktion ist nur verf"ugbar,
        wenn die Parameter \jump{SMTPUPDATEIGNOREHOSTS}{SMTP\_UPDATE\_IGNORE\_HOSTS='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 jeweils am Sonntag um 01:05h
        die Liste aktualisiert. 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{SMTP\_UPDATE\_IGNORE\_HOSTS\_CRON\_SCHEDULE='5 1 * * 0'}
\end{description}


\subsection{Die Aliasnamen}
%--------------------------

    "Uber Aliases k"onnen E-Mail-Adressen konfiguriert werden, "uber welche
    E-Mails lediglich an andere Benutzer oder Benutzergruppen weitergeleitet
    werden sollen.

    Damit kann ein Benutzer mehrere E-Mail-Adressen haben. Auch kann damit
    eine Weiterleitung eingestellt werden.

\begin{description}
%%  JED - show this description only in the help file
 %  \config{SMTP\_ALIASES\_N}{SMTP\_ALIASES\_N}{SMTPALIASESN}
 %      Die Anzahl der E-Mail-Domains f"ur die Aliasse vergeben werden sollen
 %      wird "uber den Parameter SMTP\_ALIASES\_N festgelegt. Sollte jemand
 %      mehrere sogenannte virtuelle Domains hosten und abh"angig von der
 %      Domain unterschiedliche Aliaseintr"age f"ur z.B. gleichlautende Benutzer
 %      konfigurieren wollen, so muss dieser Z"ahler entsprechend erh"oht und
 %      "uber den Parameter SMTP\_ALIASES\_x\_DOMAIN die einzelnen Domains
 %      konfiguriert werden.
 %
 %      G"ultige Werte: Zahl bzw. E-Mail-Domain
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_ALIASES\_N='2'\\
 %              SMTP\_ALIASES\_1\_DOMAIN='domain1.de'\\
 %              \ldots\\
 %              \# E-Mail an support@domain1.de soll an den lokalen\\
 %              \# Benutzer 'werner' weitergeleitet werden.\\
 %              SMTP\_ALIASES\_1\_ALIAS\_2='support:  werner'\\
 %              \\
 %              SMTP\_ALIASES\_2\_DOMAIN='domain2.de'\\
 %              \ldots\\
 %              \# E-Mail an support@domain2.de soll an den lokalen\\
 %              \# Benutzer 'hubert' weitergeleitet werden.\\
 %              SMTP\_ALIASES\_2\_ALIAS\_y='support:  hubert'}

    \index{SMTP\_ALIASES\_N}
    \config{SMTP\_ALIASES\_N / SMTP\_ALIASES\_x\_DOMAIN (ADVANCED-Modus)}{SMTP\_ALIASES\_x\_DOMAIN}{SMTPALIASESxDOMAIN}
        Die Anzahl der E-Mail-Domains f"ur die Aliasse vergeben werden sollen
        wird "uber den Parameter SMTP\_ALIASES\_N festgelegt. Sollte jemand
        mehrere sogenannte virtuelle Domains hosten und abh"angig von der
        Domain unterschiedliche Aliaseintr"age f"ur z.B. gleichlautende Benutzer
        konfigurieren wollen, so muss dieser Z"ahler entsprechend erh"oht und
        "uber den Parameter SMTP\_ALIASES\_x\_DOMAIN die einzelnen Domains
        konfiguriert werden.

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

        Beispiel:

        \texttt{SMTP\_ALIASES\_N='2'\\
                SMTP\_ALIASES\_1\_DOMAIN='domain1.de'\\
                \ldots\\
                \# E-Mail an support@domain1.de soll an den lokalen\\
                \# Benutzer 'werner' weitergeleitet werden.\\
                SMTP\_ALIASES\_1\_ALIAS\_2='support:  werner'\\
                \\
                SMTP\_ALIASES\_2\_DOMAIN='domain2.de'\\
                \ldots\\
                \# E-Mail an support@domain2.de soll an den lokalen\\
                \# Benutzer 'hubert' weitergeleitet werden.\\
                SMTP\_ALIASES\_2\_ALIAS\_y='support:  hubert'}

%%  JED - show this description only in the help file
 %  \config{SMTP\_ALIASES\_x\_ALIAS\_N}{SMTP\_ALIASES\_x\_ALIAS\_N}{SMTPALIASESxALIASN}
 %      Die Anzahl der Alias- Eintr"age pro Domain wird "uber den Parameter
 %      SMTP\_ALIASES\_x\_ALIAS\_N angegeben und "uber den Parameter
 %      SMTP\_ALIASES\_x\_ALIAS\_y wird jeweils der y-ten Aliaseintrag
 %      festgelegt. Angegebene wird die E-Mail-Adresse von einem lokalen
 %      oder entfernten Anwender an den die Nachricht weitergeleitet
 %      werden soll.
 %
 %      Format von SMTP\_ALIASES\_x\_ALIAS\_x:
 %
 %      \texttt{Zieladresse: Weiterleitung,[Weiterleitung[,Weiterleitung \ldots]]}
 %
 %      Es kann also auch ein Verteiler angegeben werden. Dabei sind die
 %      einzelnen E-Mail-Adressen oder lokale Benutzer durch ein Komma zu
 %      trennen - ohne Leerzeichen!
 %
 %      Beispiel:
 %
 %  \begin{verbatim}
 % `frank: fm@foo.bar'      # Mails, die an frank@xxx geschickt werden,
 %                          # werden an die E-Mail-Adresse fm@foo.bar
 %                          # weitergeleitet.
 %
 % `info: chef,fm@foo.bar'  # Mails, die an info@xxx geschickt werden,
 %                          # werden an den lokalen Benutzer chef und
 %                          # die entfernte Adresse fm@foo.bar
 %                          # weitergeleitet.
 %  \end{verbatim}
 %
 %      Eine Weiterleitung kann auch wieder ein anderer Alias sein, siehe
 %      auch folgendes Beispiel:
 %
 %  \begin{verbatim}
 % `frank: fm'              # Mails, die an frank@xxx geschickt werden,
 %                          # werden an den lokalen Benutzer fm
 %                          # weitergeleitet.
 %
 % `info: chef,frank'       # Mails, die an info@xxx geschickt werden,
 %                          # werden an die lokalen Benutzer chef und
 %                          # frank weitergeleitet, wobei frank wiederum
 %                          # durch den lokalen Benutzer fm ersetzt wird
 %                          # (s.o.!)
 %  \end{verbatim}
 %
 %       Es muss auf jeden Fall als erstes ein Alias f"ur den root-Benutzer
 %      konfiguriert werden, sodass vom \eisfair-Server generierte E-Mails auch
 %      ans Ziel kommen. Im Beispiel werden alle E-Mails f"ur den root-Benutzer
 %      an den lokalen Anwender `frank' weitergeleitet.
 %
 %      G"ultige Werte: Zahl bzw. Text
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_ALIASES\_1\_ALIAS\_N='1'\\
 %              SMTP\_ALIASES\_1\_ALIAS\_1='root: frank'}

    \index{SMTP\_ALIASES\_x\_ALIAS\_N}
    \config{SMTP\_ALIASES\_x\_ALIAS\_N / SMTP\_ALIASES\_x\_ALIAS\_y}{SMTP\_ALIASES\_x\_ALIAS\_y}{SMTPALIASESxALIASy}
        Die Anzahl der Alias- Eintr"age pro Domain wird "uber den Parameter
        SMTP\_ALIASES\_x\_ALIAS\_N angegeben und "uber den Parameter
        SMTP\_ALIASES\_x\_ALIAS\_y wird jeweils der y-ten Aliaseintrag
        festgelegt. Angegebene wird die E-Mail-Adresse von einem lokalen
        oder entfernten Anwender an den die Nachricht weitergeleitet
        werden soll.

        Format von SMTP\_ALIASES\_x\_ALIAS\_x:

        \texttt{Zieladresse: Weiterleitung,[Weiterleitung[,Weiterleitung \ldots]]}

        Es kann also auch ein Verteiler angegeben werden. Dabei sind die
        einzelnen E-Mail-Adressen oder lokale Benutzer durch ein Komma zu
        trennen - ohne Leerzeichen!

        Beispiel:

    \begin{verbatim}
`frank: fm@foo.bar'      # Mails, die an frank@xxx geschickt werden,
                         # werden an die E-Mail-Adresse fm@foo.bar
                         # weitergeleitet.

`info: chef,fm@foo.bar'  # Mails, die an info@xxx geschickt werden,
                         # werden an den lokalen Benutzer chef und
                         # die entfernte Adresse fm@foo.bar
                         # weitergeleitet.
    \end{verbatim}

        Eine Weiterleitung kann auch wieder ein anderer Alias sein, siehe
        auch folgendes Beispiel:

    \begin{verbatim}
`frank: fm'              # Mails, die an frank@xxx geschickt werden,
                         # werden an den lokalen Benutzer fm
                         # weitergeleitet.

`info: chef,frank'       # Mails, die an info@xxx geschickt werden,
                         # werden an die lokalen Benutzer chef und
                         # frank weitergeleitet, wobei frank wiederum
                         # durch den lokalen Benutzer fm ersetzt wird
                         # (s.o.!)
    \end{verbatim}

        Es muss auf jeden Fall als erstes ein Alias f"ur den root-Benutzer
        konfiguriert werden, sodass vom \eisfair-Server generierte E-Mails auch
        ans Ziel kommen. Im Beispiel werden alle E-Mails f"ur den root-Benutzer
        an den lokalen Anwender `frank' weitergeleitet.

        G"ultige Werte: Zahl bzw. Text

        Beispiel:

        \texttt{SMTP\_ALIASES\_1\_ALIAS\_N='1'\\
                SMTP\_ALIASES\_1\_ALIAS\_1='root: frank'}
\end{description}


\subsection{Das Umschreiben des E-Mail-Kopfes bei Verwendung von Smarthost}
%-------------------------------------------------------------------------

    Diese Parameter stehen nur zur Verf"ugung, wenn ein Smarthost
    verwendet wird. Ist dies nicht der Fall werden die vorgenommenen
    Einstellung ignoriert.

    Verwendet man im lokalen Netz z.B. die Domain `lokaledomain.lan'
    und m"ochte alle ausgehende E-Mail "uber den E-Mail-Server seines
    Providers (Domain: domain.de) versenden, so treten Probleme auf,
    da die Domain `lokaledomain.lan' au"serhalb des lokalen Netzes
    nicht bekannt ist. Ein weiteres Problem stellt sich ein, wenn
    der SMTP-Server des Providers eine Authentifizierung verlangt
    und hierf"ur zwingend die eigene Domain `domain.de' abfragt.

\begin{description}
%%  JED - show this description only in the help file
 %  \config{SMTP\_OUTGOING\_ADDRESSES\_N}{ SMTP\_OUTGOING\_ADDRESSES\_N}{ SMTPOUTGOINGADDRESSESN}
 %      "Uber den Parameter SMTP\_OUTGOING\_ADDRESSES\_N gibt man die Anzahl
 %      der "uber die Parameter SMTP\_OUTGOING\_ADDRESSES\_x konfigurierten
 %      Adresszuordnungen an. Im angegebenen Beispiel wird eine E-Mail,
 %      welche als Absenderadresse `fm@lokaledomain.lan' enth"alt mit
 %      der extern bekannten Adresse `frank@domain.de' versehen.
 %
 %      G"ultige Werte: Zahl bzw. Text
 %
 %      Standardeinstellung: SMTP\_OUTGOING\_ADDRESSES\_N='0'
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_OUTGOING\_ADDRESSES\_N='2'\\
 %              SMTP\_OUTGOING\_ADDRESSES\_1='fm:    frank@domain.de'\\
 %              SMTP\_OUTGOING\_ADDRESSES\_2='tm:    tom@domain.de'}

    \index{SMTP\_OUTGOING\_ADRESSES\_N}
    \config{SMTP\_OUTGOING\_ADDRESSES\_N / SMTP\_OUTGOING\_ADDRESSES\_x}{SMTP\_OUTGOING\_ADDRESSES\_x}{SMTPOUTGOINGADDRESSESx}
        "Uber den Parameter SMTP\_OUTGOING\_ADDRESSES\_N gibt man die Anzahl
        der "uber die Parameter SMTP\_OUTGOING\_ADDRESSES\_x konfigurierten
        Adresszuordnungen an. Im angegebenen Beispiel wird eine E-Mail,
        welche als Absenderadresse `fm@lokaledomain.lan' enth"alt mit
        der extern bekannten Adresse `frank@domain.de' versehen.

        G"ultige Werte: Zahl bzw. Text

        Standardeinstellung: SMTP\_OUTGOING\_ADDRESSES\_N='0'

        Beispiel:

        \texttt{SMTP\_OUTGOING\_ADDRESSES\_N='2'\\
                SMTP\_OUTGOING\_ADDRESSES\_1='fm:    frank@domain.de'\\
                SMTP\_OUTGOING\_ADDRESSES\_2='tm:    tom@domain.de'}
\end{description}

\subsection{Das Umschreiben von E-Mail-K"opfen bei Verwendung von Sub-Domains}
%-----------------------------------------------------------------------------

    Werden zum Beispiel in einem LAN mehrere Mail-Hosts hinter
    einem Firewall betrieben, die mit der `Au"senwelt' "uber einen
    gemeinsamen Gateway kommunizieren, so muss dieser die Mail-
    Adressen umschreiben. Denkbar ist auch die M"oglichkeit,
    dass der Gateway den lokalen Teil der Anwender beim Versenden
    umschreibt.

\begin{description}
    \config{SMTP\_HEADER\_REWRITE\_N}{SMTP\_HEADER\_REWRITE\_N}{SMTPHEADERREWRITEN}
        "Uber diesen Parameter wird die Anzahl der konfigurierten
        Umschreibregeln angegeben.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_HEADER\_REWRITE\_N='0'}

    \config{SMTP\_HEADER\_REWRITE\_x\_SOURCE}{SMTP\_HEADER\_REWRITE\_x\_SOURCE}{SMTPHEADERREWRITExSOURCE}
        "Uber diesen Parameter wird festgelegt, wann die Umschreibregel
        greifen soll. Im angegeben Beispiel ist dies der Fall, sobald
        Eine Adresse von der Domain `*@eiszeit.domain.de' von dem
        SMTP-Server entgegen genommen wird.

        G"ultige Werte: Text

        Beispiel: \texttt{SMTP\_HEADER\_REWRITE\_1\_SOURCE='*@eiszeit.domain.de'}

    \config{SMTP\_HEADER\_REWRITE\_x\_DESTINATION}{SMTP\_HEADER\_REWRITE\_x\_DESTINATION}{SMTPHEADERREWRITExDESTINATION}
        "Uber diesen Parameter wird festgelegt, in was die E-Mail-Adresse
        umgeschrieben werden soll. Im angegeben Beispiel wird der lokale
        Teil der Adresse beibehalten und nur der Domain-Anteil in
        `domain.de' ge"andert.

        G"ultige Werte: Text

        Beispiel: \texttt{SMTP\_HEADER\_REWRITE\_1\_DESTINATION='\$1@domain.de'}

    \config{SMTP\_HEADER\_REWRITE\_x\_FLAGS}{SMTP\_HEADER\_REWRITE\_x\_FLAGS}{SMTPHEADERREWRITExFLAGS}
        "Uber diesen Parameter wird festgelegt welche Felder im
        Nachrichtenumschlag (Envelope) bzw. Nachrichtenkopf (Header)
        umgeschrieben werden sollen. Eine Nachrichten ist strukturell
        wie folgt aufgebaut:

    \begin{verbatim}
+-nicht sichtbar------------------+
| Nachrichtenumschlag (Envelope)  |
| Felder: E, F, T                 |
|                                 |
| +-sichtbar--------------------+ |
| | Nachrichtenkopf (Header)    | |
| | Felder: b, c, f, h, r, s, t | |
| |                             | |
| | Nachrichtentext ...         | |
| |                             | |
| |                             | |
| +-----------------------------+ |
+---------------------------------+
    \end{verbatim}

        Es kann eine Kombinationen aus den folgenden Kennzeichnern verwendet werden:

        \begin{description}
            \item[E] - alle Felder im E-Mail-Nachrichtenumschlag
            \item[F] - das From-Feld im E-Mail-Nachrichtenumschlag
            \item[T] - das To-Feld im E-Mail-Nachrichtenumschlag
            \item[b] - das Bcc-Feld im Nchrichtenkopf
            \item[c] - das Cc-Feld im Nchrichtenkopf
            \item[f] - das From-Feld im Nchrichtenkopf
            \item[h] - alle Felder im Nchrichtenkopf
            \item[r] - das Reply-To-Feld im Nchrichtenkopf
            \item[s] - das Sender-Feld im Nchrichtenkopf
            \item[t] - das To-Feld im Nchrichtenkopf
        \end{description}

        Im angegebenen Beispiel wird die definierte Regel auf das
        From-Feld im E-Mail-Nachrichtenumschlag und das Sender-Feld
        im E-Mail-Nachrichtenkopf angewendet.

        G"ultige Werte: Text

        Beispiel: \texttt{SMTP\_HEADER\_REWRITE\_1\_FLAGS='sF'}
\end{description}

\subsection{Die Mailinglisten}
%-----------------------------

    Mailinglisten bieten die M"oglichkeit, E-Mails an eine ganze Gruppe
    von Benutzern zu schicken. Der Unterschied zu Aliasse ist aber,
    dass als Antwortadresse immer die E-Mail-Adresse der Mailingliste
    eingetragen wird. So kann eine Gruppe innerhalb der Mailingliste
    "uber ein bestimmtes Thema (das Thema der Gruppe halt) diskutieren.


\begin{description}

    \config{SMTP\_LIST\_N}{SMTP\_LIST\_N}{SMTPLISTN}
        Anzahl der Mailinglisten. Ist diese `0', werden alle folgenden
        Variablen ignoriert.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{SMTP\_LIST\_N='0'}

    \config{SMTP\_LIST\_x\_NAME}{SMTP\_LIST\_x\_NAME}{SMTPLISTxNAME}
        Name der Mailingliste. Dies ist dann auch automatisch die
        E-Mail-Adresse. Anzugeben ist hier nicht die komplette Adresse,
        sondern lediglich der Teil vor dem `@'-Zeichen. Die Domain
        (also der Teil hinter dem `@'-Zeichen) wird "uber
        SMTP\_LIST\_DOMAIN eingestellt, s.u.

        G"ultige Werte: Text

        Beispiel: \texttt{SMTP\_LIST\_1\_NAME='eisfair'}

    \config{SMTP\_LIST\_x\_ACTIVE}{SMTP\_LIST\_x\_ACTIVE}{SMTPLISTxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der
        zugeh"orige Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{SMTP\_LIST\_1\_ACTIVE='no'}

%%  JED - show this description only in the help file
 %  \config{SMTP\_LIST\_x\_USER\_N}{SMTP\_LIST\_x\_USER\_N}{SMTPLISTxUSERN}
 %      Anzahl der Benutzer innerhalb einer Liste und die Aufz"ahlung
 %      der Mitglieder (Members) einer Liste. Hier m"ussen
 %      vollst"andige E-Mail-Adressen eingetragen werden.
 %
 %      G"ultige Werte: Zahl bzw. Text
 %
 %      Beispiel:
 %
 %      \texttt{SMTP\_LIST\_1\_USER\_N='2'\\
 %              SMTP\_LIST\_1\_USER\_1='frank@foo.bar'\\
 %              SMTP\_LIST\_1\_USER\_2='joe@bar.foo'}

    \index{SMTP\_LIST\_x\_USER\_N}
    \config{SMTP\_LIST\_x\_USER\_N / SMTP\_LIST\_x\_USER\_y}{SMTP\_LIST\_x\_USER\_y}{SMTPLISTxUSERy}
        Anzahl der Benutzer innerhalb einer Liste und die Aufz"ahlung
        der Mitglieder (Members) einer Liste. Hier m"ussen
        vollst"andige E-Mail-Adressen eingetragen werden.

        G"ultige Werte: Zahl bzw. Text

        Beispiel:

        \texttt{SMTP\_LIST\_1\_USER\_N='2'\\
                SMTP\_LIST\_1\_USER\_1='frank@foo.bar'\\
                SMTP\_LIST\_1\_USER\_2='joe@bar.foo'}

    \config{SMTP\_LIST\_DOMAIN}{SMTP\_LIST\_DOMAIN}{SMTPLISTDOMAIN}
        Hier ist die Domain einzutragen. Dies ist der Teil hinter
        dem `@'-Zeichen der Listen-E-Mail-Adresse.

        G"ultige Werte: Domainname

        Beispiel: \texttt{SMTP\_LIST\_DOMAIN='domain.de'}

        Damit w"are dann eine g"ultige Listen-E-Mail-Adresse
        eisfair@domain.de.

    \config{SMTP\_LIST\_ERRORS}{SMTP\_LIST\_ERRORS}{SMTPLISTERRORS}
        E-Mail-Adresse, an welche Fehlermeldungen bzgl. Mailinglisten
        geschickt werden sollen - wie z.B. unzustellbare E-Mail.

        G"ultige Werte: E-Mail-Adresse

        Beispiel: \texttt{SMTP\_LIST\_ERRORS='joe@foo.bar'}
\end{description}

\subsection{Die Filterfunktionen (Virus/Spam/Regex/Erweiterungen)}
%-----------------------------------------------------------------

    Das dem Mail-Paket zu Grunde liegende Programm Exim wurde durch
    die Zusatzkomponente Exiscan `veredelt'. Hierdurch ist es m"oglich
    die zu verarbeitenden E-Mails direkt auf eventuell vorhandene Viren
    zu pr"ufen und entsprechende Schritte einzuleiten. F"ur die Pr"ufung
    wird auf ebenfalls zu installierende Dritt-Software zur"uckgegriffen.

\begin{description}
    \config{START\_EXISCAN}{START\_EXISCAN}{STARTEXISCAN}
        Wird dieser Parameter auf `yes' gesetzt, so wird die "Uberpr"ufung
        auf E-Mail-Viren aktiviert. Bei gesetztem Wert `no' werden alle
        Folgeparameter ignoriert.

        G"ultige Werte: yes, no

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

    \config{EXISCAN\_ACTION\_ON\_FAILURE}{EXISCAN\_ACTION\_ON\_FAILURE}{EXISCANACTIONONFAILURE}
        "Uber diesen Parameter legt man fest wie eingehende Nachrichten
        behandelt werden sollen, wenn nicht auf einen konfigurierten
        Malware- oder Spam-Scanner zugegriffen werden kann.

    \begin{description}
        \item[defer] - Die E-Mail wird mit einem tempor"aren Fehler
                       (4xx-Fehler) abgewiesen, sodass ein entfernter
                       E-Mail-Server nach einiger Zeit einen erneuten
                       Zustellversuch unternimmt.

        \item[drop]  - Die E-Mail wird mit einem permanenten Fehler
                       (5xx-Fehler) abgewiesen, sodass die Nachricht
                       an den Versender zur"uck geschickt wird, ohne
                       dass ein entfernter E-Mail-Server einen erneuten
                       Zustellversuch unternimmt.

        \item[pass]  - Die E-Mail wird zugestellt auch wenn nicht auf
                       einen konfigurierten Malware- oder Spam-Scanner
                       zugegriffen werden kann.
    \end{description}

        G"ultige Werte: defer, drop, pass

        Standardeinstellung: \texttt{EXISCAN\_ACTION\_ON\_FAILURE='defer'}


    \config{EXISCAN\_CRYPT\_SALT}{EXISCAN\_CRYPT\_SALT}{EXISCANCRYPTSALT}
        Exiscan f"ugt eine verschl"usselte Message-ID in den Nachrichtenkopf ein,
        wenn diese erfolgreich gepr"uft wurde. Diese Message-ID dient der Erkennung
        von `sauberen' Nachrichten und ob diese erneut gesendet oder verz"ogert
        werden sollen. "Uber diesen Parameter wird nun eine zweistellige Zeichenfolge
        festgelegt, die bei der Generierung der Message-ID einflie"st. Hierdurch
        wird verhindert, dass eine zuvor von einer fremden Exiscan-Implementierung
        markierte Nachricht, auf dem eigenen System automatisch als bereits gepr"uft
        erkannt wird. Wurde dieser Parameter nicht gesetzt, so wird er sp"atestens bei
        der Generierung einer neuen Mail-Konfiguration durch eine zuf"allige Zeichenkette
        gef"ullt, damit Exiscan nicht seinen Dienst einstellt.\\

        G"ultige Werte: Zeichenkette

        Beispiel: \texttt{EXISCAN\_CRYPT\_SALT='dfgdgekrkasar'}

     \config{EXISCAN\_DEMIME\_ENABLED}{EXISCAN\_DEMIME\_ENABLED}{EXISCANDEMIMEENABLED}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle MIME- und
        UUENCODE-Container in einer Nachricht f"ur eine "Uberpr"ufung entpackt.
        Bei gesetztem Parameter `no' werden alle EXISCAN\_DEMIME...-Parameter
        ignoriert.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_DEMIME\_ENABLED='yes'}

    \config{EXISCAN\_DEMIME\_ACTION}{EXISCAN\_DEMIME\_ACTION}{EXISCANDEMIMEACTION}
        "Uber diesen Parameter wird festgelegt wie mit E-Mails verfahren wird bei
        denen ein falsch formatierter MIME-Container oder andere MIME-Exploits
        festgestellt wurden. Die folgenden Optionen sind verf"ugbar:

    \begin{description}
        \item[reject] - Die E-Mail wird abgewiesen und eine Fehlermeldung
                        wird generiert. Dies f"uhrt dazu, dass Fetchmail
                        einen wiederkehrenden Fehler generiert, weil die
                        infizierte E-Mail nicht vom entfernten POP3-Server
                        abgeholt werden kann.

        \item[freeze] - Die E-Mail wird zwar vom entfernten POP3-Server
                        abgeholt, jedoch nicht dem Empf"anger zugestellt.
                        Statt dessen wird sie in der Mail-Queue als
                        `freeze' gekennzeichnet, sodass der Mail-
                        Administrator entsprechende Schritte einleiten
                        kann.

        \item[discard] - Die E-Mail wird vom entfernten POP3-Server abgeholt
                           und sofort gel"oscht.

        \item[redirect $<$address$>$] - Die E-Mail wird vom entfernten POP3-Server
                                     abgeholt, jedoch wird sie nicht dem
                                     Originalempf"anger zugestellt sondern an
                                     die angegebenen Adresse geschickt.
                                     Achtung: Die E-Mail-Adresse muss unbedingt eine Domain enthalten!

        \item[pass]       - Die E-Mail wird vom entfernten POP3-Server abgeholt
                            und dem Empf"anger zugestellt. Zur Kennzeichnung
                            wird im E-Mail-Nachrichtenkopf ein ``X-''-Eintrag
                            hinzugef"ugt.
    \end{description}

        G"ultige Werte: reject, freeze, discard, redirect inkl. E-Mail-Adresse, pass

        Standardeinstellung: \texttt{EXISCAN\_DEMIME\_ACTION='reject'}

    \config{EXISCAN\_AV\_ENABLED}{EXISCAN\_AV\_ENABLED}{EXISCANAVENABLED}
        Wird dieser Parameter auf `yes' gesetzt, so wird zur "Uberpr"ufung
        der E-Mails auf ein externes Programm zur"uckgegriffen. Bei gesetztem
        Parameter `no' werden alle EXISCAN\_AV\ldots-Parameter ignoriert.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_AV\_ENABLED='no'}


    \config{EXISCAN\_AV\_ACTION}{EXISCAN\_AV\_ACTION}{EXISCANAVACTION}
        "Uber diesen Parameter wird festgelegt wie mit E-Mails verfahren wird
        bei denen ein Virus festgestellt wurde. Die m"oglichen Optionen wurden
        ausf"uhrlich bei dem Parameter \jump{EXISCANDEMIMEACTION}{EXISCAN\_DEMIME\_ACTION}
        beschrieben.

        G"ultige Werte: reject, freeze, discard, redirect incl. E-Mail-Adresse, pass

        Standardeinstellung: \texttt{EXISCAN\_AV\_ACTION='reject'}

    \config{EXISCAN\_AV\_SUBJECT\_TAG}{EXISCAN\_AV\_SUBJECT\_TAG}{EXISCANAVSUBJECTTAG}
        "Uber diesen Parameter kann ein Text definiert werden welcher, bei Feststellung
        eines Viruses jeder Betreffzeile vorangestellt wird. Dies ist nur dann sinnvoll,
        wenn der Parameter \jump{EXISCANAVACTION}{EXISCAN\_AV\_ACTION='pass'} gesetzt
        wurde und der Mail-Reader das Filtern "ubernehmen soll. Optional k"onnen der
        Virusname (\%VN), der Hostname (\%HN) und/oder ein Datumsstempel eingef"ugt werden.
        Hier werden die vom date-Befehl bekannten Parameter unterst"utzt, wie z.B.
        [\%d.\%m.\%Y] f"ur [14.05.2004].

        Beispiel:

        \texttt{EXISCAN\_AV\_SUBJECT\_TAG='*VIRUS*'\\
                EXISCAN\_AV\_SUBJECT\_TAG='*VIRUS [\%d.\%m.\%Y] Name:\%VN*'}

    \config{EXISCAN\_AV\_SCANNER}{EXISCAN\_AV\_SCANNER}{EXISCANAVSCANNER}
        "Uber diesen Parameter wird eingestellt welche Art Viren-Scanner
        verwendet wird. Zur Auswahl stehen folgende Optionen:

    \begin{description}
        \item[auto]      - Automatische Konfiguration "uber /var/spool/exim/exiscan-av.cnf Datei

        \item[cmdline]   - Standard Kommandozeilen Scanner

        \item[sophie]    - sophie AV Daemon (\url{http://www.vanja.com/tools/sophie/})

        \item[kavdaemon] - Kapersky AVP Daemon 4.x (\url{http://www.kapersky.com})

        \item[aveserver] - Kapersky AVP Daemon 5.x (\url{http://www.kapersky.com})

        \item[clamd]     - ClamAV Scanner Daemon (\url{http://clamav.elektrapro.com})

        \item[drweb]     - DrWeb Scanner Daemon (\url{http://www.sald.com/})

        \item[fsecure]   - F-Secure Scanner Daemon (\url{http://www.f-secure.com})

        \item[mksd]      - MKS Scanner Daemon (\url{http://linux.mks.com.pl/})
    \end{description}

        G"ultige Werte: auto, cmdline, sophie, kavdaemon, aveserver, clamd, drweb, fsecure, mksd

    \config{EXISCAN\_AV\_PATH}{EXISCAN\_AV\_PATH}{EXISCANAVPATH}
        Diese Option wird nur f"ur den Kommandozeilen Scanner ben"otigt.
        Es muss der \textbf{komplette Pfad und Name} zum Virus Scanner Programm
        angegeben werden.

        G"ultige Werte: Pfad- und Programmname

        Beispiel: \texttt{EXISCAN\_AV\_PATH='/usr/local/bin/sweep'}

    \config{EXISCAN\_AV\_OPTIONS}{EXISCAN\_AV\_OPTIONS}{EXISCANAVOPTIONS}
        Diese Option wird nur f"ur den Kommandozeilen Scanner ben"otigt.
        "uber diesen Parameter legt man die Kommandozeilenparameter
        fest die an den Viren-Scanner "ubergeben werden sollen.
        Achtung: Der String muss EIN '\%s'-Zeichen enthalten,
        welches dann durch den Pfad und Dateinamen der zu pr"ufenden
        Datei ersetzt wird. Die im Beispiel angegebenen Parameter
        funktionieren mit Sweep.

        G"ultige Werte: Text inkl. `\%s'-Zeichen

        Beispiel: \texttt{EXISCAN\_AV\_OPTIONS='-all -archive -ss \%s'}

    \config{EXISCAN\_AV\_TRIGGER}{EXISCAN\_AV\_TRIGGER}{EXISCANAVTRIGGER}
        Diese Option wird nur f"ur den Kommandozeilen Scanner ben"otigt.
        Die vom Viren-Scanner zur"uckgegebenen Meldungen werden nach dem
        hier angegebenen Regexp-Ausdruck durchsucht um zu erkennen wenn
        ein Virus gefunden wurde. Der im Beispiel angegebene Ausdruck
        funktionieren mit Sweep.

        G"ultige Werte: Text

        Beispiel: \texttt{EXISCAN\_AV\_TRIGGER='found in'}

    \config{EXISCAN\_AV\_DESCRIPTION}{EXISCAN\_AV\_DESCRIPTION}{EXISCANAVDESCRIPTION}
        Diese Option wird nur f"ur den Kommandozeilen Scanner ben"otigt.
        Die vom Viren-Scanner zur"uckgegebenen Meldungen werden nach dem
        hier angegebenen Regexp-Ausdruck durchsucht um zu erkennen welcher
        Virus gefunden wurde. Der im Beispiel angegebene Ausdruck
        funktionieren mit Sweep. Es wird der Ausdruck zwischen zwei
        Hochkommata ausgewertet `(.*)' .

        G"ultige Werte: Text

        Beispiel: \texttt{EXISCAN\_AV\_DESCRIPTION={\textbackslash}'{\textbackslash}({\textbackslash}.{\textbackslash}*{\textbackslash}){\textbackslash}'}

    \config{EXISCAN\_AV\_SOCKET}{EXISCAN\_AV\_SOCKET}{EXISCANAVSOCKET}
        Diese Option wird nur f"ur den entsprechenden Viren-Scanner
        ben"otigt. Sophie, KavDaemon, AveServer, FSecure und ClamAV "offnen jeweils
        einen Unix Socket /var/run/sophie, /opt/AVP/AvpCtl, /var/run/aveserver,
        /var/run/.fsav bzw. /path/to/clamavsocket im Dateisystem.
        Es muss sichergestellt, dass ausreichende Zugriffsrechte f"ur
        den Zugriff auf diesen Socket existieren und der Benutzer, unter
        dem die Programme ausgef"uhrt werden, auf das Exim-Queue-Verzeichnis
        zugreifen kann.

        G"ultige Werte: Pfad- und Programmname

        Beispiel:

        \texttt{EXISCAN\_AV\_SOCKET='/var/run/sophie'\\
                EXISCAN\_AV\_SOCKET='/opt/AVP/AvpCtl'\\
                EXISCAN\_AV\_SOCKET='/var/run/aveserve'\\
                EXISCAN\_AV\_SOCKET='/var/run/.fsav'\\
                EXISCAN\_AV\_SOCKET='/path/to/clamacvsocket'}

    \config{EXISCAN\_AV\_SKIP\_AUTHENTICATED}{EXISCAN\_AV\_SKIP\_AUTHENTICATED}{EXISCANAVSKIPAUTHENTICATED}
        "Uber diesen Parameter wird festgelegt ob Nachrichten von authentifizierten
        Anwendern auf Malware gepr"uft werden sollen oder nicht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_AV\_SKIP\_AUTHENTICATED='no'}

    \config{EXISCAN\_EXTENSION\_ENABLE}{EXISCAN\_EXTENSION\_ENABLE}{EXISCANEXTENSIONENABLE}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle E-Mails nach
        Dateien mit bestimmten Dateierweiterungen durchsucht. Diese Dateien
        werden bei Windows-Betriebssystemen sehr oft f"ur die Viren-Verbreitung
        genutzt. (vbs,pif,bat,exe,com etc.)

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_EXTENSION\_ENABLED='no'}

    \config{EXISCAN\_EXTENSION\_ACTION}{EXISCAN\_EXTENSION\_ACTION}{EXISCANEXTENSIONACTION}
        "Uber diesen Parameter wird festgelegt wie mit E-Mails verfahren wird bei denen die
        angegebenen Dateierweiterungen festgestellt wurden. F"ur weitere Informationen
        siehe hierzu auch \jump{EXISCANDEMIMEACTION}{EXISCAN\_DEMIME\_ACTION}.

        G"ultige Werte: reject, freeze, discard, redirect inkl. E-Mail-Adresse, pass

        Standardeinstellung: \texttt{EXISCAN\_EXTENSION\_ACTION='reject'}

    \config{EXISCAN\_EXTENSION\_DATA}{EXISCAN\_EXTENSION\_DATA}{EXISCANEXTENSIONDATA}
        "Uber diesen Parameter wird festgelegt, welchen Dateierweiterungen
        herausgefiltert werden sollen. Als Trennzeichen wird ein Doppelpunkt
        verwendet.

        G"ultige Werte: Text

        Beispiel: \texttt{EXISCAN\_EXTENSION\_DATA='exe:com:vbs'}

    \config{EXISCAN\_REGEX\_ENABLED}{EXISCAN\_REGEX\_ENABLED}{EXISCANREGEXENABLED}
        Wird dieser Parameter auf `yes' gesetzt, so werden alle E-Mails nach
        einem bestimmten Regexp-Ausdruck durchsucht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_REGEX\_ENABLED='no'}

    \config{EXISCAN\_REGEX\_ACTION}{EXISCAN\_REGEX\_ACTION}{EXISCANREGEXACTION}
        "Uber diesen Parameter wird festgelegt wie mit E-Mails verfahren
        wird bei denen der angegebene Regexp-Ausdruck gefunden wurde.
        Die m"oglichen Optionen wurden ausf"uhrlich bei dem Parameter
        \jump{EXISCANDEMIMEACTION}{EXISCAN\_DEMIME\_ACTION} beschrieben.

        G"ultige Werte: reject, freeze, discard, redirect inkl. E-Mail-Adresse, pass

        Standardeinstellung: \texttt{EXISCAN\_REGEXP\_ACTION='reject'}

    \config{EXISCAN\_REGEX\_DATA}{EXISCAN\_REGEX\_DATA}{EXISCANREGEXDATA}
        "Uber diesen Parameter wird festgelegt, nach welchem Regexp-Ausdruck
        gesucht und gefiltert werden soll. Als Trennzeichen wird ein
        Doppelpunkt verwendet.

        G"ultige Werte: Text

        Beispiel: EXISCAN\_REGEX\_DATA=\texttt{'\%[Mm]ortage : make money'}

    \config{EXISCAN\_SPAMD\_ENABLED}{EXISCAN\_SPAMD\_ENABLED}{EXISCANSPAMDENABLED}
        Wird dieser Parameter auf `yes' gesetzt, so wird die Anti-Spam-
        Unterst"utzung aktiviert. Voraussetzung ist eine installierte Version
        von SpamAssassin (\url{http://www.spamassassin.org})

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_ENABLED='no'}

    \config{EXISCAN\_SPAMD\_ACTION}{EXISCAN\_SPAMD\_ACTION}{EXISCANSPAMDACTION}
        "Uber diesen Parameter wird festgelegt wie mit E-Mails verfahren
        wird bei denen der angegebene Spam-Wert "uberschritten wurde.
        Die m"oglichen Optionen wurden ausf"uhrlich bei dem Parameter
        \jump{EXISCANDEMIMEACTION}{EXISCAN\_DEMIME\_ACTION} beschrieben.

        G"ultige Werte: reject, freeze, discard, redirect inkl. E-Mail-Adresse, pass

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_ACTION='redirect spam@domain.de'}

    \config{EXISCAN\_SPAMD\_HEADER\_STYLE}{EXISCAN\_SPAMD\_HEADER\_STYLE}{EXISCANSPAMDHEADERSTYLE}
        "Uber diesen Parameter wird festgelegt, wie viel Informationen der
        Spam-Daemon zum E-Mail-Nachrichtenkopf hinzuf"ugen soll. Die folgenden
        M"oglichkeiten stehen zur Auswahl:

    \begin{description}
        \item[none]   - Es werden keine Informationen zum E-Mail-Nachrichtenkopf
                        hinzugef"ugt.

        \item[single] - Es wird die X-Spam-Score-Nachrichtenkopfzeile hinzugef"ugt.

        \item[flag]   - Es wird die X-Spam-Score-Nachrichtenkopfzeile und, wenn
                        der Message-Score-Schwellwert "uberschritten wurde, die
                        X-Spam-Flag-Nachrichtenkopfzeile hinzugef"ugt.

        \item[full]   - Es wird die X-Spam-Score-Nachrichtenkopfzeile und, wenn der
                        Message-Score-Schwellwert "uberschritten wurde, die X-Spam-
                        Flag-Nachrichtenkopfzeile hinzugef"ugt. Au"serdem wird "uber
                        den X-Spam-Report-Nachrichtenkopfeintrag der vollst"andige
                        Spam-Assassin-Report als mehrzeiliger Text hinzugef"ugt.
    \end{description}

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_HEADER\_STYLE='single'}

    \config{EXISCAN\_SPAMD\_SUBJECT\_TAG}{EXISCAN\_SPAMD\_SUBJECT\_TAG}{EXISCANSPAMDSUBJECTTAG}
        "Uber diesen Parameter kann ein Text definiert werden welcher, bei
        "uberschreiten des Message-Score-Schwellwertes jeder Betreffzeile
        vorangestellt wird. Dies ist nur dann sinnvoll, wenn der Parameter
        \jump{EXISCANSPAMDACTION}{EXISCAN\_SPAMD\_ACTION}='pass' gesetzt
        wurde und der Mail-Reader das Filtern "ubernehmen soll. Optional k"onnen
        die Spam-Wertung (\%SC), der Hostname (\%HN) und/oder ein Datumsstempel
        eingef"ugt werden. Hier werden die vom date-Befehl bekannten Parameter
        unterst"utzt, wie z.B. [\%d.\%m.\%Y] f"ur [14.05.2004].

        Beispiel:

        \texttt{EXISCAN\_SPAMD\_SUBJECT\_TAG='*SPAM*'\\
                EXISCAN\_SPAMD\_SUBJECT\_TAG='*SPAM [\%d.\%m.\%Y] Score:\%SC*'}

    \config{EXISCAN\_SPAMD\_THRESHOLD}{EXISCAN\_SPAMD\_THRESHOLD}{EXISCANSPAMDTHRESHOLD}
        "Uber diesen Parameter wird festgelegt ab welchem Spam-Wert
        eine E-Mail als Spam eingestuft wird. Der hier angegebenen
        Wert sollte mit Bedacht gew"ahlt werden, da es sonst zu
        ungewollten Filterungen kommen kann.

        G"ultige Werte: Zahl

        Beispiel: \texttt{EXISCAN\_SPAMD\_THRESHOLD='5'}

    \config{EXISCAN\_SPAMD\_ADDRESS}{EXISCAN\_SPAMD\_ADDRESS}{EXISCANSPAMDADDRESS}
        "Uber diesen Parameter werden eine oder mehrere IP-Adressen, jeweils getrennt
        durch einen Doppelpunkt, und gefolgt von der durch ein Leerzeichen getrennten
        Port-Nummer angegeben, auf denen ein spamd-Daemon l"auft.

        G"ultige Werte: eine oder mehrere IP-Adressen und eine Portnummer

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_ADDRESS='127.0.0.1 783'}

    \config{EXISCAN\_SPAMD\_LIMIT}{EXISCAN\_SPAMD\_LIMIT}{EXISCANSPAMDLIMIT}
        "Uber diesen Parameter kann die maximale Gr"o"se einer Nachrichten
        angegeben werden, die vom Spam-Daemon gepr"uft werden soll.
        Wird dieser Parameter auf `0' gesetzt oder kein Wert angegeben,
        so wird die Limit"uberpr"ufung deaktiviert. Der Limitwert kann
        zus"atzliche eine Einheitenangabe (k-kilo oder m-mega) enthalten,
        z.B. 80k f"ur 80 Kilobyte.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_LIMIT='0'}

    \config{EXISCAN\_SPAMD\_SKIP\_AUTHENTICATED}{EXISCAN\_SPAMD\_SKIP\_AUTHENTICATED}{EXISCANSPAMDSKIPAUTHENTICATED}
        "Uber diesen Parameter wird festgelegt ob Nachrichten von authentifizierten
        Anwendern auf Spam gepr"uft werden sollen oder nicht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{EXISCAN\_SPAMD\_SKIP\_AUTHENTICATED='no'}
\end{description}

\subsection{Die Zertifikatsbenachrichtigung}
%-------------------------------------------

\begin{description}

    \config{MAIL\_CERTS\_WARNING (ADVANCED-Modus)}{MAIL\_CERTS\_WARNING}{MAILCERTSWARNING}
        "Uber diesen Parameter kann der automatisierte Versand einer Warnbenachrichtigung
        aktiviert werden, wenn ein TLS-Zertifikate kurz vor dem Ablauf steht. Wird der
        Parameter auf den Wert `no' gesetzt, so wird keine "Uberpr"ufung durchgef"uhrt
        und keine Warnbenachrichtigung verschickt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{MAIL\_CERTS\_WARNING='no'}

    \config{MAIL\_CERTS\_WARNING\_SUBJECT (ADVANCED-Modus)}{MAIL\_CERTS\_WARNING\_SUBJECT}{MAILCERTSWARNINGSUBJECT}
        "Uber diesen Parameter wird der Text der Betreffzeile der Warnbenachrichtigung
        festgelegt. Optional kann der Hostname (\%HN) und/oder ein Datumsstempel
        eingef"ugt werden. Es werden die vom date-Befehl bekannten Parameter
        unterst"utzt wie z.B. [\%d.\%m.\%Y] f"ur [14.05.2004].

        G"ultige Werte: Text

        Standardeinstellung: \texttt{MAIL\_CERTS\_WARNING\_SUBJECT='TLS certificates warning'}

    \config{MAIL\_CERTS\_WARNING\_CRON\_SCHEDULE (ADVANCED-Modus)}{MAIL\_CERTS\_WARNING\_CRON\_SCHEDULE}{MAILCERTSWARNINGCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall eine "Uberpr"ufung
        der TLS-Zertifikate durchgef"uhrt werden soll. Eine Vorlauf von 20 Tagen ist hierbei
        fest vorgegeben. 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 1. und 16. eines
        Monats um 01:03h eine "Uberpr"ufung durchgef"uhrt und gegebenenfalls eine
        Warnbenachrichtigung verschickt. 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{MAIL\_CERTS\_WARNING\_CRON\_SCHEDULE='3 1 1,16 * *'}
\end{description}

\subsection{Die Queue-Benachrichtigung}
%--------------------------------------

\begin{description}

    \config{MAIL\_QUEUE\_WARNING (ADVANCED-Modus)}{MAIL\_QUEUE\_WARNING}{MAILQUEUEWARNING}
        "Uber diesen Parameter kann der automatisierte Versand einer Warnnachricht
        aktiviert werden, wenn die Anzahl von Nachrichten in der Exim-Warteschlange
        das gesetzte Limit, welches standardm"a"sig bei 10 Nachrichten liegt,
        "uberschreitet. Wird der Parameter auf den Wert `no' gesetzt, so wird
        keine "Uberpr"ufung durchgef"uhrt und keine Warnnachricht verschickt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{MAIL\_QUEUE\_WARNING='no'}

    \config{MAIL\_QUEUE\_WARNING\_SUBJECT (ADVANCED-Modus)}{MAIL\_QUEUE\_WARNING\_SUBJECT}{MAILQUEUEWARNINGSUBJECT}
        "Uber diesen Parameter wird der Betreffzeilentext der Warnnachricht festgelegt.
        Optional kann der Hostname (\%HN) und/oder ein Datumsstempel eingef"ugt werden.
        Es werden die vom date-Befehl bekannten Parameter unterst"utzt wie z.B.
        [\%d.\%m.\%Y] f"ur [14.05.2004].

        G"ultige Werte: Text

        Standardeinstellung: \texttt{MAIL\_QUEUE\_WARNING\_SUBJECT='Mail queue limit warning'}

    \config{MAIL\_QUEUE\_WARNING\_CRON\_SCHEDULE (ADVANCED-Modus)}{MAIL\_QUEUE\_WARNING\_CRON\_SCHEDULE}{MAILQUEUEWARNINGCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall eine
        "Uberpr"ufung der Exim-Warteschlange durchgef"uhrt 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 jeweils 10min bzw. 40min
        nach einer vollen Stunde eine "Uberpr"ufung durchgef"uhrt und gegebenenfalls
        eine Warnnachricht verschickt. 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{MAIL\_QUEUE\_WARNING\_CRON\_SCHEDULE='10,40 * * * *'}

    \config{MAIL\_QUEUE\_WARNING\_LIMIT (Optionaler Parameter)(ADVANCED-Modus)}{MAIL\_QUEUE\_WARNING\_LIMIT}{MAILQUEUEWARNINGLIMIT}
        "Uber diesen Parameter kann auf Wunsch der Grenzwert angepasst werden
        bei dessen "Uberschreitung eine Warnnachricht verschickt werden soll.
        Standardm"a"sig geschieht dies bei "Uberschreiten des Wertes `10'.

        G"ultige Werte: Zahl

        Beispiel: \texttt{MAIL\_QUEUE\_WARNING\_LIMIT='10'}
\end{description}

\subsection{Die Statistiknachricht}
%----------------------------------

\begin{description}

    \config{MAIL\_STATISTICS\_INFOMAIL (ADVANCED-Modus)}{MAIL\_STATISTICS\_INFOMAIL}{MAILSTATISTICSINFOMAIL}
        "Uber diesen Parameter kann der automatisierte Versand einer E-Mail
        aktiviert werden, die statistische Informationen "uber den
        E-Mail-Server enth"alt. Wird der Parameter auf den Wert `no' gesetzt,
        so wird keine Infomail verschickt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{MAIL\_STATISTICS\_INFOMAIL='no'}

    \config{MAIL\_STATISTICS\_INFOMAIL\_SUBJECT (ADVANCED-Modus)}{MAIL\_STATISTICS\_INFOMAIL\_SUBJECT}{MAILSTATISTICSINFOMAILSUBJECT}
        "Uber diesen Parameter wird der Text der Infomail-Betreffzeile festgelegt.
        Optional kann der Hostname (\%HN) und/oder ein Datumsstempel eingef"ugt werden.i
        Es werden die vom date-Befehl bekannten Parameter unterst"utzt wie z.B.
        [\%d.\%m.\%Y] f"ur [14.05.2004]. Dieser Funktion muss zuvor "uber den Parameter
        \jump{MAILSTATISTICSINFOMAIL}{MAIL\_STATISTICS\_INFOMAIL} aktiviert werden.

        G"ultige Werte: Text

        Standardeinstellung: \texttt{MAIL\_STATISTICS\_INFOMAIL\_SUBJECT='Mail server statistics'}

    \config{MAIL\_STATISTICS\_INFOMAIL\_CRON\_SCHEDULE (ADVANCED-Modus)}{MAIL\_STATISTICS\_INFOMAIL\_CRON\_SCHEDULE}{MAILSTATISTICSINFOMAILCRONSCHEDULE}
        Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall
        E-Mail-Server-Statistiken versandt werden sollen. "Uber den Parameter
        \jump{MAILSTATISTICSINFOMAIL}{MAIL\_STATISTICS\_INFOMAIL} muss diese
        Funktion jedoch zuvor aktiviert werden. 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 Samstag um 23:55h
        eine Infomail verschickt. 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{MAIL\_STATISTICS\_INFOMAIL\_CRON\_SCHEDULE='55 23 * * 6'}

    \config{MAIL\_STATISTICS\_INFOMAIL\_OPTIONS (ADVANCED-Modus)}{MAIL\_STATISTICS\_INFOMAIL\_OPTIONS}{MAILSTATISTICSINFOMAILOPTIONS}
        Optionaler Parameter: "uber diesen Parameter k"onnen individuelle Optionen
        f"ur das Programm `Eximstats' festgelegt werden, um den Inhalt der
        Statistiknachricht zu beeinflussen.

        G"ultige Werte: zul"assige Eximstats-Optionen

        Standardeinstellung: \texttt{nicht definiert}
\end{description}

\subsection{Die Logdateien}
%--------------------------

     Das Mail-Paket verwendet Logdateien, um Meldungen "uber seinen
     laufenden Betrieb zu speichern. Um zu verhindern, dass diese
     Dateien zu gro"s und un"ubersichtlich werden, kann man einstellen
     wie das System mit den Dateien umgehen soll.

\begin{description}

     \config{MAIL\_LOG\_COUNT}{MAIL\_LOG\_COUNT}{MAILLOGCOUNT}
         "Uber diesen Parameter wird eingestellt, wie viele Logdateien
         vorgehalten werden sollen. Wird dieser Wert "uberschritten, so
         wird die "alteste Logdatei gel"oscht.

         G"ultige Werte: Zahl

         Standardeinstellung: \texttt{MAIL\_LOG\_COUNT='10'}

    \config{MAIL\_LOG\_INTERVAL}{MAIL\_LOG\_INTERVAL}{MAILLOGINTERVAL}
        Dieser Parameter bestimmt in welchen Intervallen die Logdateien
        archiviert werden sollen. Zur Auswahl stehen die Schl"usselw"orter
        `daily' - t"aglich, `weekly' - w"ochentlich und `monthly - monatlich.

        G"ultige Werte: daily, weekly, monthly

        Standardeinstellung: \texttt{MAIL\_LOG\_INTERVALL='weekly'}
\end{description}

\section{Die Abwesenheitsmeldung}
%--------------------------------

    "Uber das Programm `vacation' kann man w"ahrend einer l"angeren Abwesenheit
    automatisierte Antwortnachricht vom E-Mail-Server versenden lassen.

\begin{description}
    \config{Abwesenheit beginnen}{Abwesenheit\_beginnen}{Abwesenheitbeginnen}
        Eine Abwesenheitsperiode wird wie folgt eingeleitet:

    \begin{itemize}
        \item[1] Login auf dem Server mit der Benutzer-ID des Benutzers der die
            Abwesenheitsmeldung erstellen bzw. aktivieren m"ochte.

        \item[2] Starten des Programms `vacation' ohne Angabe von Parametern
            erstellt einen neuen Benachrichtigungstext bzw. erm"oglicht das
            Bearbeiten eines bereits existierenden Textes. Es wird
            automatisch eine Datei mit dem Namen `.vacation.msg' im
            Home-Verzeichnis des Anwenders angelegt. Falls bereits eine
            `.vacation.msg' -Datei im Verzeichnis existierte wird diese in
            `.vacation.old' umbenannt.

            Der Standardtext sieht wie folgt aus:

        \begin{verbatim}
        Subject: away from my mail
        From:  smith (via the vacation program)
        I will not be reading my mail for a while. Your\
        mail regarding ``\$SUBJECT'' will be read when I return.
        \end{verbatim}

            Die Datei sollte mindestens einen `Subject: '-Eintrag enthalten.
            Es sollte kein `To:'- und m"oglichst auch kein `From: '-Eintrag in
            der Datei enthalten sein, da diese automatisch generiert werden.
            Wenn die Variable \$SUBJECT in der Datei `.vacation.msg' vorkommt,
            wird sie durch den Inhalt der Betreffzeile der Originalnachricht
            ersetzt.

            Es wird keine Nachricht verschickt, wenn in den Feldern `To: ' bzw.
            `Cc: ' nicht die E-Mail-Adresse bzw. eine Alias-Adresse des eigentlichen
            Empf"angers der Nachricht enthalten ist oder in dem `From'-Feld die
            Textfragmente `-request', `postmaster', `uucp', `mailer-daemon',
            `mailer' oder `-relay' gefunden werden. Weiterhin d"urfen im
            Nachrichtenkopf die folgenden Felder nicht existieren:
            `Precedence: bulk', `Precedence: junk' oder `Precedence: list'
            Auf diese Weise werden Mail-Schleifen und Antworten an Mailinglisten
            vermieden.

            Zus"atzlich wird im Home-Verzeichnis des Anwenders eine Datei `.forward'
            angelegt, die folgenden Inhalt hat. Eine bereits existierende Datei wird
            in `.forward.old' umbenannt.

            Beispiel:

        \begin{verbatim}
        \username, \|/usr/bin/vacation username
        \end{verbatim}

        \item[3] Eventuell durch Aufruf des Befehls `vacation -I' die Abwesenheit beginnen,
            d.h. die Datei `.vacation.db' wird initialisiert und die Datei `.forward'
            wird angelegt. (Dies sollte beim Programmaufruf ohne Parameter eigentlich
            automatisiert geschehen.
    \end{itemize}

    \config{Abwesenheit beenden}{Abwesenheit\_beenden}{Abwesenheitbeenden}
        Eine Abwesenheitsperiode wird wie folgt beendet:

    \begin{itemize}
        \item[1] Login auf dem Server mit der Benutzer-ID des Benutzers der die
            Abwesenheitsmeldung erstellen bzw. aktivieren m"ochte.

        \item[2] Im Home-Verzeichnis des Anwenders die Datei `.forward' l"oschen oder
            umbenennen um die Abwesenheit zu beenden.

        \item[3] Durch Aufruf des Programms `vaclook' kann dann der Inhalt der Datei
            `.vacation.db' angezeigt werden, welche eine Liste aller verschickten
            Antwortnachrichten enth"alt.
    \end{itemize}

    "Uber das Programm `vaclook' kann man sich die Liste der verschickten
    Abwesenheitsbenachrichtigungen anzeigen lassen.

    \config{Abwesenheit - Benachrichtigungsliste anzeigen}{Abwesenheit\_Benachrichtigungsliste}{AbwesenheitBenachrichtigungsliste}
        Durch ausf"uhren des Programms `vaclook' wird die Datei `.vacation.db' im
        Home-Verzeichnis des Anwenders ausgelesen und eine Liste "uber die verschickten
        Benachrichtigungen und deren Zeitstempel angezeigt.

        Beispiel:

        \begin{verbatim}
        sender@senders.domain:            Sat Nov 20 00:39:51 2002
        \end{verbatim}
\end{description}


\section{Das Weiterleiten von E-Mail}
%-----------------------------------

    Will ein Anwender seine eingehende Post an einen anderen Anwender weiterleiten,
    so muss er folgende Schritte durchf"uhren um diese Funktion zu aktivieren:

\begin{description}
    \config{Weiterleitung aktivieren}{Weiterleitung\_aktivieren}{Weiterleitungaktivieren}

        Eine Weiterleitung wird wie folgt aktiviert:

    \begin{itemize}
        \item[1] Login auf dem Server mit der Benutzer-ID des Benutzers der die Abwesenheitsmeldung
            erstellen bzw. aktivieren m"ochte.

        \item[2] Erstellen einer Datei `.forward' im Home-Verzeichnis des Anwenders.
            Es wird nur die E-Mail-Adresse des Anwenders eingegeben, an den die Post
            weitergeleitet werden soll.

            Beispiel: \texttt{frank@domain.de}

            Soll zus"atzlich noch eine Kopie der eingegangenen Nachricht im eigenen
            Posteingang verbleiben, so stellt man dem Eintrag den eigenen Benutzernamen
            voran.

            Beispiel:

            \begin{verbatim}
            \tom, frank@domain.de
            \end{verbatim}
    \end{itemize}

    \config{Weiterleitung aufheben}{Weiterleitung\_aufheben}{Weiterleitungaufheben}
        Eine Weiterleitung wird wie folgt aufgehoben:

    \begin{itemize}
        \item[1] Login auf dem Server mit der Benutzer-ID des Benutzers der die Abwesenheitsmeldung
            erstellen bzw. aktivieren m"ochte.

        \item[2] Im Home-Verzeichnis des Anwenders die Datei `.forward' l"oschen oder
            umbenennen um die Abwesenheit zu beenden.
    \end{itemize}

\end{description}

\section{Die Antivirus-Parameter konfigurieren}
%----------------------------------------------

    Wird zus"atzlich zum mail-Paket ein Antivirus-Paket installiert welches im Verzeichnis
    `/var/spool/exim' eine Datei mit Namen `exiscan-av.cnf' und ad"aquaten Parametern ablegt,
    so wird beim Generieren einer neuen Konfiguration automatische die Unterst"utzung f"ur die
    Virenpr"ufung (\jump{EXISCANAVENABLED}{EXISCAN\_AV\_...}) aktiviert. Kommentarzeilen
    m"ussen mit einem `\#'-Zeichen beginnen. Die Datei kann hierbei z.B. folgende Parameter
    enthalten, die automatisch in die neue Konfiguration "ubernommen werden:

    G"ultige Parameter: AV\_SCANNER, AV\_SOCKET, AV\_PATH, AV\_OPTIONS,\\
    AV\_TRIGGER, AV\_DESCRIPTION

    Beispiel (Sophie):

\begin{verbatim}
# Sophie configuration
AV_SCANNER='sophie'
AV_SOCKET='/var/run/sophie'
\end{verbatim}

    Beispiel (Sophos):

\begin{verbatim}
# Sophos configuration
AV_SCANNER='cmdline'
AV_PATH='/usr/local/bin/sweep'
AV_OPTIONS='-all -archive -tnef %s'
AV_TRIGGER='found in'
AV_DESCRIPTION="'(.*)'"
\end{verbatim}

\section{Die Problemanalyse}
%---------------------------

\begin{description}
    \config{Debug-Ausgaben aktivieren}{Debug-Ausgaben\_aktivieren}{Debug-AusgabenaktivierenMAIL}
        Falls man bei der Fehleranalyse absolut nicht weiterkommt, kann man die Variable
        MAIL\_DO\_DEBUG='yes' zur Datei /etc/config.d/mail hinzuf"ugen und dann mittels
        `/etc/init.d/mail restart' den E-Mail-Server neu starten. Um zu verhindern, dass
        tempor"are mail-Dateien gel"oscht werden kann man zus"atzlich noch die Variable
        EXISCAN\_DO\_DEBUG='yes' zur Konfiguration hinzuf"ugen, was es jedoch auch erforderlich
        macht eine eine neue Konfigurationsdatei zu generieren bevor man den E-Mail-Server neu startet.
        Fetchmail schreibt dann sehr ausf"uhrliche Debug-Eintr"age in die Logdatei und Exim wird als
        Anwendung zwecks Fehlersuche im Vordergrund gestartet. Ausf"uhrlichste Meldungen werden
        auf den Bildschirm geschrieben. Bei Verwendung von Putty darf nicht vergessen werden den
        Scrollback-Puffer gro"s genug zu setzen.

    \config{Debug-Ausgaben deaktivieren}{Debug-Ausgaben\_deaktivieren}{Debug-AusgabendeaktivierenMAIL}
        Um den Debug-Modus zu beenden muss Exim mit STRG-C beendet, der Parameter MAIL\_DO\_DEBUG='no'
        gesetzt und der E-Mail-Server mittels `/etc/init.d/mail restart' neu gestartet werden.

    \config{Liste von SMTP-Fehlernummern}{Liste von SMTP-Fehlernummern}{ListevonSMTP-Fehlernummern}
        Im Folgenden werden einige SMTP-Fehlernummern aufgef"uhrt, auf die man bei der
        Analyse der Logdateien sto"sen kann.

        \begin{description}
        \item[211] - Eine Status- oder Hilfeantwort.
        \item[214] - Hilfemeldung.
        \item[220] - Der Server ist bereit.
        \item[221] - Der Server beendet die Konversation.
        \item[250] - Die angeforderte Aktion wurde abgeschlossen.
        \item[251] - Der angegebene Anwender ist kein lokaler Nutzer aber der Server
                     wird die Nachricht weiterleiten.
        \item[354] - Dies ist eine Antwort des DATA-Befehls. Bitte mit dem Sender des
                     Nachrichtentextes beginnen und mit '{\textbackslash}r{\textbackslash}n.{\textbackslash}r{\textbackslash}n.' abschlie"sen.
        \item[421] - Der E-Mail-Server wird herunter gefahren. Speichern Sie die Nachricht
                     und versuchen es sp"ater noch einmal.
        \item[450] - Die Mailbox die Sie zu erreichen versuchten ist momentan gesperrt.
                     Warten Sie eine Weile bevor Sie es erneut versuchen.
        \item[451] - Die angeforderte Aktion wurde nicht ausgef"uhrt. Einige Fehler
                     sind im E-Mail-Server aufgetreten.
        \item[452] - Die angeforderte Aktion wurde nicht ausgef"uhrt. Dem E-Mail-Server
                     ist der Speicherplatz ausgegangen.
        \item[500] - Der letzte Befehl enthielt eine Syntaxfehler oder die Kommandozeile
                     war zu lang.
        \item[501] - Die Parameter oder Argumente im letzten Befehl enthielten einen
                     Syntaxfehler.
        \item[502] - Im E-Mail-Server ist der letzte Befehl nicht implementiert.
        \item[503] - Der letzte Befehl wurde in der falschen Reihenfolge gesendet. Zum
                     Beispiel k"onnte der DATA- vor dem RECV-Befehl gesendet worden sein.
        \item[504] - Einer der Parameter des letzten Befehls wurde im E-Mail-Server
                     nicht implementiert.
        \item[550] - Die Mailbox die Sie zu erreichen versuchten konnte nicht gefunden
                     werden oder Sie besitzen keine ausreichenden Zugriffsrechte.
        \item[551] - Der angegebene Anwender ist kein lokaler Nutzer; Teile des
                     Nachrichtentextes wird eine Weiterleitungsadresse enthalten.
        \item[552] - Der Mailbox die Sie zu erreichen versuchten ist der Speicherplatz
                     ausgegangen. Speichern Sie die Nachricht und versuchen Sie sie
                     morgen oder einige Tage sp"ater erneut zu senden, so erh"alt der
                     Anwender die M"oglichkeit einige Nachrichten zu l"oschen.
        \item[553] - Die E-Mail-Adresse, die Sie angegeben haben war syntaktisch nicht
                     in Ordnung.
        \item[554] - Die Nachrichtenfunktion ist aus unbekannten Gr"unden fehlgeschlagen.
    \end{description}
\end{description}

\section{Verschiedenes}
%----------------------

\begin{description}
    \config{DynDNS-Provider}{DynDNS-Provider}{DynDNS-Provider}
        Wer seinen \eisfair-Server "uber eine eigene dynamische Domain ans Internet
        anbinden m"ochte, findet auf \url{https://www.eisfair.org/} ein entsprechendes
        Howto welches am Beispiel von `eisfair.net' die Konfigurationsschritte erkl"art.

     \config{E-Mail-zu-Fax-Schnittstelle}{E-Mail-zu-Fax-Schnittstelle}{E-Mail-zu-Fax-Schnittstelle}
        Wird beim Generieren einer Konfiguration auf dem Server auch ein aktiviertes
        eisfax-Paket gefunden, so wird automatisch die E-Mail-zu-Fax-Schnittstelle
        aktiviert. D.h. ein Fax kann verschickt werden, wenn die Zieladresse nach
        folgender Regel aufgebaut wird:\\

\begin{verbatim}
faxg3/[<Modem>/]<Faxnummer>@domain.tld
\end{verbatim}

        Beispiel: faxg3/0221556677@domain.tld oder
                  faxg3/fax-beruf/0221556677@domain.tld

    \config{E-Mail-Backup}{E-Mail-Backup}{EMailBackup}
        Wer die E-Mail-Daten eines Anwenders sichern m"ochte, muss alle Dateien, die
        sich im Verzeichnis /home/<username>/.imapmail/ befinden und die Datei
        /var/spool/mail/<username> sichern.

    \config{E-Mail-Disclaimer}{E-Mail-Disclaimer}{EMailDisclaimer}
        Ausgehende Nachrichten, welche vom eigenen SMTP-Server an fremde SMTP-Server
        "ubermittelt werden, k"onnen bei Bedarf einen vorgegebenen Disclaimer erhalten.
        Um diese Funktion zu aktivieren legt man im Verzeichnis /var/spool/exim/disclaimer
        entsprechende Dateien an. Hierbei werden die Dateien <my-domain.de>-disclaimer.txt
        und <my-domain.de>-disclaimer.html f"ur Domain-spezifischer Disclaimer verwendet.
        Die Dateien default-disclaimer.txt und default-disclaimer.html werden
        standardm"a"sig verwendet wenn keine Domain-spezifischen Dateien existieren.
        Wird kein html-Disclaimer gefunden, so wird statt dessen ein vorhandener
        txt-Disclaimer an ausgehenden html-Nachrichten angeh"angt.\\
        Um den Einstieg in das Thema zu erleichtern werden im Verzeichnis
        /usr/share/doc/mail/examples Beispieldateien mitgeliefert, die man nur noch
        an seine Bed"urfnisse anpassen muss.\\
        \achtung{Es gilt zu beachten, dass durch das Anh"angen von Disclaimern
                 signierte Nachrichten unbrauchbar werden k"onnen.}

    \config{E-Mail-Filter}{E-Mail-Filter}{EMailFilter}
        Wer mit dem Begriff `E-Mail-Filter' automatisch das Programm `procmail'
        verbindet, dem sei gesagt, dass Exim von Hause aus E-Mail-Filterfunktionen
        mitbringt. Wer hierzu weitere Informationen sucht sollte sich auf der
        Exim-Homepage (\url{http://www.exim.org/}) die Dokumentation
        `The Exim Filter Specification - Version 4.1x' anschauen.

    \config{FAQs}{FAQs}{FAQs}
        Auf der Seite https://www.eisfair.org/ findet man im Men"u `FAQ' einige Tipps
        unter der Kategorie `eisfair:Mailserver', die bei Problemen mit dem Mail-Paket
        weiterhelfen k"onnten.

    \config{Fehlender Datumsstempel}{Fehlender Datumsstempel}{FehlenderDatumsstempel}
        Standardm"a"sig wird von einem E-Mail-Klienten jeder Nachricht ein eindeutiger
        Datumsstempel im Nachrichtenkopf eingef"ugt. Sollte dies wider erwarten nicht
        der Fall sein (es wird als Datum im E-Mail-Klienten z.B. immer der 01.01.1970
        angezeigt), so kann man durch den im Verzeichnis /usr/share/doc/mail/examples
        mitgelieferten Custom-Filter mit Namen `custom-systemfilter.add\_date' diesen
        Eintrag dem Nachrichtenkopf automatisch hinzuf"ugen lassen.\\
        Hierzu kopiert man die Datei in das Verzeichnis /var/spool/exim und generiert
        eine neue Konfiguration. Der Filter wurde erfolgreich aktiviert, wenn die
        folgende Meldung am Bildschirm angezeigt wird:\\

\begin{verbatim}
creating system-filter file ...
adding custom system filter /var/spool/exim/custom-systemfilter.add_date ...
\end{verbatim}

    \config{Fehlende Message-ID}{Fehlende Message-ID}{FehlendeMessage-ID}
        Standardm"a"sig wird von einem E-Mail-Klienten jeder Nachricht eine eindeutige
        Message-ID zugewiesen. Sollte dies wider erwarten nicht der Fall sein, so
        kann man durch den im Verzeichnis /usr/share/doc/mail/examples mitgelieferten
        Custom-Filter mit Namen `custom-systemfilter.add\_msgid' diesen Eintrag dem
        Nachrichtenkopf automatisch hinzuf"ugen lassen.\\
        Hierzu kopiert man die Datei in das Verzeichnis /var/spool/exim und generiert
        eine neue Konfiguration. Der Filter wurde erfolgreich aktiviert, wenn die
        folgende Meldung am Bildschirm angezeigt wird:\\

\begin{verbatim}
creating system-filter file ...
adding custom system filter /var/spool/exim/custom-systemfilter.add_dmsgid ...
\end{verbatim}

    \config{Google\texttrademark OAuth2-Authentifizierung f"ur Fetchmail einrichten}{OAuth2-Authentifizierung}
        Google plant zum 15.02.2021 den E-Mail-Abruf mittels LSA (Less Secure
        Access) f"ur alle Accounts unwiderruflich abschalten, sodass auch kein
        E-Mail-Abruf mittels Fetchmail mehr m"oglich sein wird. Um weiterhin
        E-Mail von Google-Accounts abrufen zu k"onnen, ist es erforderlich
        einige Anpassungen am mail-Paket vorzunehmen, ein gepatchtes
        Fetchmail-Programm zu verwenden und die OAuth2-Authentifizierung f"ur
        den abzurufenden Gmail-Account zu aktivieren.

        Im folgenden werden die erforderlichen Schritte f"ur die Umstellung des
        E-Mail-Abrufs auf die OAuth2-Authentifizierung beschrieben.

        \item[1.] Mittels eines Webbrowsers "offnet man die Google-Startseite
                  und meldet sich mit dem Google-Account, an f"ur welchen ein
                  OAuth2-Zugang eingerichtet werden soll.

                  URL: \url{https://www.google.com}\\
                  Beispielaccount: \texttt{eisfair.test@gmail.com}

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-01.png}{Google-Anmeldung}

        \item[2.] Anschlie"send "offnet man die Google-API-Konsole, wobei man
                  gegebenenfalls zuvor noch den API-Cloud-Nutzungsbedingungen
                  zustimmen muss.

                  URL: \url{https://console.developers.google.com/projectselector2/apis/library?pli=1&supportedpurview=project}

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-02.png}{API-Konsole "offnen}

        \item[3.] Dann klickt man auf den Knopf `PROJEKT ERSTELLEN' um ein
                  neues Projekt zu erstellen.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-03.png}{Projekt erstellen}

        \item[4.] Auf der Eingabeseite legt man einen eindeutigen Projektnamen
                  fest, z.B. `eisfair-fetchmail-abruf-001', verwendet diesen
                  auch f"ur die Projekt-ID und best"atigt die Eingabe durch
                  klicken auf `ERSTELLEN'.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-04.png}{Projektnamen festlegen}

        \item[5.] Sobald das Projekt erstellt wurde, was einen Moment dauern
                  kann, w"ahlt man `APIs \& Dienste > Anmeldedaten' aus, klickt
                  auf `ANMELDEDATEN ERSTELLEN' und w"ahlt `Oauth-Client-ID' aus.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-05.png}{OAuth-Client-ID}

        \item[6.] Man folgt der Aufforderung den Zustimmungsbildschirm zu
                  konfigurieren und klickt auf `ZUSTIMMUNGSBILDSCHIRM
                  KONFIGURIEREN'.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-06.png}{Zustimmungsbildschirm konfigurieren}

        \item[7.] Der Ver"offentlichungsstatus wird auf `Produktion' gesetzt,
                  um sicher zu stellen, dass die Token nicht nach 7 Tagen ablaufen.
                  Der User Type wird auf `Extern' gesetzt, da man "ublicherweise
                  keinen GSuite-Zugang besitzt, bevor man durch einen Klick auf
                  `ERSTELLEN'.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-07.png}{User Type}

        \item[8.] Man folgt der Aufforderung und legt einen Anwendungsnamen und
                  E-Mail-Adressen fest und klickt dann auf `SPEICHERN UND
                  FORTFAHREN'.

                  \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-08.png}{Anwendungsnamen festlegen}

        \item[9.] Im Abschnitt `Bereiche' sind keine Eingaben vorzunehmen,
                  sodass man nur auf `SPEICHERN UND FORTFAHREN' klicken muss.

        \item[10.] Im Abschnitt `Testnutzer' klickt man auf `ADD USERS' und
                   legt den Nutzer fest, welcher zuk"unftig den OAuth2-API-
                   Authentifizierungszugang nutzen k"onnen soll. D.h. man gibt
                   hier die E-Mail-Adresse des urspr"unglichen Google-Accounts
                   an und klickt anschlie"send auf `HINZUFUEGEN' und `SPEICHERN
                   UND FORTFAHREN'.

                   Beispielaccount: \texttt{eisfair.test@gmail.com}

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-10.png}{Testnutzer hinzuf"ugen}

        \item[11.] Im Abschnitt `Fazit' werden abschlie"send noch einmal alle
                   angegebenen Daten in einer "Ubersicht angezeigt. So die
                   Daten f"ur korrekt befunden werden, w"ahlt man nun erneut
                   `APIs \& Dienste > Anmeldedaten'. Wieder klickt man auf
                   `ANMELDEDATEN ERSTELLEN' und w"ahlt `OAuth-Client-ID' aus.

                   Als Anwendungstyp w"ahlt man `Fernsehger"ate und Ger"ate mit
                   beschr"ankter Eingabe' aus, legt einen OAUTH 2.0-Klientennamen
                   fest und klickt auf `ERSTELLEN'.

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-11.png}{Anwendungstyp w"ahlen}

        \item[12.] Final werden nun die erstellten Oauth-Daten (Client-ID
                   und Clientschl"ussel) angezeigt, auf welche jederzeit "uber
                   `Zugangsdaten > APIs \& Dienste' zugegriffen werden kann.
                   Die Client-ID sowie den Clientschl"ussel sollte man sich
                   sofort abspeichern, da diese im n"achsten Schritt ben"otigt
                   werden.  Das Fenster schlie"st man durch einen Klick auf
                   `OK'.

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-12.png}{OAuth-Client-ID und Clientschl"ussel}

        \item[13.] Nun "offnet man "uber `Setup > Service Administration
                   > Mail Service > Edit configuration (advanced)' die mail-
                   Konfiguration auf dem eisfair-Server, l"asst sich mittels
                   der F4-Taste (ECE) die optionalen Parameter einblenden
                   und passt die Abrufeinstellungen des Gmail-Accounts mit
                   den zuvor ermittelten OAuth2-Daten an und l"asst die
                   Konfiguration aktualisieren.

                   \begin{verbatim}
FETCHMAIL_x_AUTH_TYPE=‘oauth2‘
FETCHMAIL_x_OAUTH2_ID=‘1234…‘       (optionaler Parameter)
FETCHMAIL_x_OAUTH2_SECRET=‘abcd…‘   (optionaler Parameter)
                   \end{verbatim}

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-13.png}{eisfair-Konfiguration}

        \item[14.] Damit Fetchmail zuk"unftig eine Authentifizierung mittels
                   OAuth2 durchf"uhren kann, muss nun initial manuell ein
                   Abruf der Token von Hand erfolgen. Dazu navigiert man erst
                   einmal "uber das Men"u zu `Setup > Service Administration
                   > Mail Service > Goto mail tools > Setup OAuth2 mail request'.

                   In der Auswahl werden nun alle Accounts, f"ur die als
                   Authentifizierungstyp (\jump{FETCHMAILxAUTHTYPE}{FETCHMAIL\_x\_AUTH\_TYPE})
                   der Wert `oauth2' ausgew"ahlt wurde, angezeigt. Nach
                   Auswahl des gew"unschten Accounts „eisfair.test“ und
                   der durchzuf"uhrenden Aktion `(s)etup' best"atigt man
                   die Ausf"uhrung des Programms.

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-14.png}{eisfair-Oauth2-Setup}

        \item[15.] Die im vorherigen Schritt angezeigte URL
                   (\texttt{https://accounts.goolgle.com/o/oauth2/...}) kopiert
                   man aus dem Terminal-Fenster in einen Webbrowser und best"atigt
                   noch einmal den verkn"upften Gmail-Account …

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-15.png}{Gmail-Konto ausw"ahlen}

        \item[16.] … und die Tatsache, dass Google diese App nicht "uberpr"uft
                   hat (es gibt ja auch keine App die es zu "uberpr"ufen gilt),
                   durch klicken auf `Weiter'. …

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-16.png}{Keine App-Pr"ufung durch Google}

        \item[17.] … best"atigen die Auswahl noch einmal durch Klicken auf
                   `Zulassen' …

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-17.png}{Zugriff zulassen}

        \item[18.] … und einen weiteren Klick auf `Zulassen' …

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-18.png}{Zugriff gew"ahren}

        \item[19.] … um den Verification-Code angezeigt zu bekommen.

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-19.png}{Anmelde-Code}

        \item[20.] Den zuvor angezeigten Code kopiert man aus dem Webbrowser
                   in das immer noch ge"offnete Terminal-Fenster auf dem
                   \eisfair-Server, als Eingabe f"ur den geforderten
                   Verification Code, um den Abruf eines initialen Refresh-
                   und Access-Tokens abzuschlie"sen.

                   \graphic{center}{width=140mm}{./pics/mail-fm-oauth2-20.png}{eisfair-Verification-Code}

         Nachdem diese Schritte abgeschlossen wurden, gilt es noch sicher
         zu stellen, dass die Zertifikskette f"ur den Abruf bzw. die
         Aktualisierung der OAuth2-Token von dem Server `apps.googleusercontent.com'
         korrekt verifiziert werden kann. Die erforderlichen Werkzeuge
         daf"ur finden sich wie "ublich im certs-Paket.

         Um zu pr"ufen, ob ein E-Mail-Abruf eines Google-Accounts mittels
         OAuth2-Authentifizierung problemlos funktioniert, sollte man einen
         Blick in die Fetchmail-Logdatei werfen. Diese kann man sich "uber
         den Men"upunkt `View fetchmail log file' anzeigen lassen.

    \config{HowTos}{HowTos}{HowTos}
        Auf der Seite \url{https://www.eisfair.org/} findet man im Men"u `HowTos' weitere
        Anleitungen, die bei der Konfiguration des Mail-Paketes helfen.

    \config{Individuelle Kennwortdateien (ADVANCED-Modus)}{Individuelle Kennwortdateien}{IndividuelleKennwortdateien}
        Wurde in der Konfiguration MAIL\_USER\_USE\_MAILONLY\_PASSWORDS='yes'
        gesetzt, so mussten sich bisher alle Kennw"orter ebenfalls in der
        Konfigurationsdatei befinden. Dies bedeutete f"ur den Administrator
        einen erh"ohten Konfigurationsaufwand und er m"usste das Kennwort
        eines jeden Anwenders kennen. Auch war die individuelle "Anderung
        des Kennwortes durch den Anwender nicht m"oglich.
        Legt man  nun jedoch im Home-Verzeichnis eines Anwenders eine Datei
        mit Namen '.mailpasswd' an, die aus einer Zeile besteht in der sich
        das individuelle mail-Kennwort eines Benutzers befindet, so kann der
        Administrator durch Aufruf des folgenden Befehls dieses Kennwort
        automatisch auslesen und die zentrale Kennwortdatei aktualisieren:
        /var/install/config.d/mail.sh updatemailpw

    \config{IMAP-Ordner und Verzeichnisse}{IMAP-Ordner und Verzeichnisse}{IMAP-OrdnerundVerzeichnisse}
        Bei der Verwendung von Panda-IMAP, im Gegensatz zum Dovecot-IMAP,
        ist zu beachten, dass ein mail-Ordner niemals ein Unterverzeichnis
        enthalten kann. Es erfolgt eine strikte Trennung zwischen IMAP-Ordnern
        und -Verzeichnissen.

        Beispiel:

        \begin{verbatim}
+- Archiv -+- (2002)
|          +- (2003)
|
+- Sonstiges -+- Provider -+- (Provider-1)
              |            +- (Provider-2)
              +- (Kino)
        \end{verbatim}
        E-Mail k"onnen nur die in Klammern gesetzten Ordner enthalten.

    \config{Open-Relay-Test}{Open-Relay-Test}{OpenRelayTest}
        Karsten Voigt machte mich darauf aufmerksam, dass man seinen E-Mail-Server durch
        Aufruf von `telnet relay-test.mail-abuse.org' dahingehend "uberpr"ufen kann,
        ob er unerlaubtes Relaying verhindert. F"ur die korrekte Funktionalit"at wird
        keine Garantie "ubernommen und die Verwendung der Funktion geschieht auf eigene
        Gefahr $;-)$

    \config{RPA-Protokoll}{RPA-Protokoll}{RPA-Protokoll}
        Das CompuServe-RPA-Protokoll wird nur zur Authentifizierung benutzt, wodurch
        es nicht "uber die Parameter FETCHMAIL\_x\_PROTOCOL konfiguriert werden kann.
        Um es zu aktivieren, muss der "uber den Parameter FETCHMAIL\_x\_SERVER
        definierte Servername auf `.csi.com' enden und der "uber FETCHMAIL\_x\_USER
        definierte Benutzername die Domain `@compuserve.com' enthalten.\\

        Beispiel:

        \begin{verbatim}
FETCHMAIL_1_USER='frank@comuserve.com'
FETCHMAIL_1_SERVER='pop.site1.csi.com'
FETCHMAIL_1_PROTOCOL='pop3'
        \end{verbatim}

    \config{Send-Only-Konfiguration}{Send-Only-Konfiguration}{Send-Only-Konfiguration}
        Wer das mail-Paket nur dazu verwenden will um die lokalen Systemnachrichten
        "uber einen anderen E-Mail-Server versenden zu lassen, ohne eigene Mail-Dienste
        konfigurieren zu m"ussen, findet ein entsprechendes Howto auf \url{https://www.eisfair.org/}.

    \config{SMTP-nach-POP}{SMTP-nach-POP}{SMTP-nach-POP}
        Wer den SMTP-Server seines Providers nur verwenden kann, wenn er zuvor sein
        Postfach abgefragt hat (SMTP-after-POP) kann dies mit Hilfe eines Shell-Skriptes
        und eines Cronjobs erledigen.  Ein Beispielskript findet sich unter
        /usr/share/doc/mail/examples und hei"st `exim-smtp-after-pop'.
        Vor der Verwendung diese Scripts sollte auf jeden Fall gepr"uft werden, ob der
        Provider nicht doch schon SMTP-Auth unterst"utzt, da diese Art der Authentifizierung
        mit den Standardoptionen realisierbar ist.

    \config{Spam-Nachrichten automatisch l"oschen}{Spam-Nachrichten automatisch l"oschen}{Spam-Nachrichtenautomatischloeschen}
        Sollen Nachrichten, deren Spam-Klassifizierung >= 10 ist, automatisch gel"oscht
        werden, so kopiert man den im Verzeichnis /usr/share/doc/mail/examples mitgelieferten
        Custom-Filter mit Namen `custom-systemfilter.rm\_spam\_mail' in das Verzeichnis
        /var/spool/exim und generiert eine neue Konfiguration. Der Filter wurde erfolgreich
        aktiviert, wenn die folgende Meldung am Bildschirm angezeigt wird:\\

\begin{verbatim}
creating system-filter file ...
adding custom system filter /var/spool/exim/custom-systemfilter.rm_spam_mail ...
\end{verbatim}

    \config{Virus-Benachrichtigung}{Virus-Benachrichtigung}{Virus-Benachrichtigung}
        Wer automatisch den Empf"anger und/oder den Absender einer Nachricht dar"uber
        informieren m"ochte, dass die an ihn gerichtete bzw. von ihm verschickte
        Nachricht einen Virus enthalten hat, sollte sich die im Verzeichnis /usr/share/doc/mail/examples
        abgelegte Filterdatei `exim-virus-notification' anschauen und an seine
        Verh"altnisse anpassen. F"ur weitere Informationen bitte die \jump{EMailFilter}{Exim-Filterspezifikation}
        lesen.
\end{description}
