github.com/StackExchange/dnscontrol/v4@v4.11.0/documentation/provider/powerdns.md (about)

     1  ## Configuration
     2  
     3  To use this provider, add an entry to `creds.json` with `TYPE` set to `POWERDNS`
     4  along with your [API URL, API Key and Server ID](https://doc.powerdns.com/authoritative/http-api/index.html).
     5  In most cases the Server id is `localhost`.
     6  
     7  Example:
     8  
     9  {% code title="creds.json" %}
    10  ```json
    11  {
    12    "powerdns": {
    13      "TYPE": "POWERDNS",
    14      "apiKey": "your-key",
    15      "apiUrl": "http://localhost",
    16      "serverName": "localhost"
    17    }
    18  }
    19  ```
    20  {% endcode %}
    21  
    22  ## Metadata
    23  Following metadata are available:
    24  
    25  {% code title="dnsconfig.js" %}
    26  ```javascript
    27  {
    28      'default_ns': [
    29          'a.example.com.',
    30          'b.example.com.'
    31      ],
    32      'dnssec_on_create': false,
    33      'zone_kind': 'Native',
    34  }
    35  ```
    36  {% endcode %}
    37  
    38  - `default_ns` sets the nameserver which are used
    39  - `dnssec_on_create` specifies if DNSSEC should be enabled when creating zones
    40  - `zone_kind` is the type that will be used when creating the zone.
    41    <br>Can be one of `Native`, `Master` or `Slave`, when not specified it defaults to `Native`.
    42    <br>Please see [PowerDNS documentation](https://doc.powerdns.com/authoritative/modes-of-operation.html) for explanation of the kinds.
    43    <br>**Note that these tokens are case-sensitive!**
    44  - `soa_edit_api` is the default SOA serial method that is used for zone created with the API
    45    <br> Can be one of `DEFAULT`, `INCREASE`, `EPOCH`, `SOA-EDIT` or `SOA-EDIT-INCREASE`, default format is YYYYMMDD01.
    46    <br>Please see [PowerDNS SOA-EDIT-DNSUPDATE documentation](https://doc.powerdns.com/authoritative/dnsupdate.html#soa-edit-dnsupdate-settings) for explanation of the kinds.
    47    <br>**Note that these tokens are case-sensitive!**
    48  
    49  ## Usage
    50  An example configuration:
    51  
    52  {% code title="dnsconfig.js" %}
    53  ```javascript
    54  var REG_NONE = NewRegistrar("none");
    55  var DSP_POWERDNS = NewDnsProvider("powerdns");
    56  
    57  D("example.com", REG_NONE, DnsProvider(DSP_POWERDNS),
    58      A("test", "1.2.3.4"),
    59  END);
    60  ```
    61  {% endcode %}
    62  
    63  ## Activation
    64  See the [PowerDNS documentation](https://doc.powerdns.com/authoritative/http-api/index.html) how the API can be enabled.