10.3 Customizing the User Interface

Identity Governance and OSP automatically display content in the user interface according to your preferred 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 10.4, Translating Content for Identity Governance and One SSO Provider.

10.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 Administration > 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 might need to sign out of Identity Governance, clear the cache in the browser, and then log in again.

10.3.2 Customizing Strings in the JAR 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. For example, you might want to use different terminology in the Identity Governance Configuration utility.

The .jar files are located:

  • Linux: Default directories:

    • Identity Governance: /opt/netiq/idm/apps/idgov/localization

    • OSP: /opt/netiq/idm/apps/osp/osp-extras/l10n-resources

    • Identity Reporting: /opt/netiq/idm/apps/idrpt/l10n-resources

  • Windows: Default directories:

    • Identity Governance: c:\netiq\idm\apps\idgov\localization

    • OSP: c:\netiq\idm\apps\osp\osp-extras\l10n-resources

    • Identity Reporting: c:\netiq\idm\apps\idrpt\l10n-resources

To customize strings for Identity Governance or OSP:

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

  2. To modify the .properties files, complete the following steps:

    1. Locate the .jar file that you want to update.

      For example, the iac-configutil-strings.jar file contains all displayed text for the Identity Governance Configuration utility.

    2. Copy the .jar files that you want to update to a temporary directory.

    3. In the temporary directory, extract the .jar that you want to edit.

      WARNING:Do not change the file names or directory structure of the .jar files.

    4. Browse the file directory to the .properties file that you want to edit.

      For example, iac-ConfigUIstringsRsrc_fr.properties.

    5. In a text editor, customize the displayed text for the content that you want to change.

      WARNING:Do not modify any text in the code string before the = sign. For example, ADMIN_PASSWORD=. Identity Governance might not function appropriately if you change the code string incorrectly.

    6. Save and close the editor.

  3. Copy the customized .properties files to their appropriate locations in the original .jar files in the temporary directory.

    For example, replace the iac-ConfigUIstringsRsrc_fr.properties file with the modified version of the file in the following location:

    • Linux: Default location of /opt/netiq/idm/apps/tomcat/lib

    • Windows: Default location of c:\netiq\idm\apps\tomcat\lib

  4. Copy the .jar file(s) with the customized content to the lib directory.

    • Linux: Default location of /opt/netiq/idm/apps/tomcat/lib

    • Windows: Default location of c:\netiq\idm\apps\tomcat\lib

  5. Stop Apache Tomcat. For more information, see Section 3.4.3, Starting and Stopping Apache Tomcat.

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

    • Linux:

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

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

    • Windows:

      • c:\netiq\idm\apps\tomcat\temp

      • c:\netiq\idm\apps\tomcat\work\Catalina\localhost

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

    • Linux: Default location of /opt/netiq/idm/apps/tomcat/logs

    • Windows: Default location of c:\netiq\idm\apps\tomcat\logs

  8. Start Apache Tomcat. For more information, see Section 3.4.3, Starting and Stopping Apache Tomcat.

  9. Before logging in to Identity Governance, clear the browser cache to ensure that the browser displays your changes.