User group management
Overview
This guide provides detailed instructions for user group management, covering both targeted and comprehensive actions.
Targeted actions include:
Comprehensive actions include:
Benefits
User group management ensures consistent access control across teams, reduces errors by assigning permissions in bulk, and minimizes the risk of unauthorized changes. With DigiCert® DNS, users gain flexibility in managing permissions while improving efficiency and scalability. Built-in traceability features ensure accountability for all actions, while centralized management simplifies oversight by defining who can access or modify DNS records, making large-scale user administration more controlled and secure.
Procedures
Aviso
This procedure adds two users (Jane Doe and John Doe) to a specific user group (usergroup1) created in an earlier procedure.
To test this function, call this API endpoint: POST /accessmanagement/usergroups/{userGroupId}/members/bulk/add
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently registered in the system.
Select the name of the user group (for example, usergroup1) to which you want to add users - see Path 2 for quick filtering.
In the Members section, select the Add Members button.
In the Add Members dialog:
Select the checkboxes next to the users you want to add (for example, Jane Doe and John Doe).
Select Save to finish.
A message appears confirming the successful addition of the users.
Aviso
This procedure clears two user groups (usergroup1 and usergroup2) created in an earlier procedure.
To test this function, call this API endpoint: POST /accessmanagement/usergroups/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 USER GROUPS tab, select the checkboxes of the user groups you want to clear (for example, usergroup1 and usergroup2).
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 groups.
Aviso
This procedure creates two user groups: usergroup1 and usergroup2. These user groups are referenced in other procedures.
To test this function, call this API endpoint: POST /accessmanagement/usergroups
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently registered in the system.
Select the Add User Group button.
In the Add User Group dialog:
Enter a name in the User Group Name field (for example, usergroup1).
(Optional) Enter a description in the Description field.
Select Save to finish.
A message appears confirming the successful creation of the user group.
Repeat Steps 4-5 to create another user group, usergroup2.
Aviso
This procedure deletes a user group (usergroup1) created in an earlier procedure. You can follow either Path 1 or Path 2 to complete the deletion. Note that user groups can only be deleted if they are empty. The Default user group cannot be deleted.
To test this function, call this API endpoint: DELETE /accessmanagement/usergroups/{userGroupId}
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
In the USER GROUPS tab, at the end of the row of the user group you want to delete, select the trash icon.
In the Confirm Deletion dialog, select Confirm.
A message appears confirming the successful deletion of the user group.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
In the USER GROUPS tab, select the checkbox of the user group you want to delete.
Sugerencia
You can select multiple checkboxes to delete several user groups at once.
Select Delete at the top of the table.
In the Confirm Deletion dialog, select Confirm.
A message appears confirming the successful deletion of the user group.
Aviso
This procedure displays all user groups created by the user.
To test this function, call this API endpoint: GET /accessmanagement/usergroups
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently configured in the system.
Sugerencia
Use Columns and Filters to customize your view of the results.
Aviso
This procedure displays the members who exist within a specific user group (usergroup1). The user group was previously created here.
To test this function, call this API endpoint: GET /accessmanagement/usergroups/{userGroupId}/members
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently registered in the system.
Select the name of the user group (for example, usergroup1) whose members you want to view - see Path 2 for quick filtering.
Aviso
The current version of DigiCert® DNS does not include a dedicated front-end tab for viewing the non-members of a specific user group. To access this information, use the following endpoint:
GET /accessmanagement/usergroups/{userGroupId}/nonmembers
For help configuring your testing environment, refer to the API guide.
Aviso
This procedure removes two users (Jane Doe and John Doe) from a specific user group (usergroup1) created in an earlier procedure.
Users must belong to at least one user group and cannot exist independently; if a user exists only in the Default resource group, they cannot be removed from it. If a user is removed from their only group, they are automatically placed into the Default user group.
To test this function, call this API endpoint: POST /accessmanagement/usergroups/{userGroupId}/members/bulk/remove
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently registered in the system.
Select the name of the user group (for example, usergroup1) whose users you want to remove - see Path 2 for quick filtering.
In the Members section, select the checkboxes of the users you want to remove (for example, Jane Doe and John Doe).
Select Remove at the top of the table.
In the Confirm Removal dialog, select Confirm.
A message appears confirming the successful removal of the users.
Aviso
This procedure displays the details of a specific user group (usergroup1) created in an earlier procedure. 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/usergroups/{userGroupId}
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 USER GROUPS tab.
The table displays all the user groups currently configured in the system.
Select the name of the user group (for example, usergroup1) whose details you want to view.
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 USER GROUPS tab.
The table displays all the user groups currently configured in the system.
Select Filters at the top of the results table to locate the specific user group quickly.
Sugerencia
In this example, the name of the user group is known, so the following filter was applied:
Under Column, select Name.
Under Operator, select contains.
Under Value, enter the user group's name (usergroup1).
If no results appear, double-check the Filters selections and input values.
Select the name of the user group (for example, usergroup1) whose details you want to view.
Aviso
This procedure updates a specific user group (usergroup1) created in an earlier procedure.
To test this function, call this API endpoint: PUT /accessmanagement/usergroups/{userGroupId}
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select Settings > Access Management.
Select the USER GROUPS tab.
The table displays all the user groups currently configured in the system.
Locate the specific user group - see Path 2 for quick filtering.
Select the name of the user group (for example, usergroup1) whose details you want to update.
In the usergroup1 dialog:
Edit the user group's details as required.
Select Save to finish.
A message appears confirming the successful update of the user group.