LdapContribGuiPlugin
Introduction
LdapContribGuiPlugin provides services to administer the LDAP cache created by
TWiki:Plugins/LdapContrib, a BerkeleyDB v1 database created with the Perl module DB_File.
The topic requires the
TWiki:Plugins/JQueryPlugin,
TWiki:Plugins/JqPlotPlugin and
TWiki:Plugins/LdapContrib.
LdapContrib cache admin panel
As of writing this, the services are present for members of the TWikiAdminGroup via the topic
LdapContribAdmin.
The topic contains a single variable %LDAPCONTRIBADMIN% which is set via
LdapContribGuiPlugin.pm
given that:
- The plugin is enabled in
configure
.
- You are logged in.
- You are a member of TWikiAdminGroup.
- You are viewing the topic LdapContribAdmin.
Navigation in the admin panel is picked up by JQuery defined in
LdapContribGuiPlugin.js
, and any new content are fetched via AJAX served by
LdapContribPlugin.pm
over the REST architecture.
Features
- View all users, displaying stored LDAP DN, emails, WikiName, created date and update date for every user.
- Using a built-in search box you can narrow the search by searching for both login names and WikiNames using a regular expression.
- Change WikiName for users, allowing the WikiName you are changing to be preserved from being taken by other users.
- Delete users.
- View and delete ignored users and groups. These are groups that have been tried looked up in LDAP and which could not be found. The ignore lists prevents these entries to be looked up again to reduce the stress on the LDAP server.
- View groups with it's users.
- Only users which is present in the LdapContrib cache are shown, not showing members only present on the LDAP server.
- Possibility to delete groups and it's user memberships (the users themselves are not touched by doing this).
- An overview, showing the number of stored user accounts, groups, ignored users and groups, as well as a dump of the LdapContrib settings.
- The overview also show's a graph displaying the number of user registrations per month through time. The graph is generated using TWiki:Plugins/JqPlotPlugin.
Further enhancements
As of writing this, I can envision the following features being implemented in the Plugin at a future date:
- Possibility for users to change their own WikiName.
Plugin Installation Instructions
- Run configure for automated install, or do a manual install:
- Download the ZIP file from the Plugin web (see below)
- Unzip
LdapContribGuiPlugin.zip
in your twiki installation directory. Content:
File: |
Description: |
data/TWiki/LdapContribGuiPlugin.txt |
This topic |
data/TWiki/LdapContribAdmin.txt |
The topic for the LdapContribGuiPlugin admin panel, entry point for administering the LdapContrib cache. |
pub/TWiki/LdapContribAdmin/LdapContribAdmin.css |
CSS for LdapContribAdmin |
pub/TWiki/LdapContribAdmin/LdapContribAdmin.js |
JavaScript for LdapContribAdmin using jQuery and jQplot |
pub/TWiki/LdapContribAdmin/spinner.gif |
A simple spinner animation |
lib/TWiki/Plugins/LdapContribGuiPlugin.pm |
The plugin, populating the %LDAPCONTRIBADMIN% variable. Provides a REST interface for the actions in the admin panel. |
- Optionally, run
LdapContribGuiPlugin_installer.pl
to automatically check and install other TWiki modules that this module depends on. You can also do this step manually.
- Alternatively, manually make sure the dependencies listed in the table below are resolved.
- Visit
configure
in your TWiki installation, and enable the plugin in the {Plugins} section.
- Dependencies:
Name | Version | Description |
TWiki::Plugins |
|
|
TWiki::Contrib::LdapContrib |
| |
TWiki::Plugins::JQueryPlugin |
| |
TWiki::Plugins::JqPlotPlugin | | |
Plugin Info
This work was partly sponsored by
Related Topics: LdapContrib