Overview
This article explains how to link your UltraDNS account to DigiCert CertCentral for automated Domain Control Validation (DCV). DCV confirms control of a domain before a certificate can be issued.
This procedure covers the UltraDNS account connection and CertCentral domain import and automation. A cert-manager DNS-01 provider configuration error requires separate investigation; account linking alone does not resolve that configuration error.
The integration allows CertCentral to manage the DNS TXT records required for validation. After linking the accounts, you must make the required domains visible to CertCentral and import them into CertCentral to start automated validation.
When to Use This Article
- You want to connect UltraDNS to an existing CertCentral account.
- You want CertCentral to automate DNS-based domain validation.
- You need to reset or remove an existing connection.
Before You Begin
- You need an UltraDNS account and a DigiCert CertCentral account.
- Your UltraDNS user must have permission to manage account connections.
- A CertCentral administrator must complete the CertCentral portion of the setup.
- The DigiCert CertCentral Connection feature must be available in UltraDNS, and Integrate with UltraDNS must be enabled in CertCentral.
- Domains used for this automated validation workflow must be delegated to UltraDNS authoritative name servers.
If the connection option is not visible in UltraDNS, contact UltraDNS Support and provide your DigiCert CertCentral Account ID.
If Integrate with UltraDNS is missing from the Automation menu in CertCentral, contact your account manager or DigiCert Support to enable the feature.
CertCentral can connect to one UltraDNS account at a time. Connecting a different UltraDNS account disconnects the existing account and disables automated validation for domains linked to that account.
Start the Connection in UltraDNS
- Sign in to the UltraDNS portal.
- Select Accounts, select your account, and open Account Info.
- Locate DigiCert CertCentral Connection and click Link.
- In the connection window, use Click to Copy to copy the displayed Account ID and Secret key. Store both values securely.
- Click Ok, saved after saving the connection details.
The Secret key is entered as the API secret in CertCentral. The secret is displayed only once and cannot be retrieved later. Generating a replacement secret invalidates the previous secret.
If another administrator will complete the CertCentral setup, securely provide that administrator with the connection details.
Complete the Connection in CertCentral
- Sign in to CertCentral as an administrator.
- Go to Automation > Integrate with UltraDNS.
- Under Link account, enter the connection details copied from UltraDNS into UltraDNS Account ID and API secret.
- Select Link.
- Return to DigiCert CertCentral Connection in UltraDNS and check the connection status. The UltraDNS Managed Services Portal User Guide describes the status changing from Pending to Established when the connection is complete.
Make Domains Available for Automated Validation
An established account connection does not import or automate each domain. Turning on Visible to CertCentral makes the zone available through the connection. CertCentral must then import and automate it. A domain already appearing in CertCentral does not, by itself, confirm that UltraDNS automation is enabled.
- In UltraDNS, select Domains.
- Locate the domain and turn Visible to CertCentral On.
- Sign in to the CertCentral account holding the UltraDNS connection. Open Certificates > Domains > Domains available for import and look for the domain.
- Select Import and automate domains. Follow DigiCert's import and automation instructions to select the domain, assign it to an organization, and complete the workflow.
- Review the domain's automation and validation status in CertCentral. Being listed as available for import is not confirmation that import or validation has completed.
DigiCert recommends testing with one domain before importing multiple domains.
To make multiple domains visible in UltraDNS, select the domains, open the Visible to CertCentral menu, and select Enable Visibility.
If the Domain Is Visible but Not Automated
Verify that the zone belongs to the UltraDNS account bound to the CertCentral connection. The connection only sees zones in that UltraDNS account. When multiple CertCentral accounts or subaccounts are involved, confirm which CertCentral account owns the connection.
Check Domains available for import even if the domain already appears in the regular CertCentral domain list. Follow the import and automation workflow above when the domain is available for import.
If the domain is missing from the import list, the import fails, or the DCV method cannot be changed, record the exact state and contact Support. Provide the UltraDNS account ID, CertCentral account and subaccount IDs, domain, error, and screenshots. The symptom alone does not establish the cause or justify deleting the domain, resetting the connection, or unlinking the accounts.
For further checks, see How to Check Whether the UltraDNS and CertCentral Integration Is Working for Automatic DCV Revalidation.
Expected Outcome
The accounts are connected, and the domains you import into CertCentral are submitted for DNS TXT record validation. Review the domain validation status in CertCentral to confirm the result.
Reset the Connection
Use Reset when you need a replacement Secret key. Resetting temporarily suspends the connection.
- In UltraDNS, open Accounts > Account Name > Account Info.
- In DigiCert CertCentral Connection, click Reset and securely save the new connection details.
- In CertCentral, go to Automation > Integrate with UltraDNS.
- Under Link account, enter the new value in API secret and select Link.
The new secret must be entered in CertCentral to reactivate the connection. See DigiCert's API secret update instructions for the complete workflow.
Remove the Connection
In the UltraDNS DigiCert CertCentral Connection section, click Unlink to remove the connection. This stops CertCentral from automatically managing domain validation through that connection.
To use the integration again, reestablish the connection and designate the domains again in CertCentral.
Important Notes
- Visible to CertCentral remains disabled until the UltraDNS account is linked to CertCentral.
- If you have access to multiple UltraDNS accounts, each domain must belong to an account linked to CertCentral before you enable its visibility.
- Manually created
_dnsauthTXT records can block automated validation. The automation does not delete user-generated records. Confirm ownership and the validation workflow before removing a record. System-managed records cannot be manually modified or deleted in UltraDNS. - Domains using legacy Static Signing cannot be made visible to CertCentral. Review the UltraDNS Visible to CertCentral documentation if this limitation applies.