Skip to main content

Create a service user and API token

Create a dedicated identity for an application or automated process, assign DNS permissions, and generate its API token.

Before you begin

  1. Sign in to the DigiCert®​​ DNS account the application will access.

  2. Confirm that your assigned roles permit you to create service users, assign roles, and generate tokens.

  3. Identify the DNS operations the application needs to perform.

  4. Choose a descriptive service user name, such as dns-deployment-automation.

  5. Prepare a secure location for storing the token.

Create a service user

  1. Go to Configuration > Access management.

  2. Select the Service users tab.

  3. Select Create service user.

  4. Enter a name identifying the application, integration, or purpose.

  5. Select the required roles.

    For example, an application that creates zones needs the relevant Zone creation permission. An application that updates records needs the relevant Record update permission.

  6. Optionally, enter a comment for the audit log.

  7. Select Create.

  8. Locate the new service user and confirm that its status is Active.

Generate and store the API token

  1. Go to Configuration > Access management.

  2. Select the Service users tab.

  3. Select the API tokens tab.

  4. Select Generate API token.

  5. Enter a Name identifying the token’s purpose.

  6. Optionally, specify an Expiry date. Leave it blank if no scheduled expiry is required.

  7. Optionally, enter a Note describing the application or workflow that will use the token.

  8. Select Generate.

  9. Copy the full token and store it securely.

  10. Select Continue.

  11. Confirm that the token appears in the credentials list with the intended expiry.

Notice

The full token is shown only once. After you continue, the list displays only its masked value.

Keep the token out of source code, shared documents, screenshots, and diagnostic logs.

Next steps