Installer ISPConfig 3 – les plugins Roundcube sur Debian 10

Les plugins ispconfig3_roundcube intègrent les paramètres de ton compte de messagerie ISPConfig dans Roundcube. Dans ce tutoriel, je vais te guider dans le processus d’installation.

Conditions préalables

  • Roundcube doit être installé à l’aide d’apt. Si ce n’est pas le cas, tu devras peut-être modifier les chemins de fichiers utilisés dans ce tutoriel.
  • Assure-toi que ton installation d’ISPConfig et de Roundcube est à jour.

Ajout d’un utilisateur distant

Les plugins ISPConfig 3 utilisent l’API pour se connecter à ton système. Nous devons donc créer un utilisateur distant dans le panneau de contrôle.

Connecte-toi à ton panneau, va dans Système -> Utilisateurs distants, et clique sur « Ajouter un nouvel utilisateur distant ». Dans le formulaire, donne un nom et un mot de passe à ton nouvel utilisateur. Je vais utiliser rc-example avec le mot de passe examplepass. N’utilise pas les mêmes informations d’identification, mais crée les tiennes. Mon panneau d’exemple sera situé à l’adresse https://panel.example.com:8080 avec un certificat SSL valide.

Active la fonction suivante pour ton utilisateur distant :

  • Fonctions des plugins Roundcube

Et active l’accès à distance pour l’adresse IPv4 et IPv6 de ton serveur webmail.

Télécharge les plugins

Exécute les commandes suivantes :

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/

Les plugins se trouvent maintenant dans le bon dossier, avec un lien symbolique depuis /var/lib/roundcube/plugins. L’étape suivante consiste à les configurer pour utiliser notre utilisateur distant. Exécute ceci pour copier la configuration d’exemple et la modifier :

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

Tu verras ce fichier de configuration :

$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;

Je vais le changer en :

$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;

Assure-toi de remplacer le texte souligné en rouge par tes propres informations d’identification et l’adresse de ton panneau. Change soap_validate_cert en false si tu utilises https mais que tu n’as pas installé de certificat SSL de confiance.

Activer les plugins

Pour activer les plugins, ouvre la configuration de roundcube :

nano /etc/roundcube/config.inc.php

et cherche ces lignes :

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

Pour activer les plugins, ajoute ceci entre les parenthèses :

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

La ligne ressemblera alors à ceci :

// 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");

Quelques remarques à ce sujet :

  • Le plugin jqueryui doit être placé devant les autres plugins.
  • Si tu ne veux pas utiliser un plugin, par exemple le plugin fetchmail, laisse tomber ispconfig3_fetchmail.
  • Si tu utilises plusieurs serveurs de messagerie, ajoute ispconfig3_autoselect à la liste et laisse $config['default_host'] vide. ispconfig3_autoselect choisira automatiquement le bon serveur pour l’utilisateur qui se connecte. Tu peux modifier son propre fichier de configuration pour activer les connexions tls/ssl entre Roundcube et le serveur de messagerie externe dans ispconfig3_autoselect/config/config.inc.php.

Après avoir enregistré le fichier de configuration, un nouvel onglet « Compte » apparaîtra dans les paramètres du webmail :

Nouvel onglet de paramètres

Nous avons terminé !

Si tu rencontres des problèmes, jette un coup d’œil à la FAQ de dépannage sur https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ.

Si tu as des questions ou des commentaires, tu peux les laisser dans les réponses ou créer un message sur le forum.

Vous aimerez aussi...