2019-03-08 18:47:06 +00:00
|
|
|
Name = "PowerDNS"
|
|
|
|
|
Description = ''''''
|
|
|
|
|
URL = "https://www.powerdns.com/"
|
|
|
|
|
Code = "pdns"
|
2019-04-17 19:32:38 +00:00
|
|
|
Since = "v0.4.0"
|
2019-03-08 18:47:06 +00:00
|
|
|
|
2020-11-27 19:40:44 +00:00
|
|
|
Example = '''
|
|
|
|
|
PDNS_API_URL=http://pdns-server:80/ \
|
|
|
|
|
PDNS_API_KEY=xxxx \
|
2022-06-16 22:25:42 +00:00
|
|
|
lego --email you@example.com --dns pdns --domains my.example.org run
|
2020-11-27 19:40:44 +00:00
|
|
|
'''
|
2019-03-08 18:47:06 +00:00
|
|
|
|
|
|
|
|
Additional = '''
|
|
|
|
|
## Information
|
2016-08-19 07:07:18 +00:00
|
|
|
|
2018-12-06 21:50:17 +00:00
|
|
|
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.
|
2016-08-19 07:07:18 +00:00
|
|
|
|
|
|
|
|
PowerDNS Notes:
|
|
|
|
|
- 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.
|
2018-07-03 14:14:43 +00:00
|
|
|
- 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
|
2024-01-27 22:23:10 +00:00
|
|
|
- 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`.
|
2019-03-08 18:47:06 +00:00
|
|
|
'''
|
|
|
|
|
|
|
|
|
|
[Configuration]
|
|
|
|
|
[Configuration.Credentials]
|
|
|
|
|
PDNS_API_KEY = "API key"
|
2020-09-29 22:27:08 +00:00
|
|
|
PDNS_API_URL = "API URL"
|
2019-03-08 18:47:06 +00:00
|
|
|
[Configuration.Additional]
|
2024-01-27 22:23:10 +00:00
|
|
|
PDNS_SERVER_NAME = "Name of the server in the URL, 'localhost' by default"
|
|
|
|
|
PDNS_API_VERSION = "Skip API version autodetection and use the provided version number."
|
2019-03-08 18:47:06 +00:00
|
|
|
PDNS_POLLING_INTERVAL = "Time between DNS propagation check"
|
|
|
|
|
PDNS_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation"
|
|
|
|
|
PDNS_TTL = "The TTL of the TXT record used for the DNS challenge"
|
|
|
|
|
PDNS_HTTP_TIMEOUT = "API request timeout"
|
|
|
|
|
|
|
|
|
|
[Links]
|
|
|
|
|
API = "https://doc.powerdns.com/md/httpapi/README/"
|
