17.9 Promoting Detected Roles to Assigned Roles

Identity Governance detects users that hold all the permissions of a role, but it might not have assigned the role to the user. Primarily, fulfillers would assign technical roles to users based on access requests or business role authorizations. However, promoting detected roles to assigned roles gives administrators the ability to onboard any initial assignments.

After you assign the users to the role, Identity Governance creates a report you can download that contains information about the technical role assignment. The report lists the following for each user:

  • The name of the technical role assigned to the user

  • The role unique identifier

  • The user’s unique ID

  • The time the role was assigned

  • Any notes or issues associated with the user assignment, such as:

    • The user attributes did not uniquely identify a single user

    • The user was already assigned to the role

    • The role identified in a CSV file used for role assignment is not active

    • The role identified in a CSV file used for role assignment cannot be found or is deleted

Administrators can use the following methods to assign technical roles to detected users:

17.9.1 Assigning a Technical Role to Specific Detected Users of a Role

When you create a technical role, Identity Governance automatically detects users that have all permissions specified in the role. You can choose to assign the technical role to only some detected users.

To assign a technical role to specific detected users of a role:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Roles.

  3. Add # Users with all Permissions to the displayed columns.

  4. Click the number of detected users for a role.

  5. Select the users to assign.

  6. Click Assign role to users.

  7. Provide an Assignment comment.

  8. Click Assign.

NOTE:You can also perform this technical role assignment when you edit a technical role. You can click the Users with all Permissions tab, then perform Step 5 through Step 8 in the procedure.

17.9.2 Assigning Technical Roles to Detected Users with All Permissions of a Role

When you create a technical role, Identity Governance automatically detects users that have all permissions specified in the role. Administrators can assign a technical role to users with all permissions to the role. Identity Governance also allows administrators to perform that function for multiple technical roles.

To assign technical roles to users with all permissions of a role:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Roles.

  3. Select one or more roles from the list, then select Actions > Assign role to users.

  4. Enter an Assignment comment.

  5. From Assignment strategy, select Users with All Permissions.

  6. (Optional) Click Preview to download a report that contains information about the technical role assignment.

    NOTE:The Assignment Time column of the report will be empty, because the report is the result of a preview, not a role assignment.

  7. Click Assign.

17.9.3 Assigning Technical Roles Using a Search Query

When you create a technical role, Identity Governance automatically detects users that have all permissions specified in the role. Administrators can create a search query to specify users to assign the technical role, including those who do not have all permissions for the role. For information about using the Expression Builder to create a search query, see Section 5.0, Using Advanced Filters for Searches. Identity Governance also allows administrators to use a search query to assign multiple technical roles to users that match the search query.

To assign technical roles to users matching a search query:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Roles.

  3. Select one or more roles from the list, then select Actions > Assign role to users.

  4. Enter an Assignment comment.

  5. From Assignment strategy, select Users matching query.

  6. Click the filter icon and create a search query.

  7. (Optional) Click Preview to download a report that contains information about the technical role assignment.

    NOTE:The “Assignment Time” column of the report will be empty, because the report is the result of a preview, not a role assignment.

  8. Click Assign.

17.9.4 Assigning Technical Roles Using a CSV File

When you create a technical role, Identity Governance automatically detects users that have all permissions specified in the role. Administrators can create a CSV file that lists specific users to assign the technical role, including those who do not have all permissions for the role. Identity Governance also provides administrators with two methods for using a CSV file to assign multiple technical roles to users listed in the file:

  • By selecting one or more roles from the list

  • By including the technical role names in the CSV file

Creating a CSV File

You can use the Identity Governance user interface to create a CSV file you must then modify for use to assign technical roles.

To create a CSV file:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Identities.

  3. Use the advanced filter to create a list of users you want to assign the technical roles. For information about using the Expression Builder to create a search query, see Section 5.0, Using Advanced Filters for Searches.

  4. Click Download all as CSV.

Modifying a Generated CSV File

The heading names that appear in the CSV file you generated are the display names for the attributes, but technical role onboarding requires heading names to be attribute keys. Before you can assign technical roles from the CSV file, you must open the CSV file and change each heading name from the display name to the appropriate attribute key. To see a list of attributes and their attribute keys, click Data Administration > Identity Attributes.

In addition, if you plan to assign technical roles to users by including the technical role name in the CSV file, you must create a column in the file for the technical role names.

To include technical role names to the CSV file:

  1. Open the CSV file you generated.

  2. Create a technical roles column with the heading name technicalRole.

  3. Specify the technical role names you want to assign to a user into the associated technical role column cell.

  4. (Conditional) If you are assigning multiple technical roles to a user, separate the technical role names by commas.

Assigning Selected Technical Roles to User Names Listed in a CSV File

One of two methods for assigning technical roles from a CSV file allows you to select roles in Identity Governance, then use a CSV file to assign those roles to users listed in the CSV file.

To assign technical roles to users from a CSV file by selecting roles from the list:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Roles.

  3. Select one or more roles from the list, then select Actions > Assign role to users.

  4. Enter an Assignment comment.

  5. From Assignment strategy, select Users from CSV.

  6. Click Browse to find the CSV file that contains the users you want to assign the technical roles.

  7. (Optional) Click Preview to download a report that contains information about the technical role assignment.

    NOTE:The “Assignment Time” column of the report will be empty, because the report is the result of a preview, not a role assignment.

  8. Click Assign.

NOTE:If a user listed in the CSV file already has the role assigned to them, the role is not reassigned. However, the report Identity Governance generates after role assignment will indicate that the role was already assigned to the user, and the assignment time will indicate the time the role was first assigned to the user.

Assigning Technical Roles from a CSV that Includes Technical Role Names

One of two methods for assigning technical roles from a CSV file allows you to assign technical roles to users by including the technical role name in the CSV file. Before you use this method, be sure you modified the CSV file as described in Modifying a Generated CSV File.

To assign technical roles to users from a CSV file that includes the technical role name:

  1. Log in as a Customer, Global, or Technical Roles Administrator.

  2. Under Catalog, select Roles.

  3. Click Actions > Assign roles to users.

  4. Enter an Assignment comment.

  5. Click Browse to find the CSV file that contains the users you want to assign the technical roles.

  6. (Optional) Click Preview to download a report that contains information about the technical role assignment.

    NOTE:The “Assignment Time” column of the report will be empty, because the report is the result of a preview, not a role assignment.

  7. Click Assign.

NOTE:If a user listed in the CSV file already has the role assigned to them, the role is not reassigned. However, the report Identity Governance generates after role assignment will indicate that the role was already assigned to the user, and the assignment time will indicate the time the role was first assigned to the user.