Sun Java System Access Manager 7 2005Q4 Developer's Guide

Customizing Branding and Functionality

You can modify JSP templates and module configuration properties files to reflect branding or functionality specified for any of the following:

ProcedureTo Modify Branding and Functionality

  1. Go to the directory where default JSP templates are stored.

    cd AccessManager-base/SUNWam/web-src/services/config/auth

  2. Create a new directory.

    Use the appropriate customized directory path based on the level of customization. Use the following forms:


    In these examples,

    orgPath represents subOrg1/subOrg2

    filePath represents clientPath + serviceName

    clientPath represents clientType/sub-clientType

    In these paths, SubOrg, Locale, Client Path, Service Name (which represents orgPath and filePath ) are optional. The organization name you specify may match the organization attribute set in the Directory Server. For example, if the organization attribute value is SunMicrosystems, then the organization customized directory should also be SunMicrosystems. If no organization attribute exists, then use the lowercase value of the organization name (sunmicrosystems).

    For example, for the following attributes:

    org = SunMicrosystems

    locale = en

    subOrg = solaris

    clientPath = html/ customerName/

    serviceName = paycheck

    customized directory paths would be:

    SunMicrosystems_en/solaris/html/ customerName /paycheck

    SunMicrosystems/solaris/html/ customerName /paycheck

    default_en/solaris/html/ customerName/paycheck

    default/solaris/html/ customerName /paycheck

  3. Copy the default templates.

    Copy all the JSP templates (*.jsp) and authentication module configuration properties XML files (*.xml) from the default directory:

    AccessManager-base /SUNWam/web-src/services/config/auth/default

    to the new directory:

    AccessManager-base /SUNWam/web-src/services/config/ auth/CustomizedDirectoryPath

  4. Customize the files in the new directory.

    The files in the new directory can be customized if necessary, but not this is not required. See Customizing the Login Page and Customizing JSP Templates for information on what you can modify.

  5. Update and redeploy services.war.

    Once you’ve modified the authentication GUI files, in order to see the changes in the actual GUI, you must update and then redeploy services.war. See Updating and Redeploying services.war in this chapter for instructions. See Chapter 12, Updating and Redeploying Access Manager WAR Files for general information on updating and redeploying Access Manager .war files.

  6. Restart both Access Manager and the web container server.