shorewall-zones(5)

1shorewall-zones(5)                                          shorewall-zones(5)
2
3
4

NAME

6       zones - Shorewall zone declaration file
7

SYNOPSIS

9       /etc/shorewall/zones
10

DESCRIPTION

12       The  /etc/shorewall/zones file declares your network zones. You specify
13       the hosts in each zone through entries in /etc/shorewall/interfaces  or
14       /etc/shorewall/hosts.
15
16       The columns in the file are as follows.
17
18       ZONE — zone[:parent-zone[,parent-zone]...]
19              Name  of  the zone. The names "all", "none", "SOURCE" and "DEST"
20              are reserved and may not be used  as  zone  names.  The  maximum
21              length  of  a zone name is determined by the setting of the LOG‐
22              FORMAT option in shorewall.conf ⟨shorewall.conf.html⟩ (5).  With
23              the  default  LOGFORMAT,  zone names can be at most 5 characters
24              long.
25
26              Where a zone is nested in one or more other zones, you may  fol‐
27              low  the (sub)zone name by ":" and a comma-separated list of the
28              parent zones. The parent zones must have been declared in earli‐
29              er records in this file. See shorewall-nesting
30              ⟨shorewall-nesting.html⟩ (5) for additional information.
31
32              Example:
33
34              #ZONE     TYPE     OPTIONS         IN OPTIONS        OUT OPTIONS
35              a         ipv4
36              b         ipv4
37              c:a,b     ipv4
38
39              Currently, Shorewall uses this information to reorder  the  zone
40              list  so  that  parent  zones appear after their subzones in the
41              list.  The IMPLICIT_CONTINUE option in shorewall.conf  can  also
42              create implicit CONTINUE policies to/from the subzone.
43
44              In  the future, Shorewall may make additional use of nesting in‐
45              formation.
46
47       TYPE
48
49              ipv4   This is the standard Shorewall zone type and is  the  de‐
50                     fault  if you leave this column empty or if you enter "-"
51                     in the column. Communication with some zone hosts may  be
52                     encrypted.  Encrypted  hosts  are  designated  using  the
53                     'ipsec'option in  shorewall-hosts  ⟨shorewall-hosts.html⟩
54                     (5).
55
56              ipsec  Communication with all zone hosts is encrypted. Your ker‐
57                     nel and iptables must include policy match support.
58
59              firewall
60                     Designates the firewall itself. You must have exactly one
61                     'firewall'  zone.  No options are permitted with a 'fire‐
62                     wall' zone. The name that you enter in  the  ZONE  column
63                     will  be  stored  in the shell variable $FW which you may
64                     use in other configuration files to designate  the  fire‐
65                     wall zone.
66
67              bport (or bport4)
68                     (Shorewall-perl  only) The zone is associated with one or
69                     more ports on a single bridge.
70
71       OPTIONS, IN OPTIONS and OUT OPTIONS — [option[,option]...]
72              A comma-separated list of options. With the exception of the mss
73              option, these only apply to TYPE ipsec zones.
74
75              reqid=number
76                     where  number  is  specified  using  setkey(8)  using the
77                     'unique:number option for the SPD level.
78
79              spi=<number>
80                     where number is the SPI of the SA used to encrypt/decrypt
81                     packets.
82
83              proto=ah|esp|ipcomp
84                     IPSEC Encapsulation Protocol
85
86              mss=number
87                     sets the MSS field in TCP packets. If you supply this op‐
88                     tion, you should also set FASTACCEPT=No in shorewall.conf
89                     ⟨shorewall.conf.html⟩ (8) to insure that both the SYN and
90                     SYN,ACK packets have their MSS field adjusted.
91
92              mode=transport|tunnel
93                     IPSEC mode
94
95              tunnel-src=address[/mask]
96                     only available with mode=tunnel
97
98              tunnel-dst=address[/mask]
99                     only available with mode=tunnel
100
101              strict Means that packets must match all rules.
102
103              next   Separates rules; can only be used with strict
104
105       The options in the OPTIONS column are applied to both incoming and out‐
106       going traffic. The IN OPTIONS are applied to incoming traffic (in addi‐
107       tion to OPTIONS) and the OUT OPTIONS are applied to outgoing traffic.
108
109       If you wish to leave a column empty but need to make an entry in a fol‐
110       lowing column, use "-".
111

FILES

113       /etc/shorewall/zones
114

NAME

SYNOPSIS

DESCRIPTION

FILES

SEE ALSO