Websupport DNS Authenticator plugin for Certbot
Project description
Certbot plugin for authentication using Websupport REST API
This is a plugin for Certbot that uses the Websupport REST API to allow Websupport customers to prove control of a domain name.
Usage
-
Obtain an API key and API secret (see Account Page)
-
Install the plugin using
pip install certbot-plugin-websupport
-
Create a
websupport.ini
config file with the following contents and applychmod 600 websupport.ini
on it:certbot-plugin-websupport:dns_api_key = APIKEY certbot-plugin-websupport:dns_api_secret = SECRET
Replace
APIKEY
with your Websupport API key,SECRET
with your API secret and ensure permissions are set to disallow access to other users. -
Run
certbot
and direct it to use the plugin for authentication and to use the config file previously created:certbot certonly -a certbot-plugin-websupport:dns --certbot-plugin-websupport:dns-credentials websupport.ini -d domain.com
Add additional options as required to specify an installation plugin etc.
Please note that this solution is usually not relevant if you're using Websupport's web hosting services as Websupport offers free automated certificates for all simplehosting plans having SSL in the admin interface.
Updates
This plugin can be updated by running:
pip install certbot-plugin-websupport --upgrade
Wildcard certificates
This plugin is particularly useful when you need to obtain a wildcard certificate using dns challenges:
certbot certonly -a certbot-plugin-websupport:dns --certbot-plugin-websupport:dns-credentials websupport.ini -d domain.com -d \*.domain.com --server https://acme-v02.api.letsencrypt.org/directory
Automatic renewal
You can setup automatic renewal using crontab
with the following job for weekly renewal attempts:
0 0 * * 0 certbot renew -q -a certbot-plugin-websupport:dns --certbot-plugin-websupport:dns-credentials /etc/letsencrypt/websupport/websupport.ini --server https://acme-v02.api.letsencrypt.org/directory
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for certbot_plugin_websupport-0.1.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d2a6d80402787339b5928921f11d7745f022813c6fff8d6b28318c3c9fae3fe8 |
|
MD5 | 9794c66907f16e5b0ac6865e5cc067c9 |
|
BLAKE2b-256 | 2422735b7fde4200038c96ecb67a8b5243da6152dad070ca4eec28a15a209f27 |