CA Adapter UNIX Installation Guide › Deploying and Configuring SAML Sample Applications

Deploying and Configuring SAML Sample Applications

SAML sample applications can be used to verify if Adapter was successfully installed and configured for SAML integration. In addition, it demonstrates:

• The typical authentication workflows supported by Adapter
• Integration of your application with Adapter

Important! Sample application must not be used in production deployments. The sample application is provided to demonstrate the AFM SAML workflows.

This chapter covers the following topics:

• Deploying the Sample Application WAR Files
• Verifying the Sample Application Deployment
• Configuring Sample Application

Deploy the Sample Application WAR Files

The Adapter installation package includes the following SAML sample applications:

• samlsampleapp.war: The main sample application.
• bankapp.war: The sample bank application.
• insuranceapp.war: The sample insurance application.

Using these modules, you can test the authentication workflows available in the SAML integration. To deploy sample application:

1. Navigate to the following location:

   saml_sample_app_installation_dir/sampleApplications

2. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script. This script is located in the adapter-install-location directory.
3. Copy the samlsampleapp.war, bankapp.war, and insuranceapp.war files to your application server. For example on Apache Tomcat, the location to copy the WAR file is:

   application_server_home/webapps

   Apache Tomcat automatically deploys the WAR files and creates the following folders under the webapps folder:

   • samlsampleapp
   • bankapp
   • insuranceapp

Note: Refer to the vendor documentation for deployment instructions on other supported application servers. Bear in mind that you must set the $AFM_HOME environment variable before you restart the application server.

1. (Applicable Only for JDK 1.5 on Apache Tomcat) Perform the following steps to deploy the JAR files on an Apache Tomcat installation that is using JDK 1.5:
   1. Browse to the location where the Adapter installer file is unzipped.
   2. Copy the JAR files from the endorsed folder to the location configured for the -Djava.endorsed.dirs system property.
   3. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
   4. Restart the application server for the changes to take effect.
2. (Applicable Only for IBM WebSphere) Perform the following steps after you deploy the WAR file:
   1. Log in to the IBM WebSphere administration console.
   2. Navigate to Applications > Applicatons Types> WebSphere Enterprise Applications.
   3. Click the WAR file link.
   4. Click the Class loading and update detection link.
   5. In the Class loader order section, select the Classes loaded with local class loader first (parent last) option.
   6. In the WAR class loader policy section, select the Single class loader for application option.
   7. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
   8. Restart IBM WebSphere.
3. (Applicable only for Oracle WebLogic) Perform the following steps:
   1. Stop the WebLogic Server.
   2. Create a directory named endorsed, if it does not already exist, in the JAVA_HOME/jre/lib directory.
   3. If there is an existing JAVA_HOME/jre/lib/endorsed directory, take a backup of the following JAR files and then delete them from the JAVA_HOME/jre/lib/endorsed directory:
      • resolver
      • serializer
      • xalan
      • xercesImpl
      • xml-apis
   4. Copy the JAR files that are available in the endorsed directory of the Adapter package to the JAVA_HOME/jre/lib/endorsed directory.
   5. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
   6. Start the WebLogic server.