Chapter 16 Customizing OpenSSO Enterprise Administration Console Pages

For some deployments, you might need to customize Administration Console pages such as the login or logout page.

Customizing the OpenSSO Enterprise Login and Logout Pages

To Customize the OpenSSO Enterprise Login and Logout Pages

1. Make sure that your JAVA_HOME environment variable points to JDK 1.5 or later.

2. Download and unzip opensso_enterprise_80.zip, as described in Downloading OpenSSO Enterprise.

3. Create a new staging directory and extract the files from opensso.war in this staging directory. For example:

   # mkdir customwar
   # cd customwar
   # jar xvf zip-root/opensso/deployable-war/opensso.war

   where zip-root is where you unzipped opensso_enterprise_80.zip.

4. Customize the pages as required for your deployment by editing the JSP and XML files required by your deployment. For example:

   customwar/config/auth/default/Login.jsp	Console login page
   customwar/config/auth/default/Logout.jsp	Console logout page
   customwar/config/auth/default/DataStore.xml	Data store authentication page
   customwar/config/auth/default/LDAP.xml	LDAP authentication page

   where customwar is where you extracted the files from opensso.war.

5. Generate a new WAR file with the customized files. For example:

   # cd customwar
   # jar uvf OpenSSOCustom.war *

6. Deploy the new customized war file, as described in Deploying the OpenSSO Enterprise WAR File.