How to configure JasperReports Server 4.5.1, 4.7.1, 5.0.1 and CAS.

List of the software used to create the test environment:

• Operating system Ubuntu Linux 10.04 x64. You can download it by navigating the link: http://releases.ubuntu.com/lucid/

• Application container apache-tomcat-6.0.36.tar.gz. You can download in by navigating the link: http://apache-mirror.telesys.org.ua/tomcat/tomcat-6/v6.0.36/src/apache-tomcat-6.0.36-src.tar.gz

• CAS Server 3.4.5 Release. You can download it by navigating the link: http://www.jasig.org/cas_server_3_4_5

• Java SE Development Kit 7. You can download it by navigating the link: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

CAS authentication was tested with war file installers that listed below:

1. jasperreports-server-4.5.1-bin
2. jasperreports-server-4.7.1-bin
3. jasperreports-server-5.0.1-bin

Let's start and configure our test environment.

1. Download JDK and extract it into the /opt folder. For simplicity create the symbolic link from jdk1.7.0_17 to java

   

2. Define the JAVA_HOME variable and add java binaries to the system PATH variable

   

3. Use keytool utility to self-author a server certificate

   

4. The keytool command has been called under the root account, so .keystore file has been placed in the /root/ folder (/root/.keystore)

   

5. Rename cas from cas-server-webapp-3.4.5.war to cas.war

   

6. Enable apache-tomcat gui administrator account.

   

7. Deploy and configure CAS:

   

   

   

   Below I quote the properties from the cas.properties file that should be changed from their default values:

   cas.securityContext.serviceProperties.service=https://castest:8443/cas/services/j_acegi_cas_security_check
   cas.securityContext.casProcessingFilterEntryPoint.loginUrl=https://castest:8443/cas/login
   cas.securityContext.casProxyTicketValidator.casValidate=https://castest:8443/cas/proxyValidate
   cas.securityContext.ticketValidator.casServerUrlPrefix=https://castest:8443/cas
   host.name=castest
   

   As I said above, you can reload CAS application from the apache-tomcat GUI manager by navigating to it's page and clicking the Reload link related to the CAS application

   

8. Enable ssl support in apache-tomcat

   

9. Configure Java trust to CAS certificate. This should be done in the setenv.sh(bat) file

   

10. Below is shown a very simple default_master.properties file that has been used to deploy JasperReports Server into apache-tomcat.

    The files for v4.7.1 and v5.0.1 versions have the same settings that in this one.

    

11. Deploy the pre-configured war-file installation of JasperReports Server by executing:

    ./js-install
    

from the buildomatic folder

Restart apache-tomcat to apply the changes that have been done.

If you want to use 2 hosts to test JasperReports Server and CAS please follow the instruction on the picture below

On the picture below is shown contents of the archive that has been attached to this article:

Thats all. Thank you for your attention to this article :)

Alex

jasper_reports_server_451_471_501_cas.tar.gz

jasper_reports_server_451_471_501_cas.zip