User role management
Overview
This guide provides detailed instructions for user role management, covering both targeted and comprehensive actions.
Targeted actions include:
Comprehensive actions include:
Benefits
User role management provides precise and consistent permission assignment, reducing the risk of accidental or unauthorized DNS changes. With DigiCert® DNS, organizations can streamline operations, support scalable access control, and delegate tasks efficiently. Centralized management simplifies compliance, auditing, and policy enforcement, creating a more secure, manageable, and reliable DNS environment.
Procedures
Let op
This procedure clears two user roles (userrole1 and userrole2) created in an earlier procedure.
To test this function, call this API endpoint: POST /accessmanagement/userroles/bulk/delete
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
In the ROLES tab, select the checkboxes of the user roles you want to clear (for example, userrole1 and userrole2).
Select Delete at the top of the table.
In the Confirm Deletion dialog, select Confirm.
A message appears confirming the successful clearance of the user roles.
Let op
This procedure creates two user roles: userrole1 and userrole2. These user roles are referenced in other procedures. Note that only administrators can create user roles.
To test this function, call this API endpoint: POST /accessmanagement/userroles
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Select the Add Custom Role button.
In the Add Custom Role dialog:
Enter a name in the Role Name field (for example, userrole1).
(Optional) Enter a description in the Role Description field.
In the Role Permissions section, select the permissions you want to assign to the new role.
Select Save to finish.
A message appears confirming the successful creation of the user role.
Repeat Steps 4-5 to create another user role, userrole2.
Let op
This procedure displays all user roles currently configured in the system. Note that only administrators have access to this information.
To test this function, call this API endpoint: GET /accessmanagement/userroles
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Tip
Use Columns and Filters to customize your view of the results.
Let op
This procedure displays the details of a specific user role (userrole1) created in an earlier procedure. Note that only administrators have access to this information. Follow Path 1 if there are only a few results to review. Follow Path 2 if you prefer to filter results quickly.
To test this function, call this API endpoint: GET /accessmanagement/userroles/{userRoleId}
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Select the name of the user role (for example, userrole1) whose details you want to view.
Alternatively, select the overflow menu (three vertical dots) at the end of the user role's row, and select View Role.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Select Filters at the top of the results table to locate the specific user role quickly.
Tip
In this example, the name of the user role is known, so the following filter was applied:
Under Column, select Name.
Under Operator, select contains.
Under Value, enter the user role's name (userrole1).
If no results appear, double-check the Filters selections and input values.
Select the name of the role (for example, userrole1) whose details you want to view.
Alternatively, select the overflow menu (three vertical dots) at the end of the user role's row, and select View Role.
Let op
This procedure updates a specific user role (userrole1) created in an earlier procedure.
To test this function, call this API endpoint: PUT /accessmanagement/userroles/{userRoleId}
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Locate the specific user role - see Path 2 for quick filtering.
Select the name of the user role (for example, userrole1) whose details you want to update.
Alternatively, select the overflow menu (three vertical dots) at the end of the user role's row, and select Edit Role.
In the Edit Custom Role dialog:
Edit the user role's details as required.
Select Save to finish.
A message appears confirming the successful update of the user role.
Let op
This procedure updates the permissions of a specific user role (userrole1) created in an earlier procedure.
To test this function, call this API endpoint: PUT /accessmanagement/userroles/{userRoleId}/permissions
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the ROLES tab.
The table displays all the user roles currently registered in the system.
Locate the specific user role - see Path 2 for quick filtering.
Select the name of the user role (for example, userrole1) whose permissions you want to update.
Alternatively, select the overflow menu (three vertical dots) at the end of the user role's row, and select Edit Role.
In the Edit Custom Role dialog:
Edit the user role's permissions as required.
Select Save to finish.
A message appears confirming the successful update of the user role's permissions.