A simple DNS hook that lets Dehydrated talk to the PowerDNS API.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Silke 64df07654c Fix and cleanup fatal errors 7 月之前
tests Add test for soa_edit command 7 月之前
.gitignore Add default test config 9 月之前
.travis.yml Add Travis config 9 月之前
LICENSE.md Update licence to EUPL v1.2 1 年之前
README.md Update link to SOA-EDIT documentation 7 月之前
pdns_api.sh Fix and cleanup fatal errors 7 月之前
test.sh Add Travis config 9 月之前

README.md

pdns_api.sh

Build Status

A simple DNS hook that lets Dehydrated talk to the PowerDNS API.

Usage

Configuration

Add the settings for your PowerDNS API to Dehydrated’s config (in /etc/dehydrated or /usr/local/etc/dehydrated), or a config file next to pdns_api.sh:

PDNS_HOST=ns0.example.com # API Host. Can also be a URL, eg: http://ns0.example.com:8081
PDNS_PORT=8081            # Optional. Defaults to 8081
PDNS_KEY=secret           # API key
PDNS_SERVER=localhost     # Optional. Server for the API to use, usually `localhost`
PDNS_VERSION=1            # Optional. API version, 0 for anything under PowerDNS 4
PDNS_WAIT=300             # Optional. Delay for when slaves are slow
PDNS_ZONES_TXT=zones.txt  # Optional. File containing zones to use (see below).
PDNS_NO_NOTIFY=yes        # Optional. Disable sending a notification after updating the zone.
PDNS_SUFFIX=v.example.com # Optional. When using a dedicated validation zone via CNAME redirection

Configure the DNS hook by adding the following to your Dehydrated config:

CHALLENGETYPE="dns-01"
HOOK="./pdns_api.sh"
HOOK_CHAIN="yes"

Nested zones and subdomains are supported. These zones should be detected automatically, but can be overridden by creating a file called zones.txt in /etc/dehydrated, /usr/local/etc/dehydrated or next to pdns_api.sh with the zones:

test.example.domain.tld
example.domain.tld
test.domain.tld

These zones can be added in any order.

Incrementing the zone’s serial

PowerDNS can automatically increment the serial in the SOA record with the SOA-EDIT metadata entry. pdns_api.sh can show and edit this entry. Usage:

pdns_api.sh soa_edit <zone> [soa-edit] [soa-edit-api]