github.com/StackExchange/dnscontrol/v4@v4.11.0/documentation/provider/hostingde.md (about)

     1  ## Configuration
     2  
     3  To use this provider, add an entry to `creds.json` with `TYPE` set to `HOSTINGDE`
     4  along with your [`authToken` and optionally an `ownerAccountId`](https://www.hosting.de/api/#requests-and-authentication).
     5  
     6  Example:
     7  
     8  {% code title="creds.json" %}
     9  ```json
    10  {
    11    "hosting.de": {
    12      "TYPE": "HOSTINGDE",
    13      "authToken": "YOUR_API_KEY"
    14    }
    15  }
    16  ```
    17  {% endcode %}
    18  
    19  ## Usage
    20  
    21  An example configuration:
    22  
    23  {% code title="dnsconfig.js" %}
    24  ```javascript
    25  var REG_HOSTINGDE = NewRegistrar("hosting.de");
    26  var DSP_HOSTINGDE = NewDnsProvider("hosting.de");
    27  
    28  D("example.com", REG_HOSTINGDE, DnsProvider(DSP_HOSTINGDE),
    29      A("test", "1.2.3.4"),
    30  END);
    31  ```
    32  {% endcode %}
    33  
    34  ## Using this provider with http.net and others
    35  
    36  http.net and other DNS service providers use an API that is compatible with hosting.de's API.
    37  Using them requires setting the `baseURL` and (optionally) overriding the default nameservers.
    38  
    39  ### Example http.net configuration
    40  
    41  An example `creds.json` configuration:
    42  
    43  {% code title="creds.json" %}
    44  ```json
    45  {
    46    "http.net": {
    47      "TYPE": "HOSTINGDE",
    48      "authToken": "YOUR_API_KEY",
    49      "baseURL": "https://partner.http.net"
    50    }
    51  }
    52  ```
    53  {% endcode %}
    54  
    55  An example configuration:
    56  
    57  {% code title="dnsconfig.js" %}
    58  ```javascript
    59  var REG_HTTPNET = NewRegistrar("http.net");
    60  
    61  var DSP_HTTPNET = NewDnsProvider("http.net", {
    62    "default_ns": [
    63      "ns1.routing.net.",
    64      "ns2.routing.net.",
    65      "ns3.routing.net.",
    66    ],
    67  });
    68  ```
    69  {% endcode %}
    70  
    71  #### Why this works
    72  
    73  hosting.de has the concept of _nameserver sets_ but this provider does not implement it.
    74  The `HOSTINGDE` provider **ignores the default nameserver set** defined in your account to avoid unintentional changes and consolidate the full configuration in DNSControl.
    75  Instead, it uses hosting.de's nameservers (`ns1.hosting.de.`, `ns2.hosting.de.`, and `ns3.hosting.de.`) by default, regardless of your account settings.
    76  Using the `default_ns` metadata, the default nameserver set can be overwritten.