Unterabschnitte

Das Roundcube-Paket

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

Die Einleitung

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

Die Funktionen

Das Roundcube-Paket besteht aus folgenden Komponenten:

Roundcube - Das Web-Frontend für den Zugriff auf ein IMAP-Postfach
(https://roundcube.net/)
CardDAV Plugin - Stellt Funktionen für den Zugriff auf einen zentralen CardDAV Server und die dort gespeicherten Kontaktdaten zur Verfügung. (https://www.benjamin-schieder.de/carddav.html)
Rouncube-Client-side Filters-Plugin - Stellt Funktionen zum leichten Filtern von eingehenden Nachrichten zur Verfügung. (https://sourceforge.net/projects/rcubefilters)

Die Lizenzen

Die Dateien des roundcube-Programmpaketes, ausgenommen die Skin- und Plugin-Dateien, sind unter der GNU General Public License v3 (GPLv3), deren Text in der Datei LICENSE im roundcube-Webverzeichnis nachgelesen werden kann, oder neueren Versionen der GPLv3 lizenziert. Alle unmodifizierten Dateien aus diesen oder anderen Quellen unterliegen den ursprünglichen Copyright- und Lizenzangaben, die in den einzelnen Dateien vermerkt wurden.

Die Voraussetzungen

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

Die Installation

Das Roundcube-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 `https://<Name des eisfair-Servers>/roundcube/`, (ein abweichendes Verzeichnis kann in der Konfiguration über den Parameter ROUNDCUBE_x_DOCUMENT_ROOT gesetzt werden) 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:

Roundcube Webmail administration
- View documentation: Anzeigen der Dokumentation
- Edit configuration: Bearbeiten der Konfiguration
- Advanced configuration file handling: Konfigurationen verwalten
- View configuration log file: Die Konfigurations-Logmeldungen anzeigen
- Exit: Untermenü verlassen

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/roundcube.

Die Parameter

START_ROUNDCUBE

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

Gültige Werte: yes, no

Standardeinstellung: START_ROUNDCUBE='no'

ROUNDCUBE_DB_TYPE (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch, ein vom Standard 'sqlite' abweichender Datenbanktyp angegeben werden. Folgende Datenbanken werden unterstützt:

mysql MySQL
pgsql PostgreSQL
sqlite SQLite (Standard)

Gültige Werte: gültiger Datenbanktyp

Standardeinstellung: ROUNDCUBE_DB_TYPE=”

ROUNDCUBE_DB_HOST (Optionaler Parameter)

Über diesen Parameter kann bei Bedarf der FQDN-Name des Servers festgelegt werden, auf sich die Roundcube-Datenbank befindet. Falls erforderlich kann der zu verwendende TCP-Port, getrennt durch einen Doppelpunkt angehängt werden. Wird kein Port angegeben, so wird standardmäßig der Port `3306' verwendet. Standardmäßig wird die Datenbank auf dem gleichen Server erstellt, auf welchem auch Roundcube betrieben wird.

Gültige Werte: FQDN-Name eines Servers, zzgl. des TCP-Port

Beispiel: ROUNDCUBE_DB_HOST= 'db - server.privat.lan : 3306'

ROUNDCUBE_DB_USER (Optionaler Parameter)

Über diesen Parameter kann bei Bedarf ein Datenbankanwender festgelegt werden, welcher für den Zugriff auf die interne Roundcube-Datenbank verwendet werden soll. ACHTUNG
Hier sollte auf keinen Fall 'root' eingetragen werden, da dies ein potentielles Sicherheitsrisiko bedeuten würde. Falls SQL-root-Berechtigungen benötigt werden, werden Sie während der Generierung der Konfiguration zur Eingabe des SQL-root-Kennwortes aufgefordert.

Gültige Werte: Name eines Datenbankanwenders

Standardeinstellung: ROUNDCUBE_DB_USER=”

ROUNDCUBE_DB_PASS (Optionaler Parameter)

Über diesen Parameter kann bei Bedarf ein Datenbankkennwort festgelegt werden, welcher für den Zugriff auf die interne Roundcube-Datenbank verwendet werden soll.

Gültige Werte: Kennwort

Standardeinstellung: ROUNDCUBE_DB_PASS=”

ROUNDCUBE_REDIS_HOST (Optionaler Parameter)

Über diesen Parameter kann bei Bedarf der FQDN-Name des Servers festgelegt werden, auf sich die Redis-Cache-Datenbank befindet. Falls erforderlich kann der zu verwendende TCP-Port, getrennt durch einen Doppelpunkt angehängt werden. Wird kein Port angegeben, so wird standardmäßig der Port `6379' verwendet. Standardmäßig wird die Datenbank auf dem gleichen Server erstellt, auf welchem auch ownCloud betrieben wird.

Gültige Werte: FQDN-Name eines Servers

Beispiel: ROUNDCUBE_REDIS_HOST='db-server.privat.lan'

ROUNDCUBE_REDIS_PASS (Optionaler Parameter)

Über diesen Parameter kann bei Bedarf ein Datenbankkennwort festgelegt werden, welches für den Zugriff auf die Redis-Cache- Datenbank verwendet werden soll.

Gültige Werte: Kennwort

Standardeinstellung: ROUNDCUBE_REDIS_PASS=”

ROUNDCUBE_N

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

Gültige Werte: Zahl

Standardeinstellung: ROUNDCUBE_N='1'

ROUNDCUBE_x_ACTIVE

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

Beispiel: ROUNDCUBE_1_ACTIVE='no'

ROUNDCUBE_x_DOCUMENT_ROOT

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

Gültige Werte: absolute Pfadangabe

Standardeinstellung: ROUNDCUBE_1_DOCUMENT_ROOT='/var/www/htdocs/roundcube'

ROUNDCUBE_x_WEB_ROOT (Optionaler Parameter)

Falls über den Parameter ROUNDCUBE_x_DOCUMENT_ROOT ein vom Standard abweichendes Dokumentenstammverzeichnis festgelegt wurde, kann auf Wunsch über diesen Parameter auch ein vom Standard abweichendes Web-Stammverzeichnis festgelegt werden. Wird dieser Parameter nicht gesetzt, so wird standardmäßig der folgende Pfad verwendet: /roundcube

Gültige Werte: absolute Pfadangabe

Beispiel: ROUNDCUBE_1_WEB_ROOT='/roundcube'

ROUNDCUBE_x_SERVER_DOMAIN

Über diesen Parameter wird der Domainname der lokalen Domain festgelegt, für welche Roundcube zuständig sein soll. Dieser sollte gleich der Variablen SMTP_QUALIFY_DOMAIN aus dem Mail-Paket gesetzt sein.

Gültige Werte: Domainname

Beispiel: ROUNDCUBE_1_SERVER_DOMAIN='domain.de'

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

ROUNDCUBE_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: Domainname zzgl. optionalem tcp-Port

Standardeinstellung: ROUNDCUBE_1_SERVER_IMAP_HOST='localhost'

ROUNDCUBE_x_SERVER_IMAP_TYPE

Über diesen Parameter kann der IMAP-Servertyp eingestellt werden, zu welchem sich verbunden werden soll. Es kann zwischen den Typen `dovecot' (mail-dovecot-/Vmail-Paket), 'panda' (mail-panda-Paket) und `courier' gewählt werden.

Gültige Werte: dovecot, panda, courier

Standardeinstellung: ROUNDCUBE_1_SERVER_IMAP_TYPE='panda'

ROUNDCUBE_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.

Gültige Werte: md5, digest, login

Standardeinstellung: ROUNDCUBE_1_SERVER_IMAP_AUTH='md5'

ROUNDCUBE_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: default, ssl oder tls

Standardeinstellung: ROUNDCUBE_1_SERVER_IMAP_TRANSPORT='default'

ROUNDCUBE_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: Domainname zzgl. optionalem tcp-Port

Standardeinstellung: ROUNDCUBE_1_SERVER_SMTP_HOST='localhost'

ROUNDCUBE_x_SERVER_SMTP_AUTH

Ü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.

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

Standardeinstellung: ROUNDCUBE_1_SERVER_SMTP_AUTH='md5'

ROUNDCUBE_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: default, ssl oder tls

Standardeinstellung: ROUNDCUBE_1_SERVER_SMTP_TRANSPORT='default'

ROUNDCUBE_x_XFRAME_OPTIONS (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch ein vom Standard abweichender X-Frame-Options HTTP Header gesetzt werden, welcher gesendet wird um Clickjacking-Attacken vorzubeugen. Standardmäßig wird `sameorigin' verwendet.

Gültige Werte:

deny Die Seite kann nicht in einem Frame eingebettet werden, egal welches die aufrufende Webseite ist.
sameorigin Die Seite kann nur als Frame eingebettet werden, wenn beide von der gleichen Quellseite (same origin) stammen.
uri Die Seite lässt sich ausschließlich dann einbetten, wenn die einbettende Seite aus der Quelle uri stammt.

Standardeinstellung: ROUNDCUBE_1_XFRAME_OPTIONS=”

ROUNDCUBE_x_ORGA_NAME

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

Gültige Werte: Text

Standardeinstellung: ROUNDCUBE_1_ORGA_NAME='eisfair-Roundcube'

ROUNDCUBE_x_ORGA_LOGO

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

Gültige Werte: Pfad- und Dateiname

Beispiel: ROUNDCUBE_1_ORGA_LOGO='eisfair_logo_klein.png'

ROUNDCUBE_x_ORGA_PROVIDER_URL

Über diesen Parameter wird die URL des Providers konfiguriert, auf welche beim Zugriff auf das Hilfe-Menü verzweigt wird.

Gültige Werte: URL

Standardeinstellung: ROUNDCUBE_1_ORGA_PROVIDER_URL='https://github.com/roundcube/roundcubemail/wiki'

ROUNDCUBE_x_ORGA_DEF_LANGUAGE

Dieser Parameter legt fest, welche Standardsprache verwendet werden soll, wenn dies von Roundcube nicht automatisch, z.B. Über die Browser-Konfiguration, erkannt wird. Bitte den korrekten Länderkode 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änderkodes 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: ROUNDCUBE_1_ORGA_DEF_LANGUAGE='de_DE'

ROUNDCUBE_x_FOLDER_MOVE_MSGS_TO_DRAFTS

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

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_FOLDER_MOVE_MSGS_TO_DRAFTS='yes'

ROUNDCUBE_x_FOLDER_MOVE_MSGS_TO_SENT

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

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_FOLDER_MOVE_MSGS_TO_SENT='yes'

ROUNDCUBE_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: ROUNDCUBE_1_FOLDER_MOVE_MSGS_TO_TRASH='yes'

ROUNDCUBE_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 Roundcube direkt gelöscht. Wird 'no' eingestellt, so werden diese nur zum Löschen markiert.

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_FOLDER_AUTO_EXPUNGE='yes'

ROUNDCUBE_x_FOLDER_NAME_DRAFTS (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch ein vom Standard (Drafts) abweichender Name für den Ordner festgelegt werden, indem Nachrichtenentwürfe gespeichert werden sollen.

Gültige Werte: leer oder gültiger Ordnername

Standardeinstellung: ROUNDCUBE_1_FOLDER_NAME_DRAFTS=”

ROUNDCUBE_x_FOLDER_NAME_SENT (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch ein vom Standard (Sent) abweichender Name für den Ordner festgelegt werden, indem gesendete Nachrichten gespeichert werden sollen.

Gültige Werte: leer oder gültiger Ordnername

Standardeinstellung: ROUNDCUBE_1_FOLDER_NAME_SENT=”

ROUNDCUBE_x_FOLDER_NAME_SPAM (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch ein vom Standard (Junk) abweichender Name für den Ordner festgelegt werden, indem Spam- Nachrichten gespeichert werden sollen.

Gültige Werte: leer oder gültiger Ordnername

Standardeinstellung: ROUNDCUBE_1_FOLDER_NAME_SPAM=”

ROUNDCUBE_x_FOLDER_NAME_TRASH (Optionaler Parameter)

Über diesen Parameter kann auf Wunsch ein vom Standard (Trash) abweichender Name für den Ordner festgelegt werden, indem gelöschte Nachrichten gespeichert werden sollen.

Gültige Werte: leer oder gültiger Ordnername

Standardeinstellung: ROUNDCUBE_1_FOLDER_NAME_TRASH=”

ROUNDCUBE_x_FOLDER_FORCE_NSFOLDER (Optionaler Parameter)

Wird dieser Parameter auf `yes' gestellt, so wird die Anzeige spezieller Namespace-Ordner, wie z.B. #public/ oder #shared/ forciert. Bei Panda-IMAP (UW-IMAP) Servern ist dieser Parameter standardmäßig gesetzt, bei allen anderen Servern deaktiviert.

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_FORCE_NSFOLDER nicht gesetzt.

ROUNDCUBE_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.

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

Standardeinstellung: ROUNDCUBE_1_GENERAL_DEF_CHARSET='utf-8'

ROUNDCUBE_x_GENERAL_DES_KEY

Über diesen Parameter wird der DES-Schlüssel festgelegt, mit welchem das IMAP-Kennwort im Session-Datensatz (und im Client-Cookie wenn Kennwort merken aktiviert wurde) verschlüsselt werden soll. Der Schlüssel muss exakt 24 Zeichen lang sein.

Gültige Werte: gültiger DES-Schlüssel

Standardeinstellung: ROUNDCUBE_1_GENERAL_DES_KEY=”

ROUNDCUBE_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: ROUNDCUBE_1_GENERAL_ALLOW_RECEIPTS_USE='yes'

ROUNDCUBE_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: ROUNDCUBE_1_GENERAL_ALLOW_IDENTITY_EDIT='yes'

ROUNDCUBE_x_PLUGINS_USE_ALL

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

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_PLUGINS_USE_ALL='no'

ROUNDCUBE_x_PLUGINS_N / ROUNDCUBE_x_PLUGINS_y_DIRNAME

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

Gültige Werte: Zahl bzw. Verzeichnisname

Beispiel:

ROUNDCUBE_1_PLUGINS_N='3'
ROUNDCUBE_1_PLUGINS_1_DIRNAME='emoticons'
ROUNDCUBE_1_PLUGINS_2_DIRNAME='filters'
ROUNDCUBE_1_PLUGINS_3_DIRNAME='help'

ROUNDCUBE_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: ROUNDCUBE_1_GLOBADDR_LDAP_N='0'

ROUNDCUBE_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

Standardeinstellung: ROUNDCUBE_1_GLOBADDR_LDAP_1_ACTIVE='no'

ROUNDCUBE_x_GLOBADDR_LDAP_y_INFO

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

Gültige Werte: Text

Beispiel: ROUNDCUBE_1_GLOBADDR_LDAP_1_INFO='My LDAP directory'

ROUNDCUBE_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: ROUNDCUBE_1_GLOBADDR_LDAP_1_BASEDN='ou=contacts,ou=addressbook,dc=domain,dc=lan'

ROUNDCUBE_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

Standardeinstellung: ROUNDCUBE_1_GLOBADDR_LDAP_1_HOST='localhost'

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

ROUNDCUBE_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

Standardeinstellung: ROUNDCUBE_1_GLOBADDR_LDAP_1_AUTH='no'

ROUNDCUBE_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: ROUNDCUBE_1_GLOBADDR_LDAP_1_BINDDN='cn=ldapadmin,dc=domain,dc=lan'

ROUNDCUBE_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: ROUNDCUBE_1_GLOBADDR_LDAP_1_BINDPASS='my-secret'

ROUNDCUBE_x_GLOBADDR_LDAP_y_WRITEABLE

Wird dieser Parameter auf `yes' gesetzt, so wird das Bearbeiten des LDAP- Adressbuchs zugelassen. Wird der Parameter auf `no' gesetzt, so wird das Bearbeiten unterbunden.

Gültige Werte: yes, no

Standardeinstellung: ROUNDCUBE_1_GLOBADDR_LDAP_1_WRITEABLE='no'

ROUNDCUBE_x_GLOBADDR_LDAP_y_CHARSET (Optionaler Parameter)

Über diesen Parameter kann ein vom Standardzeichensatz, welcher über den Parameter ROUNDCUBE_x_GENERAL_DEF_CHARSET definiert wurde, abweichender Zeichensatz festgelegt werden.

Beispiel: ROUNDCUBE_1_GENERAL_DEF_CHARSET='utf-8'

ROUNDCUBE_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: ROUNDCUBE_1_GLOBADDR_LDAP_1_MAXROWS='200'

ROUNDCUBE_x_GLOBADDR_LDAP_y_USRSPEC (Optionaler Parameter)

Über diesen Parameter wird festgelegt, ob anwenderspezifische Adressbücher verwendet werden sollen oder nicht. Standardmäßig ist dieser Parameter nicht gesetzt.
Wird dieser Parameter auf den Wert `yes' gesetzt, so stehen die folgenden Variablen zur Verwendung in den Parametern ROUNDCUBE_x_GLOBADDR_LDAP_y_BASEDN und ROUNDCUBE_x_GLOBADDR_LDAP_y_BINDDN zur Verfügung:

%fu Der vollständige Anwendername, wobei davon ausgegangen wird, dass dies eine E-Mail-Adresse ist.
%u Der Anwendername vor dem @-Zeichen.
%d Der Domainname nach dem @-Zeichen.
%dc Der Domainname in hierarchischer Schreibweise.
%dn Der DN welcher bei einer LDAP-Suche gefunden wurde.

Gültige Werte: yes, no

Beispiel: ROUNDCUBE_x_GLOBADDR_LDAP_y_USRSPEC='yes'

ROUNDCUBE_CRON_SCHEDULE (Optionaler Parameter)

Über diesen Parameter wird festgelegt zu welchem Zeitpunkt bzw. in welchem Intervall automatisch Datenbankbereinigungen durchgeführt werden sollen. 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 01:14h die Bereinigung des Verzeichnisses durchgeführt. Wer Näheres über die verwendete Befehlssyntax erfahren möchte, sollte über eine Internet-Suchmaschine nach `man' und `crontab' suchen.

Gültige Werte: Crontab-spezifischer Parametereintrag

Standardeinstellung: ROUNDCUBE_CRON_SCHEDULE='14 1 * * *'

Die Plugins

Über Roundcube-Plugins können zusätzliche Funktionen in das Roundcube-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 Roundcube-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 Roundcube-Webseite (https://roundcube.net) weiter zu informieren.

newmail_notifier-Plugin

Über 'Einstellungen->Mailbox-Ansicht->Neue Nachricht' kann man bei aktiviertem newmail_notifer-Plugin die Art der Benachrichtigung bei eingehenden neuen Nachrichten festlegen. Zur Auswahl stehen die folgende Optionen:

Benachrichtigung im Browser neuer Nachricht - Hierbei wird der Fenstertitel und das angezeigte Favicon des Webbrowsers angepasst.
Desktop-Benachrichtigung bei neuer Nachricht - Um diese Funktion nutzen zu können muss der verwendet Webbrowser HTML5 webkitNotifications unterstützen. Chrome und Mozilla Firefox, mit installiertem HTML5 Notifications-Plugin, stellen diese Funktion z.B. bereit.
Akustische Meldung bei neuer Nachricht - Es wird die im Verzeichnis /plugins/newmail_notifier befindliche Tondatei `sound.wav' abgespielt.

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/roundcube 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.