A Synergy Wholesale DNS plugin for Cerbot to authenticate and retrieve Lets Encrypt certificates
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for certbot_dns_synergy_wholesale-1.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 34c1ad2489f17761be488b1a0be6b590ffa8aaa1f3fa0cb25c5088f3cffb96d3 |
|
MD5 | 6f37374099bf9f1ff2dfd9629f2a446f |
|
BLAKE2b-256 | b25e75ea8f1e636143bec9e1f577f906ee8f835cf2996fd8f9476ac660146aac |
Hashes for certbot_dns_synergy_wholesale-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7668e0f9d9038282a0d540b406a524ca6649453db28eb614d1e5e535f483b0d9 |
|
MD5 | 9d57e20ccc0c74451f6c434ca0471677 |
|
BLAKE2b-256 | 8ff2b2daa65e82d6b0fcab3ece79ecf0fa5890763af08005edf2f5b9ed8b31a6 |