IBM Security Identity Governance and Intelligence, Version 5.2.4

Customizing the login and logout pages

With the internal OpenID Connect authentication feature enabled, the virtual appliance local management interface, the Administration Console, and the Service Center share the same login and logout pages. You can customize some elements of these pages to fit company preferences.

About this task

From the virtual appliance local management interface you can change the appearance of the Identity Governance and Intelligence login and logout pages by customizing files in the CustomLoginScreenfolder.

The CustomLoginScreen folder contains the loginPageCustomization.properties file and the resource-bundles subfolder.
  • You can edit the loginPageCustomization.properties file to change the following items for the login and logout screens:
    • The product title
    • The product version
    • The product logo
    • The background image
    • The background color of the footer and of the login button in the login screen

    Note that the product title and the product version can be in English only.

    The next figure shows the elements that you can change in the login page if you edit loginPageCustomization.properties with the procedure that is described in this section.
    The figure is the default login page with the following elements, framed in red and shown clockwise from the upper left: product name, background color, background color of footer and login button, product logo, and product version.
    The next figure shows the elements that you can change in the logout pages if you edit loginPageCustomization.properties with the procedure that is described in this section.
    The figure is the default logout page with the following elements, framed in red and shown clockwise from the upper left: product name, background color, background color of footer, product logo, and product version.
  • The resource-bundles subfolder includes a loginLogoutMessages_<language>.properties file for every one of the supported languages. You can edit the files that match your preferred languages to change the following items:
    • The copyright statement in the login and logout screens
    • The Login label and login button text in the login screen
    • The User Name label in the login screen
    • The Password label in the login screen
    • The Forgot Password label in the Service Center login screen
    • The Logged Out label in the logout screen
    • The logout message in the logout screen

    The text is then displayed in accordance with the language that the browser is set to.

    The next figure shows the elements that you can change in the login page if you edit loginLogoutMessages_<language>.properties with the procedure that is described in this section.
    The figure is the default login page with the following elements, framed in red and shown from top to bottom: the Login, User Name, and Password labels, the Login button, and the copyright statement.
    Note: In the Login page for Service Center there is also a Forgot Password? label that you can change.
    The next figures show the elements that you can change in the logout pages if you edit loginLogoutMessages_<language>.properties with the procedure that is described in this section.
    • The Logged Out page from the virtual appliance and the Administration Console
      The figure is the default login page with the following elements, framed in red and shown from top to bottom: the Logged Out label, the logout message, and the copyright statement.
    • The Logged Out page from the Service Center
    Note: This page includes also a Login to Administration Console label that is not shown in the figure.

Procedure

  1. From the top-level menu of the Appliance Dashboard, select Configure > Manage Server Setting > Custom File Management.
  2. In the Custom File Management page, select the CustomLoginScreen folder to list the loginPageCustomization.properties file in the right frame.
    1. Select loginPageCustomization.properties and select Download.
    2. Open the file and edit the properties that you want to change. Comments describe the properties and provide updating instructions.
    3. After you saved the file, click Upload in the Custom File Management page. If you changed the product logo and the background image, upload also the respective image files in the same directory.
  3. Unfold the CustomLoginScreen directory in the left frame to list the resource-bundles subfolder. Click this subfolder to list its contents in the right frame. A loginLogoutMessages_<language>.properties file for every supported language is listed. You might have to increase the number of items displayed in the page to list all the files.
    1. Select a loginLogoutMessages_<language>.properties file and select Download.
    2. Open the file and edit the properties that you want to change. Comments describe the properties and provide updating instructions.
    3. After you saved the file, click Upload in the Custom File Management page. You can change more loginLogoutMessages_<language>.properties files to allow for multilingual login and logout pages. The product title and the product version can be in English only.

What to do next

Logout and login again to view the changes that you made. If you edited more loginLogoutMessages_<language>.properties files, change the language of your browser accordingly to see the changes.

If your custom background image or product logo does not display, clear the browser cache.

To revert back to the default pages, go to Custom File Management > Modified Files, select loginPageCustomization.properties or any other files that you edited, and click Restore Default.

Parent topic: Managing internal OpenID Connect authentication