Dynamic DNS

To set up your Dynamic DNS, please do the following:

1. Log into your easyDNS account
2. Click on DNS for said domain (this should bring you to your DNS SETTINGS page)

3. Click on the MODULAR EDITOR tab
4. Click on the wrench tool for DYNAMIC RECORDS

5. Create your dynamic records by defining your hostname(s) and a TTL
6. Create a Dynamic Authenticated Token by clicking on ENABLE

7. Click NEXT

8. Confirm the changes

Setting Up Your System To Use Dynamic DNS

There are a number of different ways to make dynamic updates and they are all dependent on your local setup. They break down into two basic types:

Hardware-Based Options

Many routers have an option to enable dynamic updates. This can be very convenient, as the router is always the first place the IP address change makes itself known. Some of these include easyDNS as one of their options, and you need only select it from the menu they provide. Others allow you to enter the settings for your dynamic server.

Here are the basic parameters you will need:

• Server address (http://api.cp.easydns.com/dyn/tomato.php)
• Hostname (your domain name)
• User name (your easyDNS username)
• Password (this should be your dynamic token mentioned earlier)

If your router does not include easyDNS or allow you to enter your own parameters, you will want to use a software-based updater.

Software Based Options

There are dozens or more different options available for software-based dynamic updates. The following are the ones we are currently recommending:

• • Mac Systems
    We currently provide our own custom updater for Mac-based servers (OS 10), which can be downloaded directly from our system:

[easyddns Mac Client for OSX 10.7 and above]

[easyddns Mac Client for OSX 10.6]

[easyddns Mac Client for OSX below 10.6]

• Linux Systems
  For Linux, Sourceforge provides an excellent update client for Linux called ddclient. One of our clients has written a nice java-based client that runs on Linux and can be downloaded from their project site HERE.
• Windows Systems
  There’s a very nice piece of software called Dynsite, which continues to be maintained by its creator Noel Danjou. You can download it HERE. For a walkthrough on installing and configuring it, please see the Dynsite tutorial HERE.

easyDNS Dynamic DNS Client Specifications V1.3

The following is what you need to know to code a Dynamic DNS client for use with easyDNS. Giving credit where credit is due, the protocol used below was adapted from the format used at dyndns.org.

After evaluating various approaches out there, we felt theirs was the simplest and most straightforward. However, there are some differences such as the back _mx parameter which has a different meaning to our system.

If you code a completely generic client and follow the specification below, you can perform dynamic DNS updates by executing a GET method request on the following URL:

api.cp.easydns.com/dyn/generic.php

You can send the following parameters in the QUERY_STRING of a request, for example:

https://username:dynamictoken@api.cp.easydns.com/dyn/generic.php?hostname=example.com&myip=10.0.0.2

If you do not include the myip parameter, our update script will look to the IP the request originates from and update to that.

If you do code a client for easyDNS, please email our support team so we can keep you informed of any changes, enhancements, bug fixes etc. Also, please be sure to let us know about your client, which platform it runs on, and where our users can download it so we can add it to our dynamic page.

Parameters

• hostname
  The full hostname being updated.
• TLD
  The root domain of your hostname. For example, if your hostname is “example.co.uk” you should set “TLD” to “co.uk”. This field can be omitted in cases of second-level domains like example.com.
• myip
  The IP address of the client to be updated. Send “0.0.0.0” to set the record to an offline state (sets record to “offline.easydns.com”). If you are behind a firewall or NAT set this to 1.1.1.1 and our system will detect your remote IP for you.
• MX
  Use this parameter as the MX handler for the domain being updated. It defaults to preference 5.
• backmx
  Either “YES” or “NO”. If “YES” we set smtp.easydns.com to be a backup mail spool for the domain being updated at preference 100.
• wildcard
  Either “ON” or “OFF” or “YES”. If “ON” sets a wildcard host record for the domain being updated equal to the IP address specified in “myip”.

Result Codes Are As Follows:

• NOACCESS
  The authentication failed. This no only happens if the username/password is wrong, but if they send a hostname for a domain that isn’t under the user’s account.
• NOSERVICE
  Dynamic DNS is not turned on for this domain. Each domain must have its own DynDNS flag enabled individually (by the user) in their member settings.
• ILLEGAL INPUT
  Self-explanatory. The client sent data that is outside the allowed set for a DynDNS update.
• TOOSOON
  Not enough time has elapsed since the last update. You need to wait at least 10 minutes between updates.
• NOERROR or OK
  Everything works fine.

Both IPv4 and IPv6 are supported.

Regarding IPv6/AAAA, for the ‘myip’ parameter in the DYN update call, you can now pass an IPv6 address. Be sure to escape special characters like colons with %3A and forward slashes with %2F as necessary in IPv6 addresses. For example, the IPv6 address 2400:cb00:2049:1::a29f:1835 would be escaped in a DYN update url as &myip=2400%3Acb00%3A2049%3A1%3A%3Aa29f%3A1835