From f2392055a33e537ce88c6a3124106bfd3b8b8e57 Mon Sep 17 00:00:00 2001 From: Indrajit Raychaudhuri Date: Sun, 23 Apr 2023 18:25:21 -0500 Subject: dns: T5144: Modernize dynamic dns operation Apply next round of configuration tree updates to 'service dns dynamic' with the following changes: - Migrate `service dns dynamic interface [use-web]` to `service dns dynamic address ` or `service dns dynamic address web [web-options]` This communicates the intent that dynamic dns IP address is detected in only one way - using the `` or using an external web request, not both. - When using external web request, (`service dns dynamic address web`), external url is optional (`web-options url`). Ddclient defaults are used when unspecified, - Rename all config `login` to `username` for consistency and also to align better with alternative ddclient backends in consideration. - Apply global 'ipv6-enable' to per service 'ip-version: ipv6'. Selecting usage of IPv4 or IPv6 (or both simultaneously) is now at per service (protocol) level instead of global level. This allows more control on the ability to select IPv4 in some cases and IPv6 in some other cases wherever supported by the underlying ddclient protocol. - While the IP address (and by extension, the detection mechanism) is global, the way it is applied to a particular ddclient protocol depends on whether it supports IPv4 or IPv6 or both. - Related to the above, this also prevents generating incorrect config file (`ddclient.conf`) with multiple global sections leading to an unpredictable behavior of ddclient. - Implement provider (protocol) specific custom tweaks whenever possible (e.g., `zone`, `username`, `server` are not necessary in all cases). - Move service name from a combination of 'protocol' (with protocol config autodetected) and custom (with protocol config specified) to a single 'service' key. This allows for consisent setup of multiple config for the same ddclient protocol (with different options and credentials). This also avoid ambiguity with usual networking term 'protocol' and ddclient specific term 'protocol' (and can change with a move to a different backend). - Apply upfront XML constraints and validations consistently wherever applicable. - RFC2136 specific change: Rename rfc2136 config `record` to `host-name` for consistency. - Cloudflare specific change: While ddclient still supports authenticating with email and global auth key, skipping `username` in config will indicate the intent to use API token authentication (with special 'token' literal as `username`). --- interface-definitions/dns-dynamic.xml.in | 190 ++++++++------------- .../dns/dynamic-service-host-name-server.xml.i | 34 ++++ 2 files changed, 106 insertions(+), 118 deletions(-) create mode 100644 interface-definitions/include/dns/dynamic-service-host-name-server.xml.i (limited to 'interface-definitions') diff --git a/interface-definitions/dns-dynamic.xml.in b/interface-definitions/dns-dynamic.xml.in index 48c101d73..308dc5de0 100644 --- a/interface-definitions/dns-dynamic.xml.in +++ b/interface-definitions/dns-dynamic.xml.in @@ -12,141 +12,94 @@ Dynamic DNS - + - Interface to send Dynamic DNS updates for - - - + Obtain IP address to send Dynamic DNS update for txt - Interface name + Use interface to obtain the IP address + + web + Use HTTP(S) web request to obtain the IP address + + + + web + #include + web - + - RFC2136 Update name + Options when using HTTP(S) web request to obtain the IP address - + #include + - File containing the secret key shared with remote DNS server + Pattern to skip from the HTTP(S) respose - filename - File in /config/auth directory + txt + Pattern to skip from the HTTP(S) respose to extract the external IP address - - - Record to be updated - - - - - - Server to be updated - - - + + + + + RFC2136 nsupdate configuration + + txt + RFC2136 nsupdate service name + + + + #include + #include + - Time To Live (default: 600) + File containing the TSIG secret key shared with remote DNS server - u32:1-86400 - DNS forwarding cache size + filename + File in /config/auth directory - + - 600 + #include - Zone to be updated + Forwarding zone to be updated + + txt + RFC2136 Zone to be updated + + + + - Service being used for Dynamic DNS - - afraid changeip cloudflare dnspark dslreports dyndns easydns namecheap noip sitelutions zoneedit - + Dynamic DNS configuration txt - Dynanmic DNS service with a custom name - - - afraid - afraid.org Services - - - changeip - changeip.com Services - - - cloudflare - cloudflare.com Services + Dynamic DNS service name - - dnspark - dnspark.com Services - - - dslreports - dslreports.com Services - - - dyndns - dyndns.com Services - - - easydns - easydns.com Services - - - namecheap - namecheap.com Services - - - noip - noip.com Services - - - sitelutions - sitelutions.com Services - - - zoneedit - zoneedit.com Services - - - (custom|afraid|changeip|cloudflare|dnspark|dslreports|dyndns|easydns|namecheap|noip|sitelutions|zoneedit|\w+) - - You can use only predefined list of services or word characters (_, a-z, A-Z, 0-9) as service name - - - Hostname to register with Dynamic DNS service - - #include - - Host-name must be alphanumeric and can contain hyphens - - - - - - Login/Username for Dynamic DNS service - - + #include + #include + #include #include @@ -159,7 +112,6 @@ - #include DNS zone to update (not used by all protocols) @@ -169,31 +121,33 @@ - - - - - Use HTTP(S) web request to obtain external IP address instead of the IP address associated with the interface - - - + - Pattern to skip from the respose + IP address version to use - txt - Pattern to skip from the respose of the given URL to extract the external IP address + _ipv4 + Use only IPv4 address + + + _ipv6 + Use only IPv6 address + + both + Use both IPv4 and IPv6 address + + + ipv4 ipv6 both + + + (ipv[46]|both) + + IP Version must be literal 'ipv4', 'ipv6' or 'both' + ipv4 - #include - - - - Explicitly use IPv6 address instead of IPv4 address to update the Dynamic DNS IP address - - - + diff --git a/interface-definitions/include/dns/dynamic-service-host-name-server.xml.i b/interface-definitions/include/dns/dynamic-service-host-name-server.xml.i new file mode 100644 index 000000000..ee1af2a36 --- /dev/null +++ b/interface-definitions/include/dns/dynamic-service-host-name-server.xml.i @@ -0,0 +1,34 @@ + + + + Hostname to register with Dynamic DNS service + + #include + + Host-name must be alphanumeric and can contain hyphens + + + + + + Remote Dynamic DNS server to send updates to + + ipv4 + IPv4 address of the remote server + + + ipv6 + IPv6 address of the remote server + + + hostname + Fully qualified domain name of the remote server + + + + + + Remote server must be IP address or fully qualified domain name + + + -- cgit v1.2.3