A dynamic DNS updater written in python.

Well actually it turned out to be the starting point for a complete dns api client :D

This project is heavily inspired by @stecklars project: https://github.com/stecklars/dynamic-dns-netcup-api

• netcup api key and api password (you can generate them in the customer control panel)
• at least one domain

• python >= 3.7 yes, you read right. This software makes use of some new features, especially dataclasses to construct the api data types
• pipenv is used to build the environment and execute the script

Python in the required version is no default in most linux distribution, but you can run in in a docker container. Included is a Dockerfile based on python:3.7-alpine. Build this by docker build -t nc_dyndns_python . and run by docker run nc_dyndns_python:latest.

• download the repository git clone https://github.com/spomjaksilp/netcup-dyndns.git
• change into the directory and run pipenv install

run pipenv run dyndns --help for information on options:

Usage: dyndns.py [OPTIONS] CONF HOSTS

 This script updates dns zone ttl and records based on the HOST file. See
 an example in hosts.sample. If not destination is specified, it uses the
 external ip found with ipify's api (https://www.ipify.org/).

 Additionally the api credentials must be passed via the settings.json file
 (again see settings.json.sample).

 !!! Please review your config in hosts.json, this script will NOT check
 the sanity of your dns entries. !!!

Options:
 -u, --update       update settings, defaults to False.
 -v, --verbose      debugging output.
 -t, --ttl INTEGER  change zone ttl to integer, defaults to not change ttl.
 --help             Show this message and exit.

This json file configures the api credentials.

{
 "API_URL":        "https://ccp.netcup.net/run/webservice/servers/endpoint.php?JSON",
 "API_PASSWORD":   "0123456789",
 "API_KEY":        "abcdefg",
 "CUSTOMER_ID":    "13"
}

Specifies the hosts to be updates.

If no destination is specified, the found external ip will be used.

{
  "zone":
  {
    "domainname": "example.com"
  },
  "hosts":  [
    {
      "hostname":     "alice",
      "type":         "A"
    },
    {
      "hostname":     "bob",
      "type":         "CNAME",
      "destination":  "alice.example.com"
    },
    {
      "hostname":     "charlie",
      "type":         "CNAME",
      "destination":  "alice.example.com"
    }
  ]
}

If you want to use api, please take a look at the source files.

Getting the external IP with www.ipify.org API:

from nc_api.utils.external_ip import ExternalIpify

print(ExternalIpify().ip)

Retrieving dns zone info and dns records:

import json

from nc_api import NcAPI

with open("settings.json") as fp:
    settings = json.load(fp)

# usage in a contextmanager makes sure the session is ended properly
with NcAPI(api_url=settings["API_URL"],
           api_key=settings["API_KEY"],
           api_password=settings["API_PASSWORD"],
           customer_id=settings["CUSTOMER_ID"]) as api:

    zone = api.infoDnsZone(domainname="example.com")
    print(zone.table())

    recordset = api.infoDnsRecords(domainname="example.com")
    print(recordset.table())