Customize the Login page text

You can customize the authentication Login page to meet the requirements of your organization. For example, you can customize the text that is displayed on the page. 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 Identity Service Center customizable files and Customization of Identity Service Center files 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 must perform customization tasks on a primary node.

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

Use the following sections to work with the configuration files or the configuration properties from the IBM Security Identity Manager virtual appliance console:

Procedure

  1. Download the LoginText.properties file from the ui/nls folder.
    1. From the top level of the Appliance Dashboard, click Configure > Advanced Configuration > Custom File Management.
    2. From the All Files tab, click directories > ui > nls.
    3. Type LoginText.properties in the search box. The list of LoginText.properties files is displayed.
    4. Select LoginText.properties and click Download.
    5. Save the file.
  2. Create a backup copy of the LoginText.properties file.
  3. Open the LoginText.properties file with a text editor to customize the various fields on the Login page. The LoginText.properties file contains a set of properties that define the text strings that are displayed in the various fields of the Login page.
  4. Customize the Login page text by changing the text that is associated with the following properties:
    LOGO_ALT_TEXT
    Specify custom text to display if the logo image is missing.
    HELP_TAG
    Specify a custom label for the Help hyperlink.
    INVALID_CREDS
    Specify a custom message that is displayed when a user ID and password are not valid, are expired or are disabled.
    SYSTEM_DOWN
    Specify a custom message that is displayed when a system error occurs.
    LEARN_MORE
    Specify custom text for the Learn More hyperlink.
    LOG_IN
    Specify a custom label for the Log in button.
    FORGOT_PASSWORD
    Specify a custom label for the Forgotten password field.
    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
    Label for the language selection field.
    LOGIN_PAGE_TITLE
    Specify the title for your Login page
  5. Save the file.
  6. Upload the LoginText.properties file to the ui/config folder.
    1. Go to the top level of the Appliance Dashboard click Configure > Advanced Configuration > Custom File Management.
    2. From the All Files tab, click directories > ui > nls.
    3. Select LoginText.properties and click Upload.
    4. Click Browse to select the LoginText.properties file that you customized.
    5. Click Save Configuration to upload the file.

Parent topic: Login page customization