###############################################################################
import logging
+import urllib2
+import xml.dom.minidom
from i18n import _
logger.propagate = 1
class DDNSProvider(object):
- INFO = {
- # A short string that uniquely identifies
- # this provider.
- "handle" : None,
+ # A short string that uniquely identifies
+ # this provider.
+ handle = None
- # The full name of the provider.
- "name" : None,
+ # The full name of the provider.
+ name = None
- # A weburl to the homepage of the provider.
- # (Where to register a new account?)
- "website" : None,
+ # A weburl to the homepage of the provider.
+ # (Where to register a new account?)
+ website = None
- # A list of supported protocols.
- "protocols" : ["ipv6", "ipv4"],
- }
+ # A list of supported protocols.
+ protocols = ("ipv6", "ipv4")
DEFAULT_SETTINGS = {}
def __cmp__(self, other):
return cmp(self.hostname, other.hostname)
- @property
- def name(self):
- """
- Returns the name of the provider.
- """
- return self.INFO.get("name")
-
- @property
- def website(self):
- """
- Returns the website URL of the provider
- or None if that is not available.
- """
- return self.INFO.get("website", None)
-
- @property
- def handle(self):
- """
- Returns the handle of this provider.
- """
- return self.INFO.get("handle")
-
def get(self, key, default=None):
"""
Get a setting from the settings dictionary.
return self.get("password")
@property
- def protocols(self):
- return self.INFO.get("protocols")
+ def token(self):
+ """
+ Fast access to the token.
+ """
+ return self.get("token")
def __call__(self, force=False):
if force:
- logger.info(_("Updating %s forced") % self.hostname)
+ logger.debug(_("Updating %s forced") % self.hostname)
# Check if we actually need to update this host.
elif self.is_uptodate(self.protocols):
- logger.info(_("%s is already up to date") % self.hostname)
+ logger.debug(_("%s is already up to date") % self.hostname)
return
# Execute the update.
current_address = self.get_address(proto)
+ # If no addresses for the given protocol exist, we
+ # are fine...
+ if current_address is None and not addresses:
+ continue
+
if not current_address in addresses:
return False
"""
return self.core.system.send_request(*args, **kwargs)
- def get_address(self, proto):
+ def get_address(self, proto, default=None):
"""
Proxy method to get the current IP address.
"""
- return self.core.system.get_address(proto)
+ return self.core.system.get_address(proto) or default
+
+
+class DDNSProviderAllInkl(DDNSProvider):
+ handle = "all-inkl.com"
+ name = "All-inkl.com"
+ website = "http://all-inkl.com/"
+ protocols = ("ipv4",)
+
+ # There are only information provided by the vendor how to
+ # perform an update on a FRITZ Box. Grab requried informations
+ # from the net.
+ # http://all-inkl.goetze.it/v01/ddns-mit-einfachen-mitteln/
+
+ url = "http://dyndns.kasserver.com"
+
+ def update(self):
+ # There is no additional data required so we directly can
+ # send our request.
+ response = self.send_request(self.url, username=self.username, password=self.password)
+
+ # Get the full response message.
+ output = response.read()
+
+ # Handle success messages.
+ if output.startswith("good") or output.startswith("nochg"):
+ return
+
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError
class DDNSProviderDHS(DDNSProvider):
- INFO = {
- "handle" : "dhs.org",
- "name" : "DHS International",
- "website" : "http://dhs.org/",
- "protocols" : ["ipv4",]
- }
+ handle = "dhs.org"
+ name = "DHS International"
+ website = "http://dhs.org/"
+ protocols = ("ipv4",)
# No information about the used update api provided on webpage,
# grabed from source code of ez-ipudate.
+
url = "http://members.dhs.org/nic/hosts"
def update(self):
if response.code == 200:
return
- # Handle error codes.
- elif response.code == 401:
- raise DDNSAuthenticationError
-
# If we got here, some other update error happened.
raise DDNSUpdateError
class DDNSProviderDNSpark(DDNSProvider):
- INFO = {
- "handle" : "dnspark.com",
- "name" : "DNS Park",
- "website" : "http://dnspark.com/",
- "protocols" : ["ipv4",]
- }
+ handle = "dnspark.com"
+ name = "DNS Park"
+ website = "http://dnspark.com/"
+ protocols = ("ipv4",)
# Informations to the used api can be found here:
# https://dnspark.zendesk.com/entries/31229348-Dynamic-DNS-API-Documentation
+
url = "https://control.dnspark.com/api/dynamic/update.php"
def update(self):
class DDNSProviderDtDNS(DDNSProvider):
- INFO = {
- "handle" : "dtdns.com",
- "name" : "DtDNS",
- "website" : "http://dtdns.com/",
- "protocols" : ["ipv4",]
- }
+ handle = "dtdns.com"
+ name = "DtDNS"
+ website = "http://dtdns.com/"
+ protocols = ("ipv4",)
# Information about the format of the HTTPS request is to be found
# http://www.dtdns.com/dtsite/updatespec
- url = "https://www.dtdns.com/api/autodns.cfm"
+ url = "https://www.dtdns.com/api/autodns.cfm"
def update(self):
data = {
class DDNSProviderDynDNS(DDNSProvider):
- INFO = {
- "handle" : "dyndns.org",
- "name" : "Dyn",
- "website" : "http://dyn.com/dns/",
- "protocols" : ["ipv4",]
- }
+ handle = "dyndns.org"
+ name = "Dyn"
+ website = "http://dyn.com/dns/"
+ protocols = ("ipv4",)
# Information about the format of the request is to be found
# http://http://dyn.com/support/developers/api/perform-update/
# http://dyn.com/support/developers/api/return-codes/
+
url = "https://members.dyndns.org/nic/update"
- def update(self):
+ def _prepare_request_data(self):
data = {
"hostname" : self.hostname,
"myip" : self.get_address("ipv4"),
}
+ return data
+
+ def update(self):
+ data = self._prepare_request_data()
+
# Send update to the server.
- response = self.send_request(self.url, username=self.username, password=self.password,
- data=data)
+ response = self.send_request(self.url, data=data,
+ username=self.username, password=self.password)
# Get the full response message.
output = response.read()
elif output == "dnserr":
raise DDNSInternalServerError(_("DNS error encountered."))
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError(_("Server response: %s") % output)
+
+
+class DDNSProviderDynU(DDNSProviderDynDNS):
+ handle = "dynu.com"
+ name = "Dynu"
+ website = "http://dynu.com/"
+ protocols = ("ipv6", "ipv4",)
+
+ # Detailed information about the request and response codes
+ # are available on the providers webpage.
+ # http://dynu.com/Default.aspx?page=dnsapi
+
+ url = "https://api.dynu.com/nic/update"
+
+ def _prepare_request_data(self):
+ data = DDNSProviderDynDNS._prepare_request_data(self)
+
+ # This one supports IPv6
+ data.update({
+ "myipv6" : self.get_address("ipv6"),
+ })
+
+ return data
+
+
+class DDNSProviderEasyDNS(DDNSProviderDynDNS):
+ handle = "easydns.com"
+ name = "EasyDNS"
+ website = "http://www.easydns.com/"
+
+ # There is only some basic documentation provided by the vendor,
+ # also searching the web gain very poor results.
+ # http://mediawiki.easydns.com/index.php/Dynamic_DNS
+
+ url = "http://api.cp.easydns.com/dyn/tomato.php"
+
+
+class DDNSProviderFreeDNSAfraidOrg(DDNSProvider):
+ handle = "freedns.afraid.org"
+ name = "freedns.afraid.org"
+ website = "http://freedns.afraid.org/"
+
+ # No information about the request or response could be found on the vendor
+ # page. All used values have been collected by testing.
+ url = "https://freedns.afraid.org/dynamic/update.php"
+
+ @property
+ def proto(self):
+ return self.get("proto")
+
+ def update(self):
+ address = self.get_address(self.proto)
+
+ data = {
+ "address" : address,
+ }
+
+ # Add auth token to the update url.
+ url = "%s?%s" % (self.url, self.token)
+
+ # Send update to the server.
+ response = self.send_request(url, data=data)
+
+ if output.startswith("Updated") or "has not changed" in output:
+ return
+
+ # Handle error codes.
+ if output == "ERROR: Unable to locate this record":
+ raise DDNSAuthenticationError
+ elif "is an invalid IP address" in output:
+ raise DDNSRequestError(_("Invalid IP address has been sent."))
+
# If we got here, some other update error happened.
raise DDNSUpdateError
class DDNSProviderLightningWireLabs(DDNSProvider):
- INFO = {
- "handle" : "dns.lightningwirelabs.com",
- "name" : "Lightning Wire Labs",
- "website" : "http://dns.lightningwirelabs.com/",
- "protocols" : ["ipv6", "ipv4",]
- }
+ handle = "dns.lightningwirelabs.com"
+ name = "Lightning Wire Labs DNS Service"
+ website = "http://dns.lightningwirelabs.com/"
# Information about the format of the HTTPS request is to be found
# https://dns.lightningwirelabs.com/knowledge-base/api/ddns
- url = "https://dns.lightningwirelabs.com/update"
- @property
- def token(self):
- """
- Fast access to the token.
- """
- return self.get("token")
+ url = "https://dns.lightningwirelabs.com/update"
def update(self):
data = {
"hostname" : self.hostname,
+ "address6" : self.get_address("ipv6", "-"),
+ "address4" : self.get_address("ipv4", "-"),
}
- # Check if we update an IPv6 address.
- address6 = self.get_address("ipv6")
- if address6:
- data["address6"] = address6
-
- # Check if we update an IPv4 address.
- address4 = self.get_address("ipv4")
- if address4:
- data["address4"] = address4
-
- # Raise an error if none address is given.
- if not data.has_key("address6") and not data.has_key("address4"):
- raise DDNSConfigurationError
-
# Check if a token has been set.
if self.token:
data["token"] = self.token
if response.code == 200:
return
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError
+
+
+class DDNSProviderNamecheap(DDNSProvider):
+ handle = "namecheap.com"
+ name = "Namecheap"
+ website = "http://namecheap.com"
+ protocols = ("ipv4",)
+
+ # Information about the format of the HTTP request is to be found
+ # https://www.namecheap.com/support/knowledgebase/article.aspx/9249/0/nc-dynamic-dns-to-dyndns-adapter
+ # https://community.namecheap.com/forums/viewtopic.php?f=6&t=6772
+
+ url = "https://dynamicdns.park-your-domain.com/update"
+
+ def parse_xml(self, document, content):
+ # Send input to the parser.
+ xmldoc = xml.dom.minidom.parseString(document)
+
+ # Get XML elements by the given content.
+ element = xmldoc.getElementsByTagName(content)
+
+ # If no element has been found, we directly can return None.
+ if not element:
+ return None
+
+ # Only get the first child from an element, even there are more than one.
+ firstchild = element[0].firstChild
+
+ # Get the value of the child.
+ value = firstchild.nodeValue
+
+ # Return the value.
+ return value
+
+ def update(self):
+ # Namecheap requires the hostname splitted into a host and domain part.
+ host, domain = self.hostname.split(".", 1)
+
+ data = {
+ "ip" : self.get_address("ipv4"),
+ "password" : self.password,
+ "host" : host,
+ "domain" : domain
+ }
+
+ # Send update to the server.
+ response = self.send_request(self.url, data=data)
+
+ # Get the full response message.
+ output = response.read()
+
+ # Handle success messages.
+ if self.parse_xml(output, "IP") == self.get_address("ipv4"):
+ return
+
# Handle error codes.
- if response.code == 403:
+ errorcode = self.parse_xml(output, "ResponseNumber")
+
+ if errorcode == "304156":
raise DDNSAuthenticationError
- elif response.code == 400:
- raise DDNSRequestError
+ elif errorcode == "316153":
+ raise DDNSRequestError(_("Domain not found."))
+ elif errorcode == "316154":
+ raise DDNSRequestError(_("Domain not active."))
+ elif errorcode in ("380098", "380099"):
+ raise DDNSInternalServerError
# If we got here, some other update error happened.
raise DDNSUpdateError
-class DDNSProviderNOIP(DDNSProvider):
- INFO = {
- "handle" : "no-ip.com",
- "name" : "No-IP",
- "website" : "http://www.no-ip.com/",
- "protocols" : ["ipv4",]
- }
+class DDNSProviderNOIP(DDNSProviderDynDNS):
+ handle = "no-ip.com"
+ name = "No-IP"
+ website = "http://www.no-ip.com/"
# Information about the format of the HTTP request is to be found
# here: http://www.no-ip.com/integrate/request and
# here: http://www.no-ip.com/integrate/response
- url = "http://%(username)s:%(password)s@dynupdate.no-ip.com/nic/update"
-
- def update(self):
- url = self.url % {
- "username" : self.username,
- "password" : self.password,
- }
+ url = "http://dynupdate.no-ip.com/nic/update"
+ def _prepare_request_data(self):
data = {
"hostname" : self.hostname,
"address" : self.get_address("ipv4"),
}
- # Send update to the server.
- response = self.send_request(url, data=data)
+ return data
+
+
+class DDNSProviderOVH(DDNSProviderDynDNS):
+ handle = "ovh.com"
+ name = "OVH"
+ website = "http://www.ovh.com/"
+
+ # OVH only provides very limited information about how to
+ # update a DynDNS host. They only provide the update url
+ # on the their german subpage.
+ #
+ # http://hilfe.ovh.de/DomainDynHost
+
+ url = "https://www.ovh.com/nic/update"
+
+ def _prepare_request_data(self):
+ data = DDNSProviderDynDNS._prepare_request_data(self)
+ data.update({
+ "system" : "dyndns",
+ })
+
+ return data
+
+
+class DDNSProviderRegfish(DDNSProvider):
+ handle = "regfish.com"
+ name = "Regfish GmbH"
+ website = "http://www.regfish.com/"
+
+ # A full documentation to the providers api can be found here
+ # but is only available in german.
+ # https://www.regfish.de/domains/dyndns/dokumentation
+
+ url = "https://dyndns.regfish.de/"
+
+ def update(self):
+ data = {
+ "fqdn" : self.hostname,
+ }
+
+ # Check if we update an IPv6 address.
+ address6 = self.get_address("ipv6")
+ if address6:
+ data["ipv6"] = address6
+
+ # Check if we update an IPv4 address.
+ address4 = self.get_address("ipv4")
+ if address4:
+ data["ipv4"] = address4
+
+ # Raise an error if none address is given.
+ if not data.has_key("ipv6") and not data.has_key("ipv4"):
+ raise DDNSConfigurationError
+
+ # Check if a token has been set.
+ if self.token:
+ data["token"] = self.token
+
+ # Raise an error if no token and no useranem and password
+ # are given.
+ elif not self.username and not self.password:
+ raise DDNSConfigurationError(_("No Auth details specified."))
+
+ # HTTP Basic Auth is only allowed if no token is used.
+ if self.token:
+ # Send update to the server.
+ response = self.send_request(self.url, data=data)
+ else:
+ # Send update to the server.
+ response = self.send_request(self.url, username=self.username, password=self.password,
+ data=data)
# Get the full response message.
output = response.read()
# Handle success messages.
- if output.startswith("good") or output.startswith("nochg"):
+ if "100" in output or "101" in output:
return
# Handle error codes.
- if output == "badauth":
+ if "401" or "402" in output:
raise DDNSAuthenticationError
- elif output == "aduse":
- raise DDNSAbuseError
- elif output == "911":
+ elif "408" in output:
+ raise DDNSRequestError(_("Invalid IPv4 address has been sent."))
+ elif "409" in output:
+ raise DDNSRequestError(_("Invalid IPv6 address has been sent."))
+ elif "412" in output:
+ raise DDNSRequestError(_("No valid FQDN was given."))
+ elif "414" in output:
raise DDNSInternalServerError
# If we got here, some other update error happened.
raise DDNSUpdateError
-class DDNSProviderSelfhost(DDNSProvider):
- INFO = {
- "handle" : "selfhost.de",
- "name" : "Selfhost.de",
- "website" : "http://www.selfhost.de/",
- "protocols" : ["ipv4",],
- }
+class DDNSProviderSelfhost(DDNSProviderDynDNS):
+ handle = "selfhost.de"
+ name = "Selfhost.de"
+ website = "http://www.selfhost.de/"
- url = "https://carol.selfhost.de/update"
+ url = "https://carol.selfhost.de/nic/update"
- def update(self):
+ def _prepare_request_data(self):
+ data = DDNSProviderDynDNS._prepare_request_data(self)
+ data.update({
+ "hostname" : "1",
+ })
+
+ return data
+
+
+class DDNSProviderSPDNS(DDNSProviderDynDNS):
+ handle = "spdns.org"
+ name = "SPDNS"
+ website = "http://spdns.org/"
+
+ # Detailed information about request and response codes are provided
+ # by the vendor. They are using almost the same mechanism and status
+ # codes as dyndns.org so we can inherit all those stuff.
+ #
+ # http://wiki.securepoint.de/index.php/SPDNS_FAQ
+ # http://wiki.securepoint.de/index.php/SPDNS_Update-Tokens
+
+ url = "https://update.spdns.de/nic/update"
+
+
+class DDNSProviderStrato(DDNSProviderDynDNS):
+ handle = "strato.com"
+ name = "Strato AG"
+ website = "http:/www.strato.com/"
+
+ # Information about the request and response can be obtained here:
+ # http://www.strato-faq.de/article/671/So-einfach-richten-Sie-DynDNS-f%C3%BCr-Ihre-Domains-ein.html
+
+ url = "https://dyndns.strato.com/nic/update"
+
+
+class DDNSProviderTwoDNS(DDNSProviderDynDNS):
+ handle = "twodns.de"
+ name = "TwoDNS"
+ website = "http://www.twodns.de"
+
+ # Detailed information about the request can be found here
+ # http://twodns.de/en/faqs
+ # http://twodns.de/en/api
+
+ url = "https://update.twodns.de/update"
+
+ def _prepare_request_data(self):
data = {
- "username" : self.username,
- "password" : self.password,
- "textmodi" : "1",
+ "ip" : self.get_address("ipv4"),
+ "hostname" : self.hostname
}
- response = self.send_request(self.url, data=data)
+ return data
+
+
+class DDNSProviderUdmedia(DDNSProviderDynDNS):
+ handle = "udmedia.de"
+ name = "Udmedia GmbH"
+ website = "http://www.udmedia.de"
+
+ # Information about the request can be found here
+ # http://www.udmedia.de/faq/content/47/288/de/wie-lege-ich-einen-dyndns_eintrag-an.html
+
+ url = "https://www.udmedia.de/nic/update"
- match = re.search("status=20(0|4)", response.read())
- if not match:
- raise DDNSUpdateError
class DDNSProviderVariomedia(DDNSProviderDynDNS):
- INFO = {
- "handle" : "variomedia.de",
- "name" : "Variomedia",
- "website" : "http://www.variomedia.de/",
- "protocols" : ["ipv6", "ipv4",]
- }
+ handle = "variomedia.de"
+ name = "Variomedia"
+ website = "http://www.variomedia.de/"
+ protocols = ("ipv6", "ipv4",)
# Detailed information about the request can be found here
# https://dyndns.variomedia.de/
"hostname" : self.hostname,
"myip" : self.get_address(self.proto)
}
+
+ return data
+
+
+class DDNSProviderZoneedit(DDNSProvider):
+ handle = "zoneedit.com"
+ name = "Zoneedit"
+ website = "http://www.zoneedit.com"
+
+ # Detailed information about the request and the response codes can be
+ # obtained here:
+ # http://www.zoneedit.com/doc/api/other.html
+ # http://www.zoneedit.com/faq.html
+
+ url = "https://dynamic.zoneedit.com/auth/dynamic.html"
+
+ @property
+ def proto(self):
+ return self.get("proto")
+
+ def update(self):
+ data = {
+ "dnsto" : self.get_address(self.proto),
+ "host" : self.hostname
+ }
+
+ # Send update to the server.
+ response = self.send_request(self.url, username=self.username, password=self.password,
+ data=data)
+
+ # Get the full response message.
+ output = response.read()
+
+ # Handle success messages.
+ if output.startswith("<SUCCESS"):
+ return
+
+ # Handle error codes.
+ if output.startswith("invalid login"):
+ raise DDNSAuthenticationError
+ elif output.startswith("<ERROR CODE=\"704\""):
+ raise DDNSRequestError(_("No valid FQDN was given."))
+ elif output.startswith("<ERROR CODE=\"702\""):
+ raise DDNSInternalServerError
+
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError