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.

Source Distribution

certbot-dns-bonk-0.2.1.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

certbot_dns_bonk-0.2.1-py3-none-any.whl (8.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page