Primary domain configuration
注意
In DigiCert® DNS, managed domains (as seen in the UI) are referred to as primary domains in the documentation. Both terms refer to the same concept.
Overview
This guide provides detailed instructions for primary domain configuration, covering both targeted and comprehensive actions.
Targeted actions include:
Comprehensive actions include:
Benefits
Configuring primary domains enhances DNS management by optimizing resolution times, strengthening security, and ensuring compliance with industry standards. With DigiCert® DNS, users benefit from a unified approach to issue detection and troubleshooting, reducing downtime and improving reliability. Automated audit trails provide full visibility into configuration changes, simplifying compliance and governance. Centralized management standardizes domain settings across environments, minimizing administrative effort while maximizing control, efficiency, and consistency.
Procedures
注意
This procedure clears two primary domains (domain1 and domain2) created in an earlier procedure.
To test this function, call this API endpoint: POST /domains/primary/bulk/delete
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
In the MANAGED DNS tab, select the checkboxes of the domains you want to clear (for example, domain1 and domain2).
Go to Actions > Delete Domain.
In the Confirm Deletion dialog:
Enter the confirmation code.
Select Confirm.
A message appears confirming the successful clearance of the domains.
注意
This procedure creates two primary domains: domain1 and domain2. These domains are referenced in other procedures.
To test this function, call this API endpoint: POST /domains/primary
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the Add Domains button.
In the Add Domains dialog:
Ensure the Managed DNS checkbox is selected.
In the Domain Names field, enter one or more domain names (for example, domain1 and domain2).
(Optional) Configure additional settings as needed:
Global Traffic Director: Enable or disable GTD capabilities.
SOA Record: Select a user-defined SOA record, or keep the system default.
Nameserver Set: Select a user-defined nameserver set, or keep the system default.
Managed IP Set: Select a user-defined IP set, or leave it as 'None' (system default).
TSIG Key: Select a user-defined TSIG key, or leave it as 'None' (system default).
Template: Select a user-defined template, or leave it as 'None' (system default).
Resource Groups: Select a user-defined resource group, or keep the system default.
Select Save to finish.
A message appears confirming the successful creation of the domain.
重要
If you encounter issues, refer to the Troubleshooting guide.
注意
This procedure deletes a specific primary domain (domain1) created in an earlier procedure. You can follow either Path 1 or Path 2 to complete the deletion.
To test this function, call this API endpoint: DELETE /domains/primary/{domainId}
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
In the MANAGED DNS tab, locate the domain you want to delete (for example, domain1).
From the overflow menu (three vertical dots) at the end of the domain's row, select Delete Domain.
In the Confirm Deletion dialog:
Enter the confirmation code.
Select Confirm.
A message appears confirming the successful deletion of the domain.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
In the MANAGED DNS tab, select the checkbox of the domain you want to delete (for example, domain1).
提示
You can select multiple checkboxes to delete several domains at once.
Go to Actions > Delete Domain.
In the Confirm Deletion dialog:
Enter the confirmation code.
Select Confirm.
A message appears confirming the successful deletion of the domain.
注意
The current version of DigiCert® DNS supports 8 GTD regions (Africa, Asia Pacific, Default, Europe, NA East, NA West, Oceania, and South America). However, these regions are only displayed on the front-end when a domain is GTD-enabled. To view all available GTD locations regardless of domain status, use the following endpoint:
GET /gtdlocations
For help configuring your testing environment, refer to the API guide.
注意
This procedure displays all primary domains created by the user.
To test this function, call this API endpoint: GET /domains/primary
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
提示
Use Columns and Filters to customize your view of the results.
注意
This procedure displays the delegated nameservers of a specific primary domain (domain1) 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 /domains/primary/{domainId}/delegatednameservers
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select the name of the primary domain (for example, domain1) whose delegated nameservers you want to view.
Select the NAMESERVERS tab.
The Delegated Nameservers table displays all the nameservers delegated to the primary domain.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select Filters at the top of the results table to locate the specific primary domain quickly.
提示
In this example, the name of the primary domain is known, so the following filter was applied:
Under Column, select Name.
Under Operator, select contains.
Under Value, enter the primary domain's name (domain1).
If no results appear, double-check the Filters selections and input values.
Select the name of the primary domain (for example, domain1) whose delegated nameservers you want to view.
Select the NAMESERVERS tab.
The Delegated Nameservers table displays all the nameservers delegated to the primary domain.
注意
This procedure displays the nameservers of a specific primary domain (domain1) 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 /domains/primary/{domainId}/nameservers
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select the name of the primary domain (for example, domain1) whose nameservers you want to view.
Select the NAMESERVERS tab.
The Nameservers table displays all the nameservers assigned to the primary domain.
Path 2
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select Filters at the top of the results table to locate the specific primary domain quickly.
提示
In this example, the name of the primary domain is known, so the following filter was applied:
Under Column, select Name.
Under Operator, select contains.
Under Value, enter the primary domain's name (domain1).
If no results appear, double-check the Filters selections and input values.
Select the name of the primary domain (for example, domain1) whose nameservers you want to view.
Select the NAMESERVERS tab.
The Nameservers table displays all the nameservers assigned to the primary domain.
注意
The current version of DigiCert® DNS does not include a dedicated front-end tab for viewing the nameservers for all primary domains. To access this information, use the following endpoint:
GET /domains/primary/nameservers
For help configuring your testing environment, refer to the API guide.
注意
The current version of DigiCert® DNS does not include a dedicated front-end tab for viewing the details of a specific GTD location. To access this information, use the following endpoint:
GET /gtdlocations/{gtdLocationId}
For help configuring your testing environment, refer to the API guide.
注意
The current version of DigiCert® DNS does not include a dedicated front-end tab for viewing the details of a specific nameserver. To access this information, use the following endpoint:
GET/domains/primary/nameservers/{id}
For help configuring your testing environment, refer to the API guide.
注意
This procedure displays the details of a specific primary domain (domain1) 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 /domains/primary/{domainId}
Path 1
Sign in to your DigiCert® DNS account.
From the landing page, go to the left sidebar and select DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select the name of the domain (for example, domain1) 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 DNS > Domains.
Select the MANAGED DNS tab.
The table displays all the primary domains associated with the account.
Select Filters at the top of the results table to locate the specific domain quickly.
提示
In this example, the name of the domain is known, so the following filter was applied:
Under Column, select Domain.
Under Operator, select contains.
Under Value, enter the domain's name (domain1).
If no results appear, double-check the Filters selections and input values.
Select the name of the domain (for example, domain1) whose details you want to view.