Connect AWS Route 53
Step-by-step guide to connect your AWS Route 53 account to Domain Pilot
This guide walks you through connecting your AWS Route 53 account to Domain Pilot so you can manage all your Route 53 domains from a single dashboard.
You'll create a dedicated IAM user for Domain Pilot and give Domain Pilot that user's Access Key ID and Secret Access Key.
Before You Begin
- An AWS account with domains registered or hosted in Route 53
- Access to the AWS IAM console (to create users and access keys)
Step 1: Open IAM Users
-
Log in to the AWS Console and open IAM
-
In the left sidebar, click IAM users
Step 2: Create an IAM User
-
Click Create user
-
Enter a user name, such as "DomainPilot". Leave Provide user access to the AWS Management Console unticked, then click Next
-
Under Permissions options, select Attach policies directly
-
Search for route and tick these two AWS managed policies, then click Next:
- AmazonRoute53DomainsFullAccess: lets Domain Pilot read your registered domains
- AmazonRoute53FullAccess: lets Domain Pilot read and manage your hosted zones and DNS records
-
Review the details and click Create user
Step 3: Create an Access Key
-
In the IAM users list, click the user you just created
-
Open the Security credentials tab
-
Under Access keys, click Create access key
-
Select Third-party service as the use case, tick the confirmation box, and click Next
-
Optionally add a description tag, such as "DomainPilotKeys", then click Create access key
Step 4: Copy Your Access Keys
On the Retrieve access keys page, copy both values:
- Access key: this is your Access Key ID
- Secret access key: click Show to reveal it, or use the copy icon
Step 5: Connect in Domain Pilot
- Log in to Domain Pilot
- Click Registrars in the sidebar, then click Add Registrar
- Select AWS Route 53
- Paste your access key into AWS Access Key ID
- Paste your secret access key into AWS Secret Access Key
- AWS Region is optional. You can leave it empty
- Click Test Connection
Verifying the Connection
Domain Pilot imports your domains as soon as the connection test succeeds and shows how many it found. Click View My Domains to see them on the Domains page.
Troubleshooting
"Invalid Credentials" Error
- Ensure you're using the matching Access Key ID and Secret Access Key pair
- Verify the IAM user still exists and the access key is Active
- If you lost the secret access key, create a new access key for the user and deactivate the old one
"Access Denied" Error
- Check that both AmazonRoute53DomainsFullAccess and AmazonRoute53FullAccess are attached to the user under the Permissions tab
- If your account is part of an AWS Organization, check that no Service Control Policy (SCP) blocks Route 53
Only Hosted Zones or Only Registered Domains Appearing
- Registered domains and hosted zones are separate services in AWS
- AmazonRoute53DomainsFullAccess covers registered domains, and AmazonRoute53FullAccess covers hosted zones and DNS. The user needs both