Hook for certbot DNS challenge automatization.
Branch: master
Clone or download
Ben Kerry and nils-wisiol fix(): add compatibility for more distributions
Add compatibility for distributions where bash is not located under /bin
Licensed under MIT
Latest commit f7c4c07 Sep 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dedynauth fix(conf): simplify Aug 23, 2017
LICENSE Initial commit Apr 10, 2017
README.md fix(): hook waits until challenge published Apr 14, 2017
hook.sh fix(): add compatibility for more distributions Oct 4, 2018

README.md

dedyn.io certbot DNS challenge automatization

With the help of this hook script, you can obtain your Let's Encrypt certificate using certbot with authorization provided by the DNS challenge mechanism, that is, you will not need a running web server or any port forwarding to your local machine.

Quick Start Guide for Beginners

To obtain a certificate for your dedyn.io domain right away, follow these steps.

  1. Install certbot. There are many ways to install certbot, depending on your distribution and preference. Please follow instructions on https://certbot.eff.org/

  2. Install hook script. To authenticate your dedyn.io domain against Let's Encrypt using the DNS challenge mechanism, you will need to update your domain according to instructions provided by Let's Encrypt. The hook script in this repository automatizes this process for you. To use it, download the hook.sh and .dedynauth files and place them into a directory of your choice.

  3. Set up hook script. You need to provide your dedyn.io credentials to the hook script, so the script can update your domain information on your behalf. To do so, edit the .dedynauth file to look something like

     export DEDYN_TOKEN=9e6ad...your token...64c53bd
     export DEDYN_NAME=yourdomain.dedyn.io
    
  4. Run certbot. To obtain your certificate, run certbot in manual mode, setup to use the dedyn hook scripts you just downloaded. For detailed instructions on how to use certbot, please refer to the certbot manual. A typical use of certbot is listed below. Please notice that you need to insert your domain name one more time. (Also, for users not familiar with bash, please note that you need to remove the \ if you reformat the command to fit one line.) Depending on how you installed certbot, you may need to replace ./certbot-auto with just certbot-auto. Please also note that the hook script may wait up to two minutes to be sure that the challenge was correctly published.

      ./certbot-auto --manual \
      --text \
      --preferred-challenges dns \
      --manual-auth-hook ./hook.sh \
      -d "YOURDOMAINNAME.dedyn.io" \
      certonly
    

Contribution

Please do not hesitate to contact us with any improvements of this work. All work should be licensed under MIT license or compatible.