certbot-dns-nextlayer

nextlayer DNS Authenticator plugin for Certbot


License
MIT
Install
pip install certbot-dns-nextlayer==1.1.2

Documentation

certbot-dns-nextlayer

Tests Upload Python Package Python Version PyPi Status Version

next layer 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

pip install --upgrade certbot # optional
pip install certbot-dns-nextlayer

Verify:

$ certbot plugins --text

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
* dns-nextlayer
Description: Obtain certificates using a DNS TXT record by using the nextlayer
dns api.
Interfaces: IAuthenticator, IPlugin
Entry point: dns-nextlayer = certbot_dns_nextlayer.dns_nextlayer:Authenticator

...
...

Configuration

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

dns_nextlayer_token=put_your_token_here

Usage

Example command

certbot certonly --authenticator dns-nextlayer --dns-nextlayer-credentials=~/nldns-credentials.ini -d nextlayer.at

Zone detection method

We've added the configuration parameter --dns-nextlayer-method to select the way our certbot plugin determines the correct zone to add the record to. Currently there are 3 options you can choose from.

intelligent

This is the default method.
It tries to determine the zone intelligently by extracting the TLD and re-adding the first level.

Examples:
* dns.nextlayer.at: nextlayer.at
* dns.nextlayer.co.at: nextlayer.co.at
* www.dns.nextlayer.co.at: nextlayer.co.at

remove-first

This method just removes the first level of the requested domain.

Examples:
* dns.nextlayer.at: nextlayer.at
* dns.nextlayer.co.at: nextlayer.co.at
* www.dns.nextlayer.co.at: dns.nextlayer.co.at

none

This method does what it's called. No magic.

Examples:
* dns.nextlayer.at: dns.nextlayer.at
* dns.nextlayer.co.at: dns.nextlayer.co.at
* www.dns.nextlayer.co.at: www.dns.nextlayer.co.at