Compare commits

...
1 Commits
Author SHA1 Message Date
sduesterhaupt 7d2e8028b8 docs(config): clarify ACME backend and DNS-01 configuration 2026-11-01 13:36:47 +01:00
+24 -10
View File
@@ -9,10 +9,10 @@
# Base directory of dynTLS configuration (defaults to script directory) # Base directory of dynTLS configuration (defaults to script directory)
#set_var DYNTLS "${0%/*}" #set_var DYNTLS "${0%/*}"
# Main ACME client program used for certificate operations # Main ACME client program, relative to DYNTLS
# You can set this to any compatible wrapper script or binary # The client must support the command-line interface used by dyntls.
# https://github.com/bruncsak/ght-acme.sh # Use the local backend for the customized BIND/nsupdate DNS-01 workflow.
#set_var DYNTLS_LE_PROGRAM "contrib/acme/letsencrypt.sh" #set_var DYNTLS_LE_PROGRAM "contrib/acme/letsencrypt_master_local.sh"
# OpenSSL binary (path if not in $PATH) # OpenSSL binary (path if not in $PATH)
#set_var DYNTLS_OPENSSL "openssl" #set_var DYNTLS_OPENSSL "openssl"
@@ -84,10 +84,24 @@
# Force regenerating keys on renewal (0=no, 1=yes) # Force regenerating keys on renewal (0=no, 1=yes)
#set_var DYNTLS_PKI_KEY_FORCE_RENEW 0 #set_var DYNTLS_PKI_KEY_FORCE_RENEW 0
# DNS validation (dns-01 challenge): server address and TSIG key file name # DNS-01 validation settings for the local ACME backend
#set_var DYNTLS_DNS_SERVER "root-dns.example365.tld" # Wildcard certificates require DNS-01 validation.
#set_var DYNTLS_DNS_TSIG "tsig.key"
#set_var DYNTLS_DNS_ZONE "" # DNS server receiving authenticated dynamic updates
#set_var DYNTLS_DNS_SERVER "dns-primary.example.net"
# Explicit path to the TSIG/RNDC key file
# The file must exist and be readable by the user running dyntls.
#set_var DYNTLS_DNS_TSIG "$DYNTLS/private/dns-primary_example_net.key"
# DNS zone setting
# The current wildcard workflow derives the zone from the certificate CN.
#set_var DYNTLS_DNS_ZONE ""
# The local ACME backend discovers authoritative nameservers from the zone.
# Before requesting validation, it checks all pending challenge TXT values
# in up to 10 rounds, waiting 5 seconds between unsuccessful rounds.
# No additional dyntls configuration variables are required for this check.
# ------------------------------------------------------------------ # ------------------------------------------------------------------
# LOGGING # LOGGING
@@ -145,13 +159,13 @@
# Commands to run before issuing/renewing a cert # Commands to run before issuing/renewing a cert
#set_list DYNTLS_CMD_PRE_LIST "" #set_list DYNTLS_CMD_PRE_LIST ""
# Commands to run after successfully issuing/renewing a cert # Commands to run after the ACME client invocation
#set_list DYNTLS_CMD_POST_LIST "" #set_list DYNTLS_CMD_POST_LIST ""
# ------------------------------------------------------------------ # ------------------------------------------------------------------
# BACKUP AND EXPIRATION # BACKUP AND EXPIRATION
# ------------------------------------------------------------------ # ------------------------------------------------------------------
# Days to keep backuped certificates before removal # Days to retain certificate backups before removal
# Set to 0 to disable automatic deletion of backups # Set to 0 to disable automatic deletion of backups
#set_var DYNTLS_BACKUP_EXPIRATION 360 #set_var DYNTLS_BACKUP_EXPIRATION 360