Metadata-Version: 2.1
Name: certbot-dns-corenetworks
Version: 0.1.3
Summary: Core Networks DNS Authenticator plugin for Certbot
Home-page: https://github.com/xoxys/certbot-dns-corenetworks
Author: Robert Kaussow
Author-email: mail@geeklabor.de
License: MIT
Keywords: dns,certbot,automation,corenetworks
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
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: Programming Language :: Python :: 3.8
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<4
Description-Content-Type: text/markdown
Requires-Dist: acme
Requires-Dist: certbot (>=0.15)
Requires-Dist: setuptools
Requires-Dist: zope.interface
Requires-Dist: corenetworks (>=0.1.4)

# certbot-dns-corenetworks

[![Build Status](https://img.shields.io/drone/build/xoxys/certbot-dns-corenetworks?logo=drone)](https://cloud.drone.io/xoxys/certbot-dns-corenetworks)
[![Python Version](https://img.shields.io/pypi/pyversions/certbot-dns-corenetworks.svg)](https://pypi.org/project/certbot-dns-corenetworks/)
[![PyPi Status](https://img.shields.io/pypi/status/certbot-dns-corenetworks.svg)](https://pypi.org/project/certbot-dns-corenetworks/)
[![PyPi Release](https://img.shields.io/pypi/v/certbot-dns-corenetworks.svg)](https://pypi.org/project/certbot-dns-corenetworks/)
[![Codecov](https://img.shields.io/codecov/c/github/xoxys/certbot-dns-corenetworks)](https://codecov.io/gh/xoxys/certbot-dns-corenetworks)
[![License: MIT](https://img.shields.io/github/license/xoxys/certbot-dns-corenetworks)](LICENSE)

## Install

Install this package via pip in the same python environment where you installed your certbot.

```console
pip install certbot-dns-corenetworks
```

## Usage

To start using DNS authentication for the Core Networks DNS API, pass the following arguments on certbot's command line:

| Option                                                               | Description                                      |
|----------------------------------------------------------------------|--------------------------------------------------|
| `--authenticator certbot-dns-corenetworks:dns-corenetworks`          | select the authenticator plugin (Required)       |
| `--certbot-dns-corenetworks:dns-corenetworks-credentials`            | Hetzner DNS API credentials INI file. (Required) |
| `--certbot-dns-corenetworks:dns-corenetworks-propagation-seconds`    | Seconds to wait for the TXT record to propagate  |

## Credentials

```ini
certbot_dns_corenetworks:dns_corenetworks_username = asaHB12r
certbot_dns_corenetworks:dns_corenetworks_password = secure_passwor
```

## Examples

To acquire a certificate for `example.com`

```bash
certbot certonly \\
 --authenticator certbot-dns-corenetworks:dns-corenetworks \\
 --certbot-dns-corenetworks:dns-corenetworks-credentials /path/to/my/credentials.ini \\
 -d example.com
```

To acquire a certificate for ``*.example.com``

```bash
certbot certonly \\
    --authenticator certbot-dns-corenetworks:dns-corenetworks \\
    --certbot-dns-corenetworks:dns-corenetworks-credentials /path/to/my/credentials.ini \\
    -d '*.example.com'
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Maintainers and Contributors

[Robert Kaussow](https://github.com/xoxys)


