Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions cmd/zz_gen_cmd_dnshelp.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 5 additions & 5 deletions docs/content/dns/zz_gen_hetzner.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

67 changes: 67 additions & 0 deletions docs/content/dns/zz_gen_hetznerv1.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

173 changes: 76 additions & 97 deletions providers/dns/hetzner/hetzner.go
Original file line number Diff line number Diff line change
Expand Up @@ -2,28 +2,28 @@
package hetzner

import (
"context"
"errors"
"fmt"
"net/http"
"os"
"time"

"github.com/go-acme/lego/v4/challenge"
"github.com/go-acme/lego/v4/challenge/dns01"
"github.com/go-acme/lego/v4/platform/config/env"
"github.com/go-acme/lego/v4/providers/dns/hetzner/internal"
"github.com/go-acme/lego/v4/providers/dns/hetzner/internal/hetznerv1"
"github.com/go-acme/lego/v4/providers/dns/hetzner/internal/legacy"
)

// Environment variables names.
const (
envNamespace = "HETZNER_"

EnvAPIKey = envNamespace + "API_KEY"

EnvTTL = envNamespace + "TTL"
EnvPropagationTimeout = envNamespace + "PROPAGATION_TIMEOUT"
EnvPollingInterval = envNamespace + "POLLING_INTERVAL"
EnvHTTPTimeout = envNamespace + "HTTP_TIMEOUT"
// Deprecated: use EnvAPIToken instead.
EnvAPIKey = legacy.EnvAPIKey
EnvAPIToken = hetznerv1.EnvAPIToken

EnvTTL = hetznerv1.EnvTTL
EnvPropagationTimeout = hetznerv1.EnvPropagationTimeout
EnvPollingInterval = hetznerv1.EnvPollingInterval
EnvHTTPTimeout = hetznerv1.EnvHTTPTimeout
)

const minTTL = 60
Expand All @@ -32,7 +32,11 @@ var _ challenge.ProviderTimeout = (*DNSProvider)(nil)

// Config is used to configure the creation of the DNSProvider.
type Config struct {
APIKey string
// Deprecated: use APIToken instead
APIKey string

APIToken string

PropagationTimeout time.Duration
PollingInterval time.Duration
TTL int
Expand All @@ -53,22 +57,40 @@ func NewDefaultConfig() *Config {

// DNSProvider implements the challenge.Provider interface.
type DNSProvider struct {
config *Config
client *internal.Client
provider challenge.ProviderTimeout
}

// NewDNSProvider returns a DNSProvider instance configured for hetzner.
// Credentials must be passed in the environment variable: HETZNER_API_KEY.
func NewDNSProvider() (*DNSProvider, error) {
values, err := env.Get(EnvAPIKey)
if err != nil {
return nil, fmt.Errorf("hetzner: %w", err)
}
_, foundAPIToken := os.LookupEnv(EnvAPIToken)
_, foundAPIKey := os.LookupEnv(EnvAPIKey)

config := NewDefaultConfig()
config.APIKey = values[EnvAPIKey]
switch {
case foundAPIToken:
provider, err := hetznerv1.NewDNSProvider()
if err != nil {
return nil, err
}

return NewDNSProviderConfig(config)
return &DNSProvider{provider: provider}, nil

case foundAPIKey:
provider, err := legacy.NewDNSProvider()
if err != nil {
return nil, err
}

return &DNSProvider{provider: provider}, nil

default:
provider, err := hetznerv1.NewDNSProvider()
if err != nil {
return nil, err
}

return &DNSProvider{provider: provider}, nil
}
}

// NewDNSProviderConfig return a DNSProvider instance configured for hetzner.
Expand All @@ -77,98 +99,55 @@ func NewDNSProviderConfig(config *Config) (*DNSProvider, error) {
return nil, errors.New("hetzner: the configuration of the DNS provider is nil")
}

if config.APIKey == "" {
return nil, errors.New("hetzner: credentials missing")
}
switch {
case config.APIToken != "":
cfg := &hetznerv1.Config{
APIToken: config.APIToken,
PropagationTimeout: config.PropagationTimeout,
PollingInterval: config.PollingInterval,
TTL: config.TTL,
HTTPClient: config.HTTPClient,
}

if config.TTL < minTTL {
return nil, fmt.Errorf("hetzner: invalid TTL, TTL (%d) must be greater than %d", config.TTL, minTTL)
}
provider, err := hetznerv1.NewDNSProviderConfig(cfg)
if err != nil {
return nil, err
}

return &DNSProvider{provider: provider}, nil

client := internal.NewClient(config.APIKey)
case config.APIKey != "":
cfg := &legacy.Config{
APIKey: config.APIKey,
PropagationTimeout: config.PropagationTimeout,
PollingInterval: config.PollingInterval,
TTL: config.TTL,
HTTPClient: config.HTTPClient,
}

if config.HTTPClient != nil {
client.HTTPClient = config.HTTPClient
provider, err := legacy.NewDNSProviderConfig(cfg)
if err != nil {
return nil, err
}

return &DNSProvider{provider: provider}, nil
}

return &DNSProvider{config: config, client: client}, nil
return nil, errors.New("hetzner: credentials missing")
}

// Timeout returns the timeout and interval to use when checking for DNS propagation.
// Adjusting here to cope with spikes in propagation times.
func (d *DNSProvider) Timeout() (timeout, interval time.Duration) {
return d.config.PropagationTimeout, d.config.PollingInterval
return d.provider.Timeout()
}

// Present creates a TXT record to fulfill the dns-01 challenge.
func (d *DNSProvider) Present(domain, token, keyAuth string) error {
info := dns01.GetChallengeInfo(domain, keyAuth)

authZone, err := dns01.FindZoneByFqdn(info.EffectiveFQDN)
if err != nil {
return fmt.Errorf("hetzner: could not find zone for domain %q: %w", domain, err)
}

zone := dns01.UnFqdn(authZone)

ctx := context.Background()

zoneID, err := d.client.GetZoneID(ctx, zone)
if err != nil {
return fmt.Errorf("hetzner: %w", err)
}

subDomain, err := dns01.ExtractSubDomain(info.EffectiveFQDN, zone)
if err != nil {
return fmt.Errorf("hetzner: %w", err)
}

record := internal.DNSRecord{
Type: "TXT",
Name: subDomain,
Value: info.Value,
TTL: d.config.TTL,
ZoneID: zoneID,
}

if err := d.client.CreateRecord(ctx, record); err != nil {
return fmt.Errorf("hetzner: failed to add TXT record: fqdn=%s, zoneID=%s: %w", info.EffectiveFQDN, zoneID, err)
}

return nil
return d.provider.Present(domain, token, keyAuth)
}

// CleanUp removes the TXT record matching the specified parameters.
func (d *DNSProvider) CleanUp(domain, token, keyAuth string) error {
info := dns01.GetChallengeInfo(domain, keyAuth)

authZone, err := dns01.FindZoneByFqdn(info.EffectiveFQDN)
if err != nil {
return fmt.Errorf("hetzner: could not find zone for domain %q: %w", domain, err)
}

zone := dns01.UnFqdn(authZone)

ctx := context.Background()

zoneID, err := d.client.GetZoneID(ctx, zone)
if err != nil {
return fmt.Errorf("hetzner: %w", err)
}

subDomain, err := dns01.ExtractSubDomain(info.EffectiveFQDN, zone)
if err != nil {
return fmt.Errorf("hetzner: %w", err)
}

record, err := d.client.GetTxtRecord(ctx, subDomain, info.Value, zoneID)
if err != nil {
return fmt.Errorf("hetzner: %w", err)
}

if err := d.client.DeleteRecord(ctx, record.ID); err != nil {
return fmt.Errorf("hetzner: failed to delete TXT record: id=%s, name=%s: %w", record.ID, record.Name, err)
}

return nil
return d.provider.CleanUp(domain, token, keyAuth)
}
10 changes: 5 additions & 5 deletions providers/dns/hetzner/hetzner.toml
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,18 @@ Code = "hetzner"
Since = "v3.7.0"

Example = '''
HETZNER_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
HETZNER_API_TOKEN="xxxxxxxxxxxxxxxxxxxxx" \
lego --email [email protected] --dns hetzner -d '*.example.com' -d example.com run
'''

[Configuration]
[Configuration.Credentials]
HETZNER_API_KEY = "API key"
HETZNER_API_TOKEN = "API token"
[Configuration.Additional]
HETZNER_POLLING_INTERVAL = "Time between DNS propagation check in seconds (Default: 2)"
HETZNER_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation in seconds (Default: 120)"
HETZNER_TTL = "The TTL of the TXT record used for the DNS challenge in seconds (Default: 60)"
HETZNER_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation in seconds (Default: 60)"
HETZNER_TTL = "The TTL of the TXT record used for the DNS challenge in seconds (Default: 120)"
HETZNER_HTTP_TIMEOUT = "API request timeout in seconds (Default: 30)"

[Links]
API = "https://dns.hetzner.com/api-docs"
API = "https://docs.hetzner.cloud/reference/cloud#dns"
Loading