Skip to content

Knowledgebase

Connect Google Cloud DNS with a service account JSON key

domain-nexus, domains-dns

Google Cloud DNS connects through a service account belonging to the intended Google Cloud project. Domain Nexus accepts the entire downloaded service account JSON key and extracts the project, service account email and private key. This is different from an ordinary Google account password or browser API key.

01 Prepare the Google Cloud project

Enable Cloud DNS for the project and confirm the account's billing and service prerequisites. Create a dedicated service account with the DNS permissions required by your operation. The module's setup guidance uses the DNS Administrator role; a deliberately narrower custom role must still allow the exact zone and record operations you intend to use.

Create a JSON key only through an authorised service-account workflow. An organisation may prohibit downloadable keys. In that case, have the organisation administrator review the integration's supported authentication requirements instead of weakening a policy or pasting an unrelated credential.

02 Configure the connection

  1. Add a Domain Nexus server and choose Google Cloud DNS.
  2. Paste the full key file into Service account key (JSON), preserving the JSON content.
  3. If maintaining an older split-field configuration, enter Project ID, Service Account Email and the complete PEM private key instead. Use one coherent set from the same credential.
  4. Save and run the check, which attempts to list a managed zone in the selected project.
  5. Assign a test package and confirm that an intended public managed zone can be read and updated.

03 Verify the serving zone

Google's managed-zone resource name and the public DNS domain name are different identifiers. The adapter discovers the provider zone and its assigned nameservers. Use the nameservers belonging to the actual public zone when preparing registrar delegation, and avoid adopting an unrelated private-zone configuration as public DNS.

Why does authentication work but a change fail?

The service account may have permission to list zones but lack permission to create a managed zone or submit record changes. Verify the role in the selected project, key validity, API enablement and the complete provider error. If the wrong project was selected, correct the connection and recheck ownership before synchronising records. Rotate or revoke the downloaded key when retiring the integration; keep its replacement available to both web requests and background jobs.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support

Powered by WHMCompleteSolution