This repo is obsolete, please see git://git.code.sf.net/p/dummynet/code@master
[ipfw.git] / configuration / rc.firewall
1 #!/bin/sh -
2 # Copyright (c) 1996  Poul-Henning Kamp
3 # All rights reserved.
4 #
5 # Redistribution and use in source and binary forms, with or without
6 # modification, are permitted provided that the following conditions
7 # are met:
8 # 1. Redistributions of source code must retain the above copyright
9 #    notice, this list of conditions and the following disclaimer.
10 # 2. Redistributions in binary form must reproduce the above copyright
11 #    notice, this list of conditions and the following disclaimer in the
12 #    documentation and/or other materials provided with the distribution.
13 #
14 # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 # ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 # SUCH DAMAGE.
25 #
26 # $FreeBSD: src/etc/rc.firewall,v 1.52.4.1 2008/01/29 00:22:32 dougb Exp $
27 #
28
29 #
30 # Setup system for ipfw(4) firewall service.
31 #
32
33 # Suck in the configuration variables.
34 if [ -z "${source_rc_confs_defined}" ]; then
35         if [ -r /etc/defaults/rc.conf ]; then
36                 . /etc/defaults/rc.conf
37                 source_rc_confs
38         elif [ -r /etc/rc.conf ]; then
39                 . /etc/rc.conf
40         fi
41 fi
42
43 ############
44 # Define the firewall type in /etc/rc.conf.  Valid values are:
45 #   open        - will allow anyone in
46 #   client      - will try to protect just this machine
47 #   simple      - will try to protect a whole network
48 #   closed      - totally disables IP services except via lo0 interface
49 #   workstation - will try to protect just this machine using statefull
50 #                 firewalling. See below for rc.conf variables used
51 #   UNKNOWN     - disables the loading of firewall rules.
52 #   filename    - will load the rules in the given filename (full path required)
53 #
54 # For ``client'' and ``simple'' the entries below should be customized
55 # appropriately.
56
57 ############
58 #
59 # If you don't know enough about packet filtering, we suggest that you
60 # take time to read this book:
61 #
62 #       Building Internet Firewalls, 2nd Edition
63 #       Brent Chapman and Elizabeth Zwicky
64 #
65 #       O'Reilly & Associates, Inc
66 #       ISBN 1-56592-871-7
67 #       http://www.ora.com/
68 #       http://www.oreilly.com/catalog/fire2/
69 #
70 # For a more advanced treatment of Internet Security read:
71 #
72 #       Firewalls and Internet Security: Repelling the Wily Hacker, 2nd Edition
73 #       William R. Cheswick, Steven M. Bellowin, Aviel D. Rubin
74 #
75 #       Addison-Wesley / Prentice Hall
76 #       ISBN 0-201-63466-X
77 #       http://www.pearsonhighered.com/
78 #       http://www.pearsonhighered.com/educator/academic/product/0,3110,020163466X,00.html
79 #
80
81 setup_loopback () {
82         ############
83         # Only in rare cases do you want to change these rules
84         #
85         ${fwcmd} add 100 pass all from any to any via lo0
86         ${fwcmd} add 200 deny all from any to 127.0.0.0/8
87         ${fwcmd} add 300 deny ip from 127.0.0.0/8 to any
88 }
89
90 if [ -n "${1}" ]; then
91         firewall_type="${1}"
92 fi
93
94 ############
95 # Set quiet mode if requested
96 #
97 case ${firewall_quiet} in
98 [Yy][Ee][Ss])
99         fwcmd="/sbin/ipfw -q"
100         ;;
101 *)
102         fwcmd="/sbin/ipfw"
103         ;;
104 esac
105
106 ############
107 # Flush out the list before we begin.
108 #
109 ${fwcmd} -f flush
110
111 setup_loopback
112
113 ############
114 # Network Address Translation.  All packets are passed to natd(8)
115 # before they encounter your remaining rules.  The firewall rules
116 # will then be run again on each packet after translation by natd
117 # starting at the rule number following the divert rule.
118 #
119 # For ``simple'' firewall type the divert rule should be put to a
120 # different place to not interfere with address-checking rules.
121 #
122 case ${firewall_type} in
123 [Oo][Pp][Ee][Nn]|[Cc][Ll][Ii][Ee][Nn][Tt])
124         case ${natd_enable} in
125         [Yy][Ee][Ss])
126                 if [ -n "${natd_interface}" ]; then
127                         ${fwcmd} add 50 divert natd ip4 from any to any via ${natd_interface}
128                 fi
129                 ;;
130         esac
131         case ${firewall_nat_enable} in
132         [Yy][Ee][Ss])
133                 if [ -n "${firewall_nat_interface}" ]; then
134                         ${fwcmd} nat 123 config if ${firewall_nat_interface} log
135                         ${fwcmd} add 50 nat 123 ip4 from any to any via ${firewall_nat_interface}
136                 fi
137                 ;;
138         esac
139 esac
140
141 ############
142 # If you just configured ipfw in the kernel as a tool to solve network
143 # problems or you just want to disallow some particular kinds of traffic
144 # then you will want to change the default policy to open.  You can also
145 # do this as your only action by setting the firewall_type to ``open''.
146 #
147 # ${fwcmd} add 65000 pass all from any to any
148
149
150 # Prototype setups.
151 #
152 case ${firewall_type} in
153 [Oo][Pp][Ee][Nn])
154         ${fwcmd} add 65000 pass all from any to any
155         ;;
156
157 [Cc][Ll][Ii][Ee][Nn][Tt])
158         ############
159         # This is a prototype setup that will protect your system somewhat
160         # against people from outside your own network.
161         ############
162
163         # set these to your network and netmask and ip
164         net="192.0.2.0"
165         mask="255.255.255.0"
166         ip="192.0.2.1"
167
168         # Allow any traffic to or from my own net.
169         ${fwcmd} add pass all from ${ip} to ${net}:${mask}
170         ${fwcmd} add pass all from ${net}:${mask} to ${ip}
171
172         # Allow TCP through if setup succeeded
173         ${fwcmd} add pass tcp from any to any established
174
175         # Allow IP fragments to pass through
176         ${fwcmd} add pass all from any to any frag
177
178         # Allow setup of incoming email
179         ${fwcmd} add pass tcp from any to me 25 setup
180
181         # Allow setup of outgoing TCP connections only
182         ${fwcmd} add pass tcp from me to any setup
183
184         # Disallow setup of all other TCP connections
185         ${fwcmd} add deny tcp from any to any setup
186
187         # Allow DNS queries out in the world
188         ${fwcmd} add pass udp from me to any 53 keep-state
189
190         # Allow NTP queries out in the world
191         ${fwcmd} add pass udp from me to any 123 keep-state
192
193         # Everything else is denied by default, unless the
194         # IPFIREWALL_DEFAULT_TO_ACCEPT option is set in your kernel
195         # config file.
196         ;;
197
198 [Ss][Ii][Mm][Pp][Ll][Ee])
199         ############
200         # This is a prototype setup for a simple firewall.  Configure this
201         # machine as a DNS and NTP server, and point all the machines
202         # on the inside at this machine for those services.
203         ############
204
205         # set these to your outside interface network and netmask and ip
206         oif="ed0"
207         onet="192.0.2.0"
208         omask="255.255.255.240"
209         oip="192.0.2.1"
210
211         # set these to your inside interface network and netmask and ip
212         iif="ed1"
213         inet="192.0.2.16"
214         imask="255.255.255.240"
215         iip="192.0.2.17"
216
217         # Stop spoofing
218         ${fwcmd} add deny all from ${inet}:${imask} to any in via ${oif}
219         ${fwcmd} add deny all from ${onet}:${omask} to any in via ${iif}
220
221         # Stop RFC1918 nets on the outside interface
222         ${fwcmd} add deny all from any to 10.0.0.0/8 via ${oif}
223         ${fwcmd} add deny all from any to 172.16.0.0/12 via ${oif}
224         ${fwcmd} add deny all from any to 192.168.0.0/16 via ${oif}
225
226         # Stop draft-manning-dsua-03.txt (1 May 2000) nets (includes RESERVED-1,
227         # DHCP auto-configuration, NET-TEST, MULTICAST (class D), and class E)
228         # on the outside interface
229         ${fwcmd} add deny all from any to 0.0.0.0/8 via ${oif}
230         ${fwcmd} add deny all from any to 169.254.0.0/16 via ${oif}
231         ${fwcmd} add deny all from any to 192.0.2.0/24 via ${oif}
232         ${fwcmd} add deny all from any to 224.0.0.0/4 via ${oif}
233         ${fwcmd} add deny all from any to 240.0.0.0/4 via ${oif}
234
235         # Network Address Translation.  This rule is placed here deliberately
236         # so that it does not interfere with the surrounding address-checking
237         # rules.  If for example one of your internal LAN machines had its IP
238         # address set to 192.0.2.1 then an incoming packet for it after being
239         # translated by natd(8) would match the `deny' rule above.  Similarly
240         # an outgoing packet originated from it before being translated would
241         # match the `deny' rule below.
242         case ${natd_enable} in
243         [Yy][Ee][Ss])
244                 if [ -n "${natd_interface}" ]; then
245                         ${fwcmd} add divert natd all from any to any via ${natd_interface}
246                 fi
247                 ;;
248         esac
249
250         # Stop RFC1918 nets on the outside interface
251         ${fwcmd} add deny all from 10.0.0.0/8 to any via ${oif}
252         ${fwcmd} add deny all from 172.16.0.0/12 to any via ${oif}
253         ${fwcmd} add deny all from 192.168.0.0/16 to any via ${oif}
254
255         # Stop draft-manning-dsua-03.txt (1 May 2000) nets (includes RESERVED-1,
256         # DHCP auto-configuration, NET-TEST, MULTICAST (class D), and class E)
257         # on the outside interface
258         ${fwcmd} add deny all from 0.0.0.0/8 to any via ${oif}
259         ${fwcmd} add deny all from 169.254.0.0/16 to any via ${oif}
260         ${fwcmd} add deny all from 192.0.2.0/24 to any via ${oif}
261         ${fwcmd} add deny all from 224.0.0.0/4 to any via ${oif}
262         ${fwcmd} add deny all from 240.0.0.0/4 to any via ${oif}
263
264         # Allow TCP through if setup succeeded
265         ${fwcmd} add pass tcp from any to any established
266
267         # Allow IP fragments to pass through
268         ${fwcmd} add pass all from any to any frag
269
270         # Allow setup of incoming email
271         ${fwcmd} add pass tcp from any to ${oip} 25 setup
272
273         # Allow access to our DNS
274         ${fwcmd} add pass tcp from any to ${oip} 53 setup
275         ${fwcmd} add pass udp from any to ${oip} 53
276         ${fwcmd} add pass udp from ${oip} 53 to any
277
278         # Allow access to our WWW
279         ${fwcmd} add pass tcp from any to ${oip} 80 setup
280
281         # Reject&Log all setup of incoming connections from the outside
282         ${fwcmd} add deny log tcp from any to any in via ${oif} setup
283
284         # Allow setup of any other TCP connection
285         ${fwcmd} add pass tcp from any to any setup
286
287         # Allow DNS queries out in the world
288         ${fwcmd} add pass udp from ${oip} to any 53 keep-state
289
290         # Allow NTP queries out in the world
291         ${fwcmd} add pass udp from ${oip} to any 123 keep-state
292
293         # Everything else is denied by default, unless the
294         # IPFIREWALL_DEFAULT_TO_ACCEPT option is set in your kernel
295         # config file.
296         ;;
297
298 [Ww][Oo][Rr][Kk][Ss][Tt][Aa][Tt][Ii][Oo][Nn])
299         # Configuration:
300         #  firewall_myservices:         List of TCP ports on which this host
301         #                                offers services.
302         #  firewall_allowservices:      List of IPs which has access to
303         #                                $firewall_myservices.
304         #  firewall_trusted:            List of IPs which has full access 
305         #                                to this host. Be very carefull 
306         #                                when setting this. This option can
307         #                                seriously degrade the level of 
308         #                                protection provided by the firewall.
309         #  firewall_logdeny:            Boolean (YES/NO) specifying if the
310         #                                default denied packets should be
311         #                                logged (in /var/log/security).
312         #  firewall_nologports:         List of TCP/UDP ports for which
313         #                                denied incomming packets are not
314         #                                logged.
315         
316         # Allow packets for which a state has been built.
317         ${fwcmd} add check-state
318
319         # For services permitted below.
320         ${fwcmd} add pass tcp  from me to any established
321
322         # Allow any connection out, adding state for each.
323         ${fwcmd} add pass tcp  from me to any setup keep-state
324         ${fwcmd} add pass udp  from me to any       keep-state
325         ${fwcmd} add pass icmp from me to any       keep-state
326
327         # Allow DHCP.
328         ${fwcmd} add pass udp  from 0.0.0.0 68 to 255.255.255.255 67 out
329         ${fwcmd} add pass udp  from any 67     to me 68 in
330         ${fwcmd} add pass udp  from any 67     to 255.255.255.255 68 in
331         # Some servers will ping the IP while trying to decide if it's 
332         # still in use.
333         ${fwcmd} add pass icmp from any to any icmptype 8
334
335         # Allow "mandatory" ICMP in.
336         ${fwcmd} add pass icmp from any to any icmptype 3,4,11
337         
338         # Add permits for this workstations published services below
339         # Only IPs and nets in firewall_allowservices is allowed in.
340         # If you really wish to let anyone use services on your 
341         # workstation, then set "firewall_allowservices='any'" in /etc/rc.conf
342         #
343         # Note: We don't use keep-state as that would allow DoS of
344         #       our statetable. 
345         #       You can add 'keep-state' to the lines for slightly
346         #       better performance if you fell that DoS of your
347         #       workstation won't be a problem.
348         #
349         for i in ${firewall_allowservices} ; do
350           for j in ${firewall_myservices} ; do
351             ${fwcmd} add pass tcp from $i to me $j
352           done
353         done
354
355         # Allow all connections from trusted IPs.
356         # Playing with the content of firewall_trusted could seriously
357         # degrade the level of protection provided by the firewall.
358         for i in ${firewall_trusted} ; do
359           ${fwcmd} add pass ip from $i to me
360         done
361         
362         ${fwcmd} add 65000 count ip from any to any
363
364         # Drop packets to ports where we don't want logging
365         for i in ${firewall_nologports} ; do
366           ${fwcmd} add deny { tcp or udp } from any to any $i in
367         done
368
369         # Broadcasts and muticasts
370         ${fwcmd} add deny ip  from any to 255.255.255.255
371         ${fwcmd} add deny ip  from any to 224.0.0.0/24 in       # XXX
372
373         # Noise from routers
374         ${fwcmd} add deny udp from any to any 520 in
375
376         # Noise from webbrowsing.
377         # The statefull filter is a bit agressive, and will cause some
378         #  connection teardowns to be logged.
379         ${fwcmd} add deny tcp from any 80,443 to any 1024-65535 in
380
381         # Deny and (if wanted) log the rest unconditionally.
382         log=""
383         if [ ${firewall_logdeny:-x} = "YES" -o ${firewall_logdeny:-x} = "yes" ] ; then
384           log="log logamount 500"       # The default of 100 is too low.
385           sysctl net.inet.ip.fw.verbose=1 >/dev/null
386         fi
387         ${fwcmd} add deny $log ip from any to any
388         ;;
389
390 [Cc][Ll][Oo][Ss][Ee][Dd])
391         ${fwcmd} add 65000 deny ip from any to any
392         ;;
393 [Uu][Nn][Kk][Nn][Oo][Ww][Nn])
394         ;;
395 *)
396         if [ -r "${firewall_type}" ]; then
397                 ${fwcmd} ${firewall_flags} ${firewall_type}
398         fi
399         ;;
400 esac