Manual:Tools/Dynamic DNS: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
mNo edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Versions|2.9, v3, v4 +}}
{{Versions|2.9, v3, v4 +}}
 
__TOC__
<div class=manual>
<div class=manual>


Line 14: Line 14:
The DNS update tool supports only one algorithm - <b>hmac-md5</b>. It's the only proposed algorithm for signing DNS messages.
The DNS update tool supports only one algorithm - <b>hmac-md5</b>. It's the only proposed algorithm for signing DNS messages.
</p>
</p>
{{Note | DNS update tool works only with BIND server, it will not work with DynDNS, EveryDNS or any other similar service. For these services other methods should be used. [[Scripts#General | <code>Read more >></code>]]  }}


==Properties==
==Properties==


<table class="styled_table">
{{Mr-arg-table-h
<tr>
|prop=Property
  <th width="40%">Property</th>
|desc=Description
  <th >Description</th>
}}
</tr>
 
<tr>
{{Mr-arg-table
    <td><var><b>address</b></var> (<em>IP</em>; Default: <b></b>)</td>
|arg=address
    <td>Defines IP address associated with the domain name.</td>
|type=IP
</tr>
|default=
<tr>
|desc=Defines IP address associated with the domain name.
    <td><var><b>dns-server</b></var> (<em>IP</em>; Default: <b></b>)</td>
}}
    <td>DNS server to send update to.</td>
 
</tr>
{{Mr-arg-table
<tr>
|arg=dns-server
    <td><var><b>key</b></var> (<em>string</em>; Default: <b></b>)</td>
|type=IP
    <td>Authorization key to access the server.</td>
|default=
</tr>
|desc=DNS server to send update to.
<tr>
}}
    <td><var><b>key-name</b></var> (<em>string</em>; Default: <b></b>)</td>
 
    <td>Authorization key name (like a username) to access the server.</td>
{{Mr-arg-table
</tr>
|arg=key
<tr>
|type=string
    <td><var><b>name</b></var> (<em>string</em>; Default: <b></b>)</td>
|default=
    <td>Name to attach with the IP address.</td>
|desc=Authorization key to access the server.
</tr>
}}
<tr>
 
    <td><var><b>ttl</b></var> (<em>integer</em>; Default: <b>0</b>)</td>
{{Mr-arg-table
    <td>Time to live for the item (in seconds).</td>
|arg=key-name
</tr>
|type=string
<tr>
|default=
    <td><var><b>zone</b></var> (<em>string</em>; Default: <b></b>)</td>
|desc=Authorization key name (like a username) to access the server.
    <td>DNS zone where to update the domain name in.</td>
}}
</tr>
 
</table>
{{Mr-arg-table
|arg=name
|type=string
|default=
|desc=Name to attach with the IP address.
}}
 
{{Mr-arg-table
|arg=ttl
|type=integer
|default=
|desc=Time to live for the item (in seconds).
}}
 
{{Mr-arg-table-end
|arg=zone
|type=string
|default=
|desc=DNS zone where to update the domain name in.
}}


<br />
<br />
{{ Note | that the system clock time on your router can't differ from the DNS server's time more than 5 minutes. Otherwise the DNS server will ignore this request. }}
{{ Note | that the system clock time on your router can't differ from the DNS server's time more than 5 minutes. Otherwise the DNS server will ignore this request. }}


==Example==
==Example==

Latest revision as of 10:30, 11 June 2010

Applies to RouterOS: 2.9, v3, v4 +

Summary

Sub-menu: /tool dns-update
Standards: RFC 2136, RFC 3007


Dynamic DNS Update Tool gives a way to keep domain name pointing to dynamic IP address. It works by sending domain name system update request to name server, which has a zone to be updated. Secure DNS updates are also supported.

The DNS update tool supports only one algorithm - hmac-md5. It's the only proposed algorithm for signing DNS messages.

Note: DNS update tool works only with BIND server, it will not work with DynDNS, EveryDNS or any other similar service. For these services other methods should be used. Read more >>


Properties

Property Description
address (IP; Default: ) Defines IP address associated with the domain name.
dns-server (IP; Default: ) DNS server to send update to.
key (string; Default: ) Authorization key to access the server.
key-name (string; Default: ) Authorization key name (like a username) to access the server.
name (string; Default: ) Name to attach with the IP address.
ttl (integer; Default: ) Time to live for the item (in seconds).
zone (string; Default: ) DNS zone where to update the domain name in.


Note: that the system clock time on your router can't differ from the DNS server's time more than 5 minutes. Otherwise the DNS server will ignore this request.


Example

To tell 23.34.45.56 DNS server to (re)associate mydomain name in the myzone.com zone with 68.42.14.4 IP address specifying that the name of the key is dns-update-key and the actual key is update:

[admin@MikroTik] tool> dns-update dns-server=23.34.45.56 name=mydomain \
\... zone=myzone.com address=68.42.14.4 key-name=dns-update-key key=update

[ Top | Back to Content ]