mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2025-01-11 01:47:53 +08:00
befb52be86
* Fix typo and add sandbox information * Use SetTargetTXT in GetZoneRecords This fixes the behavior documented in #1622 Also apply cleanup to GetZoneRecords * Remove SetTargetTXT, does not work in all tests * Set The most correct TXT handling * Well, There's your problem * Add an audit and test for unpaired quotes * Add some commentary Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
---
|
|
name: DNSimple
|
|
title: DNSimple Provider
|
|
layout: default
|
|
jsId: 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](https://developer.dnsimple.com/sandbox/) for testing.
|
|
|
|
Examples:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```js
|
|
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"
|
|
```
|
|
|