Configuring JasperReports Server for CAS Authentication

This documentation is an older version of JasperReports Server Authentication Cookbook. View the latest documentation.

Jaspersoft provides sample files for configuring JasperReports Server for external CAS authentication for both commercial and community editions; the precise files included in your deployment depend on your edition. CAS sample files are located in the <js‑install>/samples/externalAuth-sample-config directory of your JasperReports Server; the available files differ between community and commercial editions.

The sample files in your deployment that integrate Spring Security’s default CAS implementation with JasperReports Server may include the following:

•

sample-applicationContext-externalAuth-CAS.xml: Sample file for integrating CAS with a JasperReports Server with a single organization, assigning the same roles to all users.

•

sample-applicationContext-externalAuth-CAS-staticRoles.xml: Sample file for integrating CAS with a JasperReports Server with a single organization, assigning additional roles to a list of administrative users.

•

sample-applicationContext-externalAuth-CAS-db-mt.xml: Sample file for integrating CAS with a JasperReports Server with multiple organizations, retrieving role and organization data from a JDBC database.

•

sample-applicationContext-externalAuth-CAS-LDAP-mt.xml: Sample file for integrating CAS with a JasperReports Server with multiple organizations, retrieving role and organization data from an LDAP server.

To use LDAP or an external database with CAS, configure the LDAP or database connection parameters in default_master.properties prior to installing JasperReports Server. You can set up encryption for the password to your LDAP server or database at that time. See the JasperReports Server Administrator Guide for more information.

To configure JasperReports Server to work with your implementation of CAS, select the sample configuration file you want, then modify and deploy it as follows:

Make a copy of the CAS sample file you want and name it in the form applicationContext-<Name>.xml, for example, applicationContext-externalAuth-CAS.xml.

Edit the file you created and configure the beans correctly for your deployment, as described in the following sections.

Place the modified applicationContext-externalAuth-CAS.xml 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 are modifying the configuration files, as explained in WEB-INF Directory Location. The rest of this chapter refers to file names alone.