PowerDNS DCV Provisioner

Prerequisites

You need a PowerDNS Authoritative Server instance with the REST API enabled.
You need to retrieve the API key configured in the PowerDNS server (api-key setting).
The API key must have write access to the target DNS zones.

1. Log in to Horizon Administration Interface.

2. Access DCV Provisioners from the drawer or card: DCV Provisioners.

3. Click on Add Provisioner .

4. Fill in the mandatory fields.

Name* (string input):
Enter a meaningful provisioner name. It must be unique for each DCV provisioner. Horizon uses the name to identify the provisioner.
Type* (select):
Select the DNS provider type. Additional configuration fields are displayed depending on the selected type.

Timeout* (finite duration):
Maximum time Horizon waits for a response from the DNS provider.
TTL* (finite duration):
TTL applied to the DNS TXT record created for the validation challenge.
Proxy (select):
The HTTP/HTTPS proxy to use to reach the DNS provider, if any.

Endpoint* (string input):
Enter the PowerDNS API base URL (e.g. http://pdns-host:8081/api/v1).
Credentials* (select):
Select API Token credentials containing the PowerDNS API key.

See DCV Provisioners for a full explanation of zone ID mappings.

Click on Add Zone ID Mapping .

Zone ID* (string input):
PowerDNS zone identifier (e.g. `example.com.`).
Domain pattern* (regex):
Regex matching domain names that belong to this zone.

You can delete Delete mapping a mapping.

See DCV Provisioners for a full explanation of delegation zones.

Delegation zone (string input):
Optional DNS subdomain delegated to dedicated nameservers for DCV. When set, challenge records are published here instead of the domain’s authoritative zone.

5. Click on the save button.

You can edit Edit Provisioner or delete Delete Provisioner the PowerDNS DCV Provisioner.

You cannot delete a DCV Provisioner that is referenced by an existing DCV Policy.