Skip to content

Knowledgebase

Connect Route 53 and separate DNS changes from optional KMS signing access

domain-nexus, domains-dns

The Route 53 connection uses an AWS access key ID and secret access key for the account that contains your hosted zones. Give that identity the Route 53 permissions needed by the selected DNS package. DNSSEC key management introduces additional AWS KMS requirements and should be configured separately from ordinary record updates.

01 Prepare an AWS identity

Create an authorised integration identity under your AWS access policy. Restrict permissions to the required hosted-zone discovery, record reads and changes, and zone lifecycle operations where needed. Some discovery actions have different resource-scoping rules from record changes, so construct the policy from AWS's action reference instead of assuming one hosted-zone ARN covers every call.

The current connection form accepts the access key and secret pair. Do not paste an expiring session token into either field or assume that an unrelated AWS console login will work. Record credential ownership and a planned rotation date.

02 Add the connection

  1. In Domain Nexus Servers, choose AWS Route53.
  2. Enter Access Key ID and Secret Access Key.
  3. Leave the optional DNSSEC fields for a separate signing setup unless you have already prepared the required KMS key.
  4. Save and check the connection. Select an owned public hosted zone for a read and a temporary TXT record change.
  5. For packages that create zones, verify one controlled new-zone workflow and record the nameservers Route 53 assigns to that hosted zone.

Common questions

Why does a new zone have different nameservers?

Use the delegation set returned for the actual hosted zone. Creating another zone with the same domain name does not make it the zone that the registrar currently delegates to. Compare hosted-zone identity and public delegation before applying customer records.

Why is DNSSEC asking for a KMS ARN?

When the zone does not already have the required Route 53 key-signing key, the module needs the configured DNSSEC KMS Key ARN and KSK name. The KMS key must satisfy AWS's Route 53 signing requirements and policy. Follow the dedicated signing guide and verify the parent DS separately.

After a failed or uncertain write, inspect the operation and provider state before retrying. A valid AWS credential does not guarantee every IAM action or hosted zone is authorised.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support

Powered by WHMCompleteSolution