Manage roles

Roles define the access that an administrator, a specialist, or an end-user has to resources in your organization. In a role-based access control environment, user access provisioning is group through common responsibilities and needs. A role has a given set of permissions and members of your organization can be assigned to one or more roles, depending on the scope of view or write access they need.

Create a new role create-new-role

To create a new role, select the Roles tab in the sidebar and select Create Role.

flac-new-role

The Create a new role dialog appears, prompting you to enter a name, and an optional description.

When finished, select Confirm.

flac-create-new-role

Next, select the resource permissions that you would like to include in the role using the dropdown menu.

flac-add-role-permission

To add additional resources, select Adobe Experience Platform from the left navigation panel, which displays a list of resources. Alternatively, enter the resource name into the search bar in the left navigation panel.

flac-add-additional-resources

Click and drag the relevant resource and drop into the main panel.

flac-additional-resources-added

Select the resource permissions that you would like to include in the role using the dropdown menu. Repeat this for all resources you would like to include for the role. When finished, select Save and exit.

flac-save-resources

The new role is successfully created, and you are redirected to the Roles page, where you will see the newly created role appear in the list.

flac-role-saved

See the sections on managing permissions for a role for more details on how to manage role permissions once they are created.

The following video is intended to support your understanding of creating a new role and managing users for that role.

Transcript

In this video, we’ll cover how to add a user to Adobe Experience platform-based applications, like Realtime Customer Data Platform and Journey Optimizer, and how to configure permissions for features and sandboxes for that user. While this process largely takes place within the platform interface, there are some prerequisite steps that need to be done in Adobe Admin Console first. So we’ll start there. To accomplish our required tasks in Admin Console, we need to be System Admin or a Product Level Admin for Experience Platform. To start, I’ll select Products at the top of the screen, and we can see the Adobe products that we have access to. Next, I’ll select the product page for Experience Platform. We first land on the Product Profiles tab, showing the available product profiles for Platform, including their number of entitled users and admins. You will likely only have one product profile called AEP Default All Users. As the name suggests, this is the default product profile for Experience Platform. For any user to get access to any set of platform features, regardless of their role, that user must be added to this default product profile first. So, I’ll click into the product profile, and I’ll navigate to the Users tab, and then I’ll select Add User. In the dialog that appears, I’ll add the email addresses of the users that I want to grant platform permissions to. If the email is associated with an Adobe ID or a Federated ID, further details about the user are auto-populated. If the email is not associated with an Adobe account, we’re given the option to manually enter their details instead. I’ll select Save, and now these users are added to the product profile. However, doing this alone did not grant the new users permissions to any specific features within Platform. To do that, we’ll go to the next step and hop into the Experience Platform UI.

Under the Administration section in the left nav, select Permissions. The Permissions page offers several tools to help us control granular access to data and features in Platform. Since we’ve added new users to Platform’s default product profile in Admin Console, those users will now be available in this tab for permission assignment. Specifically, we want to add these new users to a role, so I’ll select Roles in the left panel here. And here we have a list of roles for our organization. In Platform, a role is a specific set of permissions for features and sandboxes that can be granted to a user. You can capture many variations of permission sets by creating multiple roles in the system, and each user can be assigned to one or more of these roles. If I click into one of these roles, I can see more details about it, including a basic description and the full set of permissions and sandboxes it grants access to. If I click Users, I can see which users in my organization have been assigned to this role and manage them if I wish. Now, we could simply add the users we set up in Admin Console earlier to this existing role, but let’s say we wanted to create an entirely new set of permissions for these users. To do that, I’ll head back to the Roles tab, and then I’ll select Create Role. I’ll give this new role a name, and optionally a description as well. And after confirming, I’m brought to the Permission Configuration view for the role. In the main part of the screen, we have our canvas, where we can drag and drop the permissions we want this role to grant. You can see that one category has already been added by default, which is Sandboxes. Each role needs to grant access to one or more sandboxes, so this category cannot be removed or left blank. Right now, this is granting access to the Production sandbox, but I can choose whichever combination of sandboxes I like. I can use the drop-down menu to add sandboxes to the category, and remove any previously added sandboxes with a single click. Now that I’m happy with my sandboxes, I can start adding feature permissions to this role. On the left side of the screen, I have a list of permission categories to choose from. Each category is based on a specific service and experience platform, such as data modeling and ingestion, or a feature in a platform-based application, such as Journeys in Adobe Journey Optimizer. A single category can contain multiple individual permissions. To add a permission category to the role, I can drag and drop it onto the canvas, or I can click the plus icon for the category in question. I’ll start by adding data modeling, and I’m prompted to select at least one permission for the category using the drop-down menu. I can choose to add individual permissions to the role, or I can simply add them all if I wish. As I continue to add new permission categories to my role, I can also remove categories by selecting the X icon on the respective container in the canvas, which also removes any permissions that may have been added under that category. I’ll continue going through the categories to add the permissions I need, and once I’ve finished, I’ll select save. Once it’s saved, I’ll select properties to navigate back to the details page for the role, and I can see that the resource and sandbox permissions I selected earlier have been added. Now, all I have left to do is to add some users to this role to grant them access to the permissions I’ve just configured. I’ll select the Users tab, then select Add Users. In the dialog that appears, I’ll select the users that I want to add to this role from the list. I can also use the search bar to narrow down the list of names if I need to. Remember that in order for a user in your organization to be available in this list, you need to add them to the default product profile in Admin Console first, as we showed earlier. Once I’ve added all the users I want, I’ll select save, and now these users are granted access to the permissions I’ve configured for this role. So, that’s the process of granting access to Experience Platform capabilities and sandboxes, which includes adding users to the default product profile for Experience Platform in Admin Console, and configuring permissions for a role in the platform UI. For the latest information on the available permissions in Experience Platform, please refer to the documentation. Thanks for watching.

Duplicate a role

To duplicate an existing role, select the role from the Roles tab. Alternatively, use the filter option to filter the results to find the role you want to duplicate.

flac-duplicate-role

Next, select Duplicate from the top right of the screen.

flac-duplicate

The Duplicate role dialog appears, prompting you to confirm the duplication.

flac-duplicate-confirm

Next, you will be taken to the role’s detail page where you can change the name and permissions for the role. The Details, Labels, and Sandboxes are duplicated from the previous role. Users will need to be added via the users tab. You can view the manage permissions for a role document to learn more about adding Details, Labels, Sandboxes, and Users to a role.

Click on the left arrow to return to the Roles tab.

flac-return-to-roles

The new role will appear in the list on the Roles page.

flac-role-duplicate-saved

Delete a role

Select the ellipsis () next to a role’s name, and a dropdown displays controls to edit, delete, or duplicate the role. Select delete from the dropdown.

flac-role-delete

The Delete user role dialog appears, prompting you to confirm the deletion.

flac-confirm-role-delete

You will be returned to the Roles tab.

Next steps

With a new role created, you can proceed to the next step to manage permissions for a role.

recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0