[pve-devel] [PATCH docs v2] acme: add note about validation delay

[pve-devel] [PATCH docs v2] acme: add note about validation delay

[Folke Gleumes]

The effect and unit of the validation delay was unclear from our
documentation, and the link to the acme.sh documentation didn't explain
it either

Signed-off-by: Folke Gleumes <f.gleumes@proxmox.com>
---

since v1:
* slight rewording suggested by Alex

 certificate-management.adoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/certificate-management.adoc b/certificate-management.adoc
index 639c15a..fb22398 100644
--- a/certificate-management.adoc
+++ b/certificate-management.adoc
@@ -177,7 +177,9 @@ interface (`Datacenter -> ACME`).
 [thumbnail="screenshot/gui-datacenter-acme-add-dns-plugin.png"]
 
 Choose `DNS` as challenge type. Then you can select your API provider, enter
-the credential data to access your account over their API.
+the credential data to access your account over their API. The validation delay determines the
+time in seconds between setting the DNS record and prompting the ACME provider to validate it,
+as providers often need some time to propagate the record in their infrastructure.
 
 TIP: See the acme.sh
 https://github.com/acmesh-official/acme.sh/wiki/dnsapi#how-to-use-dns-api[How to use DNS API]
-- 
2.39.2



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] applied: [PATCH docs v2] acme: add note about validation delay

[Thomas Lamprecht]

Am 18/06/2024 um 16:15 schrieb Folke Gleumes:
> The effect and unit of the validation delay was unclear from our
> documentation, and the link to the acme.sh documentation didn't explain
> it either
> 
> Signed-off-by: Folke Gleumes <f.gleumes@proxmox.com>
> ---
> 
> since v1:
> * slight rewording suggested by Alex
> 
>  certificate-management.adoc | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
>

applied, thanks!

I reflowed the text-width to 80 cc though, while 100 cc is fine in general,
this file was quite strictly honoring 80 cc, so the addition rather stuck
out, but just for the record, it's only a very tiny stylistic nit after all.


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel