Skip to content

About

Certbot DNS plugin for DNScale (dns-01 challenge)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

Repository files navigation

certbot-dns-dnscale

DNScale DNS Authenticator plugin for certbot.

Automates Let's Encrypt DNS-01 challenges by creating and cleaning up TXT records via the DNScale API.

Installation

pip install certbot-dns-dnscale

Or install from source:

pip install git+https://github.com/dnscaleou/certbot-dns-dnscale.git

Credentials

Create an API key at dnscale.eu with the following scopes:

  • zones:read
  • records:read
  • records:write

Save it to a credentials file:

# /etc/letsencrypt/dnscale.ini
dns_dnscale_api_token = your-api-token-here

Restrict permissions:

chmod 600 /etc/letsencrypt/dnscale.ini

Usage

Obtain a certificate

certbot certonly \
  --authenticator dns-dnscale \
  --dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
  -d example.com \
  -d "*.example.com"

Renew certificates

certbot renew

Certbot remembers the authenticator used for each certificate and will automatically use the DNScale plugin for renewal.

Propagation delay

By default, the plugin waits 60 seconds for DNS propagation. Adjust if needed:

certbot certonly \
  --authenticator dns-dnscale \
  --dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
  --dns-dnscale-propagation-seconds 120 \
  -d example.com

Docker

docker run --rm \
  -v /etc/letsencrypt:/etc/letsencrypt \
  certbot/certbot \
  pip install certbot-dns-dnscale && \
  certbot certonly \
    --authenticator dns-dnscale \
    --dns-dnscale-credentials /etc/letsencrypt/dnscale.ini \
    -d example.com

Configuration

Option Description Default
--dns-dnscale-credentials Path to credentials INI file Required
--dns-dnscale-propagation-seconds Seconds to wait for DNS propagation 60

Credentials file options

Key Description Required
dns_dnscale_api_token DNScale API token Yes
dns_dnscale_api_url API base URL No (default: https://api.dnscale.eu)

License

Apache License 2.0. See LICENSE.

About

Certbot DNS plugin for DNScale (dns-01 challenge)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages