Personal tools

From HEXONET Wiki

Jump to: navigation, search
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Sidebar}}__NOTOC__
+
{{Sidebar}}
<h2>DNS zone commands</h2>
+
<div style="font-size: 150%;">'''DNS API'''</div><br/>
 +
<p>  
  
HEXONET's DNS service platform was designed to dramatically simplify the management of DNS. [[API:Nameservers | Click here to obtain more information]]
+
= Our brand new DNS service =
 +
 
 +
HEXONET has recently upgraded its entire DNS service, with the support of our colleagues in the CentralNic Registry DNS team. Old servers have been retired and a brand new, state-of-the-art Anycast network has taken their place. 13 nodes in 5 continents, with hundreds of servers split in 3 separate clouds ensure that your domains resolve fast and securely all over the world. Our average response time has dropped from 131 to 28 milliseconds, a level of performance that most providers can barely dream of.
 +
 
 +
DNS is a fundamental piece of a domain offering and we believe all customers should have access to a solid and secure DNS infrastructure.
 +
 
 +
This is why we are retiring our old Premium DNS offering and are making this new DNS service our standard option for all domains registered through HEXONET.
 +
 
 +
Beginning April 1st, we will no longer charge for any Premium DNS subscription and it will not be possible to activate new Premium DNS subscriptions.
 +
 
 +
Resellers and Customers will still be able to manage these zones as before through our API and interfaces. Over the coming weeks, we will be removing all references to Premium DNS from our interfaces and making it easier for you to manage all your DNS zones together. During this transition period you might see references to Premium DNS and receive renewal notices for Premium DNS zones, but no charges will be applied.
 +
 
 +
To learn more about DNS management via the Control Panel, go to [[DNS in Control Panel]].
 +
 
 +
 
 +
= How to use HEXONET DNS Service =
 +
=== Create new DNS zone ===
 +
You can create a new DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = CreateDNSZone
 +
DNSZONE = (DNS zone name)
 +
</pre>
 +
 
 +
 
 +
=== Create new DNS zone for a domain not registered with HEXONET ===
 +
It is possible to use the HEXONET DNS service to host domains registered with other Registrars (also referred to as "external zones"). This service is currently offered at no charge until the end of 2021. Resellers should, however, be aware that charges will apply starting from January 1st, 2022.
 +
 
 +
To create an external zone, use the optional flag EXTERNAL=1
 +
 
 +
<pre>
 +
COMMAND = CreateDNSZone
 +
DNSZONE = (DNS zone name)
 +
EXTERNAL = 1
 +
</pre>
 +
 
 +
 
 +
=== Create new DNS zone for a domain that is about to be transferred HEXONET ===
 +
It is possible to create a zone in the HEXONET DNS system in preparation for an incoming domain transfer to HEXONET.
 +
 
 +
To create this type of zone, use the optional flag DOMAINTRANSFER=1
 +
 
 +
<pre>
 +
COMMAND = CreateDNSZone
 +
DNSZONE = (DNS zone name)
 +
DOMAINTRANSFER = 1
 +
</pre>
 +
 
 +
Please note that if the domain transfer is not completed within 14 days from the creation of the zone, the zone is automatically deleted from the HEXONET DNS system.
 +
 
 +
 
 +
=== Get a list of all DNS zones ===
 +
You can query a list of all DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = QueryDNSZoneList
 +
</pre>
 +
 
 +
 
 +
=== Get a list of all Premium DNS zones ===
 +
{{Warnbox|Deprecation warning: this command will only be available for a few more weeks, until Premium DNS zones are converted to regular DNS zones.}}
 +
 
 +
You can query a list of all Premium DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = QueryDNSZoneList
 +
PROPERTIES = PREMIUMDNS
 +
PREMIUMDNSCLASS = *
 +
</pre>
 +
 
 +
 
 +
=== Get information on a DNS zone ===
 +
You can query all information regarding a DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = StatusDNSZone
 +
DNSZONE = (DNS zone name)
 +
</pre>
 +
 
 +
 
 +
=== Add and manage records ===
 +
You can add and manage records for a DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = UpdateDNSZone
 +
DNSZONE = (DNS zone name)
 +
ADDRR0 = (add new record)
 +
DELRR0 = (remove record)
 +
</pre>
 +
 
 +
 
 +
=== Enable DNSSEC ===
 +
You can enable DNSSEC on DNS zones using the following command
 +
 
 +
<pre>
 +
COMMAND = UpdateDNSZone
 +
DNSSEC-MODE = AUTO
 +
DNSZONE = (DNS zone name)
 +
</pre>
 +
 
 +
Once enabled, you must input the DS and KEY records into the respective domain. You can get the DS and KEY record information by executing the following command
 +
 
 +
