certbot-dns-firstdomains 1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- certbot_dns_firstdomains-1.0/.gitignore +3 -0
- certbot_dns_firstdomains-1.0/LICENSE.txt +20 -0
- certbot_dns_firstdomains-1.0/MANIFEST.in +1 -0
- certbot_dns_firstdomains-1.0/PKG-INFO +114 -0
- certbot_dns_firstdomains-1.0/README.md +76 -0
- certbot_dns_firstdomains-1.0/pyproject.toml +53 -0
- certbot_dns_firstdomains-1.0/setup.cfg +4 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains/__init__.py +1 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains/dns_firstdomains.py +142 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/PKG-INFO +114 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/SOURCES.txt +13 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/dependency_links.txt +1 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/entry_points.txt +2 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/requires.txt +8 -0
- certbot_dns_firstdomains-1.0/src/certbot_dns_firstdomains.egg-info/top_level.txt +1 -0
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
Copyright (C) 2018 Luke McIntyre
|
|
2
|
+
|
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
|
4
|
+
a copy of this software and associated documentation files (the
|
|
5
|
+
"Software"), to deal in the Software without restriction, including
|
|
6
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
|
7
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
|
8
|
+
permit persons to whom the Software is furnished to do so, subject to
|
|
9
|
+
the following conditions:
|
|
10
|
+
|
|
11
|
+
The above copyright notice and this permission notice shall be
|
|
12
|
+
included in all copies or substantial portions of the Software.
|
|
13
|
+
|
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
15
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
16
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
17
|
+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
18
|
+
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
19
|
+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
20
|
+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
exclude release.sh
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: certbot-dns-firstdomains
|
|
3
|
+
Version: 1.0
|
|
4
|
+
Summary: First Domains DNS Authenticator plugin for Certbot
|
|
5
|
+
Author-email: Luke McIntyre <hatharry@hotmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/hatharry/certbot-dns-firstdomains
|
|
8
|
+
Project-URL: Repository, https://github.com/hatharry/certbot-dns-firstdomains.git
|
|
9
|
+
Project-URL: Bug Tracker, https://github.com/hatharry/certbot-dns-firstdomains/issues
|
|
10
|
+
Keywords: certbot,letsencrypt,dns-01,plugin,authenticator
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Environment :: Plugins
|
|
13
|
+
Classifier: Intended Audience :: System Administrators
|
|
14
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
15
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
16
|
+
Classifier: Programming Language :: Python
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
21
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
22
|
+
Classifier: Topic :: Security
|
|
23
|
+
Classifier: Topic :: System :: Installation/Setup
|
|
24
|
+
Classifier: Topic :: System :: Networking
|
|
25
|
+
Classifier: Topic :: System :: Systems Administration
|
|
26
|
+
Classifier: Topic :: Utilities
|
|
27
|
+
Requires-Python: >=3.8
|
|
28
|
+
Description-Content-Type: text/markdown
|
|
29
|
+
License-File: LICENSE.txt
|
|
30
|
+
Requires-Dist: acme>=0.29.0
|
|
31
|
+
Requires-Dist: certbot>=0.34.0
|
|
32
|
+
Requires-Dist: dnspython
|
|
33
|
+
Requires-Dist: mock
|
|
34
|
+
Requires-Dist: requests
|
|
35
|
+
Requires-Dist: setuptools
|
|
36
|
+
Requires-Dist: requests-mock
|
|
37
|
+
Requires-Dist: zope.interface
|
|
38
|
+
|
|
39
|
+
# certbot-dns-firstdomains
|
|
40
|
+
First Domains DNS authenticator plugin for Certbot
|
|
41
|
+
|
|
42
|
+
An authenticator plugin for [certbot][1] to support [Let's Encrypt][2]
|
|
43
|
+
DNS challenges (dns-01) for domains managed by the nameservers of [Active24][3].
|
|
44
|
+
|
|
45
|
+
This plugin is based on the [ISPConfig DNS authenticator][4] by Matthias Bilger.
|
|
46
|
+
|
|
47
|
+
## Requirements
|
|
48
|
+
* certbot (>=0.34.0)
|
|
49
|
+
|
|
50
|
+
_Note_: it is highly recommended that you install Certbot from PyPI (`pip install certbot`),
|
|
51
|
+
rather than your distribution's package manager or Snap or similar - not only is the PyPI
|
|
52
|
+
version usually the newest available, but there have been reports of issues with the plugin
|
|
53
|
+
when it's installed via PyPI and Certbot is not. If anyone has ideas on how this package
|
|
54
|
+
could be improved to fix these compatibility issues, please post an issue, or better yet,
|
|
55
|
+
a pull request - any input or help is much appreciated!
|
|
56
|
+
|
|
57
|
+
## Installation
|
|
58
|
+
1. First install the plugin:
|
|
59
|
+
```shell
|
|
60
|
+
pip install certbot-dns-firstdomains
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
2. Configure it with your First Domains credentials:
|
|
64
|
+
```shell
|
|
65
|
+
sudo $EDITOR /etc/letsencrypt/firstdomains.ini
|
|
66
|
+
```
|
|
67
|
+
Paste the following into the configuration file:
|
|
68
|
+
```
|
|
69
|
+
certbot_dns_firstdomains:dns_firstdomains_username = "your username"
|
|
70
|
+
certbot_dns_firstdomains:dns_firstdomains_password = "your password"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
3. Make sure the file is only readable by root! Otherwise all your domains might be in danger:
|
|
74
|
+
```shell
|
|
75
|
+
sudo chmod 0600 /etc/letsencrypt/firstdomains.ini
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Usage
|
|
79
|
+
Request new certificates via a certbot invocation like this:
|
|
80
|
+
|
|
81
|
+
```shell
|
|
82
|
+
sudo certbot certonly -a certbot-dns-firstdomains:dns-firstdomains -d sub.domain.tld -d *.wildcard.tld
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Renewals will automatically be performed using the same authenticator and credentials by certbot.
|
|
86
|
+
|
|
87
|
+
## Command Line Options
|
|
88
|
+
```
|
|
89
|
+
--certbot-dns-firstdomains:dns-firstdomains-credentials PATH_TO_CREDENTIALS
|
|
90
|
+
Path to First Domains account credentials INI file
|
|
91
|
+
(default: /etc/letsencrypt/firstdomains.ini)
|
|
92
|
+
|
|
93
|
+
--certbot-dns-firstdomains:dns-firstdomains-propagation-seconds SECONDS
|
|
94
|
+
The number of seconds to wait for DNS record changes
|
|
95
|
+
to propagate before asking the ACME server to verify
|
|
96
|
+
the DNS record. Default 300.
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Removal
|
|
100
|
+
|
|
101
|
+
```shell
|
|
102
|
+
sudo pip uninstall certbot-dns-firstdomains
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Development
|
|
106
|
+
|
|
107
|
+
When releasing a new version, commit all changes, create an appropriate Git tag, and then run
|
|
108
|
+
`./release.sh` from the project directory. This will check and prepare your environment,
|
|
109
|
+
push the latest code to GitHub, build the distribution package and upload it to PyPI.
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
[1]: https://certbot.eff.org/
|
|
113
|
+
[2]: https://letsencrypt.org/
|
|
114
|
+
[4]: https://github.com/m42e/certbot-dns-ispconfig
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# certbot-dns-firstdomains
|
|
2
|
+
First Domains DNS authenticator plugin for Certbot
|
|
3
|
+
|
|
4
|
+
An authenticator plugin for [certbot][1] to support [Let's Encrypt][2]
|
|
5
|
+
DNS challenges (dns-01) for domains managed by the nameservers of [Active24][3].
|
|
6
|
+
|
|
7
|
+
This plugin is based on the [ISPConfig DNS authenticator][4] by Matthias Bilger.
|
|
8
|
+
|
|
9
|
+
## Requirements
|
|
10
|
+
* certbot (>=0.34.0)
|
|
11
|
+
|
|
12
|
+
_Note_: it is highly recommended that you install Certbot from PyPI (`pip install certbot`),
|
|
13
|
+
rather than your distribution's package manager or Snap or similar - not only is the PyPI
|
|
14
|
+
version usually the newest available, but there have been reports of issues with the plugin
|
|
15
|
+
when it's installed via PyPI and Certbot is not. If anyone has ideas on how this package
|
|
16
|
+
could be improved to fix these compatibility issues, please post an issue, or better yet,
|
|
17
|
+
a pull request - any input or help is much appreciated!
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
1. First install the plugin:
|
|
21
|
+
```shell
|
|
22
|
+
pip install certbot-dns-firstdomains
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
2. Configure it with your First Domains credentials:
|
|
26
|
+
```shell
|
|
27
|
+
sudo $EDITOR /etc/letsencrypt/firstdomains.ini
|
|
28
|
+
```
|
|
29
|
+
Paste the following into the configuration file:
|
|
30
|
+
```
|
|
31
|
+
certbot_dns_firstdomains:dns_firstdomains_username = "your username"
|
|
32
|
+
certbot_dns_firstdomains:dns_firstdomains_password = "your password"
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
3. Make sure the file is only readable by root! Otherwise all your domains might be in danger:
|
|
36
|
+
```shell
|
|
37
|
+
sudo chmod 0600 /etc/letsencrypt/firstdomains.ini
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Usage
|
|
41
|
+
Request new certificates via a certbot invocation like this:
|
|
42
|
+
|
|
43
|
+
```shell
|
|
44
|
+
sudo certbot certonly -a certbot-dns-firstdomains:dns-firstdomains -d sub.domain.tld -d *.wildcard.tld
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Renewals will automatically be performed using the same authenticator and credentials by certbot.
|
|
48
|
+
|
|
49
|
+
## Command Line Options
|
|
50
|
+
```
|
|
51
|
+
--certbot-dns-firstdomains:dns-firstdomains-credentials PATH_TO_CREDENTIALS
|
|
52
|
+
Path to First Domains account credentials INI file
|
|
53
|
+
(default: /etc/letsencrypt/firstdomains.ini)
|
|
54
|
+
|
|
55
|
+
--certbot-dns-firstdomains:dns-firstdomains-propagation-seconds SECONDS
|
|
56
|
+
The number of seconds to wait for DNS record changes
|
|
57
|
+
to propagate before asking the ACME server to verify
|
|
58
|
+
the DNS record. Default 300.
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Removal
|
|
62
|
+
|
|
63
|
+
```shell
|
|
64
|
+
sudo pip uninstall certbot-dns-firstdomains
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Development
|
|
68
|
+
|
|
69
|
+
When releasing a new version, commit all changes, create an appropriate Git tag, and then run
|
|
70
|
+
`./release.sh` from the project directory. This will check and prepare your environment,
|
|
71
|
+
push the latest code to GitHub, build the distribution package and upload it to PyPI.
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
[1]: https://certbot.eff.org/
|
|
75
|
+
[2]: https://letsencrypt.org/
|
|
76
|
+
[4]: https://github.com/m42e/certbot-dns-ispconfig
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=64", "setuptools_scm>=8"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "certbot-dns-firstdomains"
|
|
7
|
+
authors = [
|
|
8
|
+
{name = "Luke McIntyre", email = "hatharry@hotmail.com"},
|
|
9
|
+
]
|
|
10
|
+
description = "First Domains DNS Authenticator plugin for Certbot"
|
|
11
|
+
readme = "README.md"
|
|
12
|
+
requires-python = ">=3.8"
|
|
13
|
+
keywords = ["certbot", "letsencrypt", "dns-01", "plugin", "authenticator"]
|
|
14
|
+
license = {text = "MIT"}
|
|
15
|
+
dynamic = ["version"]
|
|
16
|
+
classifiers = [
|
|
17
|
+
"Development Status :: 3 - Alpha",
|
|
18
|
+
"Environment :: Plugins",
|
|
19
|
+
"Intended Audience :: System Administrators",
|
|
20
|
+
"License :: OSI Approved :: Apache Software License",
|
|
21
|
+
"Operating System :: POSIX :: Linux",
|
|
22
|
+
"Programming Language :: Python",
|
|
23
|
+
"Programming Language :: Python :: 3.8",
|
|
24
|
+
"Programming Language :: Python :: 3.9",
|
|
25
|
+
"Programming Language :: Python :: 3.10",
|
|
26
|
+
"Programming Language :: Python :: 3.11",
|
|
27
|
+
"Topic :: Internet :: WWW/HTTP",
|
|
28
|
+
"Topic :: Security",
|
|
29
|
+
"Topic :: System :: Installation/Setup",
|
|
30
|
+
"Topic :: System :: Networking",
|
|
31
|
+
"Topic :: System :: Systems Administration",
|
|
32
|
+
"Topic :: Utilities",
|
|
33
|
+
]
|
|
34
|
+
dependencies = [
|
|
35
|
+
"acme>=0.29.0",
|
|
36
|
+
"certbot>=0.34.0",
|
|
37
|
+
"dnspython",
|
|
38
|
+
"mock",
|
|
39
|
+
"requests",
|
|
40
|
+
"setuptools",
|
|
41
|
+
"requests-mock",
|
|
42
|
+
"zope.interface",
|
|
43
|
+
]
|
|
44
|
+
|
|
45
|
+
[project.urls]
|
|
46
|
+
Homepage = "https://github.com/hatharry/certbot-dns-firstdomains"
|
|
47
|
+
Repository = "https://github.com/hatharry/certbot-dns-firstdomains.git"
|
|
48
|
+
"Bug Tracker" = "https://github.com/hatharry/certbot-dns-firstdomains/issues"
|
|
49
|
+
|
|
50
|
+
[project.entry-points."certbot.plugins"]
|
|
51
|
+
dns-firstdomains = "certbot_dns_firstdomains.dns_firstdomains:Authenticator"
|
|
52
|
+
|
|
53
|
+
[tool.setuptools_scm]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""First Domains DNS authenticator plugin for Certbot"""
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
from certbot.plugins.dns_common import DNSAuthenticator
|
|
2
|
+
from requests.sessions import Session
|
|
3
|
+
from functools import cache
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
class Authenticator(DNSAuthenticator):
|
|
7
|
+
"""First Domains Authenticator."""
|
|
8
|
+
|
|
9
|
+
description = "First Domains Authenticator"
|
|
10
|
+
user_agent = "certbot/1.0"
|
|
11
|
+
|
|
12
|
+
def __init__(self, *args, **kwargs):
|
|
13
|
+
super().__init__(*args, **kwargs)
|
|
14
|
+
self.credentials = None
|
|
15
|
+
self.session = Session()
|
|
16
|
+
|
|
17
|
+
@classmethod
|
|
18
|
+
def add_parser_arguments(cls, add):
|
|
19
|
+
super().add_parser_arguments(add, default_propagation_seconds=300)
|
|
20
|
+
add(
|
|
21
|
+
"credentials",
|
|
22
|
+
help="First Domains credentials INI file.",
|
|
23
|
+
default="/etc/letsencrypt/firstdomains.ini",
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
def more_info(self):
|
|
27
|
+
return "First Domains Authenticator"
|
|
28
|
+
|
|
29
|
+
def _setup_credentials(self):
|
|
30
|
+
self.credentials = self._configure_credentials(
|
|
31
|
+
"credentials",
|
|
32
|
+
"First Domains credentials INI file",
|
|
33
|
+
{
|
|
34
|
+
"username": "Username for First Domains",
|
|
35
|
+
"password": "Password for First Domains",
|
|
36
|
+
},
|
|
37
|
+
)
|
|
38
|
+
self.login()
|
|
39
|
+
|
|
40
|
+
def _perform(self, domain, validation_name, validation):
|
|
41
|
+
self.add_dns_txt(domain, validation_name, validation)
|
|
42
|
+
|
|
43
|
+
def _cleanup(self, domain, validation_name, validation):
|
|
44
|
+
self.remove_dns_txt(domain, validation)
|
|
45
|
+
|
|
46
|
+
def login(self):
|
|
47
|
+
login_url = "https://1stdomains.nz/client/login.php"
|
|
48
|
+
data = {
|
|
49
|
+
"action": "login",
|
|
50
|
+
"account_login": self.credentials.conf("username"),
|
|
51
|
+
"account_password": self.credentials.conf("password"),
|
|
52
|
+
}
|
|
53
|
+
headers = {"User-Agent": self.user_agent}
|
|
54
|
+
response = self.session.post(login_url, data=data, headers=headers)
|
|
55
|
+
response.raise_for_status() # Raise an error if the request failed
|
|
56
|
+
return None
|
|
57
|
+
|
|
58
|
+
def add_dns_txt(self, domain: str, record_name: str, txt_value: str):
|
|
59
|
+
root_name = self.get_root_name(domain)
|
|
60
|
+
self.add_record(record_name, txt_value, root_name)
|
|
61
|
+
|
|
62
|
+
def remove_dns_txt(self, domain: str, txt_value: str):
|
|
63
|
+
root_name = self.get_root_name(domain)
|
|
64
|
+
record_id = self.get_record_id(txt_value, root_name)
|
|
65
|
+
if record_id:
|
|
66
|
+
self.remove_record(record_id, root_name)
|
|
67
|
+
|
|
68
|
+
@cache
|
|
69
|
+
def get_root_name(self, record_name: str):
|
|
70
|
+
# Determine the root domain name by trying various subdomains
|
|
71
|
+
parts = record_name.split(".")
|
|
72
|
+
for i in range(len(parts) - 2, -1, -1):
|
|
73
|
+
current_name = ".".join(parts[i:])
|
|
74
|
+
if self.check_domain_exists(current_name):
|
|
75
|
+
return current_name
|
|
76
|
+
return None
|
|
77
|
+
|
|
78
|
+
def check_domain_exists(self, domain_name: str):
|
|
79
|
+
url = "https://1stdomains.nz/client/json_wrapper.php"
|
|
80
|
+
data = {
|
|
81
|
+
"library": "zone_manager",
|
|
82
|
+
"action": "load_records",
|
|
83
|
+
"domain_name": domain_name,
|
|
84
|
+
}
|
|
85
|
+
headers = {
|
|
86
|
+
"Referer": "https://1stdomains.nz/client/account_manager.php",
|
|
87
|
+
"User-Agent": self.user_agent,
|
|
88
|
+
}
|
|
89
|
+
response = self.session.post(url, data=data, headers=headers)
|
|
90
|
+
response.raise_for_status()
|
|
91
|
+
return "errors" not in response.json()
|
|
92
|
+
|
|
93
|
+
def add_record(self, record_name: str, txt_value: str, root_name: str):
|
|
94
|
+
url = "https://1stdomains.nz/client/json_wrapper.php"
|
|
95
|
+
data = {
|
|
96
|
+
"library": "zone_manager",
|
|
97
|
+
"action": "add_record",
|
|
98
|
+
"domain_name": root_name,
|
|
99
|
+
"host_name": record_name,
|
|
100
|
+
"record_type": "TXT",
|
|
101
|
+
"record_content": txt_value,
|
|
102
|
+
}
|
|
103
|
+
headers = {
|
|
104
|
+
"Referer": "https://1stdomains.nz/client/account_manager.php",
|
|
105
|
+
"User-Agent": self.user_agent,
|
|
106
|
+
}
|
|
107
|
+
response = self.session.post(url, data=data, headers=headers)
|
|
108
|
+
response.raise_for_status()
|
|
109
|
+
|
|
110
|
+
def get_record_id(self, txt_value: str, root_name: str):
|
|
111
|
+
url = "https://1stdomains.nz/client/json_wrapper.php"
|
|
112
|
+
data = {
|
|
113
|
+
"library": "zone_manager",
|
|
114
|
+
"action": "load_records",
|
|
115
|
+
"domain_name": root_name,
|
|
116
|
+
}
|
|
117
|
+
headers = {
|
|
118
|
+
"Referer": "https://1stdomains.nz/client/account_manager.php",
|
|
119
|
+
"User-Agent": self.user_agent,
|
|
120
|
+
}
|
|
121
|
+
response = self.session.post(url, data=data, headers=headers)
|
|
122
|
+
response.raise_for_status()
|
|
123
|
+
records = response.json().get("rows", [])
|
|
124
|
+
for record in records:
|
|
125
|
+
if record["cell"][3] == txt_value:
|
|
126
|
+
return record["cell"][0]
|
|
127
|
+
return None
|
|
128
|
+
|
|
129
|
+
def remove_record(self, record_id: str, root_name: str):
|
|
130
|
+
url = "https://1stdomains.nz/client/json_wrapper.php"
|
|
131
|
+
data = {
|
|
132
|
+
"library": "zone_manager",
|
|
133
|
+
"action": "del_records",
|
|
134
|
+
"domain_name": root_name,
|
|
135
|
+
"checked_records": record_id,
|
|
136
|
+
}
|
|
137
|
+
headers = {
|
|
138
|
+
"Referer": "https://1stdomains.nz/client/account_manager.php",
|
|
139
|
+
"User-Agent": self.user_agent,
|
|
140
|
+
}
|
|
141
|
+
response = self.session.post(url, data=data, headers=headers)
|
|
142
|
+
response.raise_for_status()
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: certbot-dns-firstdomains
|
|
3
|
+
Version: 1.0
|
|
4
|
+
Summary: First Domains DNS Authenticator plugin for Certbot
|
|
5
|
+
Author-email: Luke McIntyre <hatharry@hotmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/hatharry/certbot-dns-firstdomains
|
|
8
|
+
Project-URL: Repository, https://github.com/hatharry/certbot-dns-firstdomains.git
|
|
9
|
+
Project-URL: Bug Tracker, https://github.com/hatharry/certbot-dns-firstdomains/issues
|
|
10
|
+
Keywords: certbot,letsencrypt,dns-01,plugin,authenticator
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Environment :: Plugins
|
|
13
|
+
Classifier: Intended Audience :: System Administrators
|
|
14
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
15
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
16
|
+
Classifier: Programming Language :: Python
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
21
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
22
|
+
Classifier: Topic :: Security
|
|
23
|
+
Classifier: Topic :: System :: Installation/Setup
|
|
24
|
+
Classifier: Topic :: System :: Networking
|
|
25
|
+
Classifier: Topic :: System :: Systems Administration
|
|
26
|
+
Classifier: Topic :: Utilities
|
|
27
|
+
Requires-Python: >=3.8
|
|
28
|
+
Description-Content-Type: text/markdown
|
|
29
|
+
License-File: LICENSE.txt
|
|
30
|
+
Requires-Dist: acme>=0.29.0
|
|
31
|
+
Requires-Dist: certbot>=0.34.0
|
|
32
|
+
Requires-Dist: dnspython
|
|
33
|
+
Requires-Dist: mock
|
|
34
|
+
Requires-Dist: requests
|
|
35
|
+
Requires-Dist: setuptools
|
|
36
|
+
Requires-Dist: requests-mock
|
|
37
|
+
Requires-Dist: zope.interface
|
|
38
|
+
|
|
39
|
+
# certbot-dns-firstdomains
|
|
40
|
+
First Domains DNS authenticator plugin for Certbot
|
|
41
|
+
|
|
42
|
+
An authenticator plugin for [certbot][1] to support [Let's Encrypt][2]
|
|
43
|
+
DNS challenges (dns-01) for domains managed by the nameservers of [Active24][3].
|
|
44
|
+
|
|
45
|
+
This plugin is based on the [ISPConfig DNS authenticator][4] by Matthias Bilger.
|
|
46
|
+
|
|
47
|
+
## Requirements
|
|
48
|
+
* certbot (>=0.34.0)
|
|
49
|
+
|
|
50
|
+
_Note_: it is highly recommended that you install Certbot from PyPI (`pip install certbot`),
|
|
51
|
+
rather than your distribution's package manager or Snap or similar - not only is the PyPI
|
|
52
|
+
version usually the newest available, but there have been reports of issues with the plugin
|
|
53
|
+
when it's installed via PyPI and Certbot is not. If anyone has ideas on how this package
|
|
54
|
+
could be improved to fix these compatibility issues, please post an issue, or better yet,
|
|
55
|
+
a pull request - any input or help is much appreciated!
|
|
56
|
+
|
|
57
|
+
## Installation
|
|
58
|
+
1. First install the plugin:
|
|
59
|
+
```shell
|
|
60
|
+
pip install certbot-dns-firstdomains
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
2. Configure it with your First Domains credentials:
|
|
64
|
+
```shell
|
|
65
|
+
sudo $EDITOR /etc/letsencrypt/firstdomains.ini
|
|
66
|
+
```
|
|
67
|
+
Paste the following into the configuration file:
|
|
68
|
+
```
|
|
69
|
+
certbot_dns_firstdomains:dns_firstdomains_username = "your username"
|
|
70
|
+
certbot_dns_firstdomains:dns_firstdomains_password = "your password"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
3. Make sure the file is only readable by root! Otherwise all your domains might be in danger:
|
|
74
|
+
```shell
|
|
75
|
+
sudo chmod 0600 /etc/letsencrypt/firstdomains.ini
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Usage
|
|
79
|
+
Request new certificates via a certbot invocation like this:
|
|
80
|
+
|
|
81
|
+
```shell
|
|
82
|
+
sudo certbot certonly -a certbot-dns-firstdomains:dns-firstdomains -d sub.domain.tld -d *.wildcard.tld
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Renewals will automatically be performed using the same authenticator and credentials by certbot.
|
|
86
|
+
|
|
87
|
+
## Command Line Options
|
|
88
|
+
```
|
|
89
|
+
--certbot-dns-firstdomains:dns-firstdomains-credentials PATH_TO_CREDENTIALS
|
|
90
|
+
Path to First Domains account credentials INI file
|
|
91
|
+
(default: /etc/letsencrypt/firstdomains.ini)
|
|
92
|
+
|
|
93
|
+
--certbot-dns-firstdomains:dns-firstdomains-propagation-seconds SECONDS
|
|
94
|
+
The number of seconds to wait for DNS record changes
|
|
95
|
+
to propagate before asking the ACME server to verify
|
|
96
|
+
the DNS record. Default 300.
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Removal
|
|
100
|
+
|
|
101
|
+
```shell
|
|
102
|
+
sudo pip uninstall certbot-dns-firstdomains
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Development
|
|
106
|
+
|
|
107
|
+
When releasing a new version, commit all changes, create an appropriate Git tag, and then run
|
|
108
|
+
`./release.sh` from the project directory. This will check and prepare your environment,
|
|
109
|
+
push the latest code to GitHub, build the distribution package and upload it to PyPI.
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
[1]: https://certbot.eff.org/
|
|
113
|
+
[2]: https://letsencrypt.org/
|
|
114
|
+
[4]: https://github.com/m42e/certbot-dns-ispconfig
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
.gitignore
|
|
2
|
+
LICENSE.txt
|
|
3
|
+
MANIFEST.in
|
|
4
|
+
README.md
|
|
5
|
+
pyproject.toml
|
|
6
|
+
src/certbot_dns_firstdomains/__init__.py
|
|
7
|
+
src/certbot_dns_firstdomains/dns_firstdomains.py
|
|
8
|
+
src/certbot_dns_firstdomains.egg-info/PKG-INFO
|
|
9
|
+
src/certbot_dns_firstdomains.egg-info/SOURCES.txt
|
|
10
|
+
src/certbot_dns_firstdomains.egg-info/dependency_links.txt
|
|
11
|
+
src/certbot_dns_firstdomains.egg-info/entry_points.txt
|
|
12
|
+
src/certbot_dns_firstdomains.egg-info/requires.txt
|
|
13
|
+
src/certbot_dns_firstdomains.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
certbot_dns_firstdomains
|