Metadata-Version: 2.1
Name: certbot-dns-ownadmin
Version: 1.0.3
Summary: OwnAdmin Authenticator plugin for Certbot
Home-page: https://github.com/Chudeusz/certbot-dns-powerdns-ownadmin
Author: Chudeusz
Author-email: chudeusz@ownadmin.pl
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.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
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.*
Description-Content-Type: text/markdown

certbot-dns-ownadmin
============

OwnAdmin Authenticator plugin for [Certbot](https://certbot.eff.org/).

This plugin is built from the ground up and follows the development style and life-cycle
of other `certbot-dns-*` plugins found in the
[Official Certbot Repository](https://github.com/certbot/certbot).

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

```
pip install --upgrade certbot
pip install certbot-dns-ownadmin
```

Verify:

```
$ certbot plugins --text

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
* dns-ownadmin
Description: Obtain certificates using a DNS TXT record (if you are using
OwnAdmin for DNS.)
Interfaces: Authenticator, Plugin
Entry point: dns-ownadmin = certbot_dns_ownadmin.dns_ownadmin:Authenticator

...
```

Configuration
-------------

The credentials file e.g. `~/ownadmin-credentials.ini` should look like this:

```
dns_ownadmin_api_url = https://api.mypowerdns.example.org
dns_ownadmin_api_key = AbCbASsd!@34
```

Usage
-----
```
certbot ... \
        --authenticator dns-ownadmin  \
        --dns-ownadmin-credentials ~/ownadmin-credentials.ini \
        certonly
```
