: Google Cloud DNS requirements for domain validation
Focus
Focus

Google Cloud DNS requirements for domain validation

Table of Contents

Google Cloud DNS requirements for domain validation

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

Required Google Cloud properties

These Google Cloud properties are required to enable secure automation with Google Cloud DNS:
FieldPurpose
Service account JSON fileAuthenticates API access to Google Cloud DNS using a service account credential.

Required permissions

To allow Next-Gen Trust Security to create and manage TXT records automatically, the service account must include the following permissions in Google Cloud IAM.

Project-level permissions

PermissionPurpose
dns.managedZones.listLists available managed zones in the project.
dns.projects.getRetrieves project information and DNS quotas.

DNS zone–level permissions

PermissionPurpose
dns.changes.createCreates DNS record changes for DNS-01 validation.
dns.changes.getRetrieves details about DNS changes.
dns.resourceRecordSets.createAdds TXT records required for validation.
dns.resourceRecordSets.deleteRemoves TXT records after validation completes.
dns.resourceRecordSets.getReads specific DNS record details.
dns.resourceRecordSets.listLists existing DNS records in the zone.
dns.managedZonesOperations.listLists the status of long-running operations, such as DNS record updates, within a managed zone. Required for tracking asynchronous DNS changes during validation.
dns.resourceRecordSets.updateUpdates existing DNS records when a new validation TXT record replaces an older entry or when a record must be modified instead of recreated.
Tip: Need help configuring IAM roles? See Google’s guides for Creating and Managing Service Accounts and Access Control for Cloud DNS.You may need assistance from a Google Cloud administrator to create a service account and assign custom roles.