Metadata-Version: 2.1
Name: certbot-dns-nodeup
Version: 1.1.2
Summary: nodeup DNS Authenticator plugin for Certbot
Home-page: https://github.com/certbot/certbot
Author: Certbot Project
Author-email: client-dev@letsencrypt.org
License: Apache License 2.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
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 :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
Description-Content-Type: text/markdown
Provides-Extra: docs

# Certbot plugin for authentication using Nodeup API

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

## Usage

1. Obtain a NodeUp API token (see [Nodeup API Settings](https://cloud.nodeup.io/settings/api/))

2. Install the plugin using `pip install certbot-dns-nodeup`

3. Create a `nodeup.ini` config file with the following contents and apply `chmod 600 nodeup.ini` on it:
   ```
   # Nodeup API credentials used by Certbot
   dns_nodeup_api_token = TOKEN
 
   ```
   Replace `TOKEN` with your Nodeup API token 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 dns-nodeup --dns-nodeup-credentials nodeup.ini -d example.com
   ```

   Wildcard
   ```
   certbot certonly -a dns-nodeup --dns-nodeup-credentials nodeup.ini -d \*.example.com
   ```
