Sun Identity Manager Deployment Guide

Customizing the Home Page

Adding a List of Quick Links

A typical customization to the home page involves adding a custom list of links to tasks or resources that users frequently access in your environment. These quick links offer a shortcut through the product interface to frequent destinations.

ProcedureTo Add a Listof Quick Links

  1. Add links to the list in index_quickLinks.jsp.

  2. Uncomment the list section by removing the surrounding <%-- and --%> tags.

  3. Save the file. You do not need to restart your application server.

Changing the Default “Logged in as” Text

ProcedureTo Change the Default Text

  1. Imported the following XML file:


    <?xml version=’1.0’ encoding=’UTF-8’?>
    <!DOCTYPE Configuration PUBLIC ’waveset.dtd’ ’waveset.dtd’>
    <Configuration name=’AltMsgCatalog’>
      <Extension>
        <CustomCatalog id=’AltMsgCatalog’ enabled=’true’>
          <MessageSet language=’en’ country=’US’>
            <Msg id=’UI_BROWSER_TITLE_PROD_NAME_OVERRIDE’>Override Name</Msg>
          </MessageSet>
        </CustomCatalog>
      </Extension>
    </Configuration>
  2. Add the following line to the System Configuration object within the <Configuration><Extension><Object> element:


    <Attribute name=’customMessageCatalog’ value=’AltMsgCatalog’/>
  3. Add the following line:


    <msg id=’UI_NAV_FOOT_LOG’>mytext{0}</msg>
  4. Save change and restart your application server.

Changing Page Title and Subtitle

To change the default Login page title and subtitle and welcome message, change the following entries in the custom message catalog:

To change this text, follow the procedure for extracting and editing the WPMessages_en.properties file detailed in Changing the Default “Logged in as” Text.

The following text lists the default message catalog settings:


UI_LOGIN_IN_PROGRESS_TITLE=Log In (In Progress) 
UI_LOGIN_CHALLENGE=Enter Your {0} Password 
UI_LOGIN_CHALLENGE_INFO=You are required to enter the password you logged into 
[PRODUCT_NAME] with before the requested action can be completed. 
UI_LOGIN_TITLE_LONG=[PRODUCT_NAME] LogIn 
UI_LOGIN_WELCOME=Welcome to the Sun [PRODUCT_NAME] system. Enter the requested 
information, and then click <b>Login</b>. 
UI_LOGIN_WELCOME2=Welcome to the Sun [PRODUCT_NAME] system. Enter your user ID and 
password, and then click <b>Login</b>. If you can’t remember your password, click 
<b>Forgot Your Password?</b> 
UI_LOGIN_TITLE=Log In UI_LOGIN_TITLE_TO_RESOURCE=Log In to <b>{0}</b>

Changing Background Image on the Login Page

You can change the background image by editing customStyle.css as follows:

div#loginFormDiv {
   background:
url(.../images/other/login-backimage2.jpg)
no-repeat;
     margin-left: -10px;
     padding: 0px 0px 280px;
    height: 435px;

Customizing the Browser Title Bar

You can now replace the product name string in the browser title bar with a localizable string of your choice.

ProcedureTo Replace the Product Name String

  1. Import the following XML file:


    <?xml version=’1.0’ encoding=’UTF-8’?>
    <!DOCTYPE Configuration PUBLIC ’waveset.dtd’ ’waveset.dtd’>
    <Configuration name=’AltMsgCatalog’>
      <Extension>
        <CustomCatalog id=’AltMsgCatalog’ enabled=’true’>
          <MessageSet language=’en’ country=’US’>
            <Msg id=’UI_BROWSER_TITLE_PROD_NAME_OVERRIDE’>Override Name</Msg>
          </MessageSet>
        </CustomCatalog>
      </Extension>
    </Configuration>
  2. Using the Identity Manager IDE, load the System Configuration object for editing. Add the following line inside the <Configuration><Extension><Object> element:


    <Attribute name=’customMessageCatalog’ value=’AltMsgCatalog’/>
  3. Also in the System Configuration object, you must change ui.web.browserTitleProdNameOverride to true.

  4. Save this change to the System Configuration object, and restart your application server.