foorschtbar / dovecot_client_ip
Provides the HTTP client IP during IMAP connect to Dovecot in the form of an IMAP identifier for proper authentication penalty processing.
Installs: 245
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:roundcube-plugin
Requires
- php: >=5.6.0
- roundcube/plugin-installer: >=0.3.0
This package is auto-updated.
Last update: 2025-03-02 09:10:15 UTC
README
Provides the HTTP client IP during IMAP connect to Dovecot in the form of an IMAP identifier for proper authentication penalty processing.
In reverse proxy configurations the actual client IP is resolved if the request originates from a trusted proxy.
Installation
The plugin can either be installed via Composer or manually. If the webmail server allows outgoing requests, Composer is the more comfortable option as it automatically resolves dependencies and simplifies updates.
Using Composer
⚠️ Note that it is not recommended to run Composer as root
.
Plugin installation requires script support enabled, as the RoundCube installer needs to move the downloaded plugin to the plugins directory and optionally can enable the plugin automatically.
- Get [Composer][getcomposer].
- Within the RoundCube webmail root directory, add a new dependency to the plugin.
php composer.phar require 'foorschtbar/dovecot_client_ip:^1.0'
- Composer may ask whether to enable the plugin. Confirm with
y
.
To update the installed plugin to the latest version, simply run:
php composer.phar update --no-dev
Manual
- Download the latest release archive or checkout the latest release branch.
- Extract the contents into a folder named
dovecot_client_ip
within theplugins
directory of your RoundCube installation.
There are no external dependencies.
Repeat manual installation for updates.
It may be advisable to keep multiple versions of the plugin in separate folders and use a symlink named dovecot_client_ip
from within the plugins
directory to the latest version folder instead.
Configuration
To enable the plugin, add dovecot_client_ip
to the $config['plugins']
array in the RoundCube configuration file.
When using Composer, the installation routine will ask whether to automatically enable the plugin.
Options
Copy the configuration variables from config.inc.php.dist
to your global config.inc.php
or create a new file named config.inc.php
in the plugin directory and adjust the settings to your needs.
Dovecot IMAP
The following settings need to be applied to the Dovecot IMAP server:
- Add the IP addresses or networks of your RoundCube webmail servers to the
login_trusted_networks
setting in your Dovecot IMAP configuration. This disables authentication penalty processing for the configured webmail server IPs and enables processing of theX-Originating-IP
ident value with the actual client IP provided by this plugin. - Restart Dovecot IMAP.
Afterwards, Dovecot connection logs should show the actual client IP of users instead of the webmail server IP in the rip
(remote IP) field.
Credits
The original plugin was created by Michael Maier and is licensed under the GNU General Public License v3 or higher. I added the network (CIDR) support for the trusted proxies, renamed the plugin to remove the unnecessary roundcube-
prefix and moved the project to GitHub.