Customizing badges on access cards in the Request Access wizard

Edit online

The second step in the Request Access wizard is used to select the accesses being requested for a user. The set of access items to choose from is displayed as a collection of access cards that are arranged in a grid. Access cards can be annotated with highlighted text called badges. Badges are used to alert the user to special considerations that are associated with the access, such as risk, data sensitivity, or regulatory compliance requirements. You can customize the text that is displayed for badges on access cards, and the style of the badges.

Before you begin

Depending on your system customization, you might not have access to this task. Contact your system administrator to obtain access to this task, or to have someone complete it for you.

About this task

A site administrator or a service owner uses the Identity Manager Console to create badges and associate those badges with access items.

The badge text is defined as either a fixed string such as High Risk or the name of a property in the CustomLabels.properties file such as $highrisk. If a fixed string was defined as the badge text, then it cannot be customized. But if a property name was defined, you can customize the text that is displayed on the badge by modifying the value of the property.

The badge class is selected from one of the Cascading Style Sheets (CSS) style classes that are defined in the Badge.css file.

Procedure

  1. Optional: Customize the text that is displayed for a badge on an access card. Consult your site administrator or service owner to determine the property name that is defined as the text for the badge that you want to customize.
    For this example, assume that the badge text was specified as $highrisk. So the property name is highrisk.

    Open the CustomLabels.properties file in the IM_HOME/data directory, where IM_HOME is the IBM Verify Identity Governance installation directory.

    Open the CustomLabels.properties file.

    Locate the property name that is associated with the badge you want to customize, such as highrisk. If the property does not exist in the CustomLabels.properties file, then create a new property for the property name.

    Change the value of the property to the text that you want to display for the badge.

  2. Optional: Customize the style for a badge on an access card.
    Changing the style for badges is an advanced topic that requires a working knowledge of Hypertext Markup Language (HTML) and Cascading Style Sheets (CSS). IBM Verify Identity Governance contains several predefined CSS classes for badges. These classes might be suitable for your organization, but you can change these predefined classes or add new classes to meet your needs.
    To change the badge style for an existing CSS class, open the Badge.css file in the IM_HOME/data directory, where IM_HOME is the IBM Verify Identity Governance installation directory. Locate the CSS class definition for the badge that you want to change. Modify the style attributes that are associated with the CSS class to suit your needs. For example, to change the style of a badge that is associated with the green badge class, you can do the following actions:
    • Find the .badge.green CSS selector in the Badge.css file.
    • Modify the style attributes that are associated with it.

    To create a new badge class that can be assigned to access entities, open the Badge.css file. Create a CSS selector or copy an existing CSS selector for the new badge class. CSS selectors for badges must always be in the form, .badge.customName, where customName is the name of the new badge class. The Identity Manager Console displays this customName in the drop-down list of badge classes when the site administrator or service owner assigns badges to access entities. Modify the style attributes associated with the new CSS class to suit your needs.

    If you want to define more complex styles for badges, you can also create custom CSS selectors that include dynamic pseudo-classes. For example, .badge.customName:after.

Results

The badges that are displayed on access cards are changed to reflect the customization that you made in the CustomLabels.properties and Badge.css files.

What to do next

Select one or more accesses for a user that is based on your request access requirements.