Metadata-Version: 2.1
Name: certbot-dns-powerdns
Version: 0.2.0
Summary: PowerDNS DNS Authenticator plugin for Certbot
Home-page: https://github.com/pan-net-security/certbot-dns-powerdns
Author: DT Pan-Net s.r.o
Author-email: pannet.security@pan-net.eu
License: Apache License 2.0
Description: [![Build Status](https://travis-ci.com/pan-net-security/certbot-dns-powerdns.svg?branch=master)](https://travis-ci.com/pan-net-security/certbot-dns-powerdns)
        [![Coverage Status](https://coveralls.io/repos/github/pan-net-security/certbot-dns-powerdns/badge.svg?branch=master)](https://coveralls.io/github/pan-net-security/certbot-dns-powerdns?branch=master)
        [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=6cfb0c4728624ebff38afc0b1ef91700795ea9ef&metric=alert_status)](https://sonarcloud.io/dashboard?id=6cfb0c4728624ebff38afc0b1ef91700795ea9ef)
        ![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/github/pan-net-security/certbot-dns-powerdns.svg)
        ![PyPI - Status](https://img.shields.io/pypi/status/certbot-dns-powerdns.svg)
        
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/certbot-dns-powerdns.svg)
        
        
        certbot-dns-powerdns
        ============
        
        PowerDNS DNS 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-powerdns
        ```
        
        Verify:
        
        ```
        $ certbot plugins --text
        
        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        * certbot-dns-powerdns:dns-powerdns
        Description: Obtain certificates using a DNS TXT record (if you are using
        PowerDNS for DNS.)
        Interfaces: IAuthenticator, IPlugin
        Entry point: dns-powerdns = certbot_dns_powerdns.dns_powerdns:Authenticator
        
        ...
        ...
        ```
        
        Configuration
        -------------
        
        The credentials file e.g. `~/pdns-credentials.ini` should look like this:
        
        ```
        certbot_dns_powerdns:dns_powerdns_api_url = https://api.mypowerdns.example.org
        certbot_dns_powerdns:dns_powerdns_api_key = AbCbASsd!@34
        ```
        
        Usage
        -----
        
        
        ```
        certbot ... \
                --authenticator certbot-dns-powerdns:dns-powerdns  \
                --certbot-dns-powerdns:dns-powerdns-credentials ~/pdns-credentials.ini \
                certonly
        ```
        
        FAQ
        -----
        
        ##### Why such long name for a plugin?
        
        This follows the upstream nomenclature: `certbot-dns-<dns-provider>`.
        
        ##### Why do I have to use `:` separator in the name? And why are the configuration file parameters so weird?
        
        This is a limitation of the Certbot interface towards _third-party_ plugins.
        
        For details read the discussions:
        
        - https://github.com/certbot/certbot/issues/6504#issuecomment-473462138
        - https://github.com/certbot/certbot/issues/6040
        - https://github.com/certbot/certbot/issues/4351
        - https://github.com/certbot/certbot/pull/6372
        
        Development
        -----------
        
        Create a virtualenv, install the plugin (`editable` mode),
        spawn the environment and run the test:
        
        ```
        virtualenv -p python3 .venv
        . .venv/bin/activate
        pip install -e .
        docker-compose up -d
        ./test/run_certonly.sh test/pdns-credentials.ini
        ```
        
        License
        --------
        
        Copyright (c) 2019 [DT Pan-Net s.r.o](https://github.com/pan-net-security)
        
Platform: UNKNOWN
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
