Knowledge Base

DNS Made Easy Enterprise DNS services provide support for dynamic IP addresses and the capability to issue instantly propagated IP updates as soon as a change is made.

Dynamic DNS helps you avoid connection interruptions and allows you to use applications that usually require a static IP address. Dynamic DNS offers an easy way to host servers (web servers, email servers, ftp servers) that would otherwise be very difficult or impossible to accomplish without a static IP address.

How It Works

Dynamic DNS clients allow you to perform IP updates by passing parameters to an HTTP or HTTPS request. There are currently many free or paid clients on the Internet that detect your IP and allow you to pass the necessary arguments in the URL.

If you would like to develop a client and notify us, we will list your product and URL on this page. Please consult the authors of the clients or any provided documentation available with each client for technical support related to that respective client's configuration.

• Dynamic DNS Clients
• Documentation
• Locate Your Record ID
• Troubleshoot

Dynamic DNS Clients

Linux / Unix

Netgear RT31*DSL/cable routers by Jonathan Loran jonloran@yahoo.com

Shell Program

DDNS Python Script with https Support by Pekka Wallendahl

Java / Cross Platform

(UNIX / Linux / Windows / Mac, etc.)

Direct Update

Windows .Net client - Crestline DNSMEU by Perry Stathopoulos support@crestline.net

DynSite for Windows

3DWatch by EUROCOMP

Jip

DnsMadeEasy DNS Update by Esoteric Software (Windows/Mac/Linux)

Dynamic DNS script in NodeJS

Dynamic DNS VBScript using Microsoft Windows Script Host

Minglebit for MacOS

iOS App Store download

dDNS Broker app for Mac

Documentation

To make Dynamic Updates, calls need to be formulated using either HTTP/HTTPS or a dynamic DNS client.

The necessary arguments you need to pass are:

username – The username you use to log into DNS Made Easy.

password – The password you use to log into DNS Made Easy (or per record password if configured).

id- The unique ID for your record.

ip – The new IP for your record.

All arguments are required to make a successful call. From the DNS – Managed DNS menu, you can select a record and edit it to turn on Dynamic DNS and an option to set a password per record so you do not have to use your main DMS Made Easy password/username. DNS Made Easy uses the "record ID" so you are able to update any A record that you have in the system. In fact, you can update a backup IP in your DNS failover configuration or even one of your A records in your "round-robin" configuration. You can even update more than one ID at a time when you separate them by commas (,). You can view the record IDs for A records with DNS Failover on the DNS Failover configuration screen. These are the record IDs you would use to configure DDNS updates for your failover IPs.

Dynamic DNS Technical Specification Page to create a client for DDNS

All updates are made through a servlet. You must analyze the data that is sent back to you. The page (servlet) returns a string.

Here is the rundown:

The servlet is: https://cp.dnsmadeeasy.com/servlet/updateip?

You can also use http: http://cp.dnsmadeeasy.com/servlet/updateip?

Each DNS Made Easy user has four pieces of information they need to provide:

username (which is usually the users email account they use to log into DNS Made Easy)

password

record ID (Starting in 12/2003: separated by commas if more than one at a time)

ip – The new IP for your record.

The client will usually add the new IP

There are 4 parameters that you can pass in a POST or GET request to the following URL:

https://cp.dnsmadeeasy.com/servlet/updateip

The four parameters are: "username", "password", "id", and "ip".

Note: That if your password does have special characters you may have to convert them to HEX first.
https://en.wikipedia.org/wiki/ASCII

An example would be:

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007&ip=12.13.14.15

or (Starting in December of 2003)

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007,1008,1009&ip=12.13.14.15

You can also use just the HTTP protocol:

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007&ip=12.13.14.15

or (Starting in December of 2003)

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007,1008,1009&ip=12

 

Locate Your Record ID

Every record in DNS Made Easy is assigned a unique ID which is required as part of the call to pass in a dynamic update.

To locate your record ID:

Log In

Click the DNS – Managed DNS menu.

Select a domain and click on the Records tab

Double-click a record

If the DDNS check box is not enabled, enable it. The Record ID is the Dynamic DNS ID on this page that appears below the check box.

 

Troubleshooting

• "error-auth" Invalid username or password, or invalid IP syntax
• "error-auth-suspend" User has had his / her account suspended. This is if I get complaints about them or if they misuse the service.
• "error-auth-voided" User has had his / her account revoked. Same thing as suspended but this is permanent.
• "error-record-invalid" Record does not exist in the system. / Unable to update record in system database.
• "error-record-auth" User does not have access to this record.
• "error-record-ip-same" IP never changed so nothing was done.
• "error-system" General system error which is caught and recognized by the system.
• "error" General system error unrecognized by the system.
• "success" The one and only good message.