Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

README.rst

Loopia DNS Authenticator for Certbot

This allows automatic completion of Certbot's DNS01 challange for domains managed on Loopia DNS.

Installing

$ sudo pip install certbot-loopia

Note that you should normally install this as root, unless you know what you are doing.

Usage

The plugin requires the following permissions enabled for your Loopia API user:

  • addSubdomain (I can't test if it's required)
  • addZoneRecord
  • getZoneRecords
  • removeSubdomain
  • removeZoneRecord

To use the authenticator you need to provide some required options:

--certbot-loopia:credentials (required)
INI file with user and password for your Loopia API user. user normally has the format user@loopiaapi.

The credentials file must have the folling format:

certbot_loopia:auth_user = user@loopiaapi
certbot_loopia:auth_password = passwordgoeshere

For safety reasons the file must not be world readable. You can solve this by running:

$ chmod 600 credentials.ini

Then you can run certbot using:

$ sudo certbot certonly \
    --authenticator certbot-loopia:auth \
    --certbot-loopia:auth-credentials credentials.ini \
    -d domain.com

If you want to obtain a wildcard certificate you can use the --server https://acme-v02.api.letsencrypt.org/directory flag and the domain -d *.domain.com.

Known issues

  • Due to caching on Loopia's side it can take up to 15 minutes before changes propagates. Therefore the plugin will wait 15 minutes before contacting the ACME server.

Changelog

Version 0.2.0

Released 21st August 2017

  • Rewrote plugin to match the implementation of certbot-dns-* plugins
  • Updated dependency requirements since the old release was completely broken for newer acme and certbot (see issue #2)

Version 0.1.0

Released 10th May 2017

  • Initial release

Disclaimer

This plugin is neither affiliated with nor endorsed by Loopia AB.

About

Loopia DNS authentication plugin for Certbot

Topics

Resources

License

Releases

No releases published

Languages

You can’t perform that action at this time.