To use LDAP with your JasperReports Server, configure the LDAP connection parameters in default_master.properties before installing JasperReports Server. You can set up encryption for the password to your LDAP server at that time. See the JasperReports Server Security Guide for more information.
A sample file for configuring JasperReports Server for external LDAP authentication is included in the JasperReports Server distribution. Sample files are located in the <js‑install>/samples/externalAuth-sample-config directory of your JasperReports Server. The file included depends on your version of JasperReports Server:
|•||sample-applicationContext-externalAuth-LDAP.xml: Sample file for integrating LDAP with JasperReports Server with a single organization. This file is included in the community edition.|
|•||sample-applicationContext-externalAuth-LDAP-mt.xml: Sample file for integrating LDAP with JasperReports Server with multiple organizations. This file is included in commercial editions of JasperReports Server. To use external authentication with a commercial version of JasperReports Server with a single organization, you need to modify the sample file as described in Mapping the User Organization.|
To configure JasperReports Server to work with your implementation of LDAP, modify and deploy the sample configuration file as follows:
|1.||Make a copy of the LDAP sample file in the <js-install>/samples/externalAuth-sample-config/ directory and rename it to remove the sample- prefix.|
|2.||Edit the file you created and configure the beans correctly for your deployment, as described in the following sections.|
|3.||Place the modified file in the <js-webapp>/WEB-INF directory.|
<js-webapp> is the location of the JasperReports Server web application in your application server, or where you're modifying the configuration files, as explained in . The rest of this chapter refers to file names alone.