Unterabschnitte

Das Webmail-Paket

Dieses Paket ist als Zusatzpaket zum Mail-Paket zu verstehen und ermöglicht den komfortabelen Zugriff auf die E-Mail-Postfächer über eine Web-Oberfläche.

Die Einleitung

In diesem Paket wurden verschiedenste Komponenten zusammengestellt, die zusammen ein komplettes Webmail-Paket ergeben. Als Web-Frontend-Anwendung wird hierbei SquirrelMail verwendet, welches komplett auf PHP5 basiert.

Die Funktionen

Das Webmail-Paket besteht aus folgenden Komponenten:

Die Voraussetzungen

Dieses Paket benötigt das Mail-Paket mit aktiviertem IMAP-Server, sowie die Apache2- und Apache2_php5-Paket um funktionieren zu können.

Die Installation

Das Webmail-Paket wird über das Setup-Menü installiert. Wird eine ältere Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen Programmdateien installiert werden. Nach dem Installieren der Programmdateien wird direkt der Konfigurations-Editor gestartet um die Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die Konfigurationsdateien generiert und alle benötigten Programme gestartet. Danach kann über einen Webbrowser, durch Eingabe von `http://<Name des eisfair-Servers>/webmail/`, auf die Anwendung zugegriffen werden.

Das Menü im Setup-Programm

Das Menü im Setup-Programm wird über `Mail Services' -> `Goto mail modules' angesprochen und ist wie folgt aufgebaut:

Die Menüpunkte dürften selbsterklärend sein, da sie keinerlei weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen.

Die Änderung der Konfiguration

Die Konfiguration kann über den Menüpunkt `Edit configuration' geändert werden. Standardmäßig wird der Editor aufgerufen, der in der Environment- Konfiguration über die Variable 'EDITOR' festgelegt wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies bestätigt, werden über ein Skript die Anpassungen umgehend wirksam gemacht.
Hinweis
Es ist zu beachten, dass einige Programme eigenständig bei erneuter Aktivierung die Konfigurationsdatei neu einlesen, somit führt ein Beantwortung dieser Abfrage mit 'Nein' nur zu einem kurzen Aufschub der Aktivierung.


Die Konfigurationsdatei

In der Konfigurationsdatei, die über das Menü zugänglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/webmail.

Die Parameter

START_WEBMAIL
Für die Aktivierung des Webmail-Programms muss dieser Parameter lediglich auf den Wert `yes' gestellt werden. Die Einstellung `no' deaktiviert das Webmail-Programm.

Gültige Werte: yes, no

Standardeinstellung: START_WEBMAIL='no'

WEBMAIL_N
Über diesen Parameter wird die Anzahl der webmail-Instanzen angegeben, die eingerichtet werden sollen.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_N='1'

WEBMAIL_x_ACTIVE
Wird dieser Parameter auf den Wert `yes' gesetzt, so wird die zugehörige webmail-Instanz aktiviert, `no' deaktiviert sie.

Gültige Werte: yes oder no

Beispiel: WEBMAIL_1_ACTIVE='no'

WEBMAIL_x_DOCUMENT_ROOT
Über diesen Parameter wird das Document-Root-Verzeichnis festgelegt.

Gültige Werte: absolute Pfadangabe

Standardeinstellung: WEBMAIL_1_DOCUMENT_ROOT='/var/www/htdocs/webmail'

WEBMAIL_x_SERVER_DOMAIN
Über diesen Parameter wird der Domainname der lokalen Domain festgelegt, für welche SquirrelMail zuständig sein soll. Sie sollte identisch mit der Variable SMTP_QUALIFY_DOMAIN aus dem Mail-Paket sein.

Gültige Werte: Domain-Name

Beispiel: WEBMAIL_1_SERVER_DOMAIN='domain.de'

WEBMAIL_x_SERVER_DOMAIN_CHECK
Über diesen Parameter kann die Prüfung der Zugriffsdomain beim Zugriff auf alle SquirrelMail Seiten aktiviert werden. Dies kann helfen sicher zu stellen, dass die Seitenzugriffe vom selben Server und nicht von einem Fremdserver kommen (Dies passiert üblicherweise bei XSS oder Phishing-Attacken). Weicht die beim Zugriff verwendete Domain von der über den Parameter WEBMAIL_x_SERVER_DOMAIN festgelegten Domain ab, so wird der Zugriff nach Ausgabe einer Meldung verweigert.
ACHTUNG
Diese Prüfungen sind nicht narrensicher und manche Browser können diese umgehen oder absichtlich keine Referal-Informationen senden (In diesem Fall wird die Prüfung der Zugriffsdomain stillschweigend übersprungen). Wird der Parameter auf den Wert `no' gesetzt, so wird diese zusätzliche Prüfung deaktiviert.


Gültige Werte: yes oder no

Standardeinstellung: WEBMAIL_1_SERVER_DOMAIN_CHECK='yes'

Die folgenden WEBMAIL_x_SERVER_..-Parameter werden nur dann ausgewertet, wenn auf dem lokalen Rechner kein installiertes Mail- oder Vmail-Paket gefunden wird. Sie ermöglichen den Zugriff auf einen Mailserver, welcher auf einem anderen Rechner betrieben wird.

WEBMAIL_x_SERVER_IMAP_HOST
Über diesen Parameter wird der Servername des Rechners festgelegt welcher die IMAP-Postfächer verwaltet. Optional kann, durch einen Doppelpunkt getrennt, ein vom Standard abweichender TCP-Port konfiguriert werden.

Gültige Werte: Domain-Name zzgl. optionalem TCP-Port

Standardeinstellung: WEBMAIL_1_SERVER_IMAP_HOST='localhost'

WEBMAIL_x_SERVER_IMAP_AUTH
Über diesen Parameter kann die Authentifizierungsmethode festgelegt werden, welche beim Zugriff auf einen entfernten IMAP-Server verwendet werden soll.
Hinweis: Ist auf dem entfernten Mailserver das mail-Paket installiert und wurde dort der Parameter MAIL_USER_USE_MAILONLY_PASSWORDS='yes' gesetzt, so muss hier `md5' (cram-md5), ansonsten `login' eingestellt werden.

Hinweis: Ist auf dem entfernten Mailserver das vmail-Paket installiert so muss hier `login' eingestellt werden.

Gültige Werte: md5, digest, login

Standardeinstellung: WEBMAIL_1_SERVER_IMAP_AUTH='md5'

WEBMAIL_x_SERVER_IMAP_TYPE
Über diesen Parameter kann der IMAP-Servertyp eingestellt werden, zu welchem sich verbunden werden soll. Es kann zwischen den Typen `uw' (Mail-Paket) und `courier' (Vmail-Paket für eisfair-1) bzw. `dovecot' (Vmail-Paket für eisfair-2) gewählt werden.

Gültige Werte: uw, courier oder dovecot

Standardeinstellung: WEBMAIL_1_SERVER_IMAP_TYPE='uw'

WEBMAIL_x_SERVER_IMAP_TRANSPORT
Über diesen Parameter kann die verschlüsselte Kommunikation mit dem IMAP-Prozess aktiviert werden. Wird der Parameter auf den Wert `default' gesetzt, so wird über eine unverschlüsselte Verbindung kommuniziert.

Gültige Werte: tls oder default

Standardeinstellung: WEBMAIL_1_SERVER_IMAP_TRANSPORT='default'

WEBMAIL_x_SERVER_SMTP_HOST
Über diesen Parameter wird der Servername des Rechners festgelegt auf welchem der SMTP-Server läuft. Optional kann, durch einen Doppelpunkt getrennt, ein vom Standard abweichender TCP-Port konfiguriert werden.

Gültige Werte: Domain-Name zzgl. optionalem TCP-Port

Standardeinstellung: WEBMAIL_1_SERVER_SMTP_HOST='localhost'

WEBMAIL_x_SERVER_SMTP_TYPE
Über diesen Parameter kann die Authentifizierungsmethode festgelegt werden, welche beim Zugriff auf einen entfernten SMTP-Server verwendet werden soll.
Hinweis: Ist auf dem entfernten Mailserver das mail-Paket installiert und wurde dort der Parameter SMTP_AUTH_TYPE='none' gesetzt, so muss hier ebenfalls der Wert 'none' eingestellt werden. Wurde der Parameter SMTP_AUTH_TYPE='user' oder 'user_light' gesetzt, so muss bei gesetztem MAIL_USER_USE_MAILONLY_PASSWORDS='yes' `md5' (cram-md5), ansonsten `login' eingestellt werden.
Hinweis: Ist auf dem entfernten Mailserver das vmail-Paket installiert so muss hier `login' eingestellt werden.

Gültige Werte: md5, digest, login, none

Standardeinstellung: WEBMAIL_1_SERVER_SMTP_AUTH='md5'

WEBMAIL_x_SERVER_SMTP_TRANSPORT
Über diesen Parameter kann die verschlüsselte Kommunikation mit dem SMTP-Server aktiviert werden. Wird der Parameter auf den Wert `default' gesetzt, so wird über eine unverschlüsselte Verbindung kommuniziert.

Gültige Werte: tls oder default

Standardeinstellung: WEBMAIL_1_SERVER_SMTP_TRANSPORT='default'

WEBMAIL_x_ORGA_NAME
Über diesen Parameter kann an verschiedenen Stellen in der Webmail-Oberfläche der Firmenname, an Stelle von `eisfair-Webmail', eingeblendet werden.

Gültige Werte: Textstring

Standardeinstellung: WEBMAIL_1_ORGA_NAME='eisfair-Webmail'

WEBMAIL_x_ORGA_TITLE
Über diesen Parameter kann festgelegt werden, was im Browser-Titel, an Stelle von `eisfair-Webmail', angezeigt werden soll.

Gültige Werte: Textstring und Variablen

Standardeinstellung: WEBMAIL_1_ORGA_TITLE='eisfair-Webmail'

WEBMAIL_x_ORGA_LOGO
Über diesen Parameter wird das Firmen-Logo festgelegt, welches an verschiedenen Stellen der Webmail-Oberfläche angezeigt wird. Es kann entweder ein relativer oder ein absoluter Verzeichnispfad angegeben werden.

Gültige Werte: Pfad- und Dateiname

Standardeinstellung: WEBMAIL_1_ORGA_LOGO='images/eisfair_logo_gross.png'

WEBMAIL_x_ORGA_LOGO_WIDTH
Dieser Parameter legt fest, mit welcher Breite das über WEBMAIL_x_ORGA_LOGO festgelegte Logo angezeigt werden soll.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_ORGA_LOGO_WIDTH='435'

WEBMAIL_x_ORGA_LOGO_HEIGHT
Dieser Parameter legt fest, mit welcher Höhe das über WEBMAIL_x_ORGA_LOGO festgelegte Logo angezeigt werden soll.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_ORGA_LOGO_HEIGHT='168'

WEBMAIL_x_ORGA_SIGNOUT_PAGE
Dieser Parameter legt fest auf welche Seite der Anwender, nach Betätigen des `Abmelde'-Knopfes umgelenkt werden soll. Wird der Parameter leer gelassen, so wird die Standard-Abmeldeseite verwendet.

Gültige Werte: Pfad- und Dateiname

Standardeinstellung: WEBMAIL_1_ORGA_SIGNOUT_PAGE=''

WEBMAIL_x_ORGA_DEF_LANGUAGE
Dieser Parameter legt fest, welche Standardsprache verwendet werden soll, wenn dies von SquirrelMail nicht automatisch, z.B. Über die Browser-Konfiguration, erkannt wird. Bitte den korrekten Ländercode für die gewünschte Sprache verwenden. Der Wert `de_DE' steht hierbei für die deutsche Sprache. Es kann zur Zeit zwischen folgenden Länder-Codes gewählt werden:
ar, bg_BG, ca_ES, cs_CZ, cy_GB, da_DK, de_DE, el_GR, es_ES, et_EE, fi_FI, fo_FO, fr_FR, he_IL, hr_HR, hu_HU, id_ID, is_IS, it_IT, ja_JP, ko_KR, lt_LT, ms_MY, nl_NL, nn_NO, no_NO, pl_PL, pt_BR, pt_PT, ro_RO, ru_RU, sk_SK, sl_SI, sr_YU, sv_SE, th_TH, tr_TR, uk_UA, vi_VN, zh_CN, zh_TW

Gültige Werte: Locale-Kennung

Standardeinstellung: WEBMAIL_1_ORGA_DEF_LANGUAGE='de_DE'

WEBMAIL_x_ORGA_TOP_FRAME
Standardmäßig wird SquirrelMail im kompletten Browser-Fenster angezeigt. Soll die Bildschirmausgabe in einen bestimmten Rahmen einer HTML-Seite angezeigt werden, so wird der Rahmenname über diesen Parameter festgelegt.

Gültige Werte: Frame-Name

Standardeinstellung: WEBMAIL_1_ORGA_TOP_FRAME='_top'

WEBMAIL_x_ORGA_PROVIDER_NAME
Über diesen Parameter wird der Name des Providers konfiguriert, dessen Link im Menü von Squirrelmail angezeigt werden soll.

Gültige Werte: Provider Name

Standardeinstellung: WEBMAIL_1_ORGA_PROVIDER_NAME='eisfair'

WEBMAIL_x_ORGA_PROVIDER_URL
Über diesen Parameter wird die URL des Providers konfiguriert, dessen Name über den Parameter WEBMAIL_x_ORGA_PROVIDER_NAME festgelegt wurde.

Gültige Werte: URL

Standardeinstellung: WEBMAIL_1_ORGA_PROVIDER_URL='http://www.eisfair.org/'

WEBMAIL_x_FOLDER_MOVE_MSGS_TO_TRASH
Wird dieser Parameter auf `yes' gestellt, so werden Nachrichten beim Löschen in den Papierkorb verschoben und nicht direkt gelöscht.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_MOVE_MSGS_TO_TRASH='yes'

WEBMAIL_x_FOLDER_MOVE_MSGS_TO_SEND
Wird dieser Parameter auf `yes' gestellt, so werden Nachrichten nach dem Versand in den Sent-Ordner verschoben und nicht direkt gelöscht.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_MOVE_MSGS_TO_SEND='yes'

WEBMAIL_x_FOLDER_MOVE_MSGS_TO_DRAFT
Wird dieser Parameter auf `yes' gestellt, so wird beim Abbrechen der Nachrichtenbearbeitung abgefragt, ob diese im Draft-Ordner gespeichert werden soll.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_MOVE_MSGS_TO_DRAFT='yes'

WEBMAIL_x_FOLDER_SPECIAL_LIST_FIRST
Wird dieser Parameter auf `yes' gestellt, so werden die `speziellen' Mail-Ordner, wie z.B. INBOX-, Sent- oder Draft-Ordner, am Anfang der Ordnerliste angezeigt.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_SPECIAL_LIST_FIRST='yes'

WEBMAIL_x_FOLDER_SPECIAL_USE_COLOR
Wird dieser Parameter auf `yes' gestellt, so werden die `speziellen' Mail-Ordner, wie z.B. INBOX-, Sent- oder Draft-Ordner, in einer gesonderten Farbe angezeigt.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_SPECIAL_USE_COLOR='yes'

WEBMAIL_x_FOLDER_AUTO_EXPUNGE
Ein IMAP-Server handhabt das Löschen von Nachrichten wie folgt: Erst wird die Nachricht nur zum Löschen markiert, anschliessend endgültig gelöscht. Wird dieser Parameter auf `yes' gesetzt, so werden Nachrichten von SquirrelMail direkt gelöscht. Wird 'no' eingestellt, so werden diese nur zum Löschen markiert.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_FOLDER_AUTO_EXPUNGE='yes'

WEBMAIL_x_FOLDER_UNSEEN_NOTIFY
Über diesen Parameter wird festgelegt, in welchem Fall ein Anwender standardmäßig über neue Nachrichten informiert werden soll. Zur Auswahl stehen folgende Optionen:

`none' - keine Benachrichtigung.
`inbox' - nur bei neuen Nachrichten im INBOX-Ordner benachrichtigen.
`all' - bei neuen Nachrichten in allen Ordnern benachrichtigen.

Diese Einstellung kann von jedem Anwender individuell angepasst werden.

Gültige Werte: none, inbox, all

Standardeinstellung: WEBMAIL_1_FOLDER_UNSEEN_NOTIFY='inbox'

WEBMAIL_x_FOLDER_UNSEEN_TYPE
Über diesen Parameter wird eingestellt, wie ungelesenen Nachrichten im linken Rahmen angezeigt werden sollen. Zur Auswahl stehen:

`unseen' - nur ungelesene Nachrichten zeigen, z.B. (4)
`both' - ungelesene und gesamte Anzahl Nachrichten zeigen, z.B. (4/27)

Gültige Werte: unseen, both

Standardeinstellung: WEBMAIL_1_FOLDER_UNSEEN_TYPE='both'

WEBMAIL_x_GENERAL_DEF_CHARSET
Dieser Parameter legt fest welcher Zeichensatz beim Versenden von Nachrichten und bei der HTML-Anzeige verwendet werden soll. Verwenden Sie an Stelle von `US_ASCII' auf jeden Fall `UTF-8'. Um kyrillischen Text anzuzeigen stellen Sie `KOI8-R' ein, dies führt zu einer eindeutigen Geschwindigkeitssteigerung.

Gültige Werte: utf-8, iso-8859-1, koi8-r, ...

Standardeinstellung: WEBMAIL_1_GENERAL_DEF_CHARSET='utf-8'

WEBMAIL_x_GENERAL_LEFT_FRAME_WIDTH
Über diesen Parameter wird die Breite des linken Ordnerrahmens, in Pixel, festgelegt. Diese Einstellung kann von jedem Anwender individuell angepasst werden.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_GENERAL_LEFT_FRAME_WIDTH='200'

WEBMAIL_x_GENERAL_ALLOW_PRIORITY_USE
Wird dieser Parameter auf `yes' gesetzt, so kann jeder Anwender die Priorität von zu versendenden Nachrichten vorgeben.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_GENERAL_ALLOW_PRIORITY_USE='yes'

WEBMAIL_x_GENERAL_ALLOW_RECEIPTS_USE
Wird dieser Parameter auf `yes' gesetzt, so kann jeder Anwender Lese- und Zustellbenachrichtigungen für gesendete Nachrichten anfordern.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_GENERAL_ALLOW_RECEIPTS_USE='yes'

WEBMAIL_x_GENERAL_ALLOW_IDENTITY_EDIT
Wird dieser Parameter auf `yes' gesetzt, so ist es dem Anwender gestattet seinen Anwendernamen und seine E-Mail-Adresse zu bearbeiten.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_GENERAL_ALLOW_IDENTITY_EDIT='yes'

WEBMAIL_x_THEMES_USE_ALL
Wird dieser Parameter auf `yes' gesetzt, so werden alle zur Verfügung stehenden SquirrelMail-Themen aktiviert. Wird dieser Parameter auf `no' gesetzt, so können über die Parameter WEBMAIL_x_THEMES_N bzw. WEBMAIL_x_THEMES_y_FILENAME Themen individuell aktiviert werden.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_THEMES_USE_ALL='yes'

WEBMAIL_x_THEMES_DEFAULT
Über diesen Parameter kann das Standard-Thema festgelegt werden welches in Squirrelmail verwendet werden soll. Ein Anwender kann diese Einstellung individuell ändern. Wird als Wert `0' eingegeben, so wird das interne `Standard-Thema' von Squirrelmail verwendet.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_THEMES_DEFAULT='0'

WEBMAIL_x_THEMES_N / WEBMAIL_x_THEMES_y_FILENAME
Über den Parameter WEBMAIL_x_THEMES_N wird die Anzahl der zu aktivierenden SquirrelMail-Themen eingestellt. Über WEBMAIL_x_THEMES_x_FILENAME werden die Namen der zu aktivierenden Themen festgelegt.

Gültige Werte: Zahl bzw. Dateiname

Beispiel:

WEBMAIL_1_THEMES_N='0'
WEBMAIL_1_THEMES_1_FILENAME='default_theme.php'
WEBMAIL_1_THEMES_2_FILENAME='alien_glow.php'
WEBMAIL_1_THEMES_3_FILENAME='black_bean_burrito_theme.php'
WEBMAIL_1_THEMES_4_FILENAME='blue_grey_theme.php'

WEBMAIL_PLUGINS_x_USE_ALL
Wird dieser Parameter auf `yes' gesetzt, so werden alle zur Verfügung stehenden SquirrelMail-Plugins aktiviert. Wird dieser Parameter auf `no' gesetzt, so können über den Parameter WEBMAIL_x_PLUGINS_N bzw. WEBMAIL_x_PLUGINS_y_DIRNAME Plugins individuell aktiviert werden.

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_x_PLUGINS_USE_ALL='no'

WEBMAIL_x_PLUGINS_N / WEBMAIL_x_PLUGINS_y_DIRNAME
Über den Parameter WEBMAIL_x_PLUGINS_N wird die Anzahl der zu aktivierenden SquirrelMail-Plugins eingestellt. Über WEBMAIL_x_PLUGINS_y_DIRNAME werden die Namen der zu aktivierenden Plugins festgelegt. Neue Plugins müssen unter dem Verzeichnis
`/var/www/htdocs/webmail/plugins' abgelegt werden.

Gültige Werte: Zahl bzw. Verzeichnisname

Beispiel:

WEBMAIL_1_PLUGINS_N='5'
WEBMAIL_1_PLUGINS_1_DIRNAME='calendar'
WEBMAIL_1_PLUGINS_2_DIRNAME='newmail'
WEBMAIL_1_PLUGINS_3_DIRNAME='squirrel_logger'
WEBMAIL_1_PLUGINS_4_DIRNAME='show_user_and_ip'
WEBMAIL_1_PLUGINS_5_DIRNAME='wetteronline'

WEBMAIL_x_PLUGINS_ADMINUSER
Über diesen Parameter wird der für das administrator-Plugin benötigte Name des Administrator festgelegt, welcher aus der Entfernung die Webmail-Konfiguration ändern können soll.

Gültige Werte: leer, Username

Standardeinstellung: WEBMAIL_1_PLUGINS_ADMINUSER=''

WEBMAIL_x_GLOBADDR_FILE_WRITEABLE
Wird dieser Parameter auf `yes' gesetzt, so wird das Ändern des globalen Adressbuchs zugelassen. Wird der Parameter auf `no' gesetzt, so wird das Bearbeiten des Adressbuchs unterbunden. Hinweis: Um das globale Adressbuch bearbeiten zu können, erhält der Apache-Systemuser 'wwwrun' Schreibrechte auf die Adressdatei!

Gültige Werte: yes, no

Standardeinstellung: WEBMAIL_1_GLOBADDR_FILE_WRITEABLE='no'

WEBMAIL_x_GLOBADDR_FILE_N
Über diesen Parameter wird die Anzahl der vorgegebenen Einträge für das globale Adressbuch eingestellt. Wird dieser Wert auf `0' gesetzt, so wird kein globales Adressbuch verwendet.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_GLOBADDR_FILE_N='0'

WEBMAIL_x_GLOBADDR_FILE_x_NICKNAME
Über diesen Parameter wird das Kürzel eines globalen Adressbucheintrages festgelegt.

Gültige Werte: Kürzel

Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_NICKNAME='tommy'

WEBMAIL_x_GLOBADDR_FILE_y_FIRSTNAME
Über diesen Parameter wird der Vorname eines globalen Adressbucheintrages festgelegt.

Gültige Werte: Vorname

Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_FIRSTNAME='Thomas'

WEBMAIL_x_GLOBADDR_FILE_y_LASTNAME
Über diesen Parameter wird der Nachname eines globalen Adressbucheintrages festgelegt.

Gültige Werte: Nachname

Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_LASTNAME='Mueller'

WEBMAIL_x_GLOBADDR_FILE_y_EMAIL
Über diesen Parameter wird die E-Mail-Adresse eines globalen Adressbucheintrages festgelegt.

Gültige Werte: E-Mail-Adresse

Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_EMAIL='tommy@domain.de'

WEBMAIL_x_GLOBADDR_FILE_y_INFO
Über diesen Parameter werden zusätzliche Informationen eines globalen Adressbucheintrages festgelegt.

Gültige Werte: Text

Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_INFO='WebAdmin'

Hinweis: Will man eine grosse Anzahl von Einträgen anlegen, so ist es möglich diese über eine csv-Datei der aktuellen Konfigurationsdatei hinzuzufügen. Hierzu kopiert man eine Datei `global_addresses.csv' in das Verzeichnis /var/webmail und ruft das Programm `/var/install/bin/webmail-update import' auf.
Eine bestehende User-Liste kann in eine Datei `global_addresses.csv' im Verzeichnis /var/webmail exportiert werden, indem man das Programm `/var/install/bin/webmail-update export' aufruft.

Die csv-Datei muss wie folgt aufgebaut sein:

#nick,firstname,lastname,email address,comment
nick1,firstname1,lastname1,email address1,comment1
nick2,firstname2,lastname2,email address2,comment2

WEBMAIL_x_GLOBADDR_LDAP_N
Über diesen Parameter wird die Anzahl der globalen LDAP-Adressbücher angegeben auf welche zugegriffen werden soll. Wird dieser Wert auf `0' gesetzt, so werden keine globalen LDAP-Adressbücher verwendet.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_1_GLOBADDR_LDAP_N='0'

WEBMAIL_x_GLOBADDR_LDAP_y_ACTIVE
Für die Aktivierung des LDAP-basierten, globalen Adressbuches muss diese Variable lediglich auf den Wert `yes' gestellt werden. Die Einstellung `no' deaktiviert das Adressbuch.

Gültige Werte: yes, no

Standardwert: WEBMAIL_1_GLOBADDR_LDAP_1_ACTIVE='no'

WEBMAIL_x_GLOBADDR_LDAP_y_INFO
Über diesen Parameter kann ein beschreibender Text zum LDAP-Adressbuch festgelegt werden.

Gültige Werte: Text

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_INFO='My LDAP directory'

WEBMAIL_x_GLOBADDR_LDAP_y_BASEDN
Über diesen Parameter wird die base-dn für den Zugriff auf das globale LDAP-Adressbuch festgelegt.

Gültige Werte: base-dn

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BASEDN='ou=contacts,ou=addressbook,dc=domain,dc=lan'

WEBMAIL_x_GLOBADDR_LDAP_y_HOST
Über diesen Parameter wird der Name des Rechners festgelegt auf welchem der LDAP-Server läuft.

Gültige Werte: Hostname oder IP-Adresse

Standardwert: WEBMAIL_1_GLOBADDR_LDAP_1_HOST='localhost'

Beispiel:
WEBMAIL_1_GLOBADDR_LDAP_1_HOST='ldap://myldap.local.lan:389'
WEBMAIL_1_GLOBADDR_LDAP_1_HOST='ldaps://myldap.local.lan'

WEBMAIL_x_GLOBADDR_LDAP_y_AUTH
Falls eine Authentifikation gegenüber des LDAP-Servers erforderlich ist, so muss diese Variable lediglich auf den Wert `yes' gestellt werden. Bei der Einstellung `no' wird keine Authentifizierung durchgeführt.

Gültige Werte: yes, no

Standardwert: WEBMAIL_1_GLOBADDR_LDAP_1_AUTH='no'

WEBMAIL_x_GLOBADDR_LDAP_y_BINDDN
Über diesen Parameter wird die bind-dn für die Authentifizierung am LDAP-Server festgelegt.

Gültige Werte: bind-dn

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BINDDN='cn=ldapadmin,dc=domain,dc=lan'

WEBMAIL_x_GLOBADDR_LDAP_y_BINDPASS
Über diesen Parameter wird das bind-Kennwort für die Authentifizierung am LDAP-Server festgelegt.

Gültige Werte: Kennwort

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BINDPASS='my-secret'

WEBMAIL_x_GLOBADDR_LDAP_y_PORT (Optionaler Parameter)
Über diesen Parameter kann ein vom Standardport (389/tcp) abweichender TCP-Port für den Zugriff auf den LDAP-Server festgelegt werden.

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_PORT='10389'

WEBMAIL_x_GLOBADDR_LDAP_y_CHARSET (Optionaler Parameter)
Über diesen Parameter kann ein vom Standardzeichensatz, welcher über den Parameter WEBMAIL_x_GENERAL_DEF_CHARSET definiert wurde, abweichender Zeichensatz festgelegt werden.

Beispiel: WEBMAIL_1_GENERAL_DEF_CHARSET='utf-8'

WEBMAIL_x_GLOBADDR_LDAP_y_MAXROWS (Optionaler Parameter)
Über diesen Parameter wird die maximale Anzahl von Antwortzeilen definiert die für die Anzeige des Suchergebnisses genutzt werden, ansonsten wird der Standardwert '150' verwendet.

Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_MAXROWS='200'

WEBMAIL_ATTACH_CRON_SCHEDULE
Hier wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall zurückgelassene Attachments aus dem Verzeichns
`/var/webmail/attach' gelöscht werden sollen. Es werden grundsätzlich nur Dateien, die älter als 24 Stunden sind gelöscht. Die fünf Teilparameter haben dabei folgende Bedeutung:

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

D.h. bei Verwendung der Standardeinstellung wird jeden Tag um 03:07h die Bereinigung des Verzeichnisses durchgeführt. Wer Näheres über die verwendete Befehlsyntax erfahren möchte, sollte über eine Internet-Suchmaschine nach `man' und `crontab' suchen.

Gültige Werte: Crontab-spezifischer Parametereintrag

Standardeinstellung: WEBMAIL_ATTACH_CRON_SCHEDULE='7 3 * * *'

WEBMAIL_LOG_COUNT
Über diesen Parameter wird eingestellt, wie viele Logdateien vorgehalten werden sollen. Wird dieser Wert überschritten, so wird die älteste Logdatei gelöscht.

Gültige Werte: Zahl

Standardeinstellung: WEBMAIL_LOG_COUNT='6'

WEBMAIL_LOG_INTERVAL
Dieser Parameter bestimmt in welchen Intervallen die Logdateien archiviert werden sollen. Zur Auswahl stehen die Schlüsselwörter `daily' - täglich, `weekly' - wöchentlich und `monthly - monatlich.

Gültige Werte: daily, weekly, monthly

Standardeinstellung: WEBMAIL_LOG_INTERVAL='weekly'

Die Plugins

Über SquirrelMail-Plugins können zusätzliche Funktionen in das Webmail-Paket eingebunden werden. Hierbei obliegt es jedem Einzelnen zu entscheiden ob er ein Plugin, trotz eventueller Sicherheitsrisiken, aktivieren möchte oder nicht. Abhängig von den jeweiligen Plugins kann es notwendig sein, dass zuvor andere Programme installiert werden müssen, die über das Webmail-Paket bzw. den eisfair-Server nicht zur Verfügung gestellt werden. Es wird empfohlen, vor einer Aktivierung eines Plugins, die im jeweiligen Plugin-Verzeichnis vorhandene Dokumentation zu lesen und sich über die SquirrelMail-Webseite (http://www.squirrelmail.org) weiter zu informieren.
Standardmässig werden einige Plugins mitgeliefert, deren Funktion hier kurz beschrieben wird.

address_add-Plugin
Dieses Plugin erlaubt es auf einfache Weise den Absender einer Nachricht zum eigene Adressbuch hinzuzufügen.

administrator-Plugin
Dieses Plugin erlaubt es einem Administrator, dessen Login über den Parameter WEBMAIL_x_PLUGINS_ADMINUSER festgelegt werden muss, die Konfiguration von Squirrelmail aus der Entfernung zu modifizieren. Bedenken Sie, dass die Verwendung dieses Plugins gewissen Sicherheitsrisiken mit sich bringen kann.

bug_report-Plugin
Diese Plugin ermöglicht es einem Anwender einen gefundenen Fehler, inklusiv zusätzlicher Systeminformationen direkt an die SquirrelMail-Entwickler zu übermitteln.

calendar-Plugin
Dieses Plugin stellt einen einfachen Kalender mit Tages- und Monatsansicht zur Verfügung. Es ist möglich Termine anzulegen, zu löschen bzw. zu aktualisieren.

compatibility-Plugin
Dieses Plugin stellt Funktionen zur Verfügung, die es ermöglichen auch Plugins zu verwenden, die für frühere Squirrelmail-Versionen geschrieben wurden. Es ist nicht notwendig dieses Plugin zur Auswahl hinzuzufügen.

delete_move_next-Plugin
Dieses Plugin ermöglich ein direkter Weiterblättern zur nächsten Nachricht, ohne zuvor an den Nachrichtenanfang zurückspringen zu müssen. Ausserdem ist es möglich, direkt nach dem Löschen oder Verschieben einer Nachricht die nächste Nachricht anzusehen.

filters-Plugin
Dieses Plugin ermöglicht es Filter-Regeln für eingehende Nachrichten zu definieren.

info-Plugin
Dieses Plugin fügt dem Optionsmenü eine `IMAP server information'-Seite hinzu. Ein Administrator kann über die vorgegebenen oder auch eigens einzugebende Befehle prüfen, welche Kommandos vom IMAP-Server akzeptiert werden bzw. welche Antworten von diesem angezeigt werden.

listcommands-Plugin
Dieses Plugin ergänzt im Menü zusätzliche Befehle, die die Benutzung von Mailinglisten erleichtern.

message_details-Plugin
Dieses Plugin ermöglicht es eine Nachrichten im Rohformat (RFC822) anzeigen zu lassen.

newmail-Plugin
Dieses Plugin ermöglicht eine akustische Benachrichtigung bei ungelesenen Nachrichten.

show_user_and_ip-Plugin
Dieses Plugin ermöglicht die Anzeige des Benutzernamens und der aktuellen IP-Adresse im linken Ordnerrahmen.

squirrel_logger-Plugin
Dieses Plugin schreibt Informationen über Anwender-Logins und Logouts in die Datei `/var/webmail/log/access_log'. Bei Aktivierung dieses Plugins wird automatisch ein Logrotate-Eintrag angelegt, der die Datei in regelmäßigen Abständen archiviert. Siehe hierzu auch `WEBMAIL_LOG_COUNT' und `WEBMAIL_LOG_INTERVAL'.

timeout_user-Plugin
Dieses Plugin ermöglicht das automatisierte Ausloggen einen Anwenders nach Ablauf einer vorgegebenen Zeitspanne.

translate-Plugin
Dieses Plugin ermöglicht es, fremdsprachliche Nachrichten über öffentliche Übersetzungsdienste im Internet übersetzen zu lassen.

uw_folders-Plugin
Diese Plugin ermöglicht die Anzeige der Shared- und Public-Ordner.

wetteronline-Plugin
Dieses Plugin ermöglicht die Anzeige der voraussichtlichen Wetterlage im linken Ordnerrahmen.

Die Sprachpakete

Es ist möglich bei Bedarf über das Menü weitere Sprachdateien zu installieren bzw. bereits installierte Sprachdateien zu entfernen. Hierzu geht man wie folgt vor:

Für die Deinstallation eines Sprachdatei wählt man den entsprechenden Menüeintrag 'Remove installed locale(s).

Verschiedenes

PHP-Fehlermeldungen
Werden z.B. in der Ordner-Funktion Meldungen über nicht initialisierte Variablen angezeigt, so sollte man prüfen, ob in der Datei `/etc/php.ini' der folgende Parameter gesetzt wurde:

;error_reporting  =  E_ALL                               # alt
error_reporting  =  E_ALL & ~E_NOTICE & ~E_USER_NOTICE   # neu

PHP-LDAP-Zugriff
Um verschlüsselt auf ein LDAP-Verzeichnis zugreifen zu können muss zuvor das ldapclient-Paket installiert werden.
Wurde für den LDAP-Server ein selbstsigniertes Zertifikat verwendet, so ist in der Konfiguration des ldapclient-Paketes sicher zu stellen, dass der Parameter LDAPCLIENT_SERVER_CERT_CHECK dessen Verwendung nicht verweigert. Wird des Wert des Parameters z.B. auf 'never' gesetzt, so erfolgt keine Prüfung der Zertifikatskette. Mittels des im Verzeichnis /usr/share/doc/webmail mitgelieferten PHP-Skripts 'test-ldap.php' kann der Zugriff auf einen LDAP-Server getestet werden. Das Skript ist hierzu in den Webserverpfad zu kopieren, die Zugriffsrechte und Skriptparameter anzupassen und dann über einen Webbrowser aufzurufen.

Yves Schumann 2012-05-08