]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - contrib/bind9/doc/arm/Bv9ARM.ch07.html
This commit was generated by cvs2svn to compensate for changes in r169962,
[FreeBSD/FreeBSD.git] / contrib / bind9 / doc / arm / Bv9ARM.ch07.html
1 <!--
2  - Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
3  - Copyright (C) 2000-2003 Internet Software Consortium.
4  - 
5  - Permission to use, copy, modify, and distribute this software for any
6  - purpose with or without fee is hereby granted, provided that the above
7  - copyright notice and this permission notice appear in all copies.
8  - 
9  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11  - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15  - PERFORMANCE OF THIS SOFTWARE.
16 -->
17 <!-- $Id: Bv9ARM.ch07.html,v 1.50.2.9.2.33 2006/09/13 02:56:21 marka Exp $ -->
18 <html>
19 <head>
20 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
21 <title>Chapter 7. BIND 9 Security Considerations</title>
22 <meta name="generator" content="DocBook XSL Stylesheets V1.70.1">
23 <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
24 <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
25 <link rel="prev" href="Bv9ARM.ch06.html" title="Chapter 6. BIND 9 Configuration Reference">
26 <link rel="next" href="Bv9ARM.ch08.html" title="Chapter 8. Troubleshooting">
27 </head>
28 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
29 <div class="navheader">
30 <table width="100%" summary="Navigation header">
31 <tr><th colspan="3" align="center">Chapter 7. <acronym class="acronym">BIND</acronym> 9 Security Considerations</th></tr>
32 <tr>
33 <td width="20%" align="left">
34 <a accesskey="p" href="Bv9ARM.ch06.html">Prev</a> </td>
35 <th width="60%" align="center"> </th>
36 <td width="20%" align="right"> <a accesskey="n" href="Bv9ARM.ch08.html">Next</a>
37 </td>
38 </tr>
39 </table>
40 <hr>
41 </div>
42 <div class="chapter" lang="en">
43 <div class="titlepage"><div><div><h2 class="title">
44 <a name="Bv9ARM.ch07"></a>Chapter 7. <acronym class="acronym">BIND</acronym> 9 Security Considerations</h2></div></div></div>
45 <div class="toc">
46 <p><b>Table of Contents</b></p>
47 <dl>
48 <dt><span class="sect1"><a href="Bv9ARM.ch07.html#Access_Control_Lists">Access Control Lists</a></span></dt>
49 <dt><span class="sect1"><a href="Bv9ARM.ch07.html#id2591971"><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for
50 UNIX servers)</a></span></dt>
51 <dd><dl>
52 <dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2592046">The <span><strong class="command">chroot</strong></span> Environment</a></span></dt>
53 <dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2592172">Using the <span><strong class="command">setuid</strong></span> Function</a></span></dt>
54 </dl></dd>
55 <dt><span class="sect1"><a href="Bv9ARM.ch07.html#dynamic_update_security">Dynamic Update Security</a></span></dt>
56 </dl>
57 </div>
58 <div class="sect1" lang="en">
59 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
60 <a name="Access_Control_Lists"></a>Access Control Lists</h2></div></div></div>
61 <p>Access Control Lists (ACLs), are address match lists that
62 you can set up and nickname for future use in <span><strong class="command">allow-notify</strong></span>,
63 <span><strong class="command">allow-query</strong></span>, <span><strong class="command">allow-recursion</strong></span>,
64 <span><strong class="command">blackhole</strong></span>, <span><strong class="command">allow-transfer</strong></span>,
65 etc.</p>
66 <p>Using ACLs allows you to have finer control over who can access
67 your name server, without cluttering up your config files with huge
68 lists of IP addresses.</p>
69 <p>It is a <span class="emphasis"><em>good idea</em></span> to use ACLs, and to
70 control access to your server. Limiting access to your server by
71 outside parties can help prevent spoofing and denial of service (DoS)
72 attacks against your server.</p>
73 <p>Here is an example of how to properly apply ACLs:</p>
74 <pre class="programlisting">
75 // Set up an ACL named "bogusnets" that will block RFC1918 space,
76 // which is commonly used in spoofing attacks.
77 acl bogusnets { 0.0.0.0/8; 1.0.0.0/8; 2.0.0.0/8; 192.0.2.0/24; 224.0.0.0/3; 10.0.0.0/8; 172.16.0.0/12; 192.168.0.0/16; };
78
79 // Set up an ACL called our-nets. Replace this with the real IP numbers.
80 acl our-nets { x.x.x.x/24; x.x.x.x/21; }; 
81 options {
82   ...
83   ...
84   allow-query { our-nets; };
85   allow-recursion { our-nets; };
86   ...
87   blackhole { bogusnets; };
88   ...
89 };
90
91 zone "example.com" {
92   type master;
93   file "m/example.com";
94   allow-query { any; };
95 };
96 </pre>
97 <p>This allows recursive queries of the server from the outside
98 unless recursion has been previously disabled.</p>
99 <p>For more information on how to use ACLs to protect your server,
100 see the <span class="emphasis"><em>AUSCERT</em></span> advisory at
101 <a href="ftp://ftp.auscert.org.au/pub/auscert/advisory/AL-1999.004.dns_dos" target="_top">ftp://ftp.auscert.org.au/pub/auscert/advisory/AL-1999.004.dns_dos</a></p>
102 </div>
103 <div class="sect1" lang="en">
104 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
105 <a name="id2591971"></a><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for
106 UNIX servers)</h2></div></div></div>
107 <p>On UNIX servers, it is possible to run <acronym class="acronym">BIND</acronym> in a <span class="emphasis"><em>chrooted</em></span> environment
108 (using the <span><strong class="command">chroot()</strong></span> function) by specifying the "<code class="option">-t</code>"
109 option. This can help improve system security by placing <acronym class="acronym">BIND</acronym> in
110 a "sandbox", which will limit the damage done if a server is compromised.</p>
111 <p>Another useful feature in the UNIX version of <acronym class="acronym">BIND</acronym> is the
112 ability to run the daemon as an unprivileged user ( <code class="option">-u</code> <em class="replaceable"><code>user</code></em> ).
113 We suggest running as an unprivileged user when using the <span><strong class="command">chroot</strong></span> feature.</p>
114 <p>Here is an example command line to load <acronym class="acronym">BIND</acronym> in a <span><strong class="command">chroot</strong></span> sandbox, 
115 <span><strong class="command">/var/named</strong></span>, and to run <span><strong class="command">named</strong></span> <span><strong class="command">setuid</strong></span> to
116 user 202:</p>
117 <p><strong class="userinput"><code>/usr/local/bin/named -u 202 -t /var/named</code></strong></p>
118 <div class="sect2" lang="en">
119 <div class="titlepage"><div><div><h3 class="title">
120 <a name="id2592046"></a>The <span><strong class="command">chroot</strong></span> Environment</h3></div></div></div>
121 <p>In order for a <span><strong class="command">chroot</strong></span> environment to
122 work properly in a particular directory
123 (for example, <code class="filename">/var/named</code>),
124 you will need to set up an environment that includes everything
125 <acronym class="acronym">BIND</acronym> needs to run.
126 From <acronym class="acronym">BIND</acronym>'s point of view, <code class="filename">/var/named</code> is
127 the root of the filesystem.  You will need to adjust the values of options like
128 like <span><strong class="command">directory</strong></span> and <span><strong class="command">pid-file</strong></span> to account
129 for this.
130 </p>
131 <p>
132 Unlike with earlier versions of BIND, you will typically
133 <span class="emphasis"><em>not</em></span> need to compile <span><strong class="command">named</strong></span>
134 statically nor install shared libraries under the new root.
135 However, depending on your operating system, you may need
136 to set up things like
137 <code class="filename">/dev/zero</code>,
138 <code class="filename">/dev/random</code>,
139 <code class="filename">/dev/log</code>, and
140 <code class="filename">/etc/localtime</code>.
141 </p>
142 </div>
143 <div class="sect2" lang="en">
144 <div class="titlepage"><div><div><h3 class="title">
145 <a name="id2592172"></a>Using the <span><strong class="command">setuid</strong></span> Function</h3></div></div></div>
146 <p>Prior to running the <span><strong class="command">named</strong></span> daemon, use
147 the <span><strong class="command">touch</strong></span> utility (to change file access and
148 modification times) or the <span><strong class="command">chown</strong></span> utility (to
149 set the user id and/or group id) on files
150 to which you want <acronym class="acronym">BIND</acronym>
151 to write.  Note that if the <span><strong class="command">named</strong></span> daemon is running as an
152 unprivileged user, it will not be able to bind to new restricted ports if the
153 server is reloaded.</p>
154 </div>
155 </div>
156 <div class="sect1" lang="en">
157 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
158 <a name="dynamic_update_security"></a>Dynamic Update Security</h2></div></div></div>
159 <p>Access to the dynamic
160 update facility should be strictly limited.  In earlier versions of
161 <acronym class="acronym">BIND</acronym>, the only way to do this was based on the IP
162 address of the host requesting the update, by listing an IP address or
163 network prefix in the <span><strong class="command">allow-update</strong></span> zone option.
164 This method is insecure since the source address of the update UDP packet
165 is easily forged.  Also note that if the IP addresses allowed by the
166 <span><strong class="command">allow-update</strong></span> option include the address of a slave
167 server which performs forwarding of dynamic updates, the master can be
168 trivially attacked by sending the update to the slave, which will
169 forward it to the master with its own source IP address causing the
170 master to approve it without question.</p>
171 <p>For these reasons, we strongly recommend that updates be
172 cryptographically authenticated by means of transaction signatures
173 (TSIG).  That is, the <span><strong class="command">allow-update</strong></span> option should
174 list only TSIG key names, not IP addresses or network
175 prefixes. Alternatively, the new <span><strong class="command">update-policy</strong></span>
176 option can be used.</p>
177 <p>Some sites choose to keep all dynamically-updated DNS data
178 in a subdomain and delegate that subdomain to a separate zone. This
179 way, the top-level zone containing critical data such as the IP addresses
180 of public web and mail servers need not allow dynamic update at
181 all.</p>
182 </div>
183 </div>
184 <div class="navfooter">
185 <hr>
186 <table width="100%" summary="Navigation footer">
187 <tr>
188 <td width="40%" align="left">
189 <a accesskey="p" href="Bv9ARM.ch06.html">Prev</a> </td>
190 <td width="20%" align="center"> </td>
191 <td width="40%" align="right"> <a accesskey="n" href="Bv9ARM.ch08.html">Next</a>
192 </td>
193 </tr>
194 <tr>
195 <td width="40%" align="left" valign="top">Chapter 6. <acronym class="acronym">BIND</acronym> 9 Configuration Reference </td>
196 <td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
197 <td width="40%" align="right" valign="top"> Chapter 8. Troubleshooting</td>
198 </tr>
199 </table>
200 </div>
201 </body>
202 </html>