Documentation

Overview

    Package pdns implements a DNS provider for solving the DNS-01 challenge using PowerDNS nameserver.

    Index

    Constants

    View Source
    const (
    	EnvAPIKey = envNamespace + "API_KEY"
    	EnvAPIURL = envNamespace + "API_URL"
    
    	EnvTTL                = envNamespace + "TTL"
    	EnvPropagationTimeout = envNamespace + "PROPAGATION_TIMEOUT"
    	EnvPollingInterval    = envNamespace + "POLLING_INTERVAL"
    	EnvHTTPTimeout        = envNamespace + "HTTP_TIMEOUT"
    )

      Environment variables names.

      Variables

      This section is empty.

      Functions

      This section is empty.

      Types

      type Config

      type Config struct {
      	APIKey             string
      	Host               *url.URL
      	PropagationTimeout time.Duration
      	PollingInterval    time.Duration
      	TTL                int
      	HTTPClient         *http.Client
      }

        Config is used to configure the creation of the DNSProvider.

        func NewDefaultConfig

        func NewDefaultConfig() *Config

          NewDefaultConfig returns a default configuration for the DNSProvider.

          type DNSProvider

          type DNSProvider struct {
          	// contains filtered or unexported fields
          }

            DNSProvider implements the challenge.Provider interface.

            func NewDNSProvider

            func NewDNSProvider() (*DNSProvider, error)

              NewDNSProvider returns a DNSProvider instance configured for pdns. Credentials must be passed in the environment variable: PDNS_API_URL and PDNS_API_KEY.

              func NewDNSProviderConfig

              func NewDNSProviderConfig(config *Config) (*DNSProvider, error)

                NewDNSProviderConfig return a DNSProvider instance configured for pdns.

                func (*DNSProvider) CleanUp

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

                  CleanUp removes the TXT record matching the specified parameters.

                  func (*DNSProvider) Present

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

                    Present creates a TXT record to fulfill the dns-01 challenge.

                    func (*DNSProvider) Timeout

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

                      Timeout returns the timeout and interval to use when checking for DNS propagation. Adjusting here to cope with spikes in propagation times.

                      type Record

                      type Record struct {
                      	Content  string `json:"content"`
                      	Disabled bool   `json:"disabled"`
                      
                      	// pre-v1 API
                      	Name string `json:"name"`
                      	Type string `json:"type"`
                      	TTL  int    `json:"ttl,omitempty"`
                      }

                      Source Files