Merge branch 'master' of github.com:asmaps/nsupdate.info

This commit is contained in:
Fabian Faessler 2013-09-29 23:38:55 +02:00
commit f13894fd9c
2 changed files with 72 additions and 57 deletions

View File

@ -3,8 +3,10 @@
{% block content %} {% block content %}
<h1>Help / FAQ</h1> <h1>Help / FAQ</h1>
<div class="row">
<div class="col-lg-5">
<div class="well">
<h2>Standards used?</h2> <h2>Standards used?</h2>
<p>
We use: We use:
<ul> <ul>
<li>Frontend Update-API: dyndns2 protocol <li>Frontend Update-API: dyndns2 protocol
@ -15,45 +17,13 @@
</li> </li>
<li>Backend: dynamic DNS update (see <a href="http://www.ietf.org/rfc/rfc2136.txt">RFC2136</a>)</li> <li>Backend: dynamic DNS update (see <a href="http://www.ietf.org/rfc/rfc2136.txt">RFC2136</a>)</li>
</ul> </ul>
</p> </div>
<h2>Easy update URLs</h2> </div>
<p> <div class="col-lg-7">
Explanation of parameters: <div class="well">
<ul> <h3>How to configure your router?</h3>
<li>hostname: your fully qualified hostname, something like example.nsupdate.info</li> {% include "main/includes/tabbed_router_configuration.html" with host=object %}
<li>yoursecret: the secret you have configured for this hostname</li> </div>
<li>IP addresses: we use the v4 and v6 localhost addresses in the examples, but </div>
of course you need to use your real public IP instead of that. </div>
</li>
</ul>
For browser / interactive use (will ask for username (give your hostname) and password (give yoursecret)):
<ul>
<li>http://nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
<li>http://ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
<li>http://ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
</ul>
For browser / interactive use (give http basic auth username and password in URL):
<ul>
<li>http://hostname:yoursecret@nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
<li>http://hostname:yoursecret@ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
<li>http://hostname:yoursecret@ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
</ul>
For browser / interactive use as above, but manually specifying the IP address:
<ul>
<li>http://hostname:yoursecret@nsupdate.info/nic/update?myip=127.0.0.1 (updates hostname to point to ipv4 127.0.0.1)</li>
<li>http://hostname:yoursecret@nsupdate.info/nic/update?myip=::1 (updates hostname to point to ipv6 ::1)</li>
</ul>
For routers or other dyndns2 compatible clients:
<ul>
<li>They must send a http basic auth header with hostname / yoursecret.</li>
<li>They must send a GET request to our server: nsupdate.info, path: /nic/update</li>
<li>We support http on port 80 (and soon also https on port 443).</li>
<li>URL args (all are optional):
<ul>
<li>myip=127.0.0.1 or myip=::1 (if not given: autodetect from remote_addr)</li>
<li>hostname=hostname (if not given: autodetect from http basic auth)</li>
</ul>
</li>
</ul>
</p>
{% endblock %} {% endblock %}

View File

@ -1,11 +1,12 @@
<ul class="nav nav-tabs" id="myTab"> <ul class="nav nav-tabs" id="myTab">
<li class="active"><a href="#generic" data-toggle="tab">Generic</a></li> <li class="active"><a href="#generic" data-toggle="tab">General</a></li>
<li><a href="#avm" data-toggle="tab">AVM Fritz!Box</a></li> <li><a href="#avm" data-toggle="tab">AVM Fritz!Box</a></li>
<li><a href="#browser" data-toggle="tab">Browser</a></li>
</ul> </ul>
<div class="tab-content"> <div class="tab-content">
<div class="tab-pane active" id="generic"> <div class="tab-pane active" id="generic">
<h4>Generic configuration hints</h4> <h4>General configuration hints</h4>
<hr> <hr>
Your router/script needs to call the following url for IPv4-Updates: Your router/script needs to call the following url for IPv4-Updates:
<div class="well well-sm"> <div class="well well-sm">
@ -34,6 +35,18 @@
<li>Code 401: Authorization Required <i class="icon-long-arrow-right"></i> Incorrect or no authentication data</li> <li>Code 401: Authorization Required <i class="icon-long-arrow-right"></i> Incorrect or no authentication data</li>
</ul> </ul>
</ul> </ul>
For routers or other dyndns2 compatible clients:
<ul>
<li>They must send a http basic auth header with hostname / yoursecret.</li>
<li>They must send a GET request to our server: nsupdate.info, path: /nic/update</li>
<li>We support http on port 80 (and soon also https on port 443).</li>
<li>URL args (all are optional):
<ul>
<li>myip=127.0.0.1 or myip=::1 (if not given: autodetect from remote_addr)</li>
<li>hostname=hostname (if not given: autodetect from http basic auth)</li>
</ul>
</li>
</ul>
</div> </div>
<div class="tab-pane" id="avm"> <div class="tab-pane" id="avm">
<h4>Fritz!Box 7390 (and maybe others):</h4> <h4>Fritz!Box 7390 (and maybe others):</h4>
@ -49,8 +62,8 @@
<thead><th>Setting</th><th>Value</th></thead> <thead><th>Setting</th><th>Value</th></thead>
<tr><td>Dynamic DNS provider</td><td>Custom</td></tr> <tr><td>Dynamic DNS provider</td><td>Custom</td></tr>
<tr><td>Update-URL</td><td>http://nsupdate.info/nic/update</td></tr> <tr><td>Update-URL</td><td>http://nsupdate.info/nic/update</td></tr>
<tr><td>Domain Name</td><td>{{ host.get_fqdn|default:"&lt;your fqdn&gt;" }}</td></tr> <tr><td>Domain Name</td><td>{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}</td></tr>
<tr><td>User name</td><td>{{ host.get_fqdn|default:"&lt;your fqdn&gt;" }}</td></tr> <tr><td>User name</td><td>{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}</td></tr>
<tr><td>Password</td><td>{{ update_secret|default:"&lt;your secret&gt;" }}</td></tr> <tr><td>Password</td><td>{{ update_secret|default:"&lt;your secret&gt;" }}</td></tr>
</table> </table>
<h5>If you also have IPv6 (Dual Stack)</h5> <h5>If you also have IPv6 (Dual Stack)</h5>
@ -59,4 +72,36 @@
http://ipv4.nsupdate.info/nic/update http://ipv6.nsupdate.info/nic/update http://ipv4.nsupdate.info/nic/update http://ipv6.nsupdate.info/nic/update
</div> </div>
</div> </div>
<div class="tab-pane" id="browser">
<h4>Easy update URLs</h4>
Explanation of parameters:
<ul>
{% if not host %}
<li>&lt;your hostname&gt;: your fully qualified hostname, something like example.nsupdate.info</li>
{% endif %}
{% if not update_secret %}
<li>&lt;your secret&gt;: the secret you have configured for this hostname</li>
{% endif %}
<li>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.
</li>
</ul>
For browser / interactive use (will ask for username (give your hostname) and password (give yoursecret)):
<ul>
<li>http://nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
<li>http://ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
<li>http://ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
</ul>
For browser / interactive use (give http basic auth username and password in URL):
<ul>
<li>http://{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}:{{ update_secret|default:"&lt;your secret&gt;" }}@nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
<li>http://{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}:{{ update_secret|default:"&lt;your secret&gt;" }}@ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
<li>http://{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}:{{ update_secret|default:"&lt;your secret&gt;" }}@ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
</ul>
For browser / interactive use as above, but manually specifying the IP address:
<ul>
<li>http://{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}:{{ update_secret|default:"&lt;your secret&gt;" }}@nsupdate.info/nic/update?myip=127.0.0.1 (updates hostname to point to ipv4 127.0.0.1)</li>
<li>http://{{ host.get_fqdn|default:"&lt;your hostname&gt;" }}:{{ update_secret|default:"&lt;your secret&gt;" }}@nsupdate.info/nic/update?myip=::1 (updates hostname to point to ipv6 ::1)</li>
</ul>
</div>
</div> </div>