Installer ISPConfig 3 - Plugins Roundcube sur Debian 10

Les plugins ispconfig3_roundcube intègrent les paramètres de votre compte de messagerie ISPConfig dans Roundcube. Dans ce tutoriel, je vais vous guider à travers le processus de leur installation.

Prérequis

• Roundcube doit être installé en utilisant apt. Sinon, vous devrez peut-être modifier les chemins de fichiers utilisés dans ce tutoriel.
• Assurez-vous que votre installation d’ISPConfig et de Roundcube est à jour.

Ajout d’un utilisateur distant

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

Connectez-vous à votre panneau, allez dans Système -> Utilisateurs distants, et cliquez sur “Ajouter un nouvel utilisateur distant”. Dans le formulaire, donnez à votre nouvel utilisateur un nom et un mot de passe. J’utiliserai rc-example avec le mot de passe examplepass. Ne pas utiliser les mêmes identifiants, mais créez les vôtres. Mon panneau d’exemple sera situé à https://panel.example.com:8080 avec un certificat SSL valide.

Activez la fonction suivante pour votre utilisateur distant :

• Fonctions des plugins Roundcube

Et activez l’accès distant pour l’adresse IPv4 et IPv6 de votre serveur de webmail.

Télécharger les plugins

Exécutez 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 sont 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écutez ceci pour copier la configuration d’exemple et l’éditer :

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

Vous verrez 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 changer cela 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;

Assurez-vous de remplacer le texte souligné en rouge par vos propres identifiants et l’adresse de votre panneau. Changez soap_validate_cert en false si vous utilisez https mais n’avez pas de certificat SSL de confiance installé.

Activation des plugins

Pour activer les plugins, ouvrez la configuration de Roundcube :

nano /etc/roundcube/config.inc.php

Et recherchez ces lignes :

// Liste des plugins actifs (dans le répertoire plugins/) $config['plugins'] = array();

Pour activer les plugins, ajoutez ceci entre les crochets :

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

La ligne ressemblera alors à ceci :

// Liste des plugins actifs (dans le répertoire plugins/) $config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Quelques notes à ce sujet :

• Le plugin jqueryui doit être placé devant les autres plugins.
• Si vous ne souhaitez pas utiliser un plugin, par exemple le plugin fetchmail, laissez de côté ispconfig3_fetchmail.
• Si vous utilisez plus d’un serveur de messagerie, ajoutez ispconfig3_autoselect à la liste, et laissez $config['default_host'] vide. ispconfig3_autoselect choisira automatiquement le bon serveur pour l’utilisateur qui se connecte. Vous pouvez 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.dist.

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

Nous avons terminé !

Si vous rencontrez des problèmes, consultez la FAQ de dépannage sur https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Si vous avez des questions ou des commentaires, vous pouvez les laisser dans les réponses ou créer un post sur le forum.