# Check if we actually need to update this host.
elif self.is_uptodate(self.protocols):
- logger.info(_("The dynamic host %(hostname)s (%(provider)s) is already up to date") % \
+ logger.debug(_("The dynamic host %(hostname)s (%(provider)s) is already up to date") % \
{ "hostname" : self.hostname, "provider" : self.name })
return
{ "hostname" : self.hostname, "provider" : self.name })
def update(self):
+ for protocol in self.protocols:
+ if self.have_address(protocol):
+ self.update_protocol(protocol)
+ else:
+ self.remove_protocol(protocol)
+
+ def update_protocol(self, proto):
raise NotImplementedError
+ def remove_protocol(self, proto):
+ logger.warning(_("%(hostname)s current resolves to an IP address"
+ " of the %(proto)s protocol which could not be removed by ddns") % \
+ { "hostname" : self.hostname, "proto" : proto })
+
+ # Maybe this will raise NotImplementedError at some time
+ #raise NotImplementedError
+
def is_uptodate(self, protos):
"""
Returns True if this host is already up to date
"""
return self.core.system.get_address(proto) or default
+ def have_address(self, proto):
+ """
+ Returns True if an IP address for the given protocol
+ is known and usable.
+ """
+ address = self.get_address(proto)
+
+ if address:
+ return True
+
+ return False
+
class DDNSProtocolDynDNS2(object):
"""
# http://dyn.com/support/developers/api/perform-update/
# http://dyn.com/support/developers/api/return-codes/
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
data = {
"hostname" : self.hostname,
- "myip" : self.get_address("ipv4"),
+ "myip" : self.get_address(proto),
}
return data
- def update(self):
- data = self._prepare_request_data()
+ def update_protocol(self, proto):
+ data = self.prepare_request_data(proto)
+
+ return self.send_request(data)
+ def send_request(self, data):
# Send update to the server.
- response = self.send_request(self.url, data=data,
+ response = DDNSProvider.send_request(self, self.url, data=data,
username=self.username, password=self.password)
# Get the full response message.
# Handle error codes.
if output == "badauth":
raise DDNSAuthenticationError
- elif output == "aduse":
+ elif output == "abuse":
raise DDNSAbuseError
elif output == "notfqdn":
raise DDNSRequestError(_("No valid FQDN was given."))
raise DDNSInternalServerError
elif output == "dnserr":
raise DDNSInternalServerError(_("DNS error encountered."))
+ elif output == "badagent":
+ raise DDNSBlockedError
# If we got here, some other update error happened.
raise DDNSUpdateError(_("Server response: %s") % output)
if server:
scriptlet.append("server %s" % server)
+ # Set the DNS zone the host should be added to.
+ zone = self.get("zone", None)
+ if zone:
+ scriptlet.append("zone %s" % zone)
+
key = self.get("key", None)
if key:
secret = self.get("secret")
url = "http://members.dhs.org/nic/hosts"
- def update(self):
+ def update_protocol(self, proto):
data = {
"domain" : self.hostname,
- "ip" : self.get_address("ipv4"),
+ "ip" : self.get_address(proto),
"hostcmd" : "edit",
"hostcmdstage" : "2",
"type" : "4",
url = "https://control.dnspark.com/api/dynamic/update.php"
- def update(self):
+ def update_protocol(self, proto):
data = {
"domain" : self.hostname,
- "ip" : self.get_address("ipv4"),
+ "ip" : self.get_address(proto),
}
# Send update to the server.
url = "https://www.dtdns.com/api/autodns.cfm"
- def update(self):
+ def update_protocol(self, proto):
data = {
- "ip" : self.get_address("ipv4"),
+ "ip" : self.get_address(proto),
"id" : self.hostname,
"pw" : self.password
}
url = "https://api.dynu.com/nic/update"
- def _prepare_request_data(self):
- data = DDNSProtocolDynDNS2._prepare_request_data(self)
+ # DynU sends the IPv6 and IPv4 address in one request
+
+ def update(self):
+ data = DDNSProtocolDynDNS2.prepare_request_data(self, "ipv4")
# This one supports IPv6
- data.update({
- "myipv6" : self.get_address("ipv6"),
- })
+ myipv6 = self.get_address("ipv6")
- return data
+ # Add update information if we have an IPv6 address.
+ if myipv6:
+ data["myipv6"] = myipv6
+
+ self._send_request(data)
class DDNSProviderEasyDNS(DDNSProtocolDynDNS2, DDNSProvider):
url = "http://api.cp.easydns.com/dyn/tomato.php"
+class DDNSProviderDomopoli(DDNSProtocolDynDNS2, DDNSProvider):
+ handle = "domopoli.de"
+ name = "domopoli.de"
+ website = "http://domopoli.de/"
+ protocols = ("ipv4",)
+
+ # https://www.domopoli.de/?page=howto#DynDns_start
+
+ url = "http://dyndns.domopoli.de/nic/update"
+
+
+class DDNSProviderDynsNet(DDNSProvider):
+ handle = "dyns.net"
+ name = "DyNS"
+ website = "http://www.dyns.net/"
+ protocols = ("ipv4",)
+
+ # There is very detailed informatio about how to send the update request and
+ # the possible response codes. (Currently we are using the v1.1 proto)
+ # http://www.dyns.net/documentation/technical/protocol/
+
+ url = "http://www.dyns.net/postscript011.php"
+
+ def update_protocol(self, proto):
+ data = {
+ "ip" : self.get_address(proto),
+ "host" : self.hostname,
+ "username" : self.username,
+ "password" : self.password,
+ }
+
+ # 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 output.startswith("200"):
+ return
+
+ # Handle error codes.
+ if output.startswith("400"):
+ raise DDNSRequestError(_("Malformed request has been sent."))
+ elif output.startswith("401"):
+ raise DDNSAuthenticationError
+ elif output.startswith("402"):
+ raise DDNSRequestError(_("Too frequent update requests have been sent."))
+ elif output.startswith("403"):
+ raise DDNSInternalServerError
+
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError(_("Server response: %s") % output)
+
+
class DDNSProviderEnomCom(DDNSResponseParserXML, DDNSProvider):
handle = "enom.com"
name = "eNom Inc."
website = "http://www.enom.com/"
+ protocols = ("ipv4",)
# There are very detailed information about how to send an update request and
# the respone codes.
url = "https://dynamic.name-services.com/interface.asp"
- def update(self):
+ def update_protocol(self, proto):
data = {
"command" : "setdnshost",
"responsetype" : "xml",
- "address" : self.get_address("ipv4"),
+ "address" : self.get_address(proto),
"domainpassword" : self.password,
"zone" : self.hostname
}
# here: https://entrydns.net/help
url = "https://entrydns.net/records/modify"
- def update(self):
+ def update_protocol(self, proto):
data = {
- "ip" : self.get_address("ipv4")
+ "ip" : self.get_address(proto),
}
# Add auth token to the update url.
# 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)
-
+ def update_protocol(self, proto):
data = {
- "address" : address,
+ "address" : self.get_address(proto),
}
# Add auth token to the update url.
url = "https://dynamicdns.park-your-domain.com/update"
- def update(self):
+ def update_protocol(self, proto):
# Namecheap requires the hostname splitted into a host and domain part.
host, domain = self.hostname.split(".", 1)
data = {
- "ip" : self.get_address("ipv4"),
+ "ip" : self.get_address(proto),
"password" : self.password,
"host" : host,
"domain" : domain
output = response.read()
# Handle success messages.
- if self.get_xml_tag_value(output, "IP") == self.get_address("ipv4"):
+ if self.get_xml_tag_value(output, "IP") == address:
return
# Handle error codes.
url = "http://dynupdate.no-ip.com/nic/update"
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
+ assert proto == "ipv4"
+
data = {
"hostname" : self.hostname,
- "address" : self.get_address("ipv4"),
+ "address" : self.get_address(proto),
}
return data
class DDNSProviderNsupdateINFO(DDNSProtocolDynDNS2, DDNSProvider):
handle = "nsupdate.info"
name = "nsupdate.info"
- website = "http://www.nsupdate.info/"
+ website = "http://nsupdate.info/"
protocols = ("ipv6", "ipv4",)
# Information about the format of the HTTP request can be found
- # after login on the provider user intrface and here:
+ # after login on the provider user interface and here:
# http://nsupdateinfo.readthedocs.org/en/latest/user.html
# Nsupdate.info uses the hostname as user part for the HTTP basic auth,
def password(self):
return self.get("secret")
- @property
- def proto(self):
- return self.get("proto")
-
@property
def url(self):
# The update URL is different by the used protocol.
else:
raise DDNSUpdateError(_("Invalid protocol has been given"))
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
data = {
- "myip" : self.get_address(self.proto),
+ "myip" : self.get_address(proto),
}
return data
url = "https://updates.opendns.com/nic/update"
- @property
- def proto(self):
- return self.get("proto")
-
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
data = {
"hostname" : self.hostname,
- "myip" : self.get_address(self.proto)
+ "myip" : self.get_address(proto),
}
return data
url = "https://www.ovh.com/nic/update"
- def _prepare_request_data(self):
- data = DDNSProtocolDynDNS2._prepare_request_data(self)
+ def prepare_request_data(self, proto):
+ data = DDNSProtocolDynDNS2.prepare_request_data(self, proto)
data.update({
"system" : "dyndns",
})
url = "https://carol.selfhost.de/nic/update"
- def _prepare_request_data(self):
- data = DDNSProtocolDynDNS2._prepare_request_data(self)
+ def prepare_request_data(self, proto):
+ data = DDNSProtocolDynDNS2.prepare_request_data(self, proto)
data.update({
"hostname" : "1",
})
handle = "spdns.org"
name = "SPDNS"
website = "http://spdns.org/"
- protocols = ("ipv4",)
# Detailed information about request and response codes are provided
# by the vendor. They are using almost the same mechanism and status
url = "https://update.spdns.de/nic/update"
+ @property
+ def username(self):
+ return self.get("username") or self.hostname
+
+ @property
+ def password(self):
+ return self.get("username") or self.token
+
class DDNSProviderStrato(DDNSProtocolDynDNS2, DDNSProvider):
handle = "strato.com"
url = "https://update.twodns.de/update"
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
+ assert proto == "ipv4"
+
data = {
- "ip" : self.get_address("ipv4"),
+ "ip" : self.get_address(proto),
"hostname" : self.hostname
}
url = "https://dyndns.variomedia.de/nic/update"
- @property
- def proto(self):
- return self.get("proto")
-
- def _prepare_request_data(self):
+ def prepare_request_data(self, proto):
data = {
"hostname" : self.hostname,
- "myip" : self.get_address(self.proto)
+ "myip" : self.get_address(proto),
}
return data
url = "https://dynamic.zoneedit.com/auth/dynamic.html"
- @property
- def proto(self):
- return self.get("proto")
-
- def update(self):
+ def update_protocol(self, proto):
data = {
- "dnsto" : self.get_address(self.proto),
+ "dnsto" : self.get_address(proto),
"host" : self.hostname
}
# If we got here, some other update error happened.
raise DDNSUpdateError
+
+
+class DDNSProviderZZZZ(DDNSProvider):
+ handle = "zzzz.io"
+ name = "zzzz"
+ website = "https://zzzz.io"
+ protocols = ("ipv6", "ipv4",)
+
+ # Detailed information about the update request can be found here:
+ # https://zzzz.io/faq/
+
+ # Details about the possible response codes have been provided in the bugtracker:
+ # https://bugzilla.ipfire.org/show_bug.cgi?id=10584#c2
+
+ url = "https://zzzz.io/api/v1/update"
+
+ def update_protocol(self, proto):
+ data = {
+ "ip" : self.get_address(proto),
+ "token" : self.token,
+ }
+
+ if proto == "ipv6":
+ data["type"] = "aaaa"
+
+ # zzzz uses the host from the full hostname as part
+ # of the update url.
+ host, domain = self.hostname.split(".", 1)
+
+ # Add host value to the update url.
+ url = "%s/%s" % (self.url, host)
+
+ # Send update to the server.
+ try:
+ response = self.send_request(url, data=data)
+
+ # Handle error codes.
+ except DDNSNotFound:
+ raise DDNSRequestError(_("Invalid hostname specified"))
+
+ # Handle success messages.
+ if response.code == 200:
+ return
+
+ # If we got here, some other update error happened.
+ raise DDNSUpdateError