Connect UltraDNS to DNS Spy

Connecting UltraDNS (now DigiCert UltraDNS) to DNS Spy imports every DNS record from the zones in your UltraDNS account and keeps them monitored automatically. This guide walks through creating the dedicated read-only user DNS Spy signs in with, connecting it, and importing your zones. It applies equally to UltraDNS accounts provided through CSC.

What You Get

  • Full import: every record from every active zone the user can read is imported into DNS Spy.

  • Recurring sync: DNS Spy periodically re-reads your zones and picks up new or changed records, so your monitoring never drifts out of date.

  • Read-only by design: DNS Spy only lists zones and reads records. It never writes to UltraDNS.

Before You Start: UltraDNS Has No API Keys

Unlike most providers, UltraDNS does not issue API keys or tokens you can paste in. Its REST API signs in with a username and password and hands back a short-lived token. That is why we recommend a dedicated user for DNS Spy, separate from your own login, with exactly three properties:

  • API only access: the user can call the API but cannot sign in to the UltraDNS portal.

  • Read-only permissions: the user can view zones and records and change nothing.

  • Two Factor Mobile Authentication off: UltraDNS refuses API sign-ins from users that have it on. Because this user cannot sign in to the portal, your own login keeps its two-factor protection.

Step 1: Create the API User in UltraDNS

  1. Sign in to the UltraDNS portal at portal.ultradns.com as an account owner or an administrator who can manage users.

  2. Create a new user for DNS Spy. A name such as dnsspy-readonly makes its purpose obvious in audit logs.

  3. Turn on API only access for the user.

  4. Give the user read-only permissions on the zones you want monitored. Granting read access to all zones means new zones show up in DNS Spy without another change.

  5. Make sure Two Factor Mobile Authentication is not enabled for this user.

  6. Set a long, random password and keep it ready for the next step.

The exact menu names depend on your UltraDNS account and role. If you do not see an option to create users or to set API only access, your account owner or your CSC or UltraDNS representative can create the user for you.

Step 2: Connect It in DNS Spy

  1. In DNS Spy, open Team Settings, then DNS Providers, and start a new connection.

  2. Choose UltraDNS as the provider.

  3. Enter the API user's username and password.

  4. Click Test Connection. DNS Spy signs in to UltraDNS and confirms it can list zones.

  5. Save the connection.

The credentials are stored encrypted and are never displayed again after you save them.

Step 3: Import Your Zones

Use Import Domains on the connection. DNS Spy lists your active UltraDNS zones. Zones you already monitor appear separately so you can link them to the connection, and you can select any others to add. Once a domain is linked, every record in the zone is imported and monitoring starts on the next scan.

How UltraDNS Records Are Handled

  • Standard records (A, AAAA, CNAME, MX, TXT, SRV, CAA, NS and the rest) are imported and compared value for value against what resolvers return.

  • Round-robin pools are treated like standard records, because every member is served.

  • SiteBacker, Traffic Controller and Directional pools answer differently depending on health or location. DNS Spy imports them for coverage and monitors what actually resolves, so you are not alerted by normal traffic steering.

  • Alias zones and apex alias records are not imported yet. Alias zones mirror another zone, which you can import directly.

Troubleshooting

  • "Invalid username & password combination": the username or password is wrong, or the user has been disabled.

  • A message mentioning Two Factor Mobile Authentication: two-factor is on for the user. Turn it off for the dedicated API user and test again.

  • The connection works but zones are missing: the user does not have read permission on those zones. Add them in UltraDNS and run Import Domains again.

  • "Too many requests": UltraDNS limits how often an account can call its API. DNS Spy backs off and retries on its own. If it persists, check whether other tools are using the same user.

Rotating or Removing Access

To rotate the password, change it in UltraDNS and then update it on the connection in DNS Spy. To revoke access, disable or delete the user in UltraDNS. DNS Spy will notice the next time it syncs, pause the connection, and email you. Records already imported keep being monitored.

UltraDNS is a DigiCert product. CSC is a trademark of Corporation Service Company. Product names are trademarks of their respective owners. DNS Spy is not affiliated with or endorsed by DigiCert or CSC.