Instalar ISPConfig 3 - Plugins do Roundcube no Debian 10

Os plugins ispconfig3_roundcube integram as configurações da sua conta de e-mail ISPConfig no Roundcube. Neste tutorial, vou guiá-lo pelo processo de instalação deles.

Pré-requisitos

• O Roundcube deve ser instalado usando apt. Se não, você pode precisar alterar os caminhos dos arquivos usados neste tutorial.
• Certifique-se de que sua instalação do ISPConfig e do Roundcube estão atualizadas.

Adicionando um usuário remoto

Os plugins do ISPConfig 3 usam a API para se conectar ao seu sistema. Portanto, precisamos criar um usuário remoto no painel de controle.

Faça login no seu painel, vá para Sistema -> Usuários Remotos e clique em “Adicionar novo usuário remoto”. No formulário, dê um nome e uma senha ao seu novo usuário. Vou usar rc-example com a senha examplepass. Não use as mesmas credenciais, mas crie as suas. Meu painel de exemplo estará localizado em https://panel.example.com:8080 com um certificado SSL válido.

Ative a seguinte função para seu usuário remoto:

• Funções dos plugins do Roundcube

E habilite o acesso remoto para o endereço IPv4 e IPv6 do seu servidor de webmail.

Baixando os plugins

Execute os seguintes comandos:

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/

Os plugins agora estão na pasta correta, com um symlink de /var/lib/roundcube/plugins. O próximo passo é configurá-los para usar nosso usuário remoto. Execute isso para copiar a configuração de exemplo e editá-la:

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

Você verá este arquivo de configuração:

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

Vou mudar isso para:

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

Certifique-se de substituir o texto sublinhado em vermelho pelas suas próprias credenciais e endereço do painel. Altere soap_validate_cert para false se você usar https, mas não tiver um certificado SSL confiável instalado.

Habilitando os plugins

Para habilitar os plugins, abra a configuração do roundcube:

nano /etc/roundcube/config.inc.php

E procure por estas linhas:

// Lista de plugins ativos (no diretório plugins/) $config['plugins'] = array();

Para habilitar os plugins, adicione isso entre os colchetes:

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

A linha ficará assim:

// Lista de plugins ativos (no diretório plugins/) $config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Algumas observações sobre isso:

• O plugin jqueryui deve ser colocado na frente dos outros plugins.
• Se você não quiser usar um plugin, por exemplo, o plugin fetchmail, deixe de fora ispconfig3_fetchmail.
• Se você usar mais de um servidor de e-mail, adicione ispconfig3_autoselect à lista e deixe $config['default_host'] vazio. ispconfig3_autoselect escolherá automaticamente o servidor certo para o usuário que faz login. Você pode editar seu próprio arquivo de configuração para habilitar conexões tls/ssl entre o Roundcube e o servidor de e-mail externo em ispconfig3_autoselect/config/config.inc.php.dist.

Após salvar o arquivo de configuração, uma nova aba “Conta” aparecerá nas configurações do webmail:

Estamos prontos!

Se você tiver algum problema, dê uma olhada na FAQ de solução de problemas em https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Se você tiver alguma dúvida ou comentário, pode deixá-los nas respostas ou criar um post no fórum.