Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Plugin Information

View LDAP on the plugin site for more information.

Security realm based on LDAP authentication.
(In Jenkins core until 1.468.)

Configuration

Select LDAP for the Security Realm and click the help icon for each configuration option to see information about the settings.

If login attempts result in "OperationNotSupportedException - Function Not Implemented", "Administrative Limit Exceeded" or similar error, the LDAP query to determine the group membership for the user may be triggering this. First try setting the "Group search base" setting as specific as possible for your LDAP structure, to reduce the scope of the query. If the error persists, you may need to edit the WEB-INF/security/LDAPBindSecurityRealm.groovy file that is included in jenkins.war. Change the line with groupSearchFilter = "(| (member={0}) (uniqueMember={0}) (memberUid={1}))"; to query only of the field used in your LDAP for group membership, such as groupSearchFilter = "(member={0})"; (then restart Jenkins).

The LDAP groups were available in Jenkins in the format of ROLE_Uppercasedgroupname, so the developers ldap group would be ROLE_Developers in Jenkins, but since 1.404 they are available as is: no prefix or upper casing,

Since Jenkins 1.468, this has been moved to a plugin. The LDAPBindSecurityRealm.groovy file is therefore part of the ldap.jpi file. You can find the default template at $JENKINS_HOME/plugins/ldap/WEB-INF/classes/hudson/security/LDAPBindSecurityRealm.groovy. That file will be recreated from the ldap.jpi file every time Jenkins starts, so if you need to override the defaults, the correct way is to just copy the template file to $JENKINS_HOME/LDAPBindSecurityRealm.groovy. The $JENKINS_HOME/LDAPBindSecurityRealm.groovy file is re-read every time the security components are reconfigured, so it should just be a case of re-saving the security configuration to force the file to be re-read.

  • No labels