<pre>
 +
[COMMAND]
 +
COMMAND = StatusDNSZone
 +
DNSZONE = (DNS zone name)
 +
EOF
 +
 +
[RESPONSE]
 +
CODE = 200
 +
DESCRIPTION = Command completed successfully
 +
PROPERTY[DNSSEC-DS-SHA-1][0] = 20407 8 1 040772816032dc2a675d7f74725d747e47c45185
 +
PROPERTY[DNSSEC-DS-SHA-256][0] = 20407 8 2 a1dd1c5c5d78cd71477472ec5a3eeeaee65ecbc461b63ecd4630fd44d9492028
 +
PROPERTY[DNSSEC-KEY][0] = 257 3 8 AwEAAbfEdVJVqSuGwU8XEAtUWtODHv2CNPAwDKATFs0V17O2/Qe+vSUPadWNISqhSr7wAVrNxdNbOPxzw/iF8xN84GN3hArecKhX/+Yb6fSsucqkwd8fuloU+jTBAl4dq7LRM5DbqdLrN6MUyq1p2h86lP9pXjEaeTYtZ0i8zeV7IyG4d/q+FTNG+1Daw90YIvyFdek1HnNd9pXRSeYhdB8GyxZAGPPID0NBk5/L/nY3mCTi7ezQ7UsdVuB/W53sjlSgjgfFnxsqanN0XK87liuZ8fSMi84CPRTqoYglIBUVxHtTlZIN7Xg72g5HsNzX3EEQfcvkB4h62CcBKX3AIron3zc=
 +
PROPERTY[DNSSEC-KEY-TAG][0] = 20407
 +
PROPERTY[DNSSEC-MODE][0] = AUTO
 +
...
 +
EOF
 +
</pre>
 +
 
 +
To input the records into the domain, execute the following command
 +
 
 +
<pre>
 +
COMMAND = ModifyDomain
 +
ADDSECDNS-DS0 = (DNSSEC-DS from StatusDNSZone, you can choose either SHA-1 or SHA-256)
 +
ADDSECDNS-KEY0 = (DNSSEC-KEY from StatusDNSZone)
 +
DOMAIN = (domain name)
 +
</pre>
 +
 
 +
=== Disable DNSSEC ===
 +
You can disable DNSSEC on a DNS zone with the following command
 +
 
 +
<pre>
 +
COMMAND = UpdateDNSZone
 +
DNSSEC-MODE = DISABLED
 +
DNSZONE = (DNS zone name)
 +
</pre>
 +
 
 +
 
 +
= Zone Commands =
 +
HEXONET's DNS service platform was designed to dramatically simplify the management of DNS. [[API:Nameservers|More Information]]
  
 
* [[How to use HEXONET's DNS with your domains]]
 
* [[How to use HEXONET's DNS with your domains]]
*[[DNSSEC| DNSSEC API Command Extensions]]
+
* [[DNSSEC| DNSSEC API Command Extensions]]
 +
* [[xDNS| HEXONET's extended DNS Solutions]]
  
{{Infobox|Please have a look to our {{Template:Pdf|DNSZONE_API_Reference.pdf| DNS API Reference}}
+
= Document Downloads =
Please have a look to our {{Template:Pdf|howTo_Nameserver_en.pdf| HowTo: Using Virtual Nameservers}}}}
+
Download: {{Template:Pdf|howTo_Nameserver_en.pdf| Virtual Nameserver Howto}}

Latest revision as of 16:07, 29 March 2021

DNS API

Contents

[edit] Our brand new DNS service

HEXONET has recently upgraded its entire DNS service, with the support of our colleagues in the CentralNic Registry DNS team. Old servers have been retired and a brand new, state-of-the-art Anycast network has taken their place. 13 nodes in 5 continents, with hundreds of servers split in 3 separate clouds ensure that your domains resolve fast and securely all over the world. Our average response time has dropped from 131 to 28 milliseconds, a level of performance that most providers can barely dream of.

DNS is a fundamental piece of a domain offering and we believe all customers should have access to a solid and secure DNS infrastructure.

This is why we are retiring our old Premium DNS offering and are making this new DNS service our standard option for all domains registered through HEXONET.

Beginning April 1st, we will no longer charge for any Premium DNS subscription and it will not be possible to activate new Premium DNS subscriptions.

Resellers and Customers will still be able to manage these zones as before through our API and interfaces. Over the coming weeks, we will be removing all references to Premium DNS from our interfaces and making it easier for you to manage all your DNS zones together. During this transition period you might see references to Premium DNS and receive renewal notices for Premium DNS zones, but no charges will be applied.

To learn more about DNS management via the Control Panel, go to DNS in Control Panel.


[edit] How to use HEXONET DNS Service

[edit] Create new DNS zone

You can create a new DNS zone with the following command

COMMAND = CreateDNSZone
DNSZONE = (DNS zone name)


[edit] Create new DNS zone for a domain not registered with HEXONET

It is possible to use the HEXONET DNS service to host domains registered with other Registrars (also referred to as "external zones"). This service is currently offered at no charge until the end of 2021. Resellers should, however, be aware that charges will apply starting from January 1st, 2022.

To create an external zone, use the optional flag EXTERNAL=1

COMMAND = CreateDNSZone
DNSZONE = (DNS zone name)
EXTERNAL = 1


[edit] Create new DNS zone for a domain that is about to be transferred HEXONET

It is possible to create a zone in the HEXONET DNS system in preparation for an incoming domain transfer to HEXONET.

To create this type of zone, use the optional flag DOMAINTRANSFER=1

COMMAND = CreateDNSZone
DNSZONE = (DNS zone name)
DOMAINTRANSFER = 1

Please note that if the domain transfer is not completed within 14 days from the creation of the zone, the zone is automatically deleted from the HEXONET DNS system.


[edit] Get a list of all DNS zones

You can query a list of all DNS zone with the following command

COMMAND = QueryDNSZoneList


[edit] Get a list of all Premium DNS zones

Deprecation warning: this command will only be available for a few more weeks, until Premium DNS zones are converted to regular DNS zones.


You can query a list of all Premium DNS zone with the following command

COMMAND = QueryDNSZoneList
PROPERTIES = PREMIUMDNS
PREMIUMDNSCLASS = *


[edit] Get information on a DNS zone

You can query all information regarding a DNS zone with the following command

COMMAND = StatusDNSZone
DNSZONE = (DNS zone name)


[edit] Add and manage records

You can add and manage records for a DNS zone with the following command

COMMAND = UpdateDNSZone
DNSZONE = (DNS zone name)
ADDRR0 = (add new record)
DELRR0 = (remove record)


[edit] Enable DNSSEC

You can enable DNSSEC on DNS zones using the following command

COMMAND = UpdateDNSZone
DNSSEC-MODE = AUTO
DNSZONE = (DNS zone name)

Once enabled, you must input the DS and KEY records into the respective domain. You can get the DS and KEY record information by executing the following command

[COMMAND]
COMMAND = StatusDNSZone
DNSZONE = (DNS zone name)
EOF
 
[RESPONSE]
CODE = 200
DESCRIPTION = Command completed successfully
PROPERTY[DNSSEC-DS-SHA-1][0] = 20407 8 1 040772816032dc2a675d7f74725d747e47c45185
PROPERTY[DNSSEC-DS-SHA-256][0] = 20407 8 2 a1dd1c5c5d78cd71477472ec5a3eeeaee65ecbc461b63ecd4630fd44d9492028
PROPERTY[DNSSEC-KEY][0] = 257 3 8 AwEAAbfEdVJVqSuGwU8XEAtUWtODHv2CNPAwDKATFs0V17O2/Qe+vSUPadWNISqhSr7wAVrNxdNbOPxzw/iF8xN84GN3hArecKhX/+Yb6fSsucqkwd8fuloU+jTBAl4dq7LRM5DbqdLrN6MUyq1p2h86lP9pXjEaeTYtZ0i8zeV7IyG4d/q+FTNG+1Daw90YIvyFdek1HnNd9pXRSeYhdB8GyxZAGPPID0NBk5/L/nY3mCTi7ezQ7UsdVuB/W53sjlSgjgfFnxsqanN0XK87liuZ8fSMi84CPRTqoYglIBUVxHtTlZIN7Xg72g5HsNzX3EEQfcvkB4h62CcBKX3AIron3zc=
PROPERTY[DNSSEC-KEY-TAG][0] = 20407
PROPERTY[DNSSEC-MODE][0] = AUTO
...
EOF

To input the records into the domain, execute the following command

COMMAND = ModifyDomain
ADDSECDNS-DS0 = (DNSSEC-DS from StatusDNSZone, you can choose either SHA-1 or SHA-256)
ADDSECDNS-KEY0 = (DNSSEC-KEY from StatusDNSZone)
DOMAIN = (domain name)

[edit] Disable DNSSEC

You can disable DNSSEC on a DNS zone with the following command

COMMAND = UpdateDNSZone
DNSSEC-MODE = DISABLED
DNSZONE = (DNS zone name)


[edit] Zone Commands

HEXONET's DNS service platform was designed to dramatically simplify the management of DNS. More Information

[edit] Document Downloads

Download: Virtual Nameserver Howto