Skip to main content

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

Email

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

  1. Open Configuration > Access management.

  2. Select the Users tab.

  3. Select the name of the user who requires an API token.

  4. Select the API tokens tab.

  5. Select Generate API token.

  6. Enter a Name that identifies the token.

  7. Optionally, specify an Expiry date. Leave it blank if the token should have no scheduled expiry.

  8. Optionally, add a Note describing the token’s purpose.

  9. Select Generate.

  10. 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.