: Azure DNS requirements for domain validation
Focus
Focus

Azure DNS requirements for domain validation

Table of Contents

Azure DNS requirements for domain validation

When using Azure DNS with a certificate authority (CA) that supports the DNS-01 challenge method—such as Let's Encrypt or a custom ACMEv2 CA—Next-Gen Trust Security automates domain control validation by creating and deleting TXT records through the Azure API.

Required Azure properties

These Azure properties are required to enable secure automation with Azure DNS:
FieldPurpose
Subscription IDIdentifies the Azure subscription hosting your DNS zones.
Resource GroupIdentifies the resource group that contains those DNS zones.
Client IDThe application (service principal) ID registered in Azure AD.
Client SecretSecret string that, with the Client ID, authenticates requests.
Tenant IDIdentifies your Azure Active Directory instance.

Required permissions

To allow Next-Gen Trust Security to create and manage TXT records automatically, you must:
  • Create a service principal (Azure AD application).
  • Assign it the DNS Zone Contributor role at either the resource-group or DNS-zone scope.
This role lets Next-Gen Trust Security:
  • Read DNS zones and records
  • Create TXT records for validation
  • Update or delete those records when validation completes
Tip: Need help creating a service principal? See Microsoft's guide.
You may need assistance from your Azure administrator to create the principal and assign roles.