LDAP Email Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID ldapemail Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
0.7
Feb 14, 2011
1.377
Source Code
Issue Tracking
Maintainer(s)
Subversion
Open Issues
Justin Edelson (id: justinedelson)
Usage Installations 2013-Apr 1236
2013-May 1230
2013-Jun 1253
2013-Jul 1280
2013-Aug 1250
2013-Sep 1287
2013-Oct 1346
2013-Nov 1304
2013-Dec 1260
2014-Jan 1327
2014-Feb 1363
2014-Mar 1378

LDAP Email plugin

This plugin resolves user email addresses from an LDAP directory.
It is not needed if Jenkins uses LDAP as its authentication source and user records have a standard "mail" attribute. In this case Jenkins will already find user email addresses.

Configure the plugin in the LDAP Email Lookup section in the main Jenkins settings page (Manage / Configure System).

Here's an example configuration file:

<?xml version='1.0' encoding='UTF-8'?>
<com.mtvi.plateng.hudson.ldap.Configuration>
	<server>ldap://testserver:389</server>
	<baseDN>ou=People,dc=test,dc=com</baseDN>
	<bindDN>cn=Jenkins,ou=Internal,dc=test,dc=com</bindDN>
	<bindPassword>password</bindPassword>
	<emailAttribute>mail</emailAttribute>
	<searchAttribute>uid</searchAttribute>
</com.mtvi.plateng.hudson.ldap.Configuration>

The bindDN and bindPassword elements are only required if your LDAP server does not support anonymous binding.

By default the plugin will form a distinguished name (DN) with this pattern:

<searchAttribute>=<userName>,<baseDN>

However, there are environments where you need to perform an LDAP search. To do this, check the "Perform Search" checkbox in the config settings, which adds a performSearch element to the configuration file:

<?xml version='1.0' encoding='UTF-8'?>
<com.mtvi.plateng.hudson.ldap.Configuration>
	<server>ldap://testserver:389</server>
	<baseDN>dc=test,dc=com</baseDN>
	<bindDN>cn=Jenkins,ou=Internal,dc=test,dc=com</bindDN>
	<bindPassword>password</bindPassword>
	<emailAttribute>mail</emailAttribute>
	<searchAttribute>uid</searchAttribute>
        <performSearch>true</performSearch>
</com.mtvi.plateng.hudson.ldap.Configuration>

This will perform a subtree-scoped search within the baseDN with the filter

<searchAttribute>=<userName>

Version History

Version 0.7 (February 14, 2011)
  • Translation update (French)
Version 0.6 (January 31, 2010)
  • Update code for more recent Hudson
Version 0.5 (January 20, 2009)
  • Add configuration UI
Version 0.4 (September 30, 2008)
  • All logging is done at the INFO level.
Version 0.3 (September 25, 2008)
  • More logging
Version 0.2 (September 19, 2008)
  • Adding search support
  • Adding more verbose logging
  • Fixing bug where emailAttribute configuration option was ignored in some circumstances
Version 0.1 (June 20, 2008)
  • Initial release

Labels

Edit
plugin-user plugin-user Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.