{jenkins-plugin-info:ldapemail}

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.8 (July 9, 2014)
Version 0.7 (February 14, 2011)
Version 0.6 (January 31, 2010)
Version 0.5 (January 20, 2009)
Version 0.4 (September 30, 2008)
Version 0.3 (September 25, 2008)
Version 0.2 (September 19, 2008)
Version 0.1 (June 20, 2008)