Das Webmail-Paket Dieses Paket ist als Zusatzpaket zum Mail-Paket zu verstehen und ermoeglicht den komfortabelen Zugriff auf die Email-Postfaecher ueber eine Web-Oberflaeche. 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: * SquirrelMail - Der Web-Frontend fuer den Zugriff auf das IMAP-Postfach ([1]http://www.squirrelmail.org/) * SquirrelMail-Plugins - Stellen zusaetzliche Programmfunktionen zur Verfuegung ([2]http://www.squirrelmail.org/) Die Voraussetzungen Diese Paket benoetigt das Mail-Paket mit aktiviertem IMAP-Server, sowie die Apache2- und Apache2_php5-Paket um funktionieren zu koennen. Die Installation Das Webmail-Paket wird ueber das Setup-Menue installiert. Wird eine aeltere 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 benoetigten Programme gestartet. Danach kann ueber einen Webbrowser, durch Eingabe von `http:///webmail/`, auf die Anwendung zugegriffen werden. Das Menue im Setup-Programm Das Menue im Setup-Programm wird ueber `Mail Services' -> `Goto mail modules' angesprochen und ist wie folgt aufgebaut: * Webmail interface + View documentation: Anzeigen der Dokumentation + Edit configuration: Bearbeiten der Konfiguration + Advanced configuration file handling: Konfigurationen verwalten + View configuration log file: Die Konfigurations-Logmeldungen anzeigen + List installed locale(s): Installierte Sprachpakete anzeigen + Install additional locale(s): Neues Sprachpaket installieren + Remove installed locale(s): Installiertes Sprachpaket entfernen + Exit: Untermenue verlassen Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen. Die Aenderung der Konfiguration Die Konfiguration kann ueber den Menuepunkt `Edit configuration' geaendert werden. Standardmaessig wird der Editor aufgerufen, der in der Environment- Konfiguration ueber die Variable 'EDITOR' festgelegt wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies bestaetigt, werden ueber ein Skript die Anpassungen umgehend wirksam gemacht. Hinweis Es ist zu beachten, dass einige Programme eigenstaendig bei erneuter Aktivierung die Konfigurationsdatei neu einlesen, somit fuehrt ein Beantwortung dieser Abfrage mit 'Nein' nur zu einem kurzen Aufschub der Aktivierung. Die Konfigurationsdatei In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/webmail. Die Parameter START_WEBMAIL Fuer die Aktivierung des Webmail-Programms muss dieser Parameter lediglich auf den Wert `yes' gestellt werden. Die Einstellung `no' deaktiviert das Webmail-Programm. Gueltige Werte: yes, no Standardeinstellung: START_WEBMAIL='no' WEBMAIL_N Ueber diesen Parameter wird die Anzahl der webmail-Instanzen angegeben, die eingerichtet werden sollen. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_N='1' WEBMAIL_x_ACTIVE Wird dieser Parameter auf den Wert `yes' gesetzt, so wird die zugehoerige webmail-Instanz aktiviert, `no' deaktiviert sie. Gueltige Werte: yes oder no Beispiel: WEBMAIL_1_ACTIVE='no' WEBMAIL_x_DOCUMENT_ROOT Ueber diesen Parameter wird das Document-Root-Verzeichnis festgelegt. Gueltige Werte: absolute Pfadangabe Standardeinstellung: WEBMAIL_1_DOCUMENT_ROOT='/var/www/htdocs/webmail' WEBMAIL_x_SERVER_DOMAIN Ueber diesen Parameter wird der Domainname der lokalen Domain festgelegt, fuer welche SquirrelMail zustaendig sein soll. Sie sollte identisch mit der Variable SMTP_QUALIFY_DOMAIN aus dem Mail-Paket sein. Gueltige Werte: Domain-Name Beispiel: WEBMAIL_1_SERVER_DOMAIN='domain.de' WEBMAIL_x_SERVER_DOMAIN_CHECK Ueber diesen Parameter kann die Pruefung 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 ueblicherweise bei XSS oder Phishing-Attacken). Weicht die beim Zugriff verwendete Domain von der ueber den Parameter [3]WEBMAIL_x_SERVER_DOMAIN festgelegten Domain ab, so wird der Zugriff nach Ausgabe einer Meldung verweigert. ACHTUNG Diese Pruefungen sind nicht narrensicher und manche Browser koennen diese umgehen oder absichtlich keine Referal-Informationen senden (In diesem Fall wird die Pruefung der Zugriffsdomain stillschweigend uebersprungen). Wird der Parameter auf den Wert `no' gesetzt, so wird diese zusaetzliche Pruefung deaktiviert. Gueltige 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 ermoeglichen den Zugriff auf einen Mailserver, welcher auf einem anderen Rechner betrieben wird. WEBMAIL_x_SERVER_IMAP_HOST Ueber diesen Parameter wird der Servername des Rechners festgelegt welcher die IMAP-Postfaecher verwaltet. Optional kann, durch einen Doppelpunkt getrennt, ein vom Standard abweichender tcp-Port konfiguriert werden. Gueltige Werte: Domain-Name zzgl. optionalem tcp-Port Standardeinstellung: WEBMAIL_1_SERVER_IMAP_HOST='localhost' WEBMAIL_x_SERVER_IMAP_AUTH Ueber 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. Gueltige Werte: md5, digest, login Standardeinstellung: WEBMAIL_1_SERVER_IMAP_AUTH='md5' WEBMAIL_x_SERVER_IMAP_TYPE Ueber 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 fuer eisfair-1) bzw. `dovecot' (Vmail-Paket fuer eisfair-2) gewaehlt werden. Gueltige Werte: uw, courier oder dovecot Standardeinstellung: WEBMAIL_1_SERVER_IMAP_TYPE='uw' WEBMAIL_x_SERVER_IMAP_TRANSPORT Ueber diesen Parameter kann die verschluesselte Kommunikation mit dem IMAP-Prozess aktiviert werden. Wird der Parameter auf den Wert `default' gesetzt, so wird ueber eine unverschluesselte Verbindung kommuniziert. Gueltige Werte: tls oder default Standardeinstellung: WEBMAIL_1_SERVER_IMAP_TRANSPORT='default' WEBMAIL_x_SERVER_SMTP_HOST Ueber diesen Parameter wird der Servername des Rechners festgelegt auf welchem der SMTP-Server laeuft. Optional kann, durch einen Doppelpunkt getrennt, ein vom Standard abweichender tcp-Port konfiguriert werden. Gueltige Werte: Domain-Name zzgl. optionalem tcp-Port Standardeinstellung: WEBMAIL_1_SERVER_SMTP_HOST='localhost' WEBMAIL_x_SERVER_SMTP_TYPE Ueber 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. Gueltige Werte: md5, digest, login, none Standardeinstellung: WEBMAIL_1_SERVER_SMTP_AUTH='md5' WEBMAIL_x_SERVER_SMTP_TRANSPORT Ueber diesen Parameter kann die verschluesselte Kommunikation mit dem SMTP-Server aktiviert werden. Wird der Parameter auf den Wert `default' gesetzt, so wird ueber eine unverschluesselte Verbindung kommuniziert. Gueltige Werte: tls oder default Standardeinstellung: WEBMAIL_1_SERVER_SMTP_TRANSPORT='default' WEBMAIL_x_ORGA_NAME Ueber diesen Parameter kann an verschiedenen Stellen in der Webmail-Oberflaeche der Firmenname, an Stelle von `eisfair-Webmail', eingeblendet werden. Gueltige Werte: Textstring Standardeinstellung: WEBMAIL_1_ORGA_NAME='eisfair-Webmail' WEBMAIL_x_ORGA_TITLE Ueber diesen Parameter kann festgelegt werden, was im Browser-Titel, an Stelle von `eisfair-Webmail', angezeigt werden soll. Gueltige Werte: Textstring und Variablen Standardeinstellung: WEBMAIL_1_ORGA_TITLE='eisfair-Webmail' WEBMAIL_x_ORGA_LOGO Ueber diesen Parameter wird das Firmen-Logo festgelegt, welches an verschiedenen Stellen der Webmail-Oberflaeche angezeigt wird. Es kann entweder ein relativer oder ein absoluter Verzeichnispfad angegeben werden. Gueltige 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 ueber [4]WEBMAIL_x_ORGA_LOGO festgelegte Logo angezeigt werden soll. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_1_ORGA_LOGO_WIDTH='435' WEBMAIL_x_ORGA_LOGO_HEIGHT Dieser Parameter legt fest, mit welcher Hoehe das ueber [5]WEBMAIL_x_ORGA_LOGO festgelegte Logo angezeigt werden soll. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_1_ORGA_LOGO_HEIGHT='168' WEBMAIL_x_ORGA_SIGNOUT_PAGE Dieser Parameter legt fest auf welche Seite der Anwender, nach Betaetigen des `Abmelde'-Knopfes umgelenkt werden soll. Wird der Parameter leer gelassen, so wird die Standard-Abmeldeseite verwendet. Gueltige 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. Ueber die Browser-Konfiguration, erkannt wird. Bitte den korrekten Laendercode fuer die gewuenschte Sprache verwenden. Der Wert `de_DE' steht hierbei fuer die deutsche Sprache. Es kann zur Zeit zwischen folgenden Laender-Codes gewaehlt 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 Gueltige Werte: Locale-Kennung Standardeinstellung: WEBMAIL_1_ORGA_DEF_LANGUAGE='de_DE' WEBMAIL_x_ORGA_TOP_FRAME Standardmaessig wird SquirrelMail im kompletten Browser-Fenster angezeigt. Soll die Bildschirmausgabe in einen bestimmten Rahmen einer HTML-Seite angezeigt werden, so wird der Rahmenname ueber diesen Parameter festgelegt. Gueltige Werte: Frame-Name Standardeinstellung: WEBMAIL_1_ORGA_TOP_FRAME='_top' WEBMAIL_x_ORGA_PROVIDER_NAME Ueber diesen Parameter wird der Name des Providers konfiguriert, dessen Link im Menue von Squirrelmail angezeigt werden soll. Gueltige Werte: Provider Name Standardeinstellung: WEBMAIL_1_ORGA_PROVIDER_NAME='eisfair' WEBMAIL_x_ORGA_PROVIDER_URL Ueber diesen Parameter wird die URL des Providers konfiguriert, dessen Name ueber den Parameter [6]WEBMAIL_x_ORGA_PROVIDER_NAME festgelegt wurde. Gueltige 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 Loeschen in den Papierkorb verschoben und nicht direkt geloescht. Gueltige 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 geloescht. Gueltige 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. Gueltige 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. Gueltige 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. Gueltige Werte: yes, no Standardeinstellung: WEBMAIL_1_FOLDER_SPECIAL_USE_COLOR='yes' WEBMAIL_x_FOLDER_AUTO_EXPUNGE Ein IMAP-Server handhabt das Loeschen von Nachrichten wie folgt: Erst wird die Nachricht nur zum Loeschen markiert, anschliessend endgueltig geloescht. Wird dieser Parameter auf `yes' gesetzt, so werden Nachrichten von SquirrelMail direkt geloescht. Wird 'no' eingestellt, so werden diese nur zum Loeschen markiert. Gueltige Werte: yes, no Standardeinstellung: WEBMAIL_1_FOLDER_AUTO_EXPUNGE='yes' WEBMAIL_x_FOLDER_UNSEEN_NOTIFY Ueber diesen Parameter wird festgelegt, in welchem Fall ein Anwender standardmaessig ueber 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. Gueltige Werte: none, inbox, all Standardeinstellung: WEBMAIL_1_FOLDER_UNSEEN_NOTIFY='inbox' WEBMAIL_x_FOLDER_UNSEEN_TYPE Ueber 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) Gueltige 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 `ISO-8859-1'. Um kyrillischen Text anzuzeigen stellen Sie `KOI8-R' ein, dies fuehrt zu einer eindeutigen Geschwindigkeitssteigerung. Gueltige Werte: iso-8859-1, koi8-r, ... Standardeinstellung: WEBMAIL_1_GENERAL_DEF_CHARSET='iso-8859-1' WEBMAIL_x_GENERAL_LEFT_FRAME_WIDTH Ueber diesen Parameter wird die Breite des linken Ordnerrahmens, in Pixel, festgelegt. Diese Einstellung kann von jedem Anwender individuell angepasst werden. Gueltige 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 Prioritaet von zu versendenden Nachrichten vorgeben. Gueltige 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 fuer gesendete Nachrichten anfordern. Gueltige 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 Mail-Adresse zu bearbeiten. Gueltige 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 Verfuegung stehenden SquirrelMail-Themen aktiviert. Wird dieser Parameter auf `no' gesetzt, so koennen ueber die Parameter [7]WEBMAIL_x_THEMES_N bzw. [8]WEBMAIL_x_THEMES_y_FILENAME Themen individuell aktiviert werden. Gueltige Werte: yes, no Standardeinstellung: WEBMAIL_1_THEMES_USE_ALL='yes' WEBMAIL_x_THEMES_DEFAULT Ueber diesen Parameter kann das Standard-Thema festgelegt werden welches in Squirrelmail verwendet werden soll. Ein Anwender kann diese Einstellung individuell aendern. Wird als Wert `0' eingegeben, so wird das interne `Standard-Thema' von Squirrelmail verwendet. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_1_THEMES_DEFAULT='0' WEBMAIL_x_THEMES_N / WEBMAIL_x_THEMES_y_FILENAME Ueber den Parameter WEBMAIL_x_THEMES_N wird die Anzahl der zu aktivierenden SquirrelMail-Themen eingestellt. Ueber WEBMAIL_x_THEMES_x_FILENAME werden die Namen der zu aktivierenden Themen festgelegt. Gueltige 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 Verfuegung stehenden SquirrelMail-Plugins aktiviert. Wird dieser Parameter auf `no' gesetzt, so koennen ueber den Parameter [9]WEBMAIL_x_PLUGINS_N bzw. [10]WEBMAIL_x_PLUGINS_y_DIRNAME Plugins individuell aktiviert werden. Gueltige Werte: yes, no Standardeinstellung: WEBMAIL_x_PLUGINS_USE_ALL='no' WEBMAIL_x_PLUGINS_N / WEBMAIL_x_PLUGINS_y_DIRNAME Ueber den Parameter WEBMAIL_x_PLUGINS_N wird die Anzahl der zu aktivierenden SquirrelMail-Plugins eingestellt. Ueber WEBMAIL_x_PLUGINS_y_DIRNAME werden die Namen der zu aktivierenden Plugins festgelegt. Neue Plugins muessen unter dem Verzeichnis `/var/www/htdocs/webmail/plugins' abgelegt werden. Gueltige 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 Ueber diesen Parameter wird der fuer das administrator-Plugin benoetigte Name des Administrator festgelegt, welcher aus der Entfernung die Webmail-Konfiguration aendern koennen soll. Gueltige Werte: leer, Username Standardeinstellung: WEBMAIL_1_PLUGINS_ADMINUSER='' WEBMAIL_x_GLOBADDR_FILE_WRITEABLE Wird dieser Parameter auf `yes' gesetzt, so wird das Aendern des globalen Adressbuchs zugelassen. Wird der Parameter auf `no' gesetzt, so wird das Bearbeiten des Adressbuchs unterbunden. Hinweis: Um das globale Adressbuch bearbeiten zu koennen, erhaelt der Apache-Systemuser 'wwwrun' Schreibrechte auf die Adressdatei! Gueltige Werte: yes, no Standardeinstellung: WEBMAIL_1_GLOBADDR_FILE_WRITEABLE='no' WEBMAIL_x_GLOBADDR_FILE_N Ueber diesen Parameter wird die Anzahl der vorgegebenen Eintraege fuer das globale Adressbuch eingestellt. Wird dieser Wert auf `0' gesetzt, so wird kein globales Adressbuch verwendet. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_1_GLOBADDR_FILE_N='0' WEBMAIL_x_GLOBADDR_FILE_x_NICKNAME Ueber diesen Parameter wird das Kuerzel eines globalen Adressbucheintrages festgelegt. Gueltige Werte: Kuerzel Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_NICKNAME='tommy' WEBMAIL_x_GLOBADDR_FILE_y_FIRSTNAME Ueber diesen Parameter wird der Vorname eines globalen Adressbucheintrages festgelegt. Gueltige Werte: Vorname Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_FIRSTNAME='Thomas' WEBMAIL_x_GLOBADDR_FILE_y_LASTNAME Ueber diesen Parameter wird der Nachname eines globalen Adressbucheintrages festgelegt. Gueltige Werte: Nachname Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_LASTNAME='Mueller' WEBMAIL_x_GLOBADDR_FILE_y_EMAIL Ueber diesen Parameter wird die Mail-Adresse eines globalen Adressbucheintrages festgelegt. Gueltige Werte: Email-Adresse Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_EMAIL='tommy@domain.de' WEBMAIL_x_GLOBADDR_FILE_y_INFO Ueber diesen Parameter werden zusaetzliche Informationen eines globalen Adressbucheintrages festgelegt. Gueltige Werte: Text Beispiel: WEBMAIL_1_GLOBADDR_FILE_1_INFO='WebAdmin' Hinweis: Will man eine grosse Anzahl von Eintraegen anlegen, so ist es moeglich diese ueber eine csv-Datei der aktuellen Konfigurationsdatei hinzuzufuegen. 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 Ueber diesen Parameter wird die Anzahl der globalen LDAP-Adressbuecher angegeben auf welche zugegriffen werden soll. Wird dieser Wert auf `0' gesetzt, so werden keine globalen LDAP-Adressbuecher verwendet. Gueltige Werte: Zahl Standardeinstellung: WEBMAIL_1_GLOBADDR_LDAP_N='0' WEBMAIL_x_GLOBADDR_LDAP_y_ACTIVE Fuer die Aktivierung des LDAP-basierten, globalen Adressbuches muss diese Variable lediglich auf den Wert `yes' gestellt werden. Die Einstellung `no' deaktiviert das Adressbuch. Gueltige Werte: yes, no Standardwert: WEBMAIL_1_GLOBADDR_LDAP_1_ACTIVE='no' WEBMAIL_x_GLOBADDR_LDAP_y_INFO Ueber diesen Parameter kann ein beschreibender Text zum LDAP-Adressbuch festgelegt werden. Gueltige Werte: Text Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_INFO='My LDAP directory' WEBMAIL_x_GLOBADDR_LDAP_y_BASEDN Ueber diesen Parameter wird die base-dn fuer den Zugriff auf das globale LDAP-Adressbuch festgelegt. Gueltige Werte: base-dn Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BASEDN='ou=contacts,ou=addressbook,dc= domain,dc=lan' WEBMAIL_x_GLOBADDR_LDAP_y_HOST Ueber diesen Parameter wird der Name des Rechners festgelegt auf welchem der LDAP-Server laeuft. Gueltige 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 gegenueber des LDAP-Servers erforderlich ist, so muss diese Variable lediglich auf den Wert `yes' gestellt werden. Bei der Einstellung `no' wird keine Authentifizierung durchgefuehrt. Gueltige Werte: yes, no Standardwert: WEBMAIL_1_GLOBADDR_LDAP_1_AUTH='no' WEBMAIL_x_GLOBADDR_LDAP_y_BINDDN Ueber diesen Parameter wird die bind-dn fuer die Authentifizierung am LDAP-Server festgelegt. Gueltige Werte: bind-dn Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BINDDN='cn=ldapadmin,dc=domain,dc=lan' WEBMAIL_x_GLOBADDR_LDAP_y_BINDPASS Ueber diesen Parameter wird das bind-Kennwort fuer die Authentifizierung am LDAP-Server festgelegt. Gueltige Werte: Kennwort Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_BINDPASS='my-secret' WEBMAIL_x_GLOBADDR_LDAP_y_PORT (Optionaler Parameter) Ueber diesen Parameter kann ein vom Standardport (389/tcp) abweichender tcp-Port fuer den Zugriff auf den LDAP-Server festgelegt werden. Beispiel: WEBMAIL_1_GLOBADDR_LDAP_1_PORT='10389' WEBMAIL_x_GLOBADDR_LDAP_y_CHARSET (Optionaler Parameter) Ueber diesen Parameter kann ein vom Standardzeichensatz, welcher ueber den Parameter [11]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) Ueber diesen Parameter wird die maximale Anzahl von Antwortzeilen definiert die fuer 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 zurueckgelassene Attachments aus dem Verzeichns `/var/webmail/attach' geloescht werden sollen. Es werden grundsaetzlich nur Dateien, die aelter als 24 Stunden sind geloescht. Die fuenf 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 durchgefuehrt. Wer naeheres ueber die verwendete Befehlsyntax erfahren moechte, sollte ueber eine Internet-Suchmaschine nach `man' und `crontab' suchen. Gueltige Werte: Crontab-spezifischer Parametereintrag Standardeinstellung: WEBMAIL_ATTACH_CRON_SCHEDULE='7 3 * * *' WEBMAIL_LOG_COUNT Ueber diesen Parameter wird eingestellt, wie viele Logdateien vorgehalten werden sollen. Wird dieser Wert ueberschritten, so wird die aelteste Logdatei geloescht. Gueltige 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 Schluesselwoerter `daily' - taeglich, `weekly' - woechentlich und `monthly - monatlich. Gueltige Werte: daily, weekly, monthly Standardeinstellung: WEBMAIL_LOG_INTERVAL='weekly' Die Plugins Ueber SquirrelMail-Plugins koennen zusaetzliche Funktionen in das Webmail-Paket eingebunden werden. Hierbei obliegt es jedem Einzelnen zu entscheiden ob er ein Plugin, trotz eventueller Sicherheitsrisiken, aktivieren moechte oder nicht. Abhaengig von den jeweiligen Plugins kann es notwendig sein, dass zuvor andere Programme installiert werden muessen, die ueber das Webmail-Paket bzw. den eisfair-Server nicht zur Verfuegung gestellt werden. Es wird empfohlen, vor einer Aktivierung eines Plugins, die im jeweiligen Plugin-Verzeichnis vorhandene Dokumentation zu lesen und sich ueber die SquirrelMail-Webseite ([12]http://www.squirrelmail.org) weiter zu informieren. Standardmaessig 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 hinzuzufuegen. administrator-Plugin Dieses Plugin erlaubt es einem Administrator, dessen Login ueber den Parameter [13]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 ermoeglicht es einem Anwender einen gefundenen Fehler, inklusiv zusaetzlicher Systeminformationen direkt an die SquirrelMail-Entwickler zu uebermitteln. calendar-Plugin Dieses Plugin stellt einen einfachen Kalender mit Tages- und Monatsansicht zur Verfuegung. Es ist moeglich Termine anzulegen, zu loeschen bzw. zu aktualisieren. compatibility-Plugin Dieses Plugin stellt Funktionen zur Verfuegung, die es ermoeglichen auch Plugins zu verwenden, die fuer fruehere Squirrelmail-Versionen geschrieben wurden. Es ist nicht notwendig dieses Plugin zur Auswahl hinzuzufuegen. delete_move_next-Plugin Dieses Plugin ermoeglich ein direkter Weiterblaettern zur naechsten Nachricht, ohne zuvor an den Nachrichtenanfang zurueckspringen zu muessen. Ausserdem ist es moeglich, direkt nach dem Loeschen oder Verschieben einer Nachricht die naechste Nachricht anzusehen. filters-Plugin Dieses Plugin ermoeglicht es Filter-Regeln fuer eingehende Nachrichten zu definieren. info-Plugin Dieses Plugin fuegt dem Optionsmenue eine `IMAP server information'-Seite hinzu. Ein Administrator kann ueber die vorgegebenen oder auch eigens einzugebende Befehle pruefen, welche Kommandos vom IMAP-Server akzeptiert werden bzw. welche Antworten von diesem angezeigt werden. listcommands-Plugin Dieses Plugin ergaenzt im Menue zusaetzliche Befehle, die die Benutzung von Mailinglisten erleichtern. message_details-Plugin Dieses Plugin ermoeglicht es eine Nachrichten im Rohformat (RFC822) anzeigen zu lassen. newmail-Plugin Dieses Plugin ermoeglicht eine akustische Benachrichtigung bei ungelesenen Nachrichten. show_user_and_ip-Plugin Dieses Plugin ermoeglicht die Anzeige des Benutzernamens und der aktuellen IP-Adresse im linken Ordnerrahmen. squirrel_logger-Plugin Dieses Plugin schreibt Informationen ueber 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 regelmaessigen Abstaenden archiviert. Siehe hierzu auch `[14]WEBMAIL_LOG_COUNT' und `[15]WEBMAIL_LOG_INTERVAL'. timeout_user-Plugin Dieses Plugin ermoeglicht das automatisierte Ausloggen einen Anwenders nach Ablauf einer vorgegebenen Zeitspanne. translate-Plugin Dieses Plugin ermoeglicht es, fremdsprachliche Nachrichten ueber oeffentliche uebersetzungsdienste im Internet uebersetzen zu lassen. uw_folders-Plugin Diese Plugin ermoeglicht die Anzeige der Shared- und Public-Ordner. wetteronline-Plugin Dieses Plugin ermoeglicht die Anzeige der voraussichtlichen Wetterlage im linken Ordnerrahmen. Die Sprachpakete Es ist moeglich bei Bedarf ueber das Menue weitere Sprachdateien zu installieren bzw. bereits installierte Sprachdateien zu entfernen. Hierzu geht man wie folgt vor: * 1. Herunterladen der gewuenschten Sprachdatei, im gz-Format, fuer die aktuell verwendete Squirrelmail-Version und Ablage der Datei im Ordner /var/webmail. Beispiel: Download der Datei 'da_DK-1.4.7-20060702.tar.gz' oder 'all_locales-1.4.7-20060702.tar.gz' von [16]http://www.squirrelmail.org/download.php * 2. Aufruf der Menuefunktion 'Install additional locale(s)', Auswahl des zu installierenden Sprachpaketes und Start der Installation. Fuer die Deinstallation eines Sprachdatei waehlt man den entsprechenden Menueeintrag 'Remove installed locale(s). Verschiedenes PHP-Fehlermeldungen Werden z.B. in der Ordner-Funktion Meldungen ueber nicht initialisierte Variablen angezeigt, so sollte man pruefen, 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 verschluesselt auf ein LDAP-Verzeichnis zugreifen zu koennen muss zuvor das ldapclient-Paket installiert werden. Wurde fuer 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 Pruefung 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 ueber einen Webbrowser aufzurufen. Juergen Edner 2011-01-09