Managing user roles - PingOne Cloud Platform - PingOne

PingOne Cloud Platform

bundle
pingone
ft:publication_title
PingOne Cloud Platform
Product_Version_ce
PingOne Cloud Platform
PingOne
category
Administratorguide
ContentType
Guide
Product
Productdocumentation
p1
p1cloudplatform
ContentType_ce
Guide > Administrator Guide
Guide
Product documentation

A role is a collection of permissions that you can assign to a user or group. Add, remove, or limit the scope of roles for PingOne users on the Users page.

You can manage two kinds of roles:

  • Administrative roles grant access to specific PingOne capabilities. Learn more about the capabilities of each administrative role in Roles.
  • Application roles grant access to features and API resources in applications developed by your organization. Learn more in Application roles.

Assigning administrative roles

Assign administrative roles on the Users page in the directory.

  1. Go to Directory > Users and browse or search for the user that you want to edit.
  2. Click the user entry to open the user details panel.
  3. Click the Roles > Administrative Roles tab.

    If roles are assigned, they are listed here with information about where those roles apply. For example, in the following image, BX User has the Environment Admin role, and they have that role for four environments.

    Note:

    You can assign administrative roles to users, groups, worker applications, or PingFederate gateway integrations.

    A screen capture of the user details for BX User. Roles tab is selected, and shows the assignment of the Environment Admin role in four environments.
    Tip:

    Click the Info icon to view the permissions associated with the role. Click the down arrow on the right to view the list of environments or populations for which the role is assigned.

    Screen capture of the Environment Admin role expanded to display the four environments in which the user has the role.
  4. Click Grant Roles.

    The Available Responsibilities tab lists the roles that you are allowed to assign and the environments for which you are allowed to assign them. A responsibility is the combination of the role assignment and the level, or scope, at which the role is applied. Depending on the role, it could be assigned at the organization, environment, or population level.

    The Granted Responsibilities tab lists the roles, if any, that are currently assigned.

  5. On the Available Responsibilities tab, click the role that you want to assign or change and perform any combination of the following:
    1. To assign the role, select the checkboxes next to the applicable environments.
      Tip:

      Click Select All or Remove All to select or clear all available responsibilities.

    2. To remove a role assignment, clear the checkboxes next to the applicable environments.
    3. To grant this access for only a portion the environment, click the Reduce Access icon (image of reduce access icon), select a subset of the available populations on the Limit Access page, and click Confirm.
      A screen capture of the Limit Access page showing one population selected out of three populations
    Note:

    You can grant only roles that are assigned to you or that confer the permissions needed to assign that role to others. For example, if you do not have the Environment Admin role, you cannot assign the Environment Admin role to others (and that role will not be listed under Available Responsibilities). However, if you have the Identity Data Admin role, you can assign either the Identity Data Admin role or the Identity Data Read Only role to others.

    Learn more about the permissions associated with each role in Roles.

  6. Click Save.

The role assignments that you selected are listed on the Granted Responsibilities tab.

Assigning application roles

Assign application roles on the Users page in the directory.

Follow these steps to assign application roles to users after you create application roles.

Note:

The user assigning application roles must have the Identity Data Admin administrative role.

  1. Go to Directory > Users and browse or search for the user to whom you want to assign a role.
  2. Click the user entry to open the user details panel.
  3. Click the Roles > Application Roles tab.

    If the user has assigned roles, they're listed here. For example, the image shows that Theresa Miller already has the Invoicing Processor role.

    Note:

    You can assign application roles at the environment level.

    Screen capture of the Application roles tab showing the Invoicing Processor role assigned to Theresa Miller.
  4. Do one of the following.
    • If the user has assigned roles, click the Pencil icon.
    • If the user doesn’t have assigned roles, click Grant Application Roles.

    The Application Roles tab lists the roles that you can assign. The Selected Application Roles tab lists the roles, if any, that are currently assigned to the user.

    Screen capture of Edit Application Roles showing checkboxes for the Invoicing Processor and Billing Supervisor roles.
  5. On the Application Roles tab, select or clear the relevant checkboxes to assign or unassign roles.

    For example, you might assign Theresa the Billing Supervisor role while Melissa, the billing supervisor, is on vacation.

  6. Click Save.