DNS users
Users are individuals who access your DigiCert® DNS account. Each user has a profile, an access status, and assigned roles that define what they can access and do. Users can also have API tokens for authenticating API requests.
The difference between users and service users
Users represent individuals who access your account. Service users represent applications, integrations, or automated processes that access your account through the API.
Both users and service users have assigned roles that define what they can access and do. Service users use API tokens to authenticate requests, allowing you to manage access for an integration independently of an individual user.
Explore the Users page
To view users in your account, go to Configuration > Access management and select the Users tab.
The Users page provides the following information:
Column | Description |
|---|---|
Username | The user’s username. Select it to open their profile |
Name | The user’s name |
The user’s email address | |
Status | Whether the user is active or deactivated |
Tokens | The number of API tokens associated with the user |
Roles | The roles assigned to the user |
When a user has more roles than the table displays, hover over + more to view the additional roles.
Each user’s actions menu provides options to view their profile, edit their roles, activate or deactivate their access, and edit their identity in DigiCert® Account Manager.
Manage a user
A user’s profile brings together their account details, assigned roles, and API credentials. Select a username on the Users page, or select View user from the user’s actions menu, to open their profile.
The Overview tab displays the user’s username, email address, phone number, creation date, last modified date, and user ID. The Roles and permissions section shows their assigned roles.
The API credentials tab lists the API tokens used to authenticate the user. For each token, you can view its name, masked value, status, creation date, last-used date, and expiry date. Hover over the note icon to view any note associated with a token.
API credentials for users
API tokens authenticate API requests as a user. To view and manage a user’s tokens, open their profile and select the API credentials tab.
The tab displays the following information:
Column | Description |
|---|---|
Name | The name of the API token |
Token | A masked version of the token. Hover over a token’s note icon to view any associated note |
Status | The token’s status, such as Active or Revoked |
Created | The date the token was created |
Last used | The date the token was last used |
Expire | The token’s expiry date, or Never if no expiry date is set |
Generate, revoke or delete an API token
Open Configuration > Access management.
Select the Users tab.
Select the name of the user who requires an API token.
Select the API tokens tab.
Select Generate API token.
Enter a Name that identifies the token.
Optionally, specify an Expiry date. Leave it blank if the token should have no scheduled expiry.
Optionally, add a Note describing the token’s purpose.
Select Generate.
Copy the token and store it securely, then select Continue.
Notice
The full token is shown only once. After you continue, only its masked value appears in the token list.
To revoke a token, select Revoke token from its actions menu and confirm. Applications can no longer use the token to authenticate API requests. The token remains listed with a Revoked status.
To delete a token, select Delete token from its actions menu and confirm. Deletion removes the token and prevents applications from using it to authenticate API requests. This action cannot be undone.
You can also select multiple tokens using their checkboxes and choose Revoke or Delete to perform the action in bulk.
Active and deactivated users
A user’s status appears on the Users page and beside their name in their profile.
Status | Meaning |
|---|---|
Active | The user can access the account according to their assigned roles |
Deactivated | The user has been deactivated and can no longer access the account |
To deactivate a user, select Deactivate user from their actions menu and confirm the action. Their profile remains available, and their status changes to Deactivated.
To restore access, select Activate user from the actions menu on the Users page or in the user’s profile.
Account Manager-managed user identities
For users whose identities are managed in DigiCert® Account Manager, select Edit in DigiCert® Account Manager from the user’s actions menu to open their identity in DigiCert® Account Manager.
Use DigiCert® Account Manager to manage the user’s identity information. Use DigiCert® DNS to manage their DNS roles, account access status, and API credentials.
Roles and permissions
Roles define what a user can access and do in DigiCert® DNS. A user can have multiple roles, which appear on the Users page and in the Roles and permissions section of their profile.
To change a user’s roles, select Edit roles from their actions menu on the Users page, or select the edit icon beside Roles and permissions in their profile. In the Edit roles panel, add or remove roles and select Update.
Available role options include Account admin, Account operator, Account viewer, Account auditor, Access manager, Zone admin, Zone editor, and Zone viewer.
Assign roles that match the user’s responsibilities. For descriptions of the system roles and their permission matrices, see DNS roles and permissions.