-
-
Notifications
You must be signed in to change notification settings - Fork 993
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add Brandit.com as DNS provider (#1890)
- Loading branch information
1 parent
3b70a85
commit 9db0465
Showing
15 changed files
with
1,050 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
--- | ||
title: "BRANDIT" | ||
date: 2019-03-03T16:39:46+01:00 | ||
draft: false | ||
slug: brandit | ||
dnsprovider: | ||
since: "v4.11.0" | ||
code: "brandit" | ||
url: "https://www.brandit.com/" | ||
--- | ||
|
||
<!-- THIS DOCUMENTATION IS AUTO-GENERATED. PLEASE DO NOT EDIT. --> | ||
<!-- providers/dns/brandit/brandit.toml --> | ||
<!-- THIS DOCUMENTATION IS AUTO-GENERATED. PLEASE DO NOT EDIT. --> | ||
|
||
|
||
Configuration for [BRANDIT](https://www.brandit.com/). | ||
|
||
|
||
<!--more--> | ||
|
||
- Code: `brandit` | ||
- Since: v4.11.0 | ||
|
||
|
||
Here is an example bash command using the BRANDIT provider: | ||
|
||
```bash | ||
BRANDIT_API_KEY=xxxxxxxxxxxxxxxxxxxxx \ | ||
BRANDIT_API_USERNAME=yyyyyyyyyyyyyyyyyyyy \ | ||
lego --email myemail@example.com --dns brandit --domains my.example.org run | ||
``` | ||
|
||
|
||
|
||
|
||
## Credentials | ||
|
||
| Environment Variable Name | Description | | ||
|-----------------------|-------------| | ||
| `BRANDIT_API_KEY` | The API key | | ||
| `BRANDIT_API_USERNAME` | The API username | | ||
|
||
The environment variable names can be suffixed by `_FILE` to reference a file instead of a value. | ||
More information [here]({{< ref "dns#configuration-and-credentials" >}}). | ||
|
||
|
||
## Additional Configuration | ||
|
||
| Environment Variable Name | Description | | ||
|--------------------------------|-------------| | ||
| `BRANDIT_HTTP_TIMEOUT` | API request timeout | | ||
| `BRANDIT_POLLING_INTERVAL` | Time between DNS propagation check | | ||
| `BRANDIT_PROPAGATION_TIMEOUT` | Maximum waiting time for DNS propagation | | ||
| `BRANDIT_TTL` | The TTL of the TXT record used for the DNS challenge | | ||
|
||
The environment variable names can be suffixed by `_FILE` to reference a file instead of a value. | ||
More information [here]({{< ref "dns#configuration-and-credentials" >}}). | ||
|
||
|
||
|
||
|
||
## More information | ||
|
||
- [API documentation](https://portal.brandit.com/apidocv3) | ||
|
||
<!-- THIS DOCUMENTATION IS AUTO-GENERATED. PLEASE DO NOT EDIT. --> | ||
<!-- providers/dns/brandit/brandit.toml --> | ||
<!-- THIS DOCUMENTATION IS AUTO-GENERATED. PLEASE DO NOT EDIT. --> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,197 @@ | ||
package brandit | ||
|
||
import ( | ||
"errors" | ||
"fmt" | ||
"net/http" | ||
"sync" | ||
"time" | ||
|
||
"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/brandit/internal" | ||
) | ||
|
||
const defaultTTL = 600 | ||
|
||
// Environment variables names. | ||
const ( | ||
envNamespace = "BRANDIT_" | ||
|
||
EnvAPIKey = envNamespace + "API_KEY" | ||
EnvAPIUsername = envNamespace + "API_USERNAME" | ||
|
||
EnvTTL = envNamespace + "TTL" | ||
EnvPropagationTimeout = envNamespace + "PROPAGATION_TIMEOUT" | ||
EnvPollingInterval = envNamespace + "POLLING_INTERVAL" | ||
EnvHTTPTimeout = envNamespace + "HTTP_TIMEOUT" | ||
DefaultBrandItPropagationTimeout = 600 * time.Second | ||
) | ||
|
||
// Config is used to configure the creation of the DNSProvider. | ||
type Config struct { | ||
APIKey string | ||
APIUsername string | ||
|
||
PropagationTimeout time.Duration | ||
PollingInterval time.Duration | ||
TTL int | ||
HTTPClient *http.Client | ||
} | ||
|
||
// NewDefaultConfig returns a default configuration for the DNSProvider. | ||
func NewDefaultConfig() *Config { | ||
return &Config{ | ||
TTL: env.GetOrDefaultInt(EnvTTL, defaultTTL), | ||
PropagationTimeout: env.GetOrDefaultSecond(EnvPropagationTimeout, DefaultBrandItPropagationTimeout), | ||
PollingInterval: env.GetOrDefaultSecond(EnvPollingInterval, dns01.DefaultPollingInterval), | ||
HTTPClient: &http.Client{ | ||
Timeout: env.GetOrDefaultSecond(EnvHTTPTimeout, 30*time.Second), | ||
}, | ||
} | ||
} | ||
|
||
// DNSProvider implements the challenge.Provider interface. | ||
type DNSProvider struct { | ||
config *Config | ||
client *internal.Client | ||
|
||
records map[string]string | ||
recordsMu sync.Mutex | ||
} | ||
|
||
// NewDNSProvider returns a DNSProvider instance configured for BrandIT. | ||
// Credentials must be passed in the environment variables: BRANDIT_API_KEY, BRANDIT_API_USERNAME. | ||
func NewDNSProvider() (*DNSProvider, error) { | ||
values, err := env.Get(EnvAPIKey, EnvAPIUsername) | ||
if err != nil { | ||
return nil, fmt.Errorf("brandit: %w", err) | ||
} | ||
|
||
config := NewDefaultConfig() | ||
config.APIKey = values[EnvAPIKey] | ||
config.APIUsername = values[EnvAPIUsername] | ||
|
||
return NewDNSProviderConfig(config) | ||
} | ||
|
||
// NewDNSProviderConfig return a DNSProvider instance configured for BrandIT. | ||
func NewDNSProviderConfig(config *Config) (*DNSProvider, error) { | ||
if config == nil { | ||
return nil, errors.New("brandit: the configuration of the DNS provider is nil") | ||
} | ||
|
||
client, err := internal.NewClient(config.APIUsername, config.APIKey) | ||
if err != nil { | ||
return nil, fmt.Errorf("brandit: %w", err) | ||
} | ||
|
||
if config.HTTPClient != nil { | ||
client.HTTPClient = config.HTTPClient | ||
} | ||
|
||
return &DNSProvider{ | ||
config: config, | ||
client: client, | ||
records: make(map[string]string), | ||
}, nil | ||
} | ||
|
||
// Present creates a TXT record using the specified parameters. | ||
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("brandit: %w", err) | ||
} | ||
|
||
subDomain, err := dns01.ExtractSubDomain(info.EffectiveFQDN, authZone) | ||
if err != nil { | ||
return fmt.Errorf("brandit: %w", err) | ||
} | ||
|
||
record := internal.Record{ | ||
Type: "TXT", | ||
Name: subDomain, | ||
Content: info.Value, | ||
TTL: d.config.TTL, | ||
} | ||
|
||
// find the account associated with the domain | ||
account, err := d.client.StatusDomain(dns01.UnFqdn(authZone)) | ||
if err != nil { | ||
return fmt.Errorf("brandit: status domain: %w", err) | ||
} | ||
|
||
// Find the next record id | ||
recordID, err := d.client.ListRecords(account.Response.Registrar[0], dns01.UnFqdn(authZone)) | ||
if err != nil { | ||
return fmt.Errorf("brandit: list records: %w", err) | ||
} | ||
|
||
result, err := d.client.AddRecord(dns01.UnFqdn(authZone), account.Response.Registrar[0], fmt.Sprint(recordID.Response.Total[0]), record) | ||
if err != nil { | ||
return fmt.Errorf("brandit: add record: %w", err) | ||
} | ||
|
||
d.recordsMu.Lock() | ||
d.records[token] = result.Record | ||
d.recordsMu.Unlock() | ||
|
||
return nil | ||
} | ||
|
||
// 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("brandit: %w", err) | ||
} | ||
|
||
// gets the record's unique ID | ||
d.recordsMu.Lock() | ||
dnsRecord, ok := d.records[token] | ||
d.recordsMu.Unlock() | ||
if !ok { | ||
return fmt.Errorf("brandit: unknown record ID for '%s' '%s'", info.EffectiveFQDN, token) | ||
} | ||
|
||
// find the account associated with the domain | ||
account, err := d.client.StatusDomain(dns01.UnFqdn(authZone)) | ||
if err != nil { | ||
return fmt.Errorf("brandit: status domain: %w", err) | ||
} | ||
|
||
records, err := d.client.ListRecords(account.Response.Registrar[0], dns01.UnFqdn(authZone)) | ||
if err != nil { | ||
return fmt.Errorf("brandit: list records: %w", err) | ||
} | ||
|
||
var recordID int | ||
for i, r := range records.Response.RR { | ||
if r == dnsRecord { | ||
recordID = i | ||
} | ||
} | ||
|
||
_, err = d.client.DeleteRecord(dns01.UnFqdn(authZone), account.Response.Registrar[0], dnsRecord, fmt.Sprint(recordID)) | ||
if err != nil { | ||
return fmt.Errorf("brandit: delete record: %w", err) | ||
} | ||
|
||
// deletes record ID from map | ||
d.recordsMu.Lock() | ||
delete(d.records, token) | ||
d.recordsMu.Unlock() | ||
|
||
return nil | ||
} | ||
|
||
// 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 | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
Name = "BRANDIT" | ||
Description = '''''' | ||
URL = "https://www.brandit.com/" | ||
Code = "brandit" | ||
Since = "v4.11.0" | ||
|
||
Example = ''' | ||
BRANDIT_API_KEY=xxxxxxxxxxxxxxxxxxxxx \ | ||
BRANDIT_API_USERNAME=yyyyyyyyyyyyyyyyyyyy \ | ||
lego --email myemail@example.com --dns brandit --domains my.example.org run | ||
''' | ||
|
||
[Configuration] | ||
[Configuration.Credentials] | ||
BRANDIT_API_KEY = "The API key" | ||
BRANDIT_API_USERNAME = "The API username" | ||
[Configuration.Additional] | ||
BRANDIT_POLLING_INTERVAL = "Time between DNS propagation check" | ||
BRANDIT_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation" | ||
BRANDIT_TTL = "The TTL of the TXT record used for the DNS challenge" | ||
BRANDIT_HTTP_TIMEOUT = "API request timeout" | ||
|
||
[Links] | ||
API = "https://portal.brandit.com/apidocv3" |
Oops, something went wrong.