HowtoForge

ISPConfig 3 Roundcube-Plugins unter Debian 10 installieren

von ·

Die ispconfig3_roundcube-Plugins integrieren Ihre ISPConfig-Mailkonto-Einstellungen in Roundcube. In diesem Tutorial führe ich Sie durch die Installation dieser Plugins.

Voraussetzungen

  • Roundcube muss mit apt installiert werden. Falls nicht, müssen Sie möglicherweise die in diesem Tutorial verwendeten Dateipfade ändern.
  • Stellen Sie sicher, dass Ihre ISPConfig und Ihre Roundcube-Installation auf dem neuesten Stand sind

Hinzufügen eines Fernbenutzers

Die ISPConfig 3-Plugins verwenden die API, um sich mit Ihrem System zu verbinden. Daher müssen wir einen Remote-Benutzer in der Systemsteuerung anlegen.

Melden Sie sich in Ihrem Panel an, gehen Sie zu System -> Remote-Benutzer und klicken Sie auf „Neuen Remote-Benutzer hinzufügen“. Geben Sie in dem Formular Ihrem neuen Benutzer einen Namen und ein Passwort. Ich werde rc-example mit dem Passwort examplepass verwenden. Verwenden Sie nicht die gleichen Anmeldedaten, sondern erstellen Sie Ihre eigenen. Mein Beispielpanel wird unter https://panel.example.com:8080 mit einem gültigen SSL-Zertifikat zu finden sein.

Aktivieren Sie die folgenden Funktionen für Ihren entfernten Benutzer:

  • Client-Funktionen
  • Server-Funktionen
  • Mail-Benutzerfunktionen
  • Mail-Benutzer-Filterfunktionen
  • Mail-Alias-Funktionen
  • Mail-Weiterleitungsfunktionen
  • Mail fetchmail-Funktionen
  • Benutzerfunktionen des Mail-Spamfilters
  • Mail-Spamfilter-Richtlinienfunktionen
  • Mail-Spamfilter-Whitelist-Funktionen
  • Mail-Spamfilter-Blacklist-Funktionen

Und aktivieren Sie den Fernzugriff für die IPv4- und IPv6-Adresse Ihres Webmail-Servers.

Die Plugins herunterladen

Führen Sie die folgenden Befehle aus:

cd /tmp
wget https://github.com/w2c/ispconfig3_roundcube/archive/master.zip
unzip master.zip
cd ./ispconfig3_roundcube-master
cp -r ./ispconfig3_* /usr/share/roundcube/plugins
ln -s /usr/share/roundcube/plugins/ispconfig* /var/lib/roundcube/plugins/

Die Plugins befinden sich jetzt im richtigen Ordner, mit einem Symlink von /var/lib/roundcube/plugins. Der nächste Schritt ist, sie für die Verwendung unseres entfernten Benutzers zu konfigurieren. Führen Sie dies aus, um die Beispielkonfiguration zu kopieren und zu bearbeiten:

cp /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php.dist /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php
nano /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php

Sie werden diese Konfigurationsdatei sehen:

$config['identity_limit'] = false;
$config['remote_soap_user'] = '{REMOTE USERNAME}';
$config['remote_soap_pass'] = '{REMOTE PASSWORD}';
$config['soap_url'] = 'https://{YOUR SERVER}:8080/remote/';
$config['soap_validate_cert'] = true;

Ich werde dies ändern in:

$config['identity_limit'] = false;
$config['remote_soap_user'] = 'rc-example';
$config['remote_soap_pass'] = 'examplepass';
$config['soap_url'] = 'https://panel.example.com:8080/remote/';
$config['soap_validate_cert'] = true;

Achten Sie darauf, den rot unterstrichenen Text durch Ihre eigenen Anmeldedaten und die Panel-Adresse zu ersetzen. Ändern Sie soap_validate_cert in false, wenn Sie https verwenden, aber kein vertrauenswürdiges SSL-Zertifikat installiert haben.

Aktivieren der Plugins

Um die Plugins zu aktivieren, öffnen Sie die Roundcube-Konfiguration:

nano /etc/roundcube/config.inc.php

und suchen Sie nach diesen Zeilen:

// List of active plugins (in plugins/ directory)
$config['plugins'] = array();

Um die Plugins zu aktivieren, fügen Sie dies zwischen den Klammern ein:

"jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist"

Die Zeile sieht dann wie folgt aus:

// List of active plugins (in plugins/ directory)
$config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Dazu ein paar Anmerkungen:

  • Das jqueryui-Plugin muss vor den anderen Plugins platziert werden.
  • Wenn Sie kein Plugin, z.B. das fetchmail-Plugin, verwenden wollen, lassen Sie ispconfig3_fetchmail weg.
  • Wenn Sie mehr als einen Mailserver verwenden, fügen Sie ispconfig3_autoselect zur Liste hinzu und lassen Sie sie $config['default_host']leer. ispconfig3_autoselect wählt automatisch den richtigen Server für den Benutzer, der sich anmeldet. Sie können die eigene Konfigurationsdatei bearbeiten, um tls/ssl-Verbindungen zwischen dem Roundcube und dem externen Mailserver in ispconfig3_autoselect/config/config.inc.php.dist

Nach dem Speichern der Konfigurationsdatei wird in den Webmail-Einstellungen ein neuer Reiter „Konto“ angezeigt:

Registerkarte "Neue Einstellungen

Wir sind fertig!

Wenn Sie Probleme haben, werfen Sie einen Blick auf die FAQ zur Fehlerbehebung auf https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Wenn Sie Fragen oder Kommentare haben, können Sie diese in den Antworten hinterlassen oder einen Forumsbeitrag erstellen.

Das könnte dich auch interessieren …