2020-05-30 15:54:07 +02:00
|
|
|
## Configuration
|
|
|
|
|
2022-05-08 14:41:33 -04:00
|
|
|
To use this provider, add an entry to `creds.json` with `TYPE` set to `POWERDNS`
|
|
|
|
along with your [API URL, API Key and Server ID](https://doc.powerdns.com/authoritative/http-api/index.html).
|
|
|
|
In most cases the Server id is `localhost`.
|
|
|
|
|
|
|
|
Example:
|
2020-05-30 15:54:07 +02:00
|
|
|
|
2022-02-17 18:22:31 +01:00
|
|
|
```json
|
2020-05-30 15:54:07 +02:00
|
|
|
{
|
|
|
|
"powerdns": {
|
2022-05-08 14:41:33 -04:00
|
|
|
"TYPE": "POWERDNS",
|
2020-11-28 21:43:13 +01:00
|
|
|
"apiKey": "your-key",
|
2022-05-08 14:41:33 -04:00
|
|
|
"apiUrl": "http://localhost",
|
2020-11-28 21:43:13 +01:00
|
|
|
"serverName": "localhost"
|
2020-05-30 15:54:07 +02:00
|
|
|
}
|
|
|
|
}
|
2022-02-17 18:22:31 +01:00
|
|
|
```
|
2020-05-30 15:54:07 +02:00
|
|
|
|
|
|
|
## Metadata
|
|
|
|
Following metadata are available:
|
|
|
|
|
2023-01-20 13:56:20 +01:00
|
|
|
```javascript
|
2020-05-30 15:54:07 +02:00
|
|
|
{
|
|
|
|
'default_ns': [
|
|
|
|
'a.example.com.',
|
|
|
|
'b.example.com.'
|
|
|
|
],
|
|
|
|
'dnssec_on_create': false
|
|
|
|
}
|
2022-02-17 18:22:31 +01:00
|
|
|
```
|
2020-05-30 15:54:07 +02:00
|
|
|
|
|
|
|
- `default_ns` sets the nameserver which are used
|
|
|
|
- `dnssec_on_create` specifies if DNSSEC should be enabled when creating zones
|
|
|
|
|
|
|
|
## Usage
|
2022-05-08 14:41:33 -04:00
|
|
|
An example `dnsconfig.js` configuration:
|
2020-05-30 15:54:07 +02:00
|
|
|
|
2023-01-20 13:56:20 +01:00
|
|
|
```javascript
|
2022-05-08 14:41:33 -04:00
|
|
|
var REG_NONE = NewRegistrar("none");
|
|
|
|
var DSP_POWERDNS = NewDnsProvider("powerdns");
|
2020-05-30 15:54:07 +02:00
|
|
|
|
2022-05-08 14:41:33 -04:00
|
|
|
D("example.tld", REG_NONE, DnsProvider(DSP_POWERDNS),
|
|
|
|
A("test", "1.2.3.4")
|
2020-05-30 15:54:07 +02:00
|
|
|
);
|
2022-02-17 18:22:31 +01:00
|
|
|
```
|
2020-05-30 15:54:07 +02:00
|
|
|
|
|
|
|
## Activation
|
|
|
|
See the [PowerDNS documentation](https://doc.powerdns.com/authoritative/http-api/index.html) how the API can be enabled.
|