| Name | certbot-dns-leaseweb JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | |
| Summary | Automate dns-01 challenge completion using Leaseweb Domains API. |
| upload_time | 2023-10-21 09:26:24 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | Apache License 2.0 |
| keywords |
certbot
leaseweb
dns-01
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
certbot-dns-leaseweb
====================
A certbot plugin that automates the process of completing a dns-01 challenge
using Leaseweb's [Domain API](https://developer.leaseweb.com/api-docs/domains_v2.html).
Install
-------
`certbot-dns-leaseweb` should be installed via pip, in the same python
environment in which `certbot` is installed:
```
pip install certbot-dns-leaseweb
```
Usage
------
Use the following flags to `certbot` to use and control this plugin:
| Option | Description |
|--------|-------------|
| `--authenticator dns-leaseweb` | **required**, enable and use this plugin. |
| `--dns-leaseweb-credentials` | **required**, Leaseweb API credentials INI file. |
| `--dns-leaseweb-propagation-seconds` | optional, seconds to wait for DNS records to propagate. |
Credentials
------------
A suitable API token can be generated from https://secure.leaseweb.com/api-client-management/.
The token should then be stored in an INI file:
```
dns_leaseweb_api_token = notarealtoken
```
**CAUTION**: These API credentials should be carefully protected from exposure
and unauthorised access.
They could be used to complete DNS challenges, allowing potentially unauthorised
parties to obtain or revoke certificates for your domains.
Examples
--------
Obtain a wildcard certificate for `example.com`:
```
certbot certonly \
--authenticator dns-leaseweb \
--dns-leaseweb-credentials leaseweb.ini \
-d '*.example.com'
```
Obtain a wildcard certificate for `example.com`, with extra time for propagation:
```
certbot certonly \
--authenticator dns-leaseweb \
--dns-leaseweb-credentials leaseweb.ini \
--dns-leaseweb-propagation-seconds 600 \
-d '*.example.com'
```
Docker
------
If you prefer to run certbot with the `dns-leaseweb` plugin in docker, you can
build a suitable image with `make image`.
The image comes with a partially-completed CLI as its entrypoint:
```
/usr/local/bin/certbot \
--authenticator=dns-leaseweb \
--dns-leaseweb-credentials=/etc/letsencrypt/credentials/leaseweb.ini
```
You will need to create a suitable credentials file for the plugin at
`/etc/letsencrypt/credentials/leaseweb.ini` for the instructions below to work.
You can then use it as:
```
docker run --rm -ti \
--volume "/etc/letsencrypt:/etc/letsencrypt" \
--volume "/var/lib/letsencrypt:/var/lib/letsencrypt" \
certbot-dns-leaseweb:latest \
certonly \
--dns-leaseweb-propagation-seconds 600 \
-d '*.example.com'
```
Issues and development
-----------------------
Please report any issues (or improvement suggestions) at https://gitlab.com/iwaseatenbyagrue/certbot-dns-leaseweb/-/issues.
If you want to hack on this project, please make sure you run tests and linting
on your code:
```
make test
```
Thanks
------
To [Letsencrypt](https://letsencrypt.org/), and the EFF for [certbot](https://certbot.eff.org/).
This plugin is adapted from https://github.com/ctrlaltcoop/certbot-dns-hetzner,
whose README was also the template for this file.
https://github.com/m42e/certbot-dns-ispconfig was also consulted during
development of this plugin.
Raw data
{
"_id": null,
"home_page": "",
"name": "certbot-dns-leaseweb",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "certbot,leaseweb,dns-01",
"author": "",
"author_email": "iwaseatenbyagrue <iwaseatenbyagrue@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b1/08/adfc6c5a9d335097f9971ffaf436d5af81c36bec5ae0b3f1d9660a8552f5/certbot-dns-leaseweb-1.0.1.tar.gz",
"platform": null,
"description": "certbot-dns-leaseweb\n====================\n\nA certbot plugin that automates the process of completing a dns-01 challenge\nusing Leaseweb's [Domain API](https://developer.leaseweb.com/api-docs/domains_v2.html).\n\nInstall\n-------\n\n`certbot-dns-leaseweb` should be installed via pip, in the same python\nenvironment in which `certbot` is installed:\n\n```\npip install certbot-dns-leaseweb\n```\n\nUsage\n------\n\nUse the following flags to `certbot` to use and control this plugin:\n\n| Option | Description |\n|--------|-------------|\n| `--authenticator dns-leaseweb` | **required**, enable and use this plugin. |\n| `--dns-leaseweb-credentials` | **required**, Leaseweb API credentials INI file. |\n| `--dns-leaseweb-propagation-seconds` | optional, seconds to wait for DNS records to propagate. |\n\n\nCredentials\n------------\n\nA suitable API token can be generated from https://secure.leaseweb.com/api-client-management/.\n\nThe token should then be stored in an INI file:\n\n```\ndns_leaseweb_api_token = notarealtoken\n```\n\n**CAUTION**: These API credentials should be carefully protected from exposure\nand unauthorised access.\n\nThey could be used to complete DNS challenges, allowing potentially unauthorised\nparties to obtain or revoke certificates for your domains.\n\nExamples\n--------\n\nObtain a wildcard certificate for `example.com`:\n\n```\ncertbot certonly \\\n --authenticator dns-leaseweb \\\n --dns-leaseweb-credentials leaseweb.ini \\\n -d '*.example.com'\n```\n\nObtain a wildcard certificate for `example.com`, with extra time for propagation:\n\n```\ncertbot certonly \\\n --authenticator dns-leaseweb \\\n --dns-leaseweb-credentials leaseweb.ini \\\n --dns-leaseweb-propagation-seconds 600 \\\n -d '*.example.com'\n```\n\nDocker\n------\n\nIf you prefer to run certbot with the `dns-leaseweb` plugin in docker, you can\nbuild a suitable image with `make image`.\n\nThe image comes with a partially-completed CLI as its entrypoint:\n\n```\n/usr/local/bin/certbot \\\n --authenticator=dns-leaseweb \\\n --dns-leaseweb-credentials=/etc/letsencrypt/credentials/leaseweb.ini\n```\n\n\nYou will need to create a suitable credentials file for the plugin at\n`/etc/letsencrypt/credentials/leaseweb.ini` for the instructions below to work.\n\n\nYou can then use it as:\n\n```\ndocker run --rm -ti \\\n --volume \"/etc/letsencrypt:/etc/letsencrypt\" \\\n --volume \"/var/lib/letsencrypt:/var/lib/letsencrypt\" \\\n certbot-dns-leaseweb:latest \\\n certonly \\\n --dns-leaseweb-propagation-seconds 600 \\\n -d '*.example.com'\n```\n\nIssues and development\n-----------------------\n\nPlease report any issues (or improvement suggestions) at https://gitlab.com/iwaseatenbyagrue/certbot-dns-leaseweb/-/issues.\n\nIf you want to hack on this project, please make sure you run tests and linting\non your code:\n\n```\nmake test\n```\n\nThanks\n------\n\nTo [Letsencrypt](https://letsencrypt.org/), and the EFF for [certbot](https://certbot.eff.org/).\n\nThis plugin is adapted from https://github.com/ctrlaltcoop/certbot-dns-hetzner,\nwhose README was also the template for this file.\n\nhttps://github.com/m42e/certbot-dns-ispconfig was also consulted during\ndevelopment of this plugin.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Automate dns-01 challenge completion using Leaseweb Domains API.",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://gitlab.com/iwaseatenbyagrue/certbot-dns-leaseweb",
"Repository": "https://gitlab.com/iwaseatenbyagrue/certbot-dns-leaseweb"
},
"split_keywords": [
"certbot",
"leaseweb",
"dns-01"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5d287fd9ff7c566957c49e39339eea3f5c86a9edf84d858cb5f1513031524f09",
"md5": "33bdc4cba046d36819c181f98cea8a39",
"sha256": "edfc5cf025cb72dcac35c75c4c9fcde28aaf1665e64fcfa3b6f21dfef6fa03f4"
},
"downloads": -1,
"filename": "certbot_dns_leaseweb-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "33bdc4cba046d36819c181f98cea8a39",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11246,
"upload_time": "2023-10-21T09:26:22",
"upload_time_iso_8601": "2023-10-21T09:26:22.722401Z",
"url": "https://files.pythonhosted.org/packages/5d/28/7fd9ff7c566957c49e39339eea3f5c86a9edf84d858cb5f1513031524f09/certbot_dns_leaseweb-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b108adfc6c5a9d335097f9971ffaf436d5af81c36bec5ae0b3f1d9660a8552f5",
"md5": "6d4553bef75683d86d18cc5dc1bb3899",
"sha256": "bd093a3406565bed9e7e1933ef9913651fad8c7eaaf88708261ea33bd3ce5071"
},
"downloads": -1,
"filename": "certbot-dns-leaseweb-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "6d4553bef75683d86d18cc5dc1bb3899",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 17250,
"upload_time": "2023-10-21T09:26:24",
"upload_time_iso_8601": "2023-10-21T09:26:24.410220Z",
"url": "https://files.pythonhosted.org/packages/b1/08/adfc6c5a9d335097f9971ffaf436d5af81c36bec5ae0b3f1d9660a8552f5/certbot-dns-leaseweb-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-21 09:26:24",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "iwaseatenbyagrue",
"gitlab_project": "certbot-dns-leaseweb",
"lcname": "certbot-dns-leaseweb"
}
