# DNS / URL-Forwarding

## Create a dns-configuration

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Introduction**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> With this request you can create or modify a zonefile at the joker-nameserver.  
  
You can add A-Records, <abbr class="glossary" title="Canonical Name">CNAME</abbr>-Records, <abbr class="glossary" title="Mail eXchange">MX</abbr>-Records, a nameservice-based <abbr class="glossary" title="Universal Resource Locator ('Link')">Url</abbr>-forwarding and a frame-based <abbr class="glossary" title="Universal Resource Locator ('Link')">Url</abbr>-forwarding. Modifing the TTL is not possible.  
  
The format of this request is a little bit different from the other requests. Please check the given examples for how to specify the different zonefile-records.  
  
**<span style="color: red;">ATTENTION:  
</span>**  
You have to change the nameservers for a domain to the nameservers of joker.com first! </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> - a.ns.joker.com  
\- b.ns.joker.com  
\- c.ns.joker.com  
  
If you would like to use the joker-nameservice, you will have to use **all** joker-nameservers.   
  
It is **not** possible to use the joker-nameservice   
</span>

- <span style="font-family: arial,helvetica,sans-serif; font-size: small;"> for primary nameservice only </span>
- <span style="font-family: arial,helvetica,sans-serif; font-size: small;"> for secondarynameservice only </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**All** joker-nameservers </span>

- <span style="font-family: arial,helvetica,sans-serif; font-size: small;"> are configured to deny all zone-fetching requests! </span>
- <span style="font-family: arial,helvetica,sans-serif; font-size: small;"> do not query foreign nameservers! </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Request Fields**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> Definition of this request</span>

<table border="1" id="bkmrk-request-field-valid-" style="height: 130px;" width="80%"><tbody><tr bgcolor="#cccccc"><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> request-field </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> valid values </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> required </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> domains0 </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@fqdn</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> yes </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@a\_record </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> no </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Canonical Name">CNAME</abbr> </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@cname\_record</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> no </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Mail eXchange">MX</abbr> </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@mx\_record</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> no </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Universal Resource Locator ('Link')">URL</abbr> </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@url\_record</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> no </span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> FRAME </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@url\_record</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> no </span></td></tr></tbody></table>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
</span> <span style="color: #800000; font-family: arial,helvetica,sans-serif; font-size: small;">Example 1:</span><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config** (without <abbr class="glossary" title="Universal Resource Locator ('Link')">url</abbr>-forwarding and without wildcard-matching) </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
</span> <span style="font-family: arial,helvetica,sans-serif; font-size: small;">subject: create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\]  
</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0:hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:www:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:mail:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:mail2:194.33.110.20 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:@:194.33.110.10 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Mail eXchange">MX</abbr>:www.hansnose.net:70:mail.nrw.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Mail eXchange">MX</abbr>:www.hansnose.net:80:mail2.nrw.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Mail eXchange">MX</abbr>:@:70:mail.hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Mail eXchange">MX</abbr>:@:80:mail2.hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Canonical Name">CNAME</abbr>:www3:some.other.domain.com</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"><span style="color: #800000;">Example 2:</span> **create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config** (with wildcard-matching) </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> subject: create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\] </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0:hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:www:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:@:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:\*:194.33.110.20</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"><span style="color: #800000;">Example 3:</span> **create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config** (with <abbr class="glossary" title="Domain Name Server">dns</abbr>**-**based <abbr class="glossary" title="Universal Resource Locator ('Link')">url</abbr>-forwarding)</span><span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">subject: create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\]  
</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0:hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:www:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:@:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> <abbr class="glossary" title="Universal Resource Locator ('Link')">URL</abbr>:www2:http://www.sone.other.domain.com/index.html </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
*(that means, the <abbr class="glossary" title="Universal Resource Locator ('Link')">url</abbr> within the browserbar is changing to the target address)* </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"><span style="color: #800000;">Example 4:</span> **create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config** (with frame**-**based <abbr class="glossary" title="Universal Resource Locator ('Link')">url</abbr>-forwarding) </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">subject: create <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\] </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0:hansnose.net </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:www:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> A:@:194.33.110.19 </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> FRAME:www2:http://www.sone.other.domain.com/index.html </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
*(that means, the <abbr class="glossary" title="Universal Resource Locator ('Link')">url</abbr> within the browserbar is **not** changing to the target address)*</span>

## Delete a dns-configuration

<article id="bkmrk-introduction-with-th"><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **Introduction**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> With this request you can delete a zonefile at the joker-nameserver. </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **Request fields**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> mailsubject: delete <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\] </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> Definition of this request</span>

<table border="1" width="80%"><tbody><tr bgcolor="#cccccc"><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">request-field</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">valid values</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">required</span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@fqdn </span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">yes</span></td></tr></tbody></table>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
</span><span style="color: #993300; font-family: arial,helvetica,sans-serif; font-size: small;">Example 1:</span><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **delete <abbr class="glossary" title="Domain Name Server">dns</abbr>-config**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> subject: delete <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\]  
  
domains0:hansnose.net</span></article>## List a dns-configuration

<article id="bkmrk-introduction-with-th-1"><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **Introduction**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> With this request you can get a listing of a current zonefile. </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **Request fields** </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;"> mailsubject: list <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\] definition of this request</span>

<table border="1" width="80%"><tbody><tr bgcolor="#cccccc"><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">request-field</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">valid values</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">required</span></td></tr><tr><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">domains0</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">@fqdn</span></td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">yes</span></td></tr></tbody></table>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">  
</span><span style="color: #993300; font-family: arial,helvetica,sans-serif; font-size: small;">Example 1:</span><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> **list <abbr class="glossary" title="Domain Name Server">dns</abbr>-config**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">subject: list <abbr class="glossary" title="Domain Name Server">dns</abbr>-config \[your reference id\]  
  
domains0:hansnose.net</span>

</article>