INWX

INWX.de is a Berlin-based domain registrar.

Configuration

In your creds.json file you must provide your INWX username and password:

{
  "inwx":{
    "username": "yourUsername",
    "password": "yourPassword"
  }
}

Two factor authentication

INWX supports two factor authentication via TOTP and does not allow TOTP codes to be reused. This means that you will only be able to log into your INWX account once every 30 seconds. You will hit this limitation in the following two scenarios:

If you cannot work around these two limitation it is possible to contact the INWX support to request a sub-account for API access only without two factor authentication. See issue issue 848 for details.

If two factor authentication has been enabled you will also need to provide a valid TOTP number. This can also be done via an environment variable:

{
  "inwx":{
    "username": "yourUsername",
    "password": "yourPassword",
    "totp": "$INWX_TOTP"
  }
}

and then you can run

$ INWX_TOTP=12345 dnscontrol preview

It is also possible to directly provide the shared TOTP secret using the key “totp-key” in creds.json. This secret is only shown once when two factor authentication is enabled and you’ll have to make sure to write it down then.

Important Notes:

{
  "inwx":{
    "username": "yourUsername",
    "password": "yourPassword",
    "totp-key": "yourTOTPSharedSecret"
  }
}

Sandbox

You can optionally also specify sandbox with a value of 1 to redirect all requests to the sandbox API instead:

{
  "inwx":{
    "username": "yourUsername",
    "password": "yourPassword",
    "sandbox": "1"
  }
}

If sandbox is omitted or set to any other value the production API will be used.

Metadata

This provider does not recognize any special metadata fields unique to INWX.

Usage

Example Javascript for example.tld registered with INWX and delegated to CloudFlare:

var regInwx = NewRegistrar('inwx', 'INWX')
var dnsCF = NewDnsProvider('cloudflare', 'CLOUDFLAREAPI')

D("example.tld", regInwx, DnsProvider(dnsCF),
    A("test","1.2.3.4")
);