From d922c359ca3c05dc4f9979be559089f80822d194 Mon Sep 17 00:00:00 2001
From: Arne Schauf
Date: Sun, 29 Sep 2013 23:36:20 +0200
Subject: [PATCH] help
---
nsupdate/main/templates/main/help.html | 76 ++++++-------------
.../includes/tabbed_router_configuration.html | 53 ++++++++++++-
2 files changed, 72 insertions(+), 57 deletions(-)
diff --git a/nsupdate/main/templates/main/help.html b/nsupdate/main/templates/main/help.html
index a6e5264..8e14cd1 100644
--- a/nsupdate/main/templates/main/help.html
+++ b/nsupdate/main/templates/main/help.html
@@ -3,57 +3,27 @@
{% block content %}
Help / FAQ
- Standards used?
-
- We use:
-
- - Frontend Update-API: dyndns2 protocol
-
-
- - Backend: dynamic DNS update (see RFC2136)
-
-
-
-
Generic configuration hints
+
General configuration hints
Your router/script needs to call the following url for IPv4-Updates:
@@ -34,6 +35,18 @@
Code 401: Authorization Required Incorrect or no authentication data
+ For routers or other dyndns2 compatible clients:
+
+ - They must send a http basic auth header with hostname / yoursecret.
+ - They must send a GET request to our server: nsupdate.info, path: /nic/update
+ - We support http on port 80 (and soon also https on port 443).
+ - URL args (all are optional):
+
+ - myip=127.0.0.1 or myip=::1 (if not given: autodetect from remote_addr)
+ - hostname=hostname (if not given: autodetect from http basic auth)
+
+
+
Fritz!Box 7390 (and maybe others):
@@ -49,8 +62,8 @@
Setting | Value |
Dynamic DNS provider | Custom |
Update-URL | http://nsupdate.info/nic/update |
- Domain Name | {{ host.get_fqdn|default:"<your fqdn>" }} |
- User name | {{ host.get_fqdn|default:"<your fqdn>" }} |
+ Domain Name | {{ host.get_fqdn|default:"<your hostname>" }} |
+ User name | {{ host.get_fqdn|default:"<your hostname>" }} |
Password | {{ update_secret|default:"<your secret>" }} |
If you also have IPv6 (Dual Stack)
@@ -59,4 +72,36 @@
http://ipv4.nsupdate.info/nic/update http://ipv6.nsupdate.info/nic/update
+
+
Easy update URLs
+ Explanation of parameters:
+
+ {% if not host %}
+ - <your hostname>: your fully qualified hostname, something like example.nsupdate.info
+ {% endif %}
+ {% if not update_secret %}
+ - <your secret>: the secret you have configured for this hostname
+ {% endif %}
+ - IP addresses: we use the v4 and v6 localhost addresses in the examples, but
+ of course you need to use your real public IP instead of that.
+
+
+ For browser / interactive use (will ask for username (give your hostname) and password (give yoursecret)):
+
+ - http://nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)
+ - http://ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)
+ - http://ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)
+
+ For browser / interactive use (give http basic auth username and password in URL):
+
+ - http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)
+ - http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)
+ - http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)
+
+ For browser / interactive use as above, but manually specifying the IP address:
+
+ - http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update?myip=127.0.0.1 (updates hostname to point to ipv4 127.0.0.1)
+ - http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update?myip=::1 (updates hostname to point to ipv6 ::1)
+
+