Skip to main content

Certbot plugin for authentication using bonk

Project description

Certbot plugin for completing DNS challenges using bonk

This is a plugin for Certbot that uses bonk's API to authenticate certificate requests using the dns-01 challenge.

Usage

  1. Install the plugin and certbot: pip3 install certbot certbot-dns-bonk

  2. Create a bonk.ini file containing your credentials, the URL to your bonk instance, and the group that your user is in to maintain control of the records:

    certbot_dns_bonk:dns_bonk_endpoint=https://SOCRATES/bonk
    certbot_dns_bonk:dns_bonk_username=USERNAME
    certbot_dns_bonk:dns_bonk_password=PASSWORD
    certbot_dns_bonk:dns_bonk_group=GROUP
    certbot_dns_bonk:dns_bonk_cleanup_action=record
    

    If cleanup_action is record, records will be deleted after each run. If your user lacks permission to create records on its own in the zones, set this to value instead, which will only delete the values it has added.

    Make sure this file is only readable by the user running certbot, typically root.

  3. Run certbot using the plugin, e.g.

    certbot certonly -a certbot-dns-bonk:dns-bonk --certbot-dns-bonk:dns-bonk-credentials /PATH/TO/bonk.ini -d DOMAIN
    
  4. Set up automatic renewal as a cron job, e.g.

    certbot renew -q -a certbot-dns-bonk:dns-bonk --certbot-dns-bonk:dns-bonk-credentials /PATH/TO/bonk.ini -d DOMAIN
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for certbot-dns-bonk, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size certbot_dns_bonk-0.2.1-py3-none-any.whl (8.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size certbot-dns-bonk-0.2.1.tar.gz (3.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page