# Certbot plugin for authentication using the Exonet DNS
[![pypi]](https://pypi.org/project/certbot-dns-exonet)
[![Python]](https://pypi.org/project/certbot-dns-exonet)
[![License]](https://github.com/exonet/certbot-dns-exonet/blob/master/LICENSE)
[Certbot] DNS Authenticator plugin for [Exonet DNS]
# Conventions
- Code style guide: PEP 8.
- Docstring conventions: Google Python Style Guide and Markdown.
# Installation
Install using pip:
```bash
pip install certbot-dns-exonet
```
# Usage
1. Request an Exonet API token ([contact Exonet])
2. After the installation, verify if the plugin is available in certbot:
```bash
certbot plugins
```
3. Create an exonet.ini file:
```bash
touch /etc/letsencrypt/exonet.ini
chmod 0600 /etc/letsencrypt/exonet.ini
```
3. Add the Exonet API token in /etc/letsencrypt/exonet.ini:
```bash
dns_exonet_token = YOUR_EXONET_API_TOKEN
```
5. Request a certificate with certbot and this plugin to obtain a certificate using DNS record authentication:
```bash
certbot certonly \
--config-dir /etc/letsencrypt \
--work-dir /etc/letsencrypt \
--logs-dir /etc/letsencrypt \
--authenticator dns-exonet \
--dns-exonet-credentials /etc/letsencrypt/exonet.ini \
-d domain.com
```
# Change log
Please see [releases] for more information on what has changed recently.
# Security
If you discover any security related issues please email [development@exonet.nl] instead of using the issue tracker.
# Credits
- [Exonet]
- [All Contributors]
# License
The MIT License (MIT). Please see [License File] for more information.
<!-- MARKDOWN LINKS & IMAGES -->
[pypi]: https://img.shields.io/pypi/v/certbot-dns-exonet.svg?style=flat-square
[Python]: https://img.shields.io/pypi/pyversions/certbot-dns-exonet.svg?style=flat-square
[License]:https://img.shields.io/pypi/l/certbot-dns-exonet.svg?style=flat-square
[Certbot]: https://certbot.eff.org
[Exonet DNS]: https://www.exonet.nl
[contact Exonet]: https://www.exonet.nl/contact
[releases]: https://github.com/exonet/certbot-dns-exonet/releases
[development@exonet.nl]: mailto:development@exonet.nl
[Exonet]: https://github.com/exonet
[All Contributors]: https://github.com/exonet/certbot-dns-exonet/graphs/contributors
[License File]: https://github.com/exonet/certbot-dns-exonet/blob/master/LICENSE
Raw data
{
"_id": null,
"home_page": "https://github.com/exonet/certbot-dns-exonet",
"name": "certbot-dns-exonet",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Exonet",
"author_email": "development@exonet.nl",
"download_url": "https://files.pythonhosted.org/packages/f6/5b/152e5e12c911e8873928d3b931e0c77ab63a83a53199a5db51a21f3aef2b/certbot_dns_exonet-4.0.0.tar.gz",
"platform": null,
"description": "# Certbot plugin for authentication using the Exonet DNS\n\n[![pypi]](https://pypi.org/project/certbot-dns-exonet)\n[![Python]](https://pypi.org/project/certbot-dns-exonet)\n[![License]](https://github.com/exonet/certbot-dns-exonet/blob/master/LICENSE)\n\n[Certbot] DNS Authenticator plugin for [Exonet DNS]\n\n\n# Conventions\n- Code style guide: PEP 8.\n- Docstring conventions: Google Python Style Guide and Markdown.\n\n# Installation\nInstall using pip:\n```bash\n pip install certbot-dns-exonet\n```\n\n# Usage\n1. Request an Exonet API token ([contact Exonet])\n\n2. After the installation, verify if the plugin is available in certbot:\n ```bash\n certbot plugins\n ```\n3. Create an exonet.ini file:\n ```bash\n touch /etc/letsencrypt/exonet.ini\n chmod 0600 /etc/letsencrypt/exonet.ini\n ```\n3. Add the Exonet API token in /etc/letsencrypt/exonet.ini:\n ```bash\n dns_exonet_token = YOUR_EXONET_API_TOKEN\n ```\n5. Request a certificate with certbot and this plugin to obtain a certificate using DNS record authentication:\n ```bash\n certbot certonly \\\n --config-dir /etc/letsencrypt \\\n --work-dir /etc/letsencrypt \\\n --logs-dir /etc/letsencrypt \\\n --authenticator dns-exonet \\\n --dns-exonet-credentials /etc/letsencrypt/exonet.ini \\\n -d domain.com\n ```\n\n# Change log\nPlease see [releases] for more information on what has changed recently.\n\n# Security\nIf you discover any security related issues please email [development@exonet.nl] instead of using the issue tracker.\n\n# Credits\n- [Exonet]\n- [All Contributors]\n\n# License\nThe MIT License (MIT). Please see [License File] for more information.\n\n<!-- MARKDOWN LINKS & IMAGES -->\n[pypi]: https://img.shields.io/pypi/v/certbot-dns-exonet.svg?style=flat-square\n[Python]: https://img.shields.io/pypi/pyversions/certbot-dns-exonet.svg?style=flat-square\n[License]:https://img.shields.io/pypi/l/certbot-dns-exonet.svg?style=flat-square\n[Certbot]: https://certbot.eff.org\n[Exonet DNS]: https://www.exonet.nl\n[contact Exonet]: https://www.exonet.nl/contact\n[releases]: https://github.com/exonet/certbot-dns-exonet/releases\n[development@exonet.nl]: mailto:development@exonet.nl\n[Exonet]: https://github.com/exonet\n[All Contributors]: https://github.com/exonet/certbot-dns-exonet/graphs/contributors\n[License File]: https://github.com/exonet/certbot-dns-exonet/blob/master/LICENSE\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Exonet DNS Authenticator plugin for Certbot",
"version": "4.0.0",
"project_urls": {
"Documentation": "https://github.com/exonet/certbot-dns-exonet",
"Homepage": "https://github.com/exonet/certbot-dns-exonet",
"Repository": "https://github.com/exonet/certbot-dns-exonet"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2c17e3e7e9990263630ba2d4e11943858259d3a8f71527eb69e3fc28d7dabd21",
"md5": "c6d839d46fcd445a36999663ce4792b1",
"sha256": "2c4bc148fa497176f5ebb2f249e44ff41497c485a2c95f17ec8005533347a223"
},
"downloads": -1,
"filename": "certbot_dns_exonet-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6d839d46fcd445a36999663ce4792b1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.9",
"size": 8205,
"upload_time": "2025-01-07T13:04:46",
"upload_time_iso_8601": "2025-01-07T13:04:46.467411Z",
"url": "https://files.pythonhosted.org/packages/2c/17/e3e7e9990263630ba2d4e11943858259d3a8f71527eb69e3fc28d7dabd21/certbot_dns_exonet-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f65b152e5e12c911e8873928d3b931e0c77ab63a83a53199a5db51a21f3aef2b",
"md5": "7f1650632db6cfd3bfec06e73c0c4492",
"sha256": "9c05391b50945083d3df6b2d1ac626bba39c8e7ddb755ba04d9f8653f6702b1e"
},
"downloads": -1,
"filename": "certbot_dns_exonet-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "7f1650632db6cfd3bfec06e73c0c4492",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.9",
"size": 6649,
"upload_time": "2025-01-07T13:04:49",
"upload_time_iso_8601": "2025-01-07T13:04:49.802427Z",
"url": "https://files.pythonhosted.org/packages/f6/5b/152e5e12c911e8873928d3b931e0c77ab63a83a53199a5db51a21f3aef2b/certbot_dns_exonet-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-07 13:04:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "exonet",
"github_project": "certbot-dns-exonet",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "certbot-dns-exonet"
}