feat(providers): namesilo.com support (#866)

- Credits to @Zeustopher for writing most of the readme

Author: hyperring

.github/workflows/configs/mlc-config.json

@@ -32,6 +32,9 @@
     },
     {
       "pattern": "^https://my.vultr.com/settings/#settingsapi$"
+    },
+    {
+      "pattern": "^https://www.namesilo.com"
     }
   ],
   "timeout": "20s",

README.md

@@ -81,6 +81,7 @@ This readme and the [docs/](docs/) directory are **versioned** to match the prog
   - Myaddr
   - Name.com
   - Namecheap
+  - NameSilo
   - Netcup
   - NoIP
   - Now-DNS
@@ -247,6 +248,7 @@ Check the documentation for your DNS provider:
 - [Myaddr](docs/myaddr.md)
 - [Name.com](docs/name.com.md)
 - [Namecheap](docs/namecheap.md)
+- [NameSilo](docs/namesilo.md)
 - [Netcup](docs/netcup.md)
 - [NoIP](docs/noip.md)
 - [Now-DNS](docs/nowdns.md)

docs/namesilo.md

@@ -0,0 +1,51 @@
+# NameSilo
+
+[![NameSilo Website](../readme/namesilo.jpg)](https://www.namesilo.com)
+
+## Configuration
+
+### Example
+
+```json
+{
+  "settings": [
+    {
+      "provider": "namesilo",
+      "domain": "sub.example.com",
+      "key": "71dZaE8c2Aa926Ca2E8c1",
+      "ttl": 7207,
+      "ip_version": "ipv4"
+    }
+  ]
+}
+```
+
+### Compulsory parameters
+
+- `"domain"` is the domain to update. It can be `example.com` (root domain), `sub.example.com` (subdomain of `example.com`) or `*.example.com` for the wildcard.
+- `"key"` is the NameSilo API Key obtained using the domain setup instructions below. For example: `71dZaE8c2Aa926Ca2E8c1`.
+
+### Optional parameters
+
+- `"ip_version"` can be `ipv4` (A records), or `ipv6` (AAAA records) or `ipv4 or ipv6` (update one of the two, depending on the public ip found). It defaults to `ipv4 or ipv6`.
+- `"ipv6_suffix"` is the IPv6 interface identifier suffix to use. It can be for example `0:0:0:0:72ad:8fbb:a54e:bedd/64`. If left empty, it defaults to no suffix and the raw public IPv6 address obtained is used in the record updating.
+- `"ttl"` is the record's Time to Live (TTL), which defaults to `7207` seconds. It must be numeric, less than `2592001`, and greater than or equal to `3600`. TTL values of `3603` or `7207` may be subject to NameSilo's [Automatic TTL Adjustments](https://www.namesilo.com/support/v2/articles/domain-manager/dns-manager#auto_ttl).
+
+## Domain setup
+
+1. Login to the [Namesilo API Manager](https://www.namesilo.com/account/api-manager) with your account credentials.
+1. Generate an API key. The generated API key will look similar to `71dZaE8c2Aa926Ca2E8c1`.
+    - (do _not_ check the "Generate key for read-only access" box)
+
+    [![Before NameSilo API Key](../readme/namesilo1.jpg)](https://www.namesilo.com/account/api-manager)
+    [![After NameSilo API Key](../readme/namesilo2.jpg)](https://www.namesilo.com/account/api-manager)
+
+## Testing
+
+1. Go to the [NameSilo Domain Manager](https://www.namesilo.com/account_domains.php).
+1. Choose "Manage DNS for this domain" (the globe icon) for the domain you wish to test.
+    [![Manage DNS for this domain](../readme/namesilo3.jpg)](https://www.namesilo.com/account_domains.php)
+
+1. Change the IP address of the host to `127.0.0.1`.
+1. Run the ddns-updater.
+1. Refresh the Namesilo webpage to check the update occurred.

internal/provider/constants/providers.go

@@ -40,6 +40,7 @@ const (
 	Myaddr       models.Provider = "myaddr"
 	Namecheap    models.Provider = "namecheap"
 	NameCom      models.Provider = "name.com"
+	NameSilo     models.Provider = "namesilo"
 	Netcup       models.Provider = "netcup"
 	Njalla       models.Provider = "njalla"
 	NoIP         models.Provider = "noip"
@@ -94,6 +95,7 @@ func ProviderChoices() []models.Provider {
 		Myaddr,
 		Namecheap,
 		NameCom,
+		NameSilo,
 		Njalla,
 		NoIP,
 		NowDNS,

internal/provider/errors/validation.go

@@ -30,6 +30,7 @@ var (
 	ErrTokenNotValid          = errors.New("token is not valid")
 	ErrTTLNotSet              = errors.New("TTL is not set")
 	ErrTTLTooLow              = errors.New("TTL is too low")
+	ErrTTLTooHigh             = errors.New("TTL is too high")
 	ErrURLNotHTTPS            = errors.New("url is not https")
 	ErrURLNotSet              = errors.New("url is not set")
 	ErrUsernameNotSet         = errors.New("username is not set")

internal/provider/provider.go

@@ -46,6 +46,7 @@ import (
 	"github.com/qdm12/ddns-updater/internal/provider/providers/myaddr"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/namecheap"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/namecom"
+	"github.com/qdm12/ddns-updater/internal/provider/providers/namesilo"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/netcup"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/njalla"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/noip"
@@ -155,6 +156,8 @@ func New(providerName models.Provider, data json.RawMessage, domain, owner strin
 		return namecheap.New(data, domain, owner)
 	case constants.NameCom:
 		return namecom.New(data, domain, owner, ipVersion, ipv6Suffix)
+	case constants.NameSilo:
+		return namesilo.New(data, domain, owner, ipVersion, ipv6Suffix)
 	case constants.Netcup:
 		return netcup.New(data, domain, owner, ipVersion, ipv6Suffix)
 	case constants.Njalla: