1 Name = "PowerDNS"
2 Description = ''''''
3 URL = "https://www.powerdns.com/"
4 Code = "pdns"
5 Since = "v0.4.0"
6 7 Example = '''
8 PDNS_API_URL=http://pdns-server:80/ \
9 PDNS_API_KEY=xxxx \
10 lego --dns pdns -d '*.example.com' -d example.com run
11 '''
12 13 Additional = '''
14 ## Information
15 16 Tested and confirmed to work with PowerDNS authoritative server 3.4.8 and 4.0.1. Refer to [PowerDNS documentation](https://doc.powerdns.com/md/httpapi/README/) instructions on how to enable the built-in API interface.
17 18 PowerDNS Notes:
19 - PowerDNS API does not currently support SSL, therefore you should take care to ensure that traffic between lego and the PowerDNS API is over a trusted network, VPN etc.
20 - In order to have the SOA serial automatically increment each time the `_acme-challenge` record is added/modified via the API, set `SOA-EDIT-API` to `INCEPTION-INCREMENT` for the zone in the `domainmetadata` table
21 - Some PowerDNS servers doesn't have root API endpoints enabled and API version autodetection will not work. In that case version number can be defined using `PDNS_API_VERSION`.
22 '''
23 24 [Configuration]
25 [Configuration.Credentials]
26 PDNS_API_KEY = "API key"
27 PDNS_API_URL = "API URL"
28 [Configuration.Additional]
29 PDNS_SERVER_NAME = "Name of the server in the URL, 'localhost' by default"
30 PDNS_API_VERSION = "Skip API version autodetection and use the provided version number."
31 PDNS_POLLING_INTERVAL = "Time between DNS propagation check in seconds (Default: 2)"
32 PDNS_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation in seconds (Default: 120)"
33 PDNS_TTL = "The TTL of the TXT record used for the DNS challenge in seconds (Default: 120)"
34 PDNS_HTTP_TIMEOUT = "API request timeout in seconds (Default: 30)"
35 36 [Links]
37 API = "https://doc.powerdns.com/md/httpapi/README/"
38