powerdns

README

PowerDNS module for Caddy

This package contains a DNS provider module for Caddy. It can be used to manage DNS records with a PowerDNS.

Caddy module name

dns.providers.powerdns

Config examples

To use this module for the ACME DNS challenge, configure the ACME issuer in your Caddy JSON like so:

{
	"module": "acme",
	"challenges": {
		"dns": {
			"provider": {
				"name": "powerdns",
				"server_url": "{env.POWERDNS_SERVER_URL}",
				"api_token": "{env.POWERDNS_API_TOKEN}"
			}
		}
	}
}

or with the Caddyfile:

tls {
	dns powerdns {env.POWERDNS_SERVER_URL} {env.POWERDNS_API_TOKEN}
}

You can replace {env.POWERDNS_SERVER_URL} and {env.POWERDNS_API_TOKEN} with the actual server URL and API token if you prefer to put it directly in your config instead of an environment variable.

Documentation

Index

• type Provider
  • func (Provider) CaddyModule() caddy.ModuleInfo
  • func (p *Provider) Provision(ctx caddy.Context) error
  • func (p *Provider) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

Types

type Provider

type Provider struct{ *powerdns.Provider }

Provider wraps the provider implementation as a Caddy module.

func (Provider) CaddyModule

func (Provider) CaddyModule() caddy.ModuleInfo

CaddyModule returns the Caddy module information.

func (*Provider) Provision

func (p *Provider) Provision(ctx caddy.Context) error

Provision implements the Provisioner interface to initialize the PowerDNS client

func (*Provider) UnmarshalCaddyfile

func (p *Provider) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

UnmarshalCaddyfile sets up the DNS provider from Caddyfile tokens. Syntax:

powerdns {
    server_url <string>
    api_token <string>
    server_id <string>
}