1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Files
stackexchange-dnscontrol/docs/_providers/dnsimple.md
Jeffrey Cafferata 3f760cdd25 DOCS: Documentation improvements (#1786)
Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
2022-10-31 18:09:43 -04:00

1.5 KiB

name, title, layout, jsId
name title layout jsId
DNSimple DNSimple Provider default DNSIMPLE

DNSimple Provider

Configuration

To use this provider, add an entry to creds.json with TYPE set to DNSIMPLE along with a DNSimple account access token.

You can also set the baseurl to use DNSimple's free sandbox for testing.

Examples:

{
  "dnsimple": {
    "TYPE": "DNSIMPLE",
    "token": "your-dnsimple-account-access-token"
  },
  "dnsimple_sandbox": {
    "TYPE": "DNSIMPLE",
    "baseurl": "https://api.sandbox.dnsimple.com",
    "token": "your-sandbox-account-access-token"
  }
}

Metadata

This provider does not recognize any special metadata fields unique to DNSimple.

Usage

An example dnsconfig.js configuration:

var REG_DNSIMPLE = NewRegistrar("dnsimple");
var DSP_DNSIMPLE = NewDnsProvider("dnsimple");

D("example.tld", REG_DNSIMPLE, DnsProvider(DSP_DNSIMPLE),
    A("test", "1.2.3.4")
);

Activation

DNSControl depends on a DNSimple account access token.

Caveats

CAA

As of July 2022, the DNSimple DNS does not accept spaces in CAA records. Putting spaces in the record will result in a 400 Validation Failed error.

0 issue "letsencrypt.org; validationmethods=dns-01; accounturi=https://acme-v02.api.letsencrypt.org/acme/acct/1234"

Removing the spaces will work.

0 issue "letsencrypt.org;validationmethods=dns-01;accounturi=https://acme-v02.api.letsencrypt.org/acme/acct/1234"