Download the PHP package foundata/identity_from_directory without Composer
On this page you can find all versions of the php package foundata/identity_from_directory. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download foundata/identity_from_directory
More information about foundata/identity_from_directory
Files in foundata/identity_from_directory
Package identity_from_directory
Short Description Populate and maintain user identities automatically on each login, based on corresponding LDAP or Active Directory user data.
License GPL-3.0-or-later
Homepage https://github.com/foundata/roundcube-plugin-identity-from-directory
Informations about the package identity_from_directory
Roundcube Plugin: identity_from_directory
(use LDAP or AD to maintain email identities)
A Roundcube plugin to populate and maintain a user's email identities automatically on each login, based on corresponding LDAP or Active Directory data.
Table of Contents
- Screenshots
- Installation
- Installation using Composer
- Installation from release tarball
- Updating
- Update using Composer
- Update from release tarball
- Configuration
- Compatibility
- Licensing, copyright
- Author information
Screenshots
A user with the following Active Directory data
and a signature template set to
would result in the following Roundcube identities after the user login:
Installation
Installation using Composer
The following command installs the plugin package via Composer into plugins/identity_from_directory
:
If you want to use the current development version from Git, use -o "foundata/identity_from_directory:dev-main"
. Please confirm with y
when Composer asks you whether you want to enable the plugin in the Roundcube configuration. Alternatively, add identity_from_directory
to Roundcube's $config['plugins']
array by hand.
You can now configure the plugin.
Installation from release tarball
Download the latest identity_from_directory-vX.Y.Z.tar.gz
tarball (do not use the "Source code" archives Github creates automatically for each release). Extract it into plugins/
, all files have to be in plugins/identity_from_directory/
afterwards.
Useful snippet if you have got a shell available on your target server:
Configure the plugin and add identity_from_directory
to Roundcube's $config['plugins']
array to enable it.
Updating
Update using Composer
The following command updates the plugin package via Composer:
Update from release tarball
Updating is as simple as overwriting the existing files. Just follow the changelog will inform you of any manual actions required during an upgrade, typically only necessary for major version increments.
Configuration
- Copy the template
config.inc.php.dist
toconfig.inc.php
(Composer may already have done this for you) - Now edit
plugins/identity_from_directory/config.inc.php
as you need. The inline comments describe every config value in detail.
Some additional notes:
- All plugin actions are only triggered during a user's login. So logout and login again to test a new configuration.
- This plugin is technically compatible with all values of Roundcube's
$config['identities_level']
config option. However, a value of1
(user can edit all params but not the email address as well as add or delete identities in the UI) or3
(user can edit all params but not the email address and cannot add or delete identities in the UI) makes most sense. - Set
$config['identity_from_directory_deleteunmanaged'] = true
if you want to delete propably unwanted identities automatically. - Set
$config['identity_from_directory_handle_proxyaddresses'] = true
to support searching for alias addresses in Active Directory'sproxyAddresses
field. It may contain a CSV string likesmtp:[email protected],smtp:[email protected]
.
Compatibility
- Roundcube 1.6 or higher.
- PHP 7.4 or higher.
- No special database requirements. This plugin does not adapt the database schema and is using Roundcube's built-in actions and hooks to handle the identity data.
The plugin may work with older versions then listed above, but this is not tested nor supported. We recommend using the latest stable Roundcube version and PHP 8.x, which the plugin is most tested with.
Licensing, copyright
Copyright (c) 2024, foundata GmbH (https://foundata.com)
This project is licensed under the GNU General Public License v3.0 or later (SPDX-License-Identifier: GPL-3.0-or-later
), see LICENSES/GPL-3.0-or-later.txt
for the full text.
The SPDX software bill of materials (SBOM).
Author information
This project was created and is maintained by foundata. If you like it, you might buy them a coffee. The plugin was heavily inspired by the new_user_identity
plugin.