X-Git-Url: http://git.ipfire.org/?p=oddments%2Fddns.git;a=blobdiff_plain;f=src%2Fddns%2Fproviders.py;h=99da4bf00ca89efeda1497f50ce92c852da7c138;hp=2bf177435822eb4d1c2e81b27ac0dbe3ec2fceaf;hb=3b524cf247ba1a7051735c81a65d61eb178f6ba7;hpb=ee0712714c733d2c56789e180ab58e0170202189 diff --git a/src/ddns/providers.py b/src/ddns/providers.py index 2bf1774..99da4bf 100644 --- a/src/ddns/providers.py +++ b/src/ddns/providers.py @@ -20,6 +20,8 @@ ############################################################################### import logging +import urllib2 +import xml.dom.minidom from i18n import _ @@ -30,21 +32,19 @@ logger = logging.getLogger("ddns.providers") 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 = {} @@ -62,28 +62,6 @@ class DDNSProvider(object): 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. @@ -111,10 +89,6 @@ class DDNSProvider(object): """ return self.get("password") - @property - def protocols(self): - return self.INFO.get("protocols") - @property def token(self): """ @@ -124,11 +98,11 @@ class DDNSProvider(object): 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. @@ -148,6 +122,11 @@ class DDNSProvider(object): 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 @@ -160,20 +139,47 @@ class DDNSProvider(object): """ 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. @@ -196,21 +202,15 @@ class DDNSProviderDHS(DDNSProvider): 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 @@ -254,12 +254,10 @@ class DDNSProviderDNSpark(DDNSProvider): 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 @@ -309,12 +307,10 @@ class DDNSProviderDtDNS(DDNSProvider): 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/ @@ -358,16 +354,36 @@ class DDNSProviderDynDNS(DDNSProvider): raise DDNSInternalServerError(_("DNS error encountered.")) # If we got here, some other update error happened. - raise DDNSUpdateError + 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): - INFO = { - "handle" : "easydns.com", - "name" : "EasyDNS", - "website" : "http://www.easydns.com/", - "protocols" : ["ipv4",] - } + 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. @@ -377,12 +393,9 @@ class DDNSProviderEasyDNS(DDNSProviderDynDNS): class DDNSProviderFreeDNSAfraidOrg(DDNSProvider): - INFO = { - "handle" : "freedns.afraid.org", - "name" : "freedns.afraid.org", - "website" : "http://freedns.afraid.org/", - "protocols" : ["ipv6", "ipv4",] - } + 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. @@ -414,14 +427,14 @@ class DDNSProviderFreeDNSAfraidOrg(DDNSProvider): 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 @@ -430,22 +443,10 @@ class DDNSProviderLightningWireLabs(DDNSProvider): 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 @@ -468,23 +469,83 @@ class DDNSProviderLightningWireLabs(DDNSProvider): 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(DDNSProviderDynDNS): - INFO = { - "handle" : "no-ip.com", - "name" : "No-IP", - "website" : "http://www.no-ip.com/", - "protocols" : ["ipv4",] - } + 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 @@ -502,12 +563,9 @@ class DDNSProviderNOIP(DDNSProviderDynDNS): class DDNSProviderOVH(DDNSProviderDynDNS): - INFO = { - "handle" : "ovh.com", - "name" : "OVH", - "website" : "http://www.ovh.com/", - "protocols" : ["ipv4",] - } + 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 @@ -518,44 +576,105 @@ class DDNSProviderOVH(DDNSProviderDynDNS): url = "https://www.ovh.com/nic/update" def _prepare_request_data(self): - data = { - "hostname" : self.hostname, - "myip" : self.get_address("ipv4"), - "system" : "dyndns", - } + 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/" -class DDNSProviderSelfhost(DDNSProvider): - INFO = { - "handle" : "selfhost.de", - "name" : "Selfhost.de", - "website" : "http://www.selfhost.de/", - "protocols" : ["ipv4",], - } + # 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://carol.selfhost.de/update" + url = "https://dyndns.regfish.de/" def update(self): data = { - "username" : self.username, - "password" : self.password, - "textmodi" : "1", + "fqdn" : self.hostname, } - response = self.send_request(self.url, data=data) + # 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 - match = re.search("status=20(0|4)", response.read()) - if not match: - raise DDNSUpdateError + # 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 "100" in output or "101" in output: + return + + # Handle error codes. + if "401" or "402" in output: + raise DDNSAuthenticationError + 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(DDNSProviderDynDNS): + handle = "selfhost.de" + name = "Selfhost.de" + website = "http://www.selfhost.de/" + + url = "https://carol.selfhost.de/nic/update" + + def _prepare_request_data(self): + data = DDNSProviderDynDNS._prepare_request_data(self) + data.update({ + "hostname" : "1", + }) + + return data class DDNSProviderSPDNS(DDNSProviderDynDNS): - INFO = { - "handle" : "spdns.org", - "name" : "SPDNS", - "website" : "http://spdns.org/", - "protocols" : ["ipv4",] - } + 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 @@ -567,13 +686,53 @@ class DDNSProviderSPDNS(DDNSProviderDynDNS): 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 = { + "ip" : self.get_address("ipv4"), + "hostname" : self.hostname + } + + 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" + + 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/ @@ -589,3 +748,50 @@ class DDNSProviderVariomedia(DDNSProviderDynDNS): "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("