certbot-dns-dynu

certbot-dns-dynu

Dynu DNS Authenticator plugin for Certbot.

This plugin is built from the ground up and follows the development style and life-cycle of other certbot-dns-* plugins found in the Official Certbot Repository.

Installation

• Install

  pip install --upgrade certbot
  pip install certbot-dns-dynu
  

• Verify

  $ certbot plugins --text
  
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  * dns-dynu
  Description: Obtain certificates using a DNS TXT record (if you are using Dynu
  for DNS.)
  Interfaces: Authenticator, Plugin
  Entry point: dns-dynu = certbot_dns_dynu.dns_dynu:Authenticator
  
  ...
  ...
  

Configuration

• The credentials file e.g. ~/dynu-credentials.ini should look like this:

  dns_dynu_auth_token = AbCbASsd!@34
  

Usage

• Command line args for certbot

  certbot ... \
  --authenticator dns-dynu  \
  --dns-dynu-credentials ~/dynu-credentials.ini \
  ...
  

• Example

  certbot certonly \
  --authenticator dns-dynu --dns-dynu-credentials ./test/dynu-credentials.ini
  

FAQ

• Why such long name for a plugin? This follows the upstream nomenclature: certbot-dns-<dns-provider>.

• Why do I have to use : separator in the name? And why are the configuration file parameters so weird? This is a limitation of the certbot interface towards third-party plugins.

• For details read the discussions:

  • https://github.com/certbot/certbot/issues/6504#issuecomment-473462138
  • https://github.com/certbot/certbot/issues/6040
  • https://github.com/certbot/certbot/issues/4351
  • https://github.com/certbot/certbot/pull/6372

Development

Local

• Create a virtual env, install the plugin (editable mode), spawn the environment and run the test:

  python3 -m venv .venv
  . .venv/bin/activate
  python -m pip install --upgrade pip
  pip install -e .
  ./test/run_certonly.sh <action> "<domain> " "<email>"
  

Dev Container

• Install ms-vscode-remote.remote-containers plugin in vscode
• Press Ctrl + Shift + p or Cmd + Shift + p
• Type Reopen in Container
• Select the option from Dev Container
• vscode will pull all the required dependencies and setup the environment for development

License

Copyright (c) 2021 Bikramjeet Singh

Credits

PowerDNS

dns-lexicon

Helpful links

DNS Plugin list

acme.sh

dynu with acme.sh

dynu api