Welcome to certbot-dns-transip’s documentation!

Contents:

certbot-dns-transip

Certbot plugin to authenticate using dns TXT records via Transip API

  • Documentation: https://readthedocs.org/projects/certbot-dns-transip/
  • Running with docker: docker run -ti -v $PWD/transip.ini:/transip.ini -v $PWD/transip-rsa.key:/transip-rsa.key hsmade/certbot-transip certonly -d <host.domain.tld> -a certbot-dns-transip:dns-transip –certbot-dns-transip:dns-transip-credentials transip.ini –certbot-dns-transip:dns-transip-propagation-seconds 240

Installation

At the command line:

$ pip install certbot-dns-transip

Or, if you have virtualenvwrapper installed:

$ mkvirtualenv certbot-dns-transip
$ pip install certbot-dns-transip

Usage

To use certbot-dns-transip in a project:

# Get an API key from TransIP

# Convert the key to an RSA key
$ openssl rsa -in transip.key -out transip-rsa.key

# make sure the rights are set correctly
$ chmod 600 transip-rsa.key

$ cat transip-rsa.key
-----BEGIN RSA PRIVATE KEY-----
MIIE........
-----END RSA PRIVATE KEY-----

# Create a transip.ini file
$ cat transip.ini
certbot_dns_transip:dns_transip_username = my_username
certbot_dns_transip:dns_transip_key_file = transip-rsa.key

# Execute certbot
$ certbot certonly -d <host.domain.tld> -a certbot-dns-transip:dns-transip --certbot-dns-transip:dns-transip-credentials transip.ini --certbot-dns-transip:dns-transip-propagation-seconds 240
# make sure to use the propagation wait time of at least 240 seconds, as Transip doesn't refresh the zones that often.

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

Submit Feedback

If you are proposing a feature:

  • Explain in detail how it would work.
  • Keep the scope as narrow as possible, to make it easier to implement.

Get Started!

Ready to contribute? Here’s how to set up certbot-dns-transip for local development.

  1. Clone your fork locally:

    $ git clone https://github.com/hsmade/certbot-dns-transip

  2. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your clone for local development:

    $ mkvirtualenv certbot-dns-transip
$ cd certbot-dns-transip/
$ python setup.py develop

  3. Create a branch for local development:

    $ git checkout -b name-of-your-bugfix-or-feature

    Now you can make your changes locally.

  4. Commit your changes and push your branch to the server:

    $ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin name-of-your-bugfix-or-feature

  5. Submit a merge request

certbot_dns_transip

certbot_dns_transip package

Submodules

certbot_dns_transip.dns_transip module

certbot DNS plugin for Transip

class certbot_dns_transip.dns_transip.Authenticator(*args, **kwargs)[source]

Bases: certbot.plugins.dns_common.DNSAuthenticator

DNS Authenticator for Transip

This Authenticator uses the Transip API to fulfill a dns-01 challenge.

classmethod add_parser_arguments(add, **kwargs)[source]

Add plugin arguments to the CLI argument parser.

NOTE: If some of your flags interact with others, you can use cli.report_config_interaction to register this to ensure values are correctly saved/overridable during renewal.

Parameters:add (callable) – Function that proxies calls to argparse.ArgumentParser.add_argument prepending options with unique plugin name prefix.
description = 'Obtain certs using a DNS TXT record (if you are using Transip for DNS).'
more_info()[source]

Module contents

certbot_dns_transip package

Imports all parts from certbot_dns_transip here

Credits

Development Lead

Contributors

None yet. Why not be the first?

History

0.2.6 (21-03-2020)

  • updated transip lib

0.1.4 (18-01-2019)

  • Added docker image + instructions

0.1.2 (12-11-2018)

  • Updated the API for transip to current version

0.1 (14-07-2017)

Indices and tables