Difference between revisions of "DNS server unique zone"

 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Category:Linux]]
 
[[Category:Linux]]
 
The DNS [Domain Name System] is a key component of a network infrastructure. '''It allows you to use NAMES''' instead of IP addresses and technical garbage.
 
 
You can learn how it works through a simple Google request.
 
 
  
 
Here, I will present the installation of:  
 
Here, I will present the installation of:  
* '''DNS primary server''' (= DNS for domain smartcards.local) using ''BIND9''
 
 
* Local domain (.local)
 
* Local domain (.local)
  
 +
That means '''all the INTERNAL resources are private'''. Nothing is reachable from the outside.
  
  
You can re-use all this content for a web-site or public domain. Just replace ''smartcards.local'' by ''mywebsite.com''.
 
 
 
 
 
=Setup=
 
 
<syntaxhighlight lang="bash">
 
apt-get install bind9 dnsutils bind9-doc
 
</syntaxhighlight>
 
 
 
 
=Primary master=
 
 
A DNS primary master is the main DNS for your local domain (ex: smartcards.local).
 
 
 
These are the steps to do:
 
* '''Set the external DNS''' to use by your server
 
**File: /etc/bind/named.conf.options
 
 
* '''Declare the new domain''' to manage
 
** File: /etc/bind/named.conf.local
 
 
* Create a '''dedicated configuration file''' for the new domain
 
** New file: /etc/bind/smartcards.local
 
 
* Adjust the '''reverse zone'''
 
** File: /etc/bind/named.conf.local
 
** Rename and adjust file: /etc/bind/db.192
 
 
 
==Set the external DNS==
 
 
This is the list of DNS your server will use to populate its own cache.
 
  
 +
In the following example I'll be using:
 +
* INTERNAL zone: ''smartcards.'''local'''''
 +
* DNS server name: ''smartcard-gw''
 +
* Network: 172.16.50.0/24 ; router: 172.16.50.1 ; DNS server IP: 172.16.50.2
  
The external DNS can either be your ISP's DNS or Google's servers.
 
  
!! Mind the order !!
 
First DNS have a higher priority.
 
  
 +
=Zone configuration (name to IP @)=
  
 
+
==Declare the new zone==
Edit configuration file:
 
 
 
<syntaxhighlight lang="bash">
 
vim /etc/bind/named.conf.options
 
</syntaxhighlight>
 
 
 
 
 
Uncomment and adjust the file content
 
 
 
<syntaxhighlight lang="bash">
 
[...]
 
forwarders {
 
    # Local gateway or router
 
    172.16.50.1;
 
 
 
    # Your ISP DNS IP’s
 
    182.176.39.23;
 
    182.176.18.13;
 
 
 
    # Google's DNS
 
    8.8.8.8;
 
    8.8.4.4;
 
};
 
[...]
 
</syntaxhighlight>
 
 
 
 
 
 
 
==Declare the new domain==
 
  
 
Edit configuration file:
 
Edit configuration file:
Line 96: Line 28:
 
Uncomment and adjust the file content
 
Uncomment and adjust the file content
  
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
zone "smartcards.local" {
 
zone "smartcards.local" {
 
type master;
 
type master;
Line 105: Line 37:
  
  
==Domain configuration file==
+
==Zone configuration file==
  
  
Create the domain configuration file from a local template:
+
Create the zone configuration file from a local template:
  
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 124: Line 56:
 
Adjust the file content
 
Adjust the file content
  
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
;
 
;
; BIND data file for smartcards.local (you can use mywebsite.com)
+
; BIND data file for smartcards.local
 
;
 
;
 
$TTL    604800
 
$TTL    604800
Line 145: Line 77:
 
@                IN      NS      smartcard-gw.smartcards.local.
 
@                IN      NS      smartcard-gw.smartcards.local.
 
smartcard-gw    IN      A      172.16.50.2
 
smartcard-gw    IN      A      172.16.50.2
 
;
 
; -- alternative --
 
; To declare a server a specific domain only
 
;
 
;website.com      IN      NS      smartcard-gw.website.com.
 
;website.com      IN      A      172.16.50.2
 
 
  
 
;
 
;
Line 162: Line 86:
 
; Declare your servers and networks hosts  
 
; Declare your servers and networks hosts  
 
;
 
;
smarcartd-prod-00 IN      A      172.16.50.10
+
smarcartd-prod-00 IN      A      172.16.50.50
smarcartd-prod-01 IN      A      172.16.50.11
+
smarcartd-prod-01 IN      A      172.16.50.51
smarcartd-prod-02 IN      A      172.16.50.12
+
smarcartd-prod-02 IN      A      172.16.50.52
smarcartd-prod-03 IN      A      172.16.50.13
+
smarcartd-prod-03 IN      A      172.16.50.53
  
 
; Create an alias to an existing record
 
; Create an alias to an existing record
Line 188: Line 112:
  
  
==Reverse zone file==
+
=Reverse zone (IP @ to name)=
 
 
  
 
Now that the zone is setup and resolving names to IP Adresses a '''Reverse zone''' is also required. A Reverse zone allows DNS to resolve an address to a name.
 
Now that the zone is setup and resolving names to IP Adresses a '''Reverse zone''' is also required. A Reverse zone allows DNS to resolve an address to a name.
Line 206: Line 129:
 
Add the following reverse
 
Add the following reverse
  
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
# Our reverse zone
 
# Our reverse zone
 
# Server IP 172.16.50.2
 
# Server IP 172.16.50.2
Line 224: Line 147:
  
  
===Configure reverse zone===
+
==Configure reverse zone==
  
  
Line 242: Line 165:
  
 
The content is basically the same as /etc/bind/smartcards.local:
 
The content is basically the same as /etc/bind/smartcards.local:
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
;
 
;
 
; BIND reverse data file for local 172.16.50.XXX net
 
; BIND reverse data file for local 172.16.50.XXX net
Line 267: Line 190:
 
; Other components and hosts
 
; Other components and hosts
 
;
 
;
10       IN      PTR    smartcard-prod-00.smartcards.local.
+
50       IN      PTR    smartcard-prod-00.smartcards.local.
11       IN      PTR    smartcard-prod-01.smartcards.local.
+
51       IN      PTR    smartcard-prod-01.smartcards.local.
12       IN      PTR    smartcard-prod-02.smartcards.local.
+
52       IN      PTR    smartcard-prod-02.smartcards.local.
13       IN      PTR    smartcard-prod-03.smartcards.local.
+
53       IN      PTR    smartcard-prod-03.smartcards.local.
  
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 285: Line 208:
  
  
==Take changes into account==
+
=Take changes into account=
  
  
Line 292: Line 215:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
 
==Use the local DNS server as default one==
 
 
Now that your server is ready to be used, you have to use it !!
 
 
* All the clients will get their configuration from DHCP (see [[DHCP server]]).
 
 
* On the local server, you have to edit your current IP settings
 
 
 
 
<syntaxhighlight lang="bash">
 
vim /etc/network/interfaces
 
</syntaxhighlight>
 
 
 
Adjust it like that:
 
 
<syntaxhighlight lang="bash">
 
# The primary network interface [static IP]
 
auto eth0
 
iface eth0 inet static
 
        address 172.16.50.2
 
        netmask 255.255.255.0
 
        gateway 172.16.50.1
 
        network 172.16.50.0
 
        broadcast 172.16.50.255
 
 
        # Local DNS server on 172.16.50.2 as default. Then the DNS server itself will forward the requests to external DNS servers.
 
        dns-nameservers 172.16.50.2
 
        dns-search smartcards.local
 
        dns-domain smartcards.local
 
</syntaxhighlight>
 
 
 
Don't forget to reboot to take on your configuration changes !
 
 
 
 
==Test your configuration==
 
 
 
===Test on SERVER side===
 
 
 
Run the following commands to check your configuration. All commands should output '''OK''' or be a ping success. :)
 
 
 
Check the local zone:
 
 
<syntaxhighlight lang="bash">
 
named-checkzone smartcards.local /etc/bind/zones/smartcards.local
 
named-checkzone smartcards.local /etc/bind/zones/db.172
 
</syntaxhighlight>
 
 
 
Check the reverse zone:
 
 
<syntaxhighlight lang="bash">
 
named-checkzone 50.16.172.in-addr.arpa. /etc/bind/db.172
 
</syntaxhighlight>
 
 
 
 
Now you can try to ping the router and a client:
 
 
<syntaxhighlight lang="bash">
 
ping cisco-router
 
ping smartcard-prod-00
 
</syntaxhighlight>
 
 
 
Now you can try to ping a website:
 
 
<syntaxhighlight lang="bash">
 
ping dev.daxiongmao.eu
 
</syntaxhighlight>
 
 
 
===Test on CLIENT side===
 
 
 
Try to access ping the DNS server name from a client:
 
 
<syntaxhighlight lang="bash">
 
ping smartcard-gw
 
</syntaxhighlight>
 
 
 
Now you can try to ping a website:
 
 
<syntaxhighlight lang="bash">
 
ping tcl.fr
 
</syntaxhighlight>
 
 
 
 
 
==DNS server logs==
 
 
Logs are in '''/var/log/syslog'''
 
  
  
Line 416: Line 237:
 
Add a A or AAAA entry:
 
Add a A or AAAA entry:
  
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
my-new-host      IN      A      172.16.50.60
 
my-new-host      IN      A      172.16.50.60
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 434: Line 255:
 
Add a A or AAAA entry:
 
Add a A or AAAA entry:
  
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="apache">
 
60      IN      PTR    my-new-host.smartcards.local.
 
60      IN      PTR    my-new-host.smartcards.local.
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 445: Line 266:
 
service bind9 restart
 
service bind9 restart
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
  
  
Line 463: Line 285:
  
 
* http://doc.ubuntu-fr.org/bind9  (in French)
 
* http://doc.ubuntu-fr.org/bind9  (in French)
 +
 +
 +
Bug fixes:
 +
 +
* no forwarding due to DNS-SEC errors (broken trust chain): http://pewetheb.blogspot.se/2013/11/named-error-broken-trust-chain.html

Latest revision as of 14:16, 22 August 2014


Here, I will present the installation of:

  • Local domain (.local)

That means all the INTERNAL resources are private. Nothing is reachable from the outside.


In the following example I'll be using:

  • INTERNAL zone: smartcards.local
  • DNS server name: smartcard-gw
  • Network: 172.16.50.0/24 ; router: 172.16.50.1 ; DNS server IP: 172.16.50.2


Zone configuration (name to IP @)

Declare the new zone

Edit configuration file:

vim /etc/bind/named.conf.local


Uncomment and adjust the file content

zone "smartcards.local" {
	type master;
        file "/etc/bind/smartcards.local";
};


Zone configuration file

Create the zone configuration file from a local template:

cp /etc/bind/db.local /etc/bind/smartcards.local


Edit configuration file:

vim /etc/bind/smartcards.local


Adjust the file content

;
; BIND data file for smartcards.local
;
$TTL    604800
@       IN      SOA     smartcard-gw.smartcards.local. root.smartcards.local. (
                       20140603         ; Serial
                                        ; As the serial be changed everytime you edit this file
                                        ; it is recommended to use the pattern "yyyyMMdd"
                         604800         ; Refresh
                          86400         ; Retry
                        2419200         ; Expire
                         604800 )       ; Negative Cache TTL

; 
; DNS server declaration
; Each NS must point to an A record, not a CNAME. 
; This is where the Primary and Secondary DNS servers are defined
;
@                IN      NS      smartcard-gw.smartcards.local.
smartcard-gw     IN      A       172.16.50.2

;
; Gateway (router)
;
cisco-router      IN      A       172.16.50.1

;
; Declare your servers and networks hosts 
;
smarcartd-prod-00 IN      A       172.16.50.50
smarcartd-prod-01 IN      A       172.16.50.51
smarcartd-prod-02 IN      A       172.16.50.52
smarcartd-prod-03 IN      A       172.16.50.53

; Create an alias to an existing record
;wwww             IN      CNAME   smartcard-gw


Notes:

  • Don't forget to adjust the serial every-time you edit the file !
  • NS = Name server
  • A = IP v4 entry
  • AAAA = IP v6 entry
  • CNAME = Alias to a previous A or AAAA entry


Reverse zone (IP @ to name)

Now that the zone is setup and resolving names to IP Adresses a Reverse zone is also required. A Reverse zone allows DNS to resolve an address to a name.


Declare reverse zone

Edit configuration file:

vim /etc/bind/named.conf.local


Add the following reverse

# Our reverse zone
# Server IP 172.16.50.2
zone "50.16.172.in-addr.arpa" {
        type master;
        file "/etc/bind/db.172";
};


Key points:

  • Replace 50.16.172 with the first three octets of whatever network you are using - in reverse order!
  • Name the zone file /etc/bind/db.172 : it should match the first octet of your network.


Configure reverse zone

Now create the /etc/bind/db.172 file:

cp /etc/bind/db.127 /etc/bind/db.172


Edit the new file:

vim /etc/bind/db.172


The content is basically the same as /etc/bind/smartcards.local:

;
; BIND reverse data file for local 172.16.50.XXX net
;
$TTL    604800
@       IN      SOA     smartcard-gw.smartcards.local. root.smartcards.local. (
                       20140603         ; Serial
                                        ; As the serial be changed everytime you edit this file
                                        ; it is recommended to use the pattern "yyyyMMdd"
                         604800         ; Refresh
                          86400         ; Retry
                        2419200         ; Expire
                         604800 )       ; Negative Cache TTL
;
; Local server
;
@       IN      NS      smartcard-gw.
2       IN      PTR     smartcard-gw.smartcards.local.

; Gateway (router)
1       IN      PTR     cisco-router.smartcards.local

;
; Other components and hosts
;
50       IN      PTR     smartcard-prod-00.smartcards.local.
51       IN      PTR     smartcard-prod-01.smartcards.local.
52       IN      PTR     smartcard-prod-02.smartcards.local.
53       IN      PTR     smartcard-prod-03.smartcards.local.


Notes:

  • Don't forget to adjust the serial every-time you edit the file !
  • You only need to put the last byte value in the reverse
  • PTR = redirection to A entry


Take changes into account

service bind9 restart



Add new hostname

This is how we had a new host-name into the network:


Update LOCAL zone

Edit local zone:

vim /etc/bind/smartcards.local


Add a A or AAAA entry:

my-new-host       IN      A       172.16.50.60


Update REVERSE zone

Edit local zone:

vim /etc/bind/db.172


Add a A or AAAA entry:

60       IN      PTR     my-new-host.smartcards.local.


Restart service

service bind9 restart




Sources

You can find a lot of information about DNS on the web. I used the following tutorials:


Bug fixes: