AutoDNS

Configuration

To use this provider, add an entry to creds.json with TYPE set to AUTODNS along with username, password and a context.

Example:

creds.json

{
  "autodns": {
    "TYPE": "AUTODNS",
    "username": "[e-mail]",
    "password": "[***]",
    "context": "33004"
  }
}

Two factor authentication

If two-factor authentication has been enabled on your account you will also need to provide a valid TOTP code. This can also be done via an environment variable:

creds.json

{
  "autodns": {
    "TYPE": "AUTODNS",
    "username": "[e-mail]",
    "password": "[***]",
    "context": "33004",
    "totp": "$AUTODNS_TOTP"
  }
}

and then you can run

AUTODNS_TOTP=123456 dnscontrol preview

It is also possible to directly provide the shared TOTP secret using the key "totp-key" in creds.json. This secret is only available when first enabling two-factor authentication.

Security Warning:

• Anyone with access to this creds.json file will have full access to your AutoDNS account and will be able to modify and delete your DNS entries.

• Storing the shared secret together with the password weakens two factor authentication because both factors are stored in a single place.

creds.json

{
  "autodns": {
    "TYPE": "AUTODNS",
    "username": "[e-mail]",
    "password": "[***]",
    "context": "33004",
    "totp-key": "yourTOTPSharedSecret"
  }
}

totp and totp-key must not be set at the same time. Omit both if the account does not use two factor authentication.

Including sub-user zones

By default DNSControl only sees zones owned directly by the configured user. If you authenticate as a master/admin user and want get-zones (and the all keyword) to also include zones owned by sub-users — the same optional "include subusers" toggle the AutoDNS web UI offers — set children to "true":

creds.json

{
  "autodns": {
    "TYPE": "AUTODNS",
    "username": "[e-mail]",
    "password": "[***]",
    "context": "33004",
    "children": "true"
  }
}

Usage

An example configuration:

dnsconfig.js

var REG_NONE = NewRegistrar("none");
var DSP_AUTODNS = NewDnsProvider("autodns");

D("example.com", REG_NONE, DnsProvider(DSP_AUTODNS),
    A("test", "1.2.3.4"),
);

Feature Summary

• Provider Type

  • Official Support: ❌

  • DNS Provider: ✅

  • Registrar: ✅

• Provider API

  • Concurrency Verified: ✅

  • dual host: ❌

  • create-domains: ❌

  • get-zones: ✅

• DNS extensions

  • ALIAS: ✅

  • DNAME: ❔

  • LOC: ❔

  • PTR: ✅

  • SOA: ❔

• Service discovery

  • DHCID: ❔

  • NAPTR: ❔

  • SRV: ✅

  • SVCB: ❔

• Security

  • CAA: ✅

  • HTTPS: ❔

  • SMIMEA: ❔

  • SSHFP: ❌

  • TLSA: ❌

• DNSSEC

  • AUTODNSSEC: ❔

  • DNSKEY: ❔

  • DS: ❌