Software Stack Customizing the Login page

Edit online

You can customize the authentication Login page to meet the requirements of your organization. For example, you can customize your company or product logo. You can also define more details, or change the labels of fields on the page.

Before you begin

You must have read or write access to the customizable files and the directories where they are maintained. See Location of IVIG Service Center customizable files and Customizing IVIG Service Center files (Software stack ) for specific details about where these files are located. Contact your system administrator if you do not have the necessary permissions.

About this task

You can customize the appearance and content of the Login page to meet your needs.

Procedure

  1. Open any text editor to edit a property file.
  2. Optional: Make a custom copy of the nls/LoginText.properties file.
  3. Optional: Edit the nls/LoginText.properties file to customize the various fields on the Login page.
    The nls/LoginText.properties file contains a set of properties that define the text strings that are displayed in the various fields of the Login page. You can customize the Login page text by changing the text that is associated with these properties, as follows:
    LOGO_ALT_TEXT
    Specify custom text to display if the logo image is missing.
    HELP_TAG
    Specify a custom label for the Help hyperlink.
    LEARN_MORE
    Specify custom text for the Learn More hyperlink.
    LOG_IN
    Specify a custom label for the Log in button.
    PASSWORD
    Specify a custom label for the Password field.
    PRODUCT_NAME
    Specify a custom title for the product name.
    USER_ID
    Specify a custom label for the User ID field.
    INVALID_USERNAME
    Specify a custom message that is displayed when an invalid user name is entered.
    INVALID_PASSWORD
    Specify a custom message that is displayed when an invalid password is entered.
    LANGUAGE_LABEL
    Specify the label for the language selection field.
  4. Optional: Customize the company or product image on the Login page.
    You can customize the image on the login page by using either of the following ways:
    • Create a custom image file in GIF format with the file name companyLogo.gif. Place the image file in the /images folder of your customizable files.
    • Create a custom image file with any file name, such as someImage.jpg. Place the image file in the /images folder of your customizable files. Then, create a custom copy of the config/UIconfig.properties file and modify the LOGO_IMAGE property to specify the name of the image file such as someImage.png.
  5. Optional: Modify the copyright information at the bottom of the Login page.
    The copyright information that is provided by IBM is delivered as an HTML template, nls/html/LoginPageCopyrightContent.html, and a properties file, nls/LoginPageCopyrightContent.properties. The properties file contains the text that is substituted into the HTML template. To customize the copyright information on the Login page, you can take one of the following actions:
    • Continue to use the HTML template that is provided by IBM. Create a custom copy of the template substitutions nls/LoginPageCopyrightContent.properties file. Then, modify the FOOTER_TEXT property in the nls/LoginPageCopyrightContent.properties file to the text you want to be displayed at the bottom of the Login page.
    • Create a custom version of the nls/html/LoginPageCopyrightContent.html template and modify it to use whatever HTML formatting and template substitutions that you want. Then, create a custom copy of the nls/LoginPageCopyrightContent.properties file and add or modify the properties in it to provide the necessary substitutions for your custom HTML template.
    • If you do not want to use an HTML template with substitutions, you can create a custom copy of the nls/html/LoginPageCopyrightContent.html template file. Then, replace the template substitution references with the actual copyright text that you want to display.
  6. Optional: Modify the site information on the right side of the Login page.
    The site information that is provided by IBM is delivered as an HTML template, nls/html/LoginPageInfoContent.html, and a properties file, nls/LoginPageInfoContent.properties. The properties file contains text that is substituted into the HTML template. To customize the site information on the Login page, you can take one of the following actions:
    • Continue to use the HTML template that is provided by IBM. Create a custom copy of the template substitutions nls/LoginPageInfoContent.properties file. Then, modify the properties in the nls/LoginPageInfoContent.properties file to provide the text that you want to be displayed on the right side of the Login page.
    • Create a custom version of the nls/html/LoginPageInfoContent.html template and modify it to use whatever HTML formatting and template substitutions that you want. Then, create a custom copy of the nls/LoginPageInfoContent.properties file and modify or replace the properties in it to provide the necessary substitutions for your custom HTML template.
    • If you do not want to use an HTML template with substitutions, you can create a custom copy of the nls/html/LoginPageInfoContent.html template file. Then, replace the template substitution references with the actual site information text that you want to display.
  7. Save and close each of the custom files when you are finished customizing for the Login page.
  8. Start the Login page again.

Results

The Login page now displays the customization that you made.

What to do next

Use the custom Login page for your requirements. You can verify the change immediately in a single-server WebSphere® Application Server environment. In a managed-cluster environment, you must wait until after the configuration is synchronized to the application servers in the cluster. For information about synchronizing the WebSphere managed-cluster environments, see the WebSphere Application Server section of the IBM Knowledge Center.