Roundcube¶
The Roundcube Userli plugin creates a Roundcube identity for each alias of a user when they sign in to Roundcube. Users can then send emails from their aliases without setting up identities manually.
The plugin also handles the sign-in: users with two-factor authentication enter their code in a second step. Roundcube then uses a webmail credential from Userli for IMAP and SMTP instead of the password. The credential is valid for 12 hours and is revoked on logout. This is required for webmail if app passwords are required with 2FA.
On the Userli host¶
Create an API token with the scope roundcube:
bin/console app:api-token:create --name "Roundcube" --scopes roundcube
On the Roundcube host¶
Install the plugin, either with Composer
(systemli/userli) or by
cloning the repository into the plugins/ directory, and enable it in the
Roundcube configuration:
$config['plugins'] = ['userli' /* , ... */];
Configure it in plugins/userli/config.inc.php (copy from
config.inc.php.dist):
$config['userli_url'] = 'https://users.example.org';
$config['userli_token'] = '<PLAIN_TOKEN>';
$config['userli_ssl_verify'] = true;
Webmail link¶
Set the URL of Roundcube as Webmail URL in Admin → Settings to show a Webmail card to users.