LDAP Authentication

Lightweight Directory Access Protocol (LDAP) is one of the most popular architectures for enterprise directories. By centralizing all user management in an LDAP directory, applications across the enterprise can share the same user database, and administrators don't need to duplicate user accounts.

This chapter shows how JasperReports Server can be configured to perform external authentication with LDAP. As part of the authentication process, JasperReports Server also synchronizes the external user information, such as roles and organization ID, between LDAP and the JasperReports Server internal database.

LDAP authentication does not provide single sign-on (SSO) functionality. You must implement that separately and configure it for use within JasperReports Server. Enabling SSO with LDAP is beyond the scope of this guide. For more information, see Advanced Topics.

This chapter assumes you're familiar with LDAP servers and the structure of the data they contain, in particular the format of distinguished names (DNs) and relative distinguished names (RDNs) that create structure and identify entries in LDAP. For more information about LDAP in Spring Security, see the LDAP sample in the Spring Security reference documentation for 3.2.x at

This chapter contains the following sections:

Overview of External LDAP Authentication
Configuring JasperReports Server for LDAP Authentication
Overview of LDAP Beans
Setting the LDAP Connection Parameters
Performing LDAP User Search
Mapping the User Roles
Mapping the User Organization
Mapping Roles to System Roles
Setting Up Multiple Providers
Restarting JasperReports Server