11.3 Customizing the User Interface

Identity Governance and OSP automatically display content in the user interface according to your browser language. You can customize content such as attribute names and informational messages using a text editor.

You might customize the content if your organization requires special terminology for some or all attributes. For example, you might refer to user ID as account name. You can change all instances of user ID in the catalog.

For more information about translating the content to a new language instead of customizing it, see Section 11.4.1, Preparing Files for Translation.

11.3.1 Customizing the Labels in the Identity Governance Interface

Some organizations might want to customize the default names for the attributes, risk levels, and navigation items in Identity Governance. The .properties file for customizing this content is available from the Identity Governance interface, rather than a .jar file.

To customize the labels:

  1. Log in to Identity Governance as a Global Administrator.

  2. Select Configuration > Localization Import and Export.

    Identity Governance lists the .properties files by language.

  3. For the language that you want to customize, select Download.

    Depending on your browser settings, you might be prompted for the download path.

    NOTE:If prompted, do not rename the .properties file. Identity Governance cannot upload a file that does not match the expected name.

  4. In a text editor, customize the displayed text for the attributes that you want to change.

    For example, you want to change all instances of user ID to account name. When you search for user ID, you will find the following type of string:

    com.netiq.iac.persistence.ops.AttributeDefinition.USER.userID=User ID from source

    Change User ID from Source to Account Name from Source.

    WARNING:Do not modify any text in the code string before the = sign. For example, com.netiq.iac.persistence.ops.AttributeDefinition.USER.userID=. Identity Governance might not function appropriately if you change the code string incorrectly.

  5. Save and close the file.

  6. To submit the modified file, select Upload for the language that you customized.

  7. Refresh the browser window to view the changes.

    NOTE:Depending on the browser settings, you could need to sign out of Identity Governance, clear the cache in the browser, and then log in again.

11.3.2 Customizing Strings in the Properties Files

By editing the various .properties files in the Identity Governance and OSP .jar files, you can customize the content displayed in the Identity Governance Configuration utility, as well as most of the Identity Governance and OSP interface.

Customizing Strings for the Configuration Utility

If you want to use different terminology in the Identity Governance Configuration utility, you can do so by editing .properties files.

To customize strings for the Configuration utility:

  1. Log in to the server where you installed Identity Governance.

  2. Navigate to the /opt/netiq/idm/apps/idgov/localization directory.

  3. Copy the iac-configutil-strings.jar to a temporary directory.

    For example: opt/netiq/idm/apps/work

  4. Extract the iac-configutil-strings.jar, making sure to maintain folder structure.

    For example: /opt/netiq/idm/apps/work/com/netiq/iac/config/util/

  5. Navigate to the com/netiq/iac/config/util directory.

  6. Perform the following steps to create a new .properties file:

    1. Rename the existing IacConfigUIstringsRsrc_en.properties file to org-IacConfigUIstringsRsrc_en.properties.

    2. Create a new, empty IacConfigUIstringsRsrc_en.properties file.

  7. Perform the following steps to modify specific strings:

    1. Use a text editor to open the org-IacConfigUIstringsRsrc_en.properties file.

    2. Find the properties that you want to modify.

      For example, the labels Bootstrap Admin and Bootstrap File Details, which appear on the Authentication Server Details tab in the Configuration utility:

      FILE_DETAILS_TITLE=Bootstrap File Details

      BOOTSTRAP_ADMIN_TITLE=Bootstrap Admin

    3. Copy the properties into the empty IacConfigUIstringsRsrc_en.properties file.

    4. Modify the string values, which appear after the equal sign.

      For example:

      FILE_DETAILS_TITLE=Default Admin File Details

      BOOTSTRAP_ADMIN_TITLE=Default Admin

    5. Save and close the file.

  8. (Optional) Repeat Step 6 through Step 7 for each language you want to modify.

  9. Navigate to the folder from which you extracted the iac-configutil-strings.jar file.

    For example: /opt/netiq/idm/apps/work

  10. Create a custom .jar file that contains only the .properties files you modified.

    For example: jar -cMf my-configutil-strings.jar com/netiq/iac/config/util/IacConfigUIstringsRsrc_en.properties

  11. Copy the custom .jar file to the /opt/netiq/idm/apps/idgov/lib directory.

    NOTE:Be sure to set the correct permissions and ownership of the .jar file.

  12. Navigate to the /opt/netiq/idm/apps/idgov/bin directory, and perform the following steps:

    1. Use a text editor to open the configutil.sh file.

    2. Scroll to the bottom of the file, then add the custom .jar file you created in Step 10 to the -cp section.

      For example: -cp "${app_home}/lib/ig-configutil.jar":"${app_home}/lib/${_db_jdbc_jar}":"${app_home}/lib/my-configutil-strings.jar"

    3. Save and close the file.

  13. Launch the Configuration utility in GUI mode to view the changes.

Customizing Strings for Identity Governance

If you want to use different terminology in Identity Governance and Access Request, you can do so by editing .properties files.

To customize strings for Identity Governance and Access Request:

  1. Log in to the server where you installed Identity Governance.

  2. Navigate to the /opt/netiq/idm/apps/idgov/localization directory.

  3. Copy the client-strings.jar file and the cx-client-strings.jar file to a temporary directory.

    For example: /opt/netiq/idm/apps/work

  4. Extract the client-strings.jar file and the cx-client-strings.jar file, making sure to maintain folder structure.

    For example:

    /opt/netiq/idm/apps/work/com/netiq/iac/client and

    /opt/netiq/idm/apps/work/com/netiq/cx/client/

  5. Navigate to the /com/netiq/iac/client directory.

  6. Perform the following steps to create a new .properties file for Identity Governance:

    1. Rename the ArRsrc_en.properties file to org-ArRsrc_en.properties.

    2. Create a new, empty file named ArRsrc_en.properties.

  7. Perform the following steps to modify specific strings:

    1. Use a text editor to open the org-ArRsrc_en.properties file.

    2. Find the properties that you want to modify.

      For example, the Legend and About labels that appear when you click your user name in the title bar:

      legend=Legend

      about=About

    3. Copy the properties you want to modify into the empty ArRsrc_en.properties file.

    4. Modify the string values, which appear after the equal sign.

      For example:

      legend=Key

      about=Info

    5. Save and close the file.

  8. (Optional) Repeat Step 6 through Step 7 for each language you want to modify.

  9. Navigate to the /com/netiq/cx/client directory.

  10. Perform the following steps to create a new .properties file for Access Request:

    1. Rename the CxRsrc_en.properties file to org-CxRsrc_en.properties.

    2. Create a new, empty CxRsrc_en.properties file.

  11. Perform the following steps to modify specific strings:

    1. Use a text editor to open the org-CxRsrc_en.properties file.

    2. Find the properties that you want to modify.

      For example, the Legend and About labels that appear when you click your user name in the title bar:

      legend=Legend

      about=About

    3. Copy the properties into the empty CxRsrc_en.properties file.

    4. Modify the string values, which appear after the equal sign.

      For example:

      legend=Key

      about=Info

    5. Save and close the file.

  12. (Optional) Repeat Step 10 through Step 11 for each language for which you want to modify strings.

  13. Navigate to the folder from which you extracted the .jar files.

    For example: /opt/netiq/idm/apps/work

  14. Create a custom .jar file that contains only the .properties files you modified.

    For example: jar -cMf my-ui-strings.jar com/netiq/iac/client/ArRsrc_en.properties com/netiq/cx/client/CxRsrc_en.properties

  15. Copy the custom .jar file to the tomcat/lib directory.

    For example: /opt/netiq/idm/apps/tomcat/lib

    NOTE:Be sure to set the correct permissions and ownership of the .jar file.

  16. Stop Apache Tomcat. For more information, see Section 3.5.3, Starting and Stopping Apache Tomcat.

  17. Delete all files and folders in the following temporary directories:

    /opt/netiq/idm/apps/tomcat/temp

    /opt/netiq/idm/apps/tomcat/work/Catalina/localhost

  18. Delete all log files from the logs directory for Apache Tomcat.

    /opt/netiq/idm/apps/tomcat/logs

  19. Start Apache Tomcat. For more information, see Section 3.5.3, Starting and Stopping Apache Tomcat.

If you want to verify your changes, clear your browser cache, then log in to Identity Governance and view the pages that should contain your changes.

For example, to verify changes for the examples used in the procedure:

  1. Log in to Identity Governance as a user who can access both Identity Governance and Access Request.

  2. Within Governance Administration, select your name in the Navigation to view the changes.

  3. Within Access Request, select your name in the Navigation to view the changes.