Version: v0.4.1 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Sep 26, 2017 License: MIT Imports: 7 Imported by: 0



Package rfc2136 implements a DNS provider for solving the DNS-01 challenge using the rfc2136 dynamic update.



This section is empty.


This section is empty.


This section is empty.


type DNSProvider

type DNSProvider struct {
	// contains filtered or unexported fields

DNSProvider is an implementation of the acme.ChallengeProvider interface that uses dynamic DNS updates (RFC 2136) to create TXT records on a nameserver.

func NewDNSProvider

func NewDNSProvider() (*DNSProvider, error)

NewDNSProvider returns a DNSProvider instance configured for rfc2136 dynamic update. Configured with environment variables: RFC2136_NAMESERVER: Network address in the form "host" or "host:port". RFC2136_TSIG_ALGORITHM: Defaults to hmac-md5.sig-alg.reg.int. (HMAC-MD5). See https://github.com/miekg/dns/blob/master/tsig.go for supported values. RFC2136_TSIG_KEY: Name of the secret key as defined in DNS server configuration. RFC2136_TSIG_SECRET: Secret key payload. RFC2136_TIMEOUT: DNS propagation timeout in time.ParseDuration format. (60s) To disable TSIG authentication, leave the RFC2136_TSIG* variables unset.

func NewDNSProviderCredentials added in v0.3.1

func NewDNSProviderCredentials(nameserver, tsigAlgorithm, tsigKey, tsigSecret, timeout string) (*DNSProvider, error)

NewDNSProviderCredentials uses the supplied credentials to return a DNSProvider instance configured for rfc2136 dynamic update. To disable TSIG authentication, leave the TSIG parameters as empty strings. nameserver must be a network address in the form "host" or "host:port".

func (*DNSProvider) CleanUp

func (r *DNSProvider) CleanUp(domain, token, keyAuth string) error

CleanUp removes the TXT record matching the specified parameters

func (*DNSProvider) Present

func (r *DNSProvider) Present(domain, token, keyAuth string) error

Present creates a TXT record using the specified parameters

func (*DNSProvider) Timeout added in v0.4.1

func (d *DNSProvider) Timeout() (timeout, interval time.Duration)

Returns the timeout configured with RFC2136_TIMEOUT, or 60s.

Source Files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL