dnscontrol/docs/_providers/hostingde.md
Julius Rickert d5665ceaf6
Documentation: Customizing nameservers for hosting.de provider (#1396)
* Add support for default nameservers

Uses provider metadata with default_ns key.

Fixes #1401.

* Fix formatting

* Add documentation on custom nameservers

* Rework hosting.de documentation

Separate usage with hosting.de and usage with compatible providers.

Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
2022-02-22 10:54:02 -05:00

1.8 KiB

name title layout jsId
hosting.de hosting.de Provider default hostingde

hosting.de Provider

Configuration

In your credentials file, you must provide your authToken and optionally an ownerAccountId.

Example creds.json

{
  "hosting.de": {
    "authToken": "YOUR_API_KEY"
  }
}

Usage

Example dnsconfig.js

var REG_HOSTINGDE = NewRegistrar('hosting.de', 'HOSTINGDE')
var DNS_HOSTINGDE = NewDnsProvider('hosting.de' 'HOSTINGDE');

D('example.tld', REG_HOSTINGDE, DnsProvider(DNS_HOSTINGDE),
    A('test', '1.2.3.4')
);

Using this provider with http.net and others

http.net and other DNS service providers use an API that is compatible with hosting.de's API. Using them requires setting the baseURL and (optionally) overriding the default nameservers.

Example http.net configuration

Example creds.json

{
  "http.net": {
    "authToken": "YOUR_API_KEY",
    "baseURL": "https://partner.http.net"
  }
}

Example dnsconfig.js

var REG_HTTPNET = NewRegistrar('http.net', 'HOSTINGDE');

var DNS_HTTPNET = NewDnsProvider('http.net', 'HOSTINGDE', {
  default_ns: [
    'ns1.routing.net.',
    'ns2.routing.net.',
    'ns3.routing.net.',
  ],
});

Why this works

hosting.de has the concept of nameserver sets but this provider does not implement it. The HOSTINGDE provider ignores the default nameserver set defined in your account to avoid unintentional changes and consolidate the full configuration in DNSControl. Instead, it uses hosting.de's nameservers (ns1.hosting.de., ns2.hosting.de., and ns3.hosting.de.) by default, regardless of your account settings. Using the default_ns metadata, the default nameserver set can be overwritten.