A simple DNS hook that lets Dehydrated talk to the PowerDNS API.
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.
Silke 64df07654c Fix and cleanup fatal errors 7 månader sedan
tests Add test for soa_edit command 7 månader sedan
.gitignore Add default test config 9 månader sedan
.travis.yml Add Travis config 9 månader sedan
LICENSE.md Update licence to EUPL v1.2 1 år sedan
README.md Update link to SOA-EDIT documentation 7 månader sedan
pdns_api.sh Fix and cleanup fatal errors 7 månader sedan
test.sh Add Travis config 9 månader sedan

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]