certbot-dns-dnspod-109 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

certbot_dns_dnspod_109/_internal/dns_dnspod.py

@@ -20,10 +20,12 @@ class Authenticator(dns_common.DNSAuthenticator):
     This Authenticator uses the Dnspod API to fulfill a dns-01 challenge.
     """
 
+    # required by certbot
+    description = 'Obtain certificates using a DNS TXT record (if you are using Dnspod for DNS).'
+
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self.credentials: Optional[CredentialsConfiguration] = None
-        self.description = 'Obtain certificates using a DNS TXT record (if you are using Dnspod for DNS).'
         self.ACCOUNT_URL = 'https://console.cloud.tencent.com/cam'
         self.ttl = 600
 

{certbot_dns_dnspod_109-1.0.0.dist-info → certbot_dns_dnspod_109-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: certbot-dns-dnspod-109
-Version: 1.0.0
+Version: 1.0.1
 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).
 Home-page: https://github.com/10935336/certbot-dns-dnspod-109
 Author: 10935336
@@ -21,43 +21,45 @@ License-File: LICENSE.txt
 
 
 ## Just Another DNSPod DNS Authenticator plugin for Certbot
-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 
+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).
 
+If you are using [Dnspod](https://www.dnspod.cn/) ([Tencent Cloud](https://cloud.tencent.com)) as your DNS provider,
+then this is your plugin.
+
+
+Tested on
+- Certbot 3.0.1
+
+
 ## Usage
 
 ### 1. Install
 
 #### pip:
 ```bash
-pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
+pip install certbot-dns-dnspod-109
 ```
 or
 ```bash
-pip install certbot-dns-dnspod-109
+pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
 ```
 
 
 #### snap:
 ```bash
-snap install certbot-dns-dnspod-109
-snap connect certbot:plugin certbot-dns-dnspod-109
-```
-
-if root snap:
-```bash
-snap install certbot-dns-dnspod-109
+snap install certbot-dns-dnspod-10935336
 snap set certbot trust-plugin-with-root=ok
-snap connect certbot:plugin certbot-dns-dnspod-109
+snap connect certbot:plugin certbot-dns-dnspod-10935336
 ```
 
 ### 2. Obtain SecretId and SecretKey
-   1. Visit https://console.cloud.tencent.com/cam to create a sub-user
-   2. Select "Programmatic access" for the sub-user access method
-   3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
-   4. Record SecretId and SecretKey
+1. Visit https://console.cloud.tencent.com/cam to create a sub-user
+2. Select "Programmatic access" for the sub-user access method
+3. Grant the sub-user QcloudDNSPodFullAccess (Cloud DNS full read and write access rights) permission
+4. Record SecretId and SecretKey
 
 ### 3. Prepare Credentials File
 
@@ -99,58 +101,62 @@ certbot certonly \
 ```
 
 Test run
-
 ```bash
 certbot certonly \
   --register-unsafely-without-email \
   -a dns-dnspod-109 \
   --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
+  --dns-dnspod-109-propagation-seconds 60 \
   -v \
   --dry-run
 ```
 
+## Parameter Description
+``--dns-dnspod-109-credentials <path>`` points to the credentials file. (Required)
 
+``--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)
 
 
 
 
+<br>
+<br>
+<br>
+<br>
+<br>
 
 # 简体中文
 
-
-
-
 ## 只是另一个适用于 Certbot 的 DNSPod DNS Authenticator 插件
 
 `certbot-dns-dnspod-109` 插件通过使用 Dnspod API（腾讯云 API 3.0）创建并随后删除 TXT 记录，自动完成`dns-01` 质询（`~acme.challenges.DNS01`）。
 
+如果你使用 [Dnspod](https://www.dnspod.cn/) ([腾讯云](https://cloud.tencent.com)) 作为你的域名解析服务提供商，那么这就是你的插件。
+
+在以下版本中测试通过
+- Certbot 3.0.1
+
 ## 使用方法
 
 ### 1. 安装
 
 #### pip:
 ```bash
-pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
+pip install certbot-dns-dnspod-109
 ```
 或者
 ```bash
-pip install certbot-dns-dnspod-109
+pip install git+https://github.com/10935336/certbot-dns-dnspod-109.git
 ```
 
 #### snap:
 ```bash
-snap install certbot-dns-dnspod-109
-snap connect certbot:plugin certbot-dns-dnspod-109
-```
-
-如果你使用 root snap:
-```bash
-snap install certbot-dns-dnspod-109
+snap install certbot-dns-dnspod-10935336
 snap set certbot trust-plugin-with-root=ok
-snap connect certbot:plugin certbot-dns-dnspod-109
+snap connect certbot:plugin certbot-dns-dnspod-10935336
 ```
 
-### 2. 获取SecretId和SecretKey
+### 2. 获取 SecretId 和 SecretKey
 1. 访问 https://console.cloud.tencent.com/cam 创建子用户
 2. 子用户访问方式选择“编程访问”
 3. 授予子用户 QcloudDNSPodFullAccess（Cloud DNS 完全读写访问权限）权限
@@ -196,12 +202,18 @@ certbot certonly \
 ```
 
 测试运行
-
 ```bash
 certbot certonly \
   --register-unsafely-without-email \
   -a dns-dnspod-109 \
   --dns-dnspod-109-credentials ~/.secrets/certbot/dnspod-109.ini \
+  --dns-dnspod-109-propagation-seconds 60 \
   -v \
   --dry-run
 ```
+
+## 参数说明
+``--dns-dnspod-109-credentials <路径>`` 指向凭证文件。（必需）
+
+``--dns-dnspod-109-propagation-seconds`` 在要求 ACME 服务器验证 DNS 记录之前等待 DNS 传播的秒数。如果显示 DNS 记录添加成功但验证失败，则尝试增加此值 。 （默认值：10）
+

{certbot_dns_dnspod_109-1.0.0.dist-info → certbot_dns_dnspod_109-1.0.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 certbot_dns_dnspod_109/__init__.py,sha256=qvnjZ72P7cvpavn66_Ws2c7s0Ft6OJpaSiIP8bAtYmc,3479
 certbot_dns_dnspod_109/_internal/__init__.py,sha256=TxsS2fQuUdzQP-YoerMhKrCrodqACPybbe2JDGdtcZw,95
-certbot_dns_dnspod_109/_internal/dns_dnspod.py,sha256=svj0ByFEAC6lTlDaZEzFw7nwOWKtx1T3ex_NGweeBXU,6375
+certbot_dns_dnspod_109/_internal/dns_dnspod.py,sha256=nNz-Fyve_1an-D-cMthvV2IcswrrffU-M5hZ2cB6KGM,6393
 certbot_dns_dnspod_109/_internal/tests/__init__.py,sha256=rjj8qB-_GHbjCMAlaq6MKyzVtE_NWf5A6NGYGC8JAPk,68
 certbot_dns_dnspod_109/_internal/tests/dns_dnspod_test.py,sha256=6J7Rgk7iEeW9J_32bpIx4wmQ9aiyyi7koCNXBbj5fTo,8864
-certbot_dns_dnspod_109-1.0.0.dist-info/LICENSE.txt,sha256=LMXecVrlqXbwhvukkwiAyeQhkUFz_IURG_9RTUdXEj8,10786
-certbot_dns_dnspod_109-1.0.0.dist-info/METADATA,sha256=SfKsnjyoeQluCVFScvtN7BTdhx66lNUzs8HBwB8Z5Ck,5149
-certbot_dns_dnspod_109-1.0.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-certbot_dns_dnspod_109-1.0.0.dist-info/entry_points.txt,sha256=ri1pHfGGa7B3kLCWkTGn8Xg32rdNTLqBv4pDHwD8OUs,93
-certbot_dns_dnspod_109-1.0.0.dist-info/top_level.txt,sha256=TZ8F7YwXuC4Q35y9QMVXnIAAf2aEEhxyBCQVwIK5yvg,23
-certbot_dns_dnspod_109-1.0.0.dist-info/RECORD,,
+certbot_dns_dnspod_109-1.0.1.dist-info/LICENSE.txt,sha256=LMXecVrlqXbwhvukkwiAyeQhkUFz_IURG_9RTUdXEj8,10786
+certbot_dns_dnspod_109-1.0.1.dist-info/METADATA,sha256=1FPk0y-ZkLhH105LbUrmM70uPu40adLJepCKjbcnafs,6097
+certbot_dns_dnspod_109-1.0.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+certbot_dns_dnspod_109-1.0.1.dist-info/entry_points.txt,sha256=ri1pHfGGa7B3kLCWkTGn8Xg32rdNTLqBv4pDHwD8OUs,93
+certbot_dns_dnspod_109-1.0.1.dist-info/top_level.txt,sha256=TZ8F7YwXuC4Q35y9QMVXnIAAf2aEEhxyBCQVwIK5yvg,23
+certbot_dns_dnspod_109-1.0.1.dist-info/RECORD,,