Metadata-Version: 2.1
Name: certbot-dns-njalla
Version: 0.0.4
Summary: Njalla DNS Authenticator plugin for Certbot
Home-page: UNKNOWN
Author: Chaptergy
Author-email: 26956711+chaptergy@users.noreply.github.com
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Networking
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: acme (>=0.31.0)
Requires-Dist: certbot (>=0.31.0)
Requires-Dist: dns-lexicon (>=3.4.1)
Requires-Dist: dnspython
Requires-Dist: mock
Requires-Dist: setuptools
Requires-Dist: zope.interface
Requires-Dist: requests

# Certbot plugin for authentication using Njalla

This is a plugin for [Certbot](https://certbot.eff.org/) that uses the [Njalla](https://njal.la/) API
to allow customers to prove control of a domain name.

## Usage

1. Obtain an Njalla API token (found in the [settings](https://njal.la/settings/api/))

2. Install the plugin using `pip3 install certbot-dns-njalla`, or if you are using `sudo` with certbot use `sudo -H pip3 install certbot-dns-njalla`

3. Create a `njalla.ini` config file with the following contents and apply `chmod 600 njalla.ini` on it:

   ```
   certbot_dns_njalla:dns_njalla_token=0000000000000000000000000000000000000000
   ```

   Replace the zeroes with your Njalla API key and ensure permissions are set
   to disallow access to other users.

4. Run `certbot` and direct it to use the plugin for authentication and to use
   the config file previously created:
   ```
   certbot certonly -a certbot-dns-njalla:dns-njalla --certbot-dns-njalla:dns-njalla-credentials njalla.ini -d domain.com
   ```
   Add additional options as required to specify an installation plugin etc.

## Distribution

- PyPI: https://pypi.org/project/certbot-dns-njalla/


