Metadata-Version: 2.4
Name: certbot-dns-git
Version: 0.0.1
Summary: Git repository-based DNS authenticator plugin for Certbot
Author: Christophe Kyvrakidis
License: Apache-2.0
Project-URL: Homepage, https://github.com/certmate/certbot-dns-git
Keywords: certbot,dns,git,acme,ssl,tls,letsencrypt
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: certbot>=2.0.0
Requires-Dist: dulwich>=1.2.0
Dynamic: license-file

certbot-dns-git
===============

Git repository-based DNS authenticator plugin for Certbot.

This plugin clones a Git repository containing BIND zone files, adds or
removes ``_acme-challenge`` TXT records for the ACME dns-01 challenge,
commits the change, and pushes it back to the remote.

Installation
------------

.. code:: bash

   pip install certbot-dns-git

Credentials file format
-----------------------

.. code:: ini

   dns_git_repo = https://github.com/example/dns-zones.git
   dns_git_token = your_git_token
   dns_git_branch = main
   dns_git_zone_path = zones/example.com
   dns_git_zone_prefix = db.
   dns_git_zone_suffix = .zone
   dns_git_git_user = certbot-bot
   dns_git_git_email = certbot@example.com

Usage
-----

.. code:: bash

   certbot certonly \\
     --authenticator dns-git \\
     --dns-git-credentials /path/to/credentials.ini \\
     -d example.com
