certbot-dns-synergy-wholesale

A Synergy Wholesale DNS plugin for Cerbot to authenticate and retrieve Lets Encrypt certificates


Keywords
acme, acme-dns, certbot-dns, certbot-dns-authenticator, certbot-plugin, lets-encrypt, letsencrypt, letsencrypt-plugin, synergywholesale
License
Apache-2.0
Install
pip install certbot-dns-synergy-wholesale==1.0.3

Documentation

certbot-dns-synergy-wholesale

A Synergy Wholesale DNS plugin for Cerbot to authenticate and retrieve Lets Encrypt certificates. Automates the process of completing a dns-01 challenge by creating, and subsequently removing, TXT records

Installation

# create a virtual environment, to avoid conflicts
python3 -m venv /some/path

# use the pip in the virtual environment to install or update
/some/path/bin/pip install -U certbot-dns-synergy-wholesale

# use the cerbot from the virtualenv, to avoid accidentally
# using one from a different environment that does not have this library
/some/path/bin/certbot

Named Arguments

To start using DNS authentication for Synergy Wholesale, pass the following arguments on certbot's command line:

Option Description
--authenticator dns-synergy-wholesale select the authenticator plugin (Required)
--dns-synergy-wholesale-credentials FILE credentials INI file. (Required)

Credentials

Use of this plugin requires a configuration file containing API credentials, obtained from your manage.synergywholesale.com.

Warning: You must whitelist the IP address from where certbot will run, Otherwise you'll run into API errors.

Remember this file will need to have 600 permissions.

An example credentials.ini file:

dns_synergy_wholesale_reseller_id = 1
dns_synergy_wholesale_api_key = abc123

Examples

To acquire a single certificate for both example.com and *.example.com

certbot certonly \
  --authenticator dns-synergy-wholesale \
  --dns-synergy-wholesale-credentials /path/to/credentials.ini \
  -d 'example.com' \
  -d '*.example.com'

You can also add addtional paramaters such as --keep-until-expiring --non-interactive --expand for automation. More information here

Docker

You can build a docker image from source using the included Dockerfile or pull the latest version directly from Docker Hub:

docker pull alamellama/certbot-dns-synergy-wholesale

Once that's finished, the application can be run as follows:

docker run --rm \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  -v /etc/letsencrypt:/etc/letsencrypt \
  --cap-drop=all \
  alamellama/certbot-dns-synergy-wholesale certbot certonly \
    --authenticator dns-synergy-wholesale \
    --dns-synergy-wholesale-credentials /var/lib/letsencrypt/credentials.ini \
    --keep-until-expiring --non-interactive --expand \
    --server https://acme-v02.api.letsencrypt.org/directory \
    --agree-tos --email "webmaster@example.com" \
    -d example.com -d '*.example.com'

You may want to change the volumes /var/lib/letsencrypt and /etc/letsencrypt to local directories where the certificates and configuration should be stored.