To Customize the Distributed Authentication User Interface

Before You Begin

The Distributed Authentication User Interface package must already be installed. For detailed installation instructions, see Installing and Configuring a Distributed Authentication UI Server Using the Java ES Installer in Sun Java System Access Manager 7.1 Postinstallation Guide.

1. Explode the Distributed Authentication User Interface WAR.

2. At the command line, go to the directory where the default JSP templates are stored.

   Example:

   cd DistributedAuth-base/config/auth

   where DistributedAuth-base is the directory where the Distributed Authentication User Interface package is exploded.

3. Create a new directory using the appropriate directory path based on the level of customization.

   Use the following form:

   org_locale/orgPath/filePath
           org/orgPath/filePath
           default_locale/orgPath/filePath
           default/orgPath/filePath

   where:

   orgPath = subOrg1/subOrg2
           filePath = clientPath + serviceName
           clientPath = clientType/sub-clientType

   The following are optional: Sub-org, Locale , Client Path , and Service Name . In the following example, orgPath and filePath are optional.

   For example, given the following:

   org = iplanet
   locale = en
   subOrg = solaris
   clientPath = html/nokia/
   serviceName = paycheck

   the appropriate directory paths for the above are:

   iplanet_en/solaris/html/nokia/paycheck    
   iplanet/solaris/html/nokia/paycheck          
   default_en/solaris/html/nokia/paycheck         
   default/solaris/html/nokia/paycheck

4. Copy all the JSP templates and authentication module configuration properties XML files from the default directory to the new directory.

   cp DistributedAuth-base/config/auth/default/*.jsp  
   			DistributedAuth-base/config/auth/new_directory_path
   

   cp DistributedAuth-base/config/auth/default/*.xml 
   			DistributedAuth-base/config/auth/new_directory_path
   

5. (Optional) Modify the files in the new directory to suit your needs.

   • For information about customizing the .jsp files, see Java Server Pages.

   • For information about customizing the .xml files, XML Files.

6. Create a new .WAR file named amauthdistui_deploy.war from DistributedAuth-base.

7. Deploy amauthdistui_deploy.war.

   The web container administrator deploys the file in the remote web container.