Metadata-Version: 2.4
Name: certbot_dns_mchost24
Version: 1.0.0
Summary: Certbot DNS Authenticator plugin for MCHost24
Author-email: JoeJoeTV <joejoetv@joejoetv.de>
License-Expression: GPL-3.0
Project-URL: Homepage, https://github.com/JoeJoeTV/certbot-dns-mchost24
Project-URL: Issues, https://github.com/JoeJoeTV/certbot-dns-mchost24/issues
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: acme>=2.9.0
Requires-Dist: certbot>=2.9.0
Requires-Dist: setuptools
Requires-Dist: mchost24
Dynamic: license-file

# MCHost24 Certbot DNS Authentication Plugin

A plugin for certbot that enables performing DNS validation using the MCHost24 API.

## Usage

1. Obtain an MCHost24 API token (e.g. using the cli tool of the `mchost24` module found [here](https://github.com/JoeJoeTV/mchost24-api-python))
2. Install the plugin
3. Create a `mchost24.ini` config file that contains the `mchost24_dns_api_token` key with the value set to the previously obtained API token:
    ```ini
    # MCHost24 API token
    mchost24_dns_api_token=<insert obtained API token here>
    ```
4. Run `certbot` and tell it to use the plugin to perform dns authentication and the config file:
    ```sh
    certbot certonly --authenticator dns-mchost24 --dns-mchost24-credentials /etc/letsencrypt/mchost24/mchost24.ini -d domain.com
    ```

## Requirements

Requires the MCHost24 API python module, which can be found [here](https://github.com/JoeJoeTV/mchost24-api-python).
