Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Chapter 17 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

ProcedureTo 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.