certbot-dns-dnspod-109 1.0.0__tar.gz → 1.0.2__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.
Files changed (18) hide show
  1. {certbot_dns_dnspod_109-1.0.0/certbot_dns_dnspod_109.egg-info → certbot_dns_dnspod_109-1.0.2}/PKG-INFO +71 -37
  2. certbot_dns_dnspod_109-1.0.0/PKG-INFO → certbot_dns_dnspod_109-1.0.2/Readme.md +45 -49
  3. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109/_internal/dns_dnspod.py +3 -1
  4. certbot_dns_dnspod_109-1.0.2/certbot_dns_dnspod_109.egg-info/PKG-INFO +241 -0
  5. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109.egg-info/SOURCES.txt +2 -1
  6. certbot_dns_dnspod_109-1.0.2/certbot_dns_dnspod_109.egg-info/requires.txt +9 -0
  7. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/setup.py +13 -1
  8. certbot_dns_dnspod_109-1.0.0/Readme.md +0 -191
  9. certbot_dns_dnspod_109-1.0.0/pyproject.toml +0 -18
  10. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/LICENSE.txt +0 -0
  11. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109/__init__.py +0 -0
  12. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109/_internal/__init__.py +0 -0
  13. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109/_internal/tests/__init__.py +0 -0
  14. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109/_internal/tests/dns_dnspod_test.py +0 -0
  15. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109.egg-info/dependency_links.txt +0 -0
  16. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109.egg-info/entry_points.txt +0 -0
  17. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/certbot_dns_dnspod_109.egg-info/top_level.txt +0 -0
  18. {certbot_dns_dnspod_109-1.0.0 → certbot_dns_dnspod_109-1.0.2}/setup.cfg +0 -0
@@ -1,18 +1,40 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: certbot-dns-dnspod-109
3
- Version: 1.0.0
4
- Summary: The `certbot-dns-dnspod-109` plugin automates the process of completing a `dns-01` challenge (`~acme.challenges.DNS01`) by creating, and subsequently removing, TXT records using the Dnspod API (Tencent Cloud API 3.0).
3
+ Version: 1.0.2
4
+ Summary: Dnspod DNS Authenticator plugin for Certbot
5
5
  Home-page: https://github.com/10935336/certbot-dns-dnspod-109
6
6
  Author: 10935336
7
- Author-email: 10935336 <109@pha.pub>
7
+ Author-email: 109@pha.pub
8
+ License: Apache License 2.0
8
9
  Project-URL: Homepage, https://github.com/10935336/certbot-dns-dnspod-109
9
10
  Project-URL: Issues, https://github.com/10935336/certbot-dns-dnspod-109/issues
10
- Classifier: Programming Language :: Python :: 3
11
+ Classifier: Development Status :: 5 - Production/Stable
12
+ Classifier: Environment :: Plugins
13
+ Classifier: Intended Audience :: System Administrators
11
14
  Classifier: License :: OSI Approved :: Apache Software License
12
15
  Classifier: Operating System :: POSIX :: Linux
16
+ Classifier: Programming Language :: Python
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Topic :: Internet :: WWW/HTTP
23
+ Classifier: Topic :: Security
24
+ Classifier: Topic :: System :: Installation/Setup
25
+ Classifier: Topic :: System :: Networking
26
+ Classifier: Topic :: System :: Systems Administration
27
+ Classifier: Topic :: Utilities
13
28
  Requires-Python: >=3.9
14
29
  Description-Content-Type: text/markdown
15
30
  License-File: LICENSE.txt
31
+ Requires-Dist: acme>=3.0.1
32
+ Requires-Dist: certbot>=3.0.1
33
+ Requires-Dist: tencentcloud-sdk-python-common>=3.0.1227
34
+ Requires-Dist: tencentcloud-sdk-python-dnspod>=3.0.1227
35
+ Provides-Extra: docs
36
+ Provides-Extra: test
37
+ Requires-Dist: pytest; extra == "test"
16
38
 
17
39
  [English](#english) | [简体中文](#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)
18
40
 
@@ -21,43 +43,45 @@ License-File: LICENSE.txt
21
43
 
22
44
 
23
45
  ## Just Another DNSPod DNS Authenticator plugin for Certbot
24
- The `certbot-dns-dnspod-109` plugin automates the process of
25
- completing a `dns-01` challenge (`~acme.challenges.DNS01`)
26
- by creating, and subsequently removing, TXT records using the
46
+ The `certbot-dns-dnspod-109` plugin automates the process of
47
+ completing a `dns-01` challenge (`~acme.challenges.DNS01`)
48
+ by creating, and subsequently removing, TXT records using the
27
49
  Dnspod API (Tencent Cloud API 3.0).
28
50
 
51
+ If you are using [Dnspod](https://www.dnspod.cn/) ([Tencent Cloud](https://cloud.tencent.com)) as your DNS provider,
52
+ then this is your plugin.
53
+
54
+
55
+ Tested on
56
+ - Certbot 3.0.1
57
+
58
+
29
59
  ## Usage
30
60
 
31
61
  ### 1. Install
32
62
 
33
63
  #### pip:
34
64
  ```bash
35
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
65
+ pip install certbot-dns-dnspod-109
36
66
  ```
37
67
  or
38
68
  ```bash
39
- pip install certbot-dns-dnspod-109
69
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
40
70
  ```
41
71
 
42
72
 
43
73
  #### snap:
44
74
  ```bash
45
- snap install certbot-dns-dnspod-109
46
- snap connect certbot:plugin certbot-dns-dnspod-109
47
- ```
48
-
49
- if root snap:
50
- ```bash
51
- snap install certbot-dns-dnspod-109
75
+ snap install certbot-dns-dnspod-10935336
52
76
  snap set certbot trust-plugin-with-root=ok
53
- snap connect certbot:plugin certbot-dns-dnspod-109
77
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
54
78
  ```
55
79
 
56
80
  ### 2. Obtain SecretId and SecretKey
57
- 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
58
- 2. Select "Programmatic access" for the sub-user access method
59
- 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
60
- 4. Record SecretId and SecretKey
81
+ 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
82
+ 2. Select "Programmatic access" for the sub-user access method
83
+ 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
84
+ 4. Record SecretId and SecretKey
61
85
 
62
86
  ### 3. Prepare Credentials File
63
87
 
@@ -99,58 +123,62 @@ certbot certonly \
99
123
  ```
100
124
 
101
125
  Test run
102
-
103
126
  ```bash
104
127
  certbot certonly \
105
128
  --register-unsafely-without-email \
106
129
  -a dns-dnspod-109 \
107
130
  --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
131
+ --dns-dnspod-109-propagation-seconds 60 \
108
132
  -v \
109
133
  --dry-run
110
134
  ```
111
135
 
136
+ ## Parameter Description
137
+ ``--dns-dnspod-109-credentials <path>`` points to the credentials file. (Required)
112
138
 
139
+ ``--dns-dnspod-109-propagation-seconds`` The number of seconds to wait for DNS propagation before asking the ACME server to verify DNS records. If DNS records appear to be added successfully but verification fails, try increasing this value. (Default: 10)
113
140
 
114
141
 
115
142
 
116
143
 
144
+ <br>
145
+ <br>
146
+ <br>
147
+ <br>
148
+ <br>
117
149
 
118
150
  # 简体中文
119
151
 
120
-
121
-
122
-
123
152
  ## 只是另一个适用于 Certbot 的 DNSPod DNS Authenticator 插件
124
153
 
125
154
  `certbot-dns-dnspod-109` 插件通过使用 Dnspod API(腾讯云 API 3.0)创建并随后删除 TXT 记录,自动完成`dns-01` 质询(`~acme.challenges.DNS01`)。
126
155
 
156
+ 如果你使用 [Dnspod](https://www.dnspod.cn/) ([腾讯云](https://cloud.tencent.com)) 作为你的域名解析服务提供商,那么这就是你的插件。
157
+
158
+ 在以下版本中测试通过
159
+ - Certbot 3.0.1
160
+
127
161
  ## 使用方法
128
162
 
129
163
  ### 1. 安装
130
164
 
131
165
  #### pip:
132
166
  ```bash
133
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
167
+ pip install certbot-dns-dnspod-109
134
168
  ```
135
169
  或者
136
170
  ```bash
137
- pip install certbot-dns-dnspod-109
171
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
138
172
  ```
139
173
 
140
174
  #### snap:
141
175
  ```bash
142
- snap install certbot-dns-dnspod-109
143
- snap connect certbot:plugin certbot-dns-dnspod-109
144
- ```
145
-
146
- 如果你使用 root snap:
147
- ```bash
148
- snap install certbot-dns-dnspod-109
176
+ snap install certbot-dns-dnspod-10935336
149
177
  snap set certbot trust-plugin-with-root=ok
150
- snap connect certbot:plugin certbot-dns-dnspod-109
178
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
151
179
  ```
152
180
 
153
- ### 2. 获取SecretId和SecretKey
181
+ ### 2. 获取 SecretId SecretKey
154
182
  1. 访问 https://console.cloud.tencent.com/cam 创建子用户
155
183
  2. 子用户访问方式选择“编程访问”
156
184
  3. 授予子用户 QcloudDNSPodFullAccess(Cloud DNS 完全读写访问权限)权限
@@ -196,12 +224,18 @@ certbot certonly \
196
224
  ```
197
225
 
198
226
  测试运行
199
-
200
227
  ```bash
201
228
  certbot certonly \
202
229
  --register-unsafely-without-email \
203
230
  -a dns-dnspod-109 \
204
231
  --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
232
+ --dns-dnspod-109-propagation-seconds 60 \
205
233
  -v \
206
234
  --dry-run
207
235
  ```
236
+
237
+ ## 参数说明
238
+ ``--dns-dnspod-109-credentials <路径>`` 指向凭证文件。(必需)
239
+
240
+ ``--dns-dnspod-109-propagation-seconds`` 在要求 ACME 服务器验证 DNS 记录之前等待 DNS 传播的秒数。如果显示 DNS 记录添加成功但验证失败,则尝试增加此值 。 (默认值:10)
241
+
@@ -1,19 +1,3 @@
1
- Metadata-Version: 2.1
2
- Name: certbot-dns-dnspod-109
3
- Version: 1.0.0
4
- Summary: The `certbot-dns-dnspod-109` plugin automates the process of completing a `dns-01` challenge (`~acme.challenges.DNS01`) by creating, and subsequently removing, TXT records using the Dnspod API (Tencent Cloud API 3.0).
5
- Home-page: https://github.com/10935336/certbot-dns-dnspod-109
6
- Author: 10935336
7
- Author-email: 10935336 <109@pha.pub>
8
- Project-URL: Homepage, https://github.com/10935336/certbot-dns-dnspod-109
9
- Project-URL: Issues, https://github.com/10935336/certbot-dns-dnspod-109/issues
10
- Classifier: Programming Language :: Python :: 3
11
- Classifier: License :: OSI Approved :: Apache Software License
12
- Classifier: Operating System :: POSIX :: Linux
13
- Requires-Python: >=3.9
14
- Description-Content-Type: text/markdown
15
- License-File: LICENSE.txt
16
-
17
1
  [English](#english) | [简体中文](#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)
18
2
 
19
3
 
@@ -21,43 +5,45 @@ License-File: LICENSE.txt
21
5
 
22
6
 
23
7
  ## Just Another DNSPod DNS Authenticator plugin for Certbot
24
- The `certbot-dns-dnspod-109` plugin automates the process of
25
- completing a `dns-01` challenge (`~acme.challenges.DNS01`)
26
- by creating, and subsequently removing, TXT records using the
8
+ The `certbot-dns-dnspod-109` plugin automates the process of
9
+ completing a `dns-01` challenge (`~acme.challenges.DNS01`)
10
+ by creating, and subsequently removing, TXT records using the
27
11
  Dnspod API (Tencent Cloud API 3.0).
28
12
 
13
+ If you are using [Dnspod](https://www.dnspod.cn/) ([Tencent Cloud](https://cloud.tencent.com)) as your DNS provider,
14
+ then this is your plugin.
15
+
16
+
17
+ Tested on
18
+ - Certbot 3.0.1
19
+
20
+
29
21
  ## Usage
30
22
 
31
23
  ### 1. Install
32
24
 
33
25
  #### pip:
34
26
  ```bash
35
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
27
+ pip install certbot-dns-dnspod-109
36
28
  ```
37
29
  or
38
30
  ```bash
39
- pip install certbot-dns-dnspod-109
31
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
40
32
  ```
41
33
 
42
34
 
43
35
  #### snap:
44
36
  ```bash
45
- snap install certbot-dns-dnspod-109
46
- snap connect certbot:plugin certbot-dns-dnspod-109
47
- ```
48
-
49
- if root snap:
50
- ```bash
51
- snap install certbot-dns-dnspod-109
37
+ snap install certbot-dns-dnspod-10935336
52
38
  snap set certbot trust-plugin-with-root=ok
53
- snap connect certbot:plugin certbot-dns-dnspod-109
39
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
54
40
  ```
55
41
 
56
42
  ### 2. Obtain SecretId and SecretKey
57
- 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
58
- 2. Select "Programmatic access" for the sub-user access method
59
- 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
60
- 4. Record SecretId and SecretKey
43
+ 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
44
+ 2. Select "Programmatic access" for the sub-user access method
45
+ 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
46
+ 4. Record SecretId and SecretKey
61
47
 
62
48
  ### 3. Prepare Credentials File
63
49
 
@@ -99,58 +85,62 @@ certbot certonly \
99
85
  ```
100
86
 
101
87
  Test run
102
-
103
88
  ```bash
104
89
  certbot certonly \
105
90
  --register-unsafely-without-email \
106
91
  -a dns-dnspod-109 \
107
92
  --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
93
+ --dns-dnspod-109-propagation-seconds 60 \
108
94
  -v \
109
95
  --dry-run
110
96
  ```
111
97
 
98
+ ## Parameter Description
99
+ ``--dns-dnspod-109-credentials <path>`` points to the credentials file. (Required)
112
100
 
101
+ ``--dns-dnspod-109-propagation-seconds`` The number of seconds to wait for DNS propagation before asking the ACME server to verify DNS records. If DNS records appear to be added successfully but verification fails, try increasing this value. (Default: 10)
113
102
 
114
103
 
115
104
 
116
105
 
106
+ <br>
107
+ <br>
108
+ <br>
109
+ <br>
110
+ <br>
117
111
 
118
112
  # 简体中文
119
113
 
120
-
121
-
122
-
123
114
  ## 只是另一个适用于 Certbot 的 DNSPod DNS Authenticator 插件
124
115
 
125
116
  `certbot-dns-dnspod-109` 插件通过使用 Dnspod API(腾讯云 API 3.0)创建并随后删除 TXT 记录,自动完成`dns-01` 质询(`~acme.challenges.DNS01`)。
126
117
 
118
+ 如果你使用 [Dnspod](https://www.dnspod.cn/) ([腾讯云](https://cloud.tencent.com)) 作为你的域名解析服务提供商,那么这就是你的插件。
119
+
120
+ 在以下版本中测试通过
121
+ - Certbot 3.0.1
122
+
127
123
  ## 使用方法
128
124
 
129
125
  ### 1. 安装
130
126
 
131
127
  #### pip:
132
128
  ```bash
133
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
129
+ pip install certbot-dns-dnspod-109
134
130
  ```
135
131
  或者
136
132
  ```bash
137
- pip install certbot-dns-dnspod-109
133
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
138
134
  ```
139
135
 
140
136
  #### snap:
141
137
  ```bash
142
- snap install certbot-dns-dnspod-109
143
- snap connect certbot:plugin certbot-dns-dnspod-109
144
- ```
145
-
146
- 如果你使用 root snap:
147
- ```bash
148
- snap install certbot-dns-dnspod-109
138
+ snap install certbot-dns-dnspod-10935336
149
139
  snap set certbot trust-plugin-with-root=ok
150
- snap connect certbot:plugin certbot-dns-dnspod-109
140
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
151
141
  ```
152
142
 
153
- ### 2. 获取SecretId和SecretKey
143
+ ### 2. 获取 SecretId SecretKey
154
144
  1. 访问 https://console.cloud.tencent.com/cam 创建子用户
155
145
  2. 子用户访问方式选择“编程访问”
156
146
  3. 授予子用户 QcloudDNSPodFullAccess(Cloud DNS 完全读写访问权限)权限
@@ -196,12 +186,18 @@ certbot certonly \
196
186
  ```
197
187
 
198
188
  测试运行
199
-
200
189
  ```bash
201
190
  certbot certonly \
202
191
  --register-unsafely-without-email \
203
192
  -a dns-dnspod-109 \
204
193
  --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
194
+ --dns-dnspod-109-propagation-seconds 60 \
205
195
  -v \
206
196
  --dry-run
207
197
  ```
198
+
199
+ ## 参数说明
200
+ ``--dns-dnspod-109-credentials <路径>`` 指向凭证文件。(必需)
201
+
202
+ ``--dns-dnspod-109-propagation-seconds`` 在要求 ACME 服务器验证 DNS 记录之前等待 DNS 传播的秒数。如果显示 DNS 记录添加成功但验证失败,则尝试增加此值 。 (默认值:10)
203
+
@@ -20,10 +20,12 @@ class Authenticator(dns_common.DNSAuthenticator):
20
20
  This Authenticator uses the Dnspod API to fulfill a dns-01 challenge.
21
21
  """
22
22
 
23
+ # required by certbot
24
+ description = 'Obtain certificates using a DNS TXT record (if you are using Dnspod for DNS).'
25
+
23
26
  def __init__(self, *args: Any, **kwargs: Any) -> None:
24
27
  super().__init__(*args, **kwargs)
25
28
  self.credentials: Optional[CredentialsConfiguration] = None
26
- self.description = 'Obtain certificates using a DNS TXT record (if you are using Dnspod for DNS).'
27
29
  self.ACCOUNT_URL = 'https://console.cloud.tencent.com/cam'
28
30
  self.ttl = 600
29
31
 
@@ -0,0 +1,241 @@
1
+ Metadata-Version: 2.1
2
+ Name: certbot-dns-dnspod-109
3
+ Version: 1.0.2
4
+ Summary: Dnspod DNS Authenticator plugin for Certbot
5
+ Home-page: https://github.com/10935336/certbot-dns-dnspod-109
6
+ Author: 10935336
7
+ Author-email: 109@pha.pub
8
+ License: Apache License 2.0
9
+ Project-URL: Homepage, https://github.com/10935336/certbot-dns-dnspod-109
10
+ Project-URL: Issues, https://github.com/10935336/certbot-dns-dnspod-109/issues
11
+ Classifier: Development Status :: 5 - Production/Stable
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
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Topic :: Internet :: WWW/HTTP
23
+ Classifier: Topic :: Security
24
+ Classifier: Topic :: System :: Installation/Setup
25
+ Classifier: Topic :: System :: Networking
26
+ Classifier: Topic :: System :: Systems Administration
27
+ Classifier: Topic :: Utilities
28
+ Requires-Python: >=3.9
29
+ Description-Content-Type: text/markdown
30
+ License-File: LICENSE.txt
31
+ Requires-Dist: acme>=3.0.1
32
+ Requires-Dist: certbot>=3.0.1
33
+ Requires-Dist: tencentcloud-sdk-python-common>=3.0.1227
34
+ Requires-Dist: tencentcloud-sdk-python-dnspod>=3.0.1227
35
+ Provides-Extra: docs
36
+ Provides-Extra: test
37
+ Requires-Dist: pytest; extra == "test"
38
+
39
+ [English](#english) | [简体中文](#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)
40
+
41
+
42
+ # English
43
+
44
+
45
+ ## Just Another DNSPod DNS Authenticator plugin for Certbot
46
+ The `certbot-dns-dnspod-109` plugin automates the process of
47
+ completing a `dns-01` challenge (`~acme.challenges.DNS01`)
48
+ by creating, and subsequently removing, TXT records using the
49
+ Dnspod API (Tencent Cloud API 3.0).
50
+
51
+ If you are using [Dnspod](https://www.dnspod.cn/) ([Tencent Cloud](https://cloud.tencent.com)) as your DNS provider,
52
+ then this is your plugin.
53
+
54
+
55
+ Tested on
56
+ - Certbot 3.0.1
57
+
58
+
59
+ ## Usage
60
+
61
+ ### 1. Install
62
+
63
+ #### pip:
64
+ ```bash
65
+ pip install certbot-dns-dnspod-109
66
+ ```
67
+ or
68
+ ```bash
69
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
70
+ ```
71
+
72
+
73
+ #### snap:
74
+ ```bash
75
+ snap install certbot-dns-dnspod-10935336
76
+ snap set certbot trust-plugin-with-root=ok
77
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
78
+ ```
79
+
80
+ ### 2. Obtain SecretId and SecretKey
81
+ 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
82
+ 2. Select "Programmatic access" for the sub-user access method
83
+ 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
84
+ 4. Record SecretId and SecretKey
85
+
86
+ ### 3. Prepare Credentials File
87
+
88
+ foobar.ini:
89
+ ```ini
90
+ dns_dnspod_109_secret_id=foo
91
+ dns_dnspod_109_secret_key=bar
92
+ ```
93
+
94
+ ### 4. Ready to go
95
+
96
+ #### Usage Examples
97
+
98
+ To acquire a certificate for `example.com`
99
+
100
+ ```bash
101
+ certbot certonly \
102
+ -a dns-dnspod-109 \
103
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
104
+ -d example.com
105
+ ```
106
+
107
+ To acquire a single certificate for both example.com and www.example.com
108
+ ```bash
109
+ certbot certonly \
110
+ -a dns-dnspod-109 \
111
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
112
+ -d example.com \
113
+ -d www.example.com
114
+ ```
115
+
116
+ To acquire a certificate for example.com, waiting 60 seconds for DNS propagation
117
+ ```bash
118
+ certbot certonly \
119
+ -a dns-dnspod-109 \
120
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
121
+ --dns-dnspod-109-propagation-seconds 60 \
122
+ -d example.com
123
+ ```
124
+
125
+ Test run
126
+ ```bash
127
+ certbot certonly \
128
+ --register-unsafely-without-email \
129
+ -a dns-dnspod-109 \
130
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
131
+ --dns-dnspod-109-propagation-seconds 60 \
132
+ -v \
133
+ --dry-run
134
+ ```
135
+
136
+ ## Parameter Description
137
+ ``--dns-dnspod-109-credentials <path>`` points to the credentials file. (Required)
138
+
139
+ ``--dns-dnspod-109-propagation-seconds`` The number of seconds to wait for DNS propagation before asking the ACME server to verify DNS records. If DNS records appear to be added successfully but verification fails, try increasing this value. (Default: 10)
140
+
141
+
142
+
143
+
144
+ <br>
145
+ <br>
146
+ <br>
147
+ <br>
148
+ <br>
149
+
150
+ # 简体中文
151
+
152
+ ## 只是另一个适用于 Certbot 的 DNSPod DNS Authenticator 插件
153
+
154
+ `certbot-dns-dnspod-109` 插件通过使用 Dnspod API(腾讯云 API 3.0)创建并随后删除 TXT 记录,自动完成`dns-01` 质询(`~acme.challenges.DNS01`)。
155
+
156
+ 如果你使用 [Dnspod](https://www.dnspod.cn/) ([腾讯云](https://cloud.tencent.com)) 作为你的域名解析服务提供商,那么这就是你的插件。
157
+
158
+ 在以下版本中测试通过
159
+ - Certbot 3.0.1
160
+
161
+ ## 使用方法
162
+
163
+ ### 1. 安装
164
+
165
+ #### pip:
166
+ ```bash
167
+ pip install certbot-dns-dnspod-109
168
+ ```
169
+ 或者
170
+ ```bash
171
+ pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
172
+ ```
173
+
174
+ #### snap:
175
+ ```bash
176
+ snap install certbot-dns-dnspod-10935336
177
+ snap set certbot trust-plugin-with-root=ok
178
+ snap connect certbot:plugin certbot-dns-dnspod-10935336
179
+ ```
180
+
181
+ ### 2. 获取 SecretId 和 SecretKey
182
+ 1. 访问 https://console.cloud.tencent.com/cam 创建子用户
183
+ 2. 子用户访问方式选择“编程访问”
184
+ 3. 授予子用户 QcloudDNSPodFullAccess(Cloud DNS 完全读写访问权限)权限
185
+ 4. 记录 SecretId 和 SecretKey
186
+
187
+ ### 3. 准备凭证文件
188
+
189
+ foobar.ini:
190
+ ```ini
191
+ dns_dnspod_109_secret_id=foo
192
+ dns_dnspod_109_secret_key=bar
193
+ ```
194
+
195
+ ### 4. 准备就绪
196
+
197
+ #### 使用示例
198
+
199
+ 获取 `example.com` 的证书
200
+
201
+ ```bash
202
+ certbot certonly \
203
+ -a dns-dnspod-109 \
204
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
205
+ -d example.com
206
+ ```
207
+
208
+ 获取同时有 `example.com` 和 `www.example.com` 的单个证书
209
+ ```bash
210
+ certbot certonly \
211
+ -a dns-dnspod-109 \
212
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
213
+ -d example.com \
214
+ -d www.example.com
215
+ ```
216
+
217
+ 获取 `example.com` 的证书,但设置等待 60 秒(等待 DNS 传播)
218
+ ```bash
219
+ certbot certonly \
220
+ -a dns-dnspod-109 \
221
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
222
+ --dns-dnspod-109-propagation-seconds 60 \
223
+ -d example.com
224
+ ```
225
+
226
+ 测试运行
227
+ ```bash
228
+ certbot certonly \
229
+ --register-unsafely-without-email \
230
+ -a dns-dnspod-109 \
231
+ --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
232
+ --dns-dnspod-109-propagation-seconds 60 \
233
+ -v \
234
+ --dry-run
235
+ ```
236
+
237
+ ## 参数说明
238
+ ``--dns-dnspod-109-credentials <路径>`` 指向凭证文件。(必需)
239
+
240
+ ``--dns-dnspod-109-propagation-seconds`` 在要求 ACME 服务器验证 DNS 记录之前等待 DNS 传播的秒数。如果显示 DNS 记录添加成功但验证失败,则尝试增加此值 。 (默认值:10)
241
+
@@ -1,12 +1,13 @@
1
1
  LICENSE.txt
2
+ README.md
2
3
  Readme.md
3
- pyproject.toml
4
4
  setup.py
5
5
  certbot_dns_dnspod_109/__init__.py
6
6
  certbot_dns_dnspod_109.egg-info/PKG-INFO
7
7
  certbot_dns_dnspod_109.egg-info/SOURCES.txt
8
8
  certbot_dns_dnspod_109.egg-info/dependency_links.txt
9
9
  certbot_dns_dnspod_109.egg-info/entry_points.txt
10
+ certbot_dns_dnspod_109.egg-info/requires.txt
10
11
  certbot_dns_dnspod_109.egg-info/top_level.txt
11
12
  certbot_dns_dnspod_109/_internal/__init__.py
12
13
  certbot_dns_dnspod_109/_internal/dns_dnspod.py
@@ -0,0 +1,9 @@
1
+ acme>=3.0.1
2
+ certbot>=3.0.1
3
+ tencentcloud-sdk-python-common>=3.0.1227
4
+ tencentcloud-sdk-python-dnspod>=3.0.1227
5
+
6
+ [docs]
7
+
8
+ [test]
9
+ pytest
@@ -1,7 +1,7 @@
1
1
  import os
2
2
  from setuptools import find_packages, setup
3
3
 
4
- version = '1.0.0'
4
+ version = '1.0.2'
5
5
 
6
6
  install_requires = [
7
7
  # Minimum dependencies for the plugin to function correctly
@@ -21,14 +21,26 @@ test_extras = [
21
21
  'pytest', # for running tests
22
22
  ]
23
23
 
24
+ long_description = ""
25
+ if os.path.exists("README.md"):
26
+ with open("README.md", encoding="utf-8") as f:
27
+ long_description = f.read()
28
+
24
29
  setup(
25
30
  name='certbot-dns-dnspod-109',
26
31
  version=version,
27
32
  description="Dnspod DNS Authenticator plugin for Certbot",
33
+ long_description=long_description,
34
+ long_description_content_type="text/markdown",
28
35
  url='https://github.com/10935336/certbot-dns-dnspod-109',
36
+ project_urls={
37
+ "Homepage": "https://github.com/10935336/certbot-dns-dnspod-109",
38
+ "Issues": "https://github.com/10935336/certbot-dns-dnspod-109/issues",
39
+ },
29
40
  author="10935336",
30
41
  author_email='109@pha.pub',
31
42
  python_requires='>=3.9',
43
+ license="Apache License 2.0",
32
44
  classifiers=[
33
45
  'Development Status :: 5 - Production/Stable',
34
46
  'Environment :: Plugins',
@@ -1,191 +0,0 @@
1
- [English](#english) | [简体中文](#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)
2
-
3
-
4
- # English
5
-
6
-
7
- ## Just Another DNSPod DNS Authenticator plugin for Certbot
8
- The `certbot-dns-dnspod-109` plugin automates the process of
9
- completing a `dns-01` challenge (`~acme.challenges.DNS01`)
10
- by creating, and subsequently removing, TXT records using the
11
- Dnspod API (Tencent Cloud API 3.0).
12
-
13
- ## Usage
14
-
15
- ### 1. Install
16
-
17
- #### pip:
18
- ```bash
19
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
20
- ```
21
- or
22
- ```bash
23
- pip install certbot-dns-dnspod-109
24
- ```
25
-
26
-
27
- #### snap:
28
- ```bash
29
- snap install certbot-dns-dnspod-109
30
- snap connect certbot:plugin certbot-dns-dnspod-109
31
- ```
32
-
33
- if root snap:
34
- ```bash
35
- snap install certbot-dns-dnspod-109
36
- snap set certbot trust-plugin-with-root=ok
37
- snap connect certbot:plugin certbot-dns-dnspod-109
38
- ```
39
-
40
- ### 2. Obtain SecretId and SecretKey
41
- 1. Visit https://console.cloud.tencent.com/cam to create a sub-user
42
- 2. Select "Programmatic access" for the sub-user access method
43
- 3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
44
- 4. Record SecretId and SecretKey
45
-
46
- ### 3. Prepare Credentials File
47
-
48
- foobar.ini:
49
- ```ini
50
- dns_dnspod_109_secret_id=foo
51
- dns_dnspod_109_secret_key=bar
52
- ```
53
-
54
- ### 4. Ready to go
55
-
56
- #### Usage Examples
57
-
58
- To acquire a certificate for `example.com`
59
-
60
- ```bash
61
- certbot certonly \
62
- -a dns-dnspod-109 \
63
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
64
- -d example.com
65
- ```
66
-
67
- To acquire a single certificate for both example.com and www.example.com
68
- ```bash
69
- certbot certonly \
70
- -a dns-dnspod-109 \
71
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
72
- -d example.com \
73
- -d www.example.com
74
- ```
75
-
76
- To acquire a certificate for example.com, waiting 60 seconds for DNS propagation
77
- ```bash
78
- certbot certonly \
79
- -a dns-dnspod-109 \
80
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
81
- --dns-dnspod-109-propagation-seconds 60 \
82
- -d example.com
83
- ```
84
-
85
- Test run
86
-
87
- ```bash
88
- certbot certonly \
89
- --register-unsafely-without-email \
90
- -a dns-dnspod-109 \
91
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
92
- -v \
93
- --dry-run
94
- ```
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
- # 简体中文
103
-
104
-
105
-
106
-
107
- ## 只是另一个适用于 Certbot 的 DNSPod DNS Authenticator 插件
108
-
109
- `certbot-dns-dnspod-109` 插件通过使用 Dnspod API(腾讯云 API 3.0)创建并随后删除 TXT 记录,自动完成`dns-01` 质询(`~acme.challenges.DNS01`)。
110
-
111
- ## 使用方法
112
-
113
- ### 1. 安装
114
-
115
- #### pip:
116
- ```bash
117
- pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
118
- ```
119
- 或者
120
- ```bash
121
- pip install certbot-dns-dnspod-109
122
- ```
123
-
124
- #### snap:
125
- ```bash
126
- snap install certbot-dns-dnspod-109
127
- snap connect certbot:plugin certbot-dns-dnspod-109
128
- ```
129
-
130
- 如果你使用 root snap:
131
- ```bash
132
- snap install certbot-dns-dnspod-109
133
- snap set certbot trust-plugin-with-root=ok
134
- snap connect certbot:plugin certbot-dns-dnspod-109
135
- ```
136
-
137
- ### 2. 获取SecretId和SecretKey
138
- 1. 访问 https://console.cloud.tencent.com/cam 创建子用户
139
- 2. 子用户访问方式选择“编程访问”
140
- 3. 授予子用户 QcloudDNSPodFullAccess(Cloud DNS 完全读写访问权限)权限
141
- 4. 记录 SecretId 和 SecretKey
142
-
143
- ### 3. 准备凭证文件
144
-
145
- foobar.ini:
146
- ```ini
147
- dns_dnspod_109_secret_id=foo
148
- dns_dnspod_109_secret_key=bar
149
- ```
150
-
151
- ### 4. 准备就绪
152
-
153
- #### 使用示例
154
-
155
- 获取 `example.com` 的证书
156
-
157
- ```bash
158
- certbot certonly \
159
- -a dns-dnspod-109 \
160
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
161
- -d example.com
162
- ```
163
-
164
- 获取同时有 `example.com` 和 `www.example.com` 的单个证书
165
- ```bash
166
- certbot certonly \
167
- -a dns-dnspod-109 \
168
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
169
- -d example.com \
170
- -d www.example.com
171
- ```
172
-
173
- 获取 `example.com` 的证书,但设置等待 60 秒(等待 DNS 传播)
174
- ```bash
175
- certbot certonly \
176
- -a dns-dnspod-109 \
177
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
178
- --dns-dnspod-109-propagation-seconds 60 \
179
- -d example.com
180
- ```
181
-
182
- 测试运行
183
-
184
- ```bash
185
- certbot certonly \
186
- --register-unsafely-without-email \
187
- -a dns-dnspod-109 \
188
- --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
189
- -v \
190
- --dry-run
191
- ```
@@ -1,18 +0,0 @@
1
- [project]
2
- name = "certbot-dns-dnspod-109"
3
- version = "1.0.0"
4
- authors = [
5
- { name="10935336", email="109@pha.pub" },
6
- ]
7
- description = "The `certbot-dns-dnspod-109` plugin automates the process of completing a `dns-01` challenge (`~acme.challenges.DNS01`) by creating, and subsequently removing, TXT records using the Dnspod API (Tencent Cloud API 3.0)."
8
- readme = "Readme.md"
9
- requires-python = ">=3.9"
10
- classifiers = [
11
- 'Programming Language :: Python :: 3',
12
- 'License :: OSI Approved :: Apache Software License',
13
- 'Operating System :: POSIX :: Linux',
14
- ]
15
-
16
- [project.urls]
17
- Homepage = "https://github.com/10935336/certbot-dns-dnspod-109"
18
- Issues = "https://github.com/10935336/certbot-dns-dnspod-109/issues"