We provide sample files for configuring JasperReports Server for external CAS authentication. These files are specific to your edition (commercial or community). CAS sample files are located in the <js‑install>/samples/externalAuth-sample-config directory of your JasperReports Server.
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 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 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 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 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 before installing JasperReports Server. You can set up encryption for the password to your LDAP server or database at that time. See the JasperReports Server Security 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:
|1.||Make a copy of the CAS sample file and name it in the form applicationContext-<Name>.xml, for example, applicationContext-externalAuth-CAS.xml.|
|2.||Edit the file you created and configure the beans correctly for your deployment, as described in the following sections.|
|3.||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're modifying the configuration files, as explained in WEB-INF Directory Location. The rest of this chapter refers to file names alone.