{"id":4640,"date":"2022-12-20T18:09:24","date_gmt":"2022-12-20T21:09:24","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/shorewallzones-man5\/"},"modified":"2022-12-20T18:09:24","modified_gmt":"2022-12-20T21:09:24","slug":"shorewallzones-man5","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/shorewallzones-man5\/","title":{"rendered":"SHOREWALL−ZONES (man5)"},"content":{"rendered":"

SHOREWALL\u2212ZONES<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
FILES<\/a>
SEE ALSO<\/a>
NOTES<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

zones \u2212 Shorewall zone declaration file<\/p>\n

SYNOPSIS <\/a> <\/h2>\n\n\n
<\/td>\n\n

\/etc\/shorewall\/zones<\/b><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

DESCRIPTION <\/a> <\/h2>\n

The \/etc\/shorewall\/zones file declares your network zones. You specify the hosts in each zone through entries in \/etc\/shorewall\/interfaces or \/etc\/shorewall\/hosts.<\/p>\n

The columns in the file are as follows (where the column name is followed by a different name in parentheses, the different name is used in the alternate specification syntax).<\/p>\n

ZONE<\/b> \u2212 zone<\/i>[:<\/b>parent\u2212zone<\/i>[,<\/b>parent\u2212zone<\/i>]…]<\/p>\n

Name of the zone<\/i>. Must start with a letter and consist of letters, digits or ‘_’. The names “all”, “none”, “any”, “SOURCE” and “DEST” are reserved and may not be used as zone names. The maximum length of a zone name is determined by the setting of the LOGFORMAT option in shorewall.conf<\/font><\/b> [1]<\/font><\/small> (5). With the default LOGFORMAT, zone names can be at most 5 characters long. The maximum length of an iptables log prefix is 29 bytes. As explained in<\/font> shorewall.conf<\/font><\/b> [1]<\/font><\/small> (5), the legacy default LOGPREFIX formatting string is \u201cShorewall:%s:%s:\u201d where the first %s is replaced by the chain name and the second is replaced by the disposition.<\/font><\/p>\n

\u2022 The “Shorewall:%s:%s:” formatting string has 12 fixed characters (“Shorewall” and three colons).<\/font><\/p>\n

\u2022 The longest of the standard dispositions are ACCEPT and REJECT which have 6 characters each.<\/font><\/p>\n

\u2022 The canonical name for the chain containing the rules for traffic going from zone 1 to zone 2 is “2” or “\u2212“.<\/font><\/p>\n

\u2022 So if M is the maximum zone name length, such chains can have length 2*M + 1.<\/font><\/p>\n

12 + 6 + 2*M + 1 = 29 which reduces to
2*M = 29 \u2212 12 \u2212 6 \u2212 1 = 10 or
M = 5<\/font><\/p>\n

In Shorewall 5.1.0, the LOGFORMAT in the default and sample shorewall.conf files was changed to “%s:%s “.<\/font><\/p>\n

\u2022 That formatting string has 2 fixed characters (“:” and a space).<\/font><\/p>\n

\u2022 So the maximum zone name length M is calculated as:<\/font><\/p>\n

2 + 6 + 2*M + 1 = 29
2M = 29 \u2212 2 \u2212 6 \u2212 1 = 20
M = 10<\/font><\/p>\n

The order in which Shorewall matches addresses from packets to zones is determined by the order of zone declarations. Where a zone is nested in one or more other zones, you may either ensure that the nested zone precedes its parents in this file, or you may follow the (sub)zone name by “:” and a comma\u2212separated list of the parent zones. The parent zones must have been declared in earlier records in this file. See<\/font> shorewall\u2212nesting<\/font><\/b> [2]<\/font><\/small> (5) for additional information.<\/font><\/p>\n

Example:<\/font><\/p>\n

#ZONE TYPE OPTIONS IN OPTIONS OUT OPTIONS
a ip
b ip
c:a,b ip<\/font><\/p>\n

Currently, Shorewall uses this information to reorder the zone list so that parent zones appear after their subzones in the list. The IMPLICIT_CONTINUE option in<\/font> shorewall.conf<\/font><\/b> [1]<\/font><\/small> (5) can also create implicit CONTINUE policies to\/from the subzone.<\/font><\/p>\n

Where an ipsec<\/b> zone is explicitly included as a child of an ip<\/b> zone, the ruleset allows CONTINUE policies (explicit or implicit) to work as expected.<\/font><\/p>\n

In the future, Shorewall may make additional use of nesting information.<\/font><\/p>\n

TYPE<\/b><\/font><\/p>\n

ip<\/b><\/font><\/p>\n

This is the standard Shorewall zone type and is the default if you leave this column empty or if you enter “\u2212” in the column. Communication with some zone hosts may be encrypted. Encrypted hosts are designated using the ‘ipsec’ option in<\/font> shorewall\u2212hosts<\/font><\/b> [3]<\/font><\/small> (5). For clarity, this zone type may be specified as ipv4<\/b> in IPv4 configurations and ipv6<\/b> in IPv6 configurations.<\/font><\/p>\n

ipsec<\/b><\/font><\/p>\n

Communication with all zone hosts is encrypted. Your kernel and iptables must include policy match support. For clarity, this zone type may be specified as ipsec4<\/b> in IPv4 configurations and ipsec6<\/b> in IPv6 configurations.<\/font><\/p>\n

firewall<\/b><\/font><\/p>\n

Designates the firewall itself. You must have exactly one ‘firewall’ zone. No options are permitted with a ‘firewall’ zone. The name that you enter in the ZONE column will be stored in the shell variable $FW which you may use in other configuration files to designate the firewall zone.<\/font><\/p>\n

bport<\/b><\/font><\/p>\n

The zone is associated with one or more ports on a single bridge. For clarity, this zone type may be specified as bport4<\/b> in IPv4 configurations and bport6<\/b> in IPv6 configurations.<\/font><\/p>\n

vserver<\/b><\/font><\/p>\n

Added in Shorewall 4.4.11 Beta 2 \u2212 A zone composed of Linux\u2212vserver guests. The zone contents must be defined in<\/font> shorewall\u2212hosts<\/font><\/b> [3]<\/font><\/small> (5).<\/font><\/p>\n

Vserver zones are implicitly handled as subzones of the firewall zone.<\/font><\/p>\n

loopback<\/b><\/font><\/p>\n

Added in Shorewall 4.5.17.<\/font><\/p>\n

Normally, Shorewall treats the loopback interface (lo) in the following way:<\/font><\/p>\n

\u2022 By default, all traffic through the interface is ACCEPTed.<\/font><\/p>\n

\u2022 If a $FW \u2212> $FW policy is defined or $FW \u2212> $FW rules are defined, they are placed in a chain named ${FW}2${F2} or ${FW}\u2212${FW} (e.g., ‘fw2fw’ or ‘fw\u2212fw’ ) depending on the ZONE2ZONE setting in<\/font> shorewall.conf<\/font><\/b> [1]<\/font><\/small> (5).<\/font><\/p>\n

\u2022 $FW \u2212> $FW traffic is only filtered in the OUTPUT chain.<\/font><\/p>\n

By defining a loopback<\/b> zone and associating it with the loopback interface in shorewall\u2212interfaces(5), you can effect a slightly different model. Suppose that the loopback<\/b> zone name is ‘local’; then:<\/font><\/p>\n

\u2022 Both $FW \u2212> local and local \u2212> $FW chains are created.<\/font><\/p>\n

\u2022 The $FW \u2212> local and local \u2212> $FW policies may be different.<\/font><\/p>\n

\u2022 Both $FW \u2212> local and local \u2212> $FW rules may be specified.<\/font><\/p>\n

Rules to\/from the loopback<\/b> zone and any zone other than the firewall zone are ignored with a warning.<\/font><\/p>\n

loopback<\/b> zones may be nested within other loopback<\/b> zones.<\/font><\/p>\n

local<\/font><\/p>\n

Added in Shorewall 4.5.17. local<\/b> is the same as ipv4<\/b> with the exception that the zone is only accessible from the firewall<\/b> and vserver<\/b> zones.<\/font><\/p>\n

OPTIONS, IN OPTIONS and OUT OPTIONS<\/b> (options, in_options, out_options) \u2212 [option<\/i>[,<\/b>option<\/i>]…]<\/font><\/p>\n

A comma\u2212separated list of options. With the exception of the mss<\/b> and blacklist<\/b> options, these only apply to TYPE ipsec<\/b> zones.<\/font><\/p>\n

dynamic_shared<\/b><\/font><\/p>\n

Added in Shorewall 4.5.9. May only be specified in the OPTIONS column and indicates that only a single ipset should be created for this zone if it has multiple dynamic entries in<\/font> shorewall\u2212hosts<\/font><\/b> [3]<\/font><\/small> (5). Without this option, a separate ipset is created for each interface.<\/font><\/p>\n

reqid=<\/b>number<\/i><\/font><\/p>\n

where number<\/i> is specified using setkey(8) using the ‘unique:number<\/i> option for the SPD level.<\/font><\/p>\n

spi=<\/b><\/font><\/p>\n

where number<\/i> is the SPI of the SA used to encrypt\/decrypt packets.<\/font><\/p>\n

proto=ah<\/b>|esp<\/b>|ipcomp<\/b><\/font><\/p>\n

IPSEC Encapsulation Protocol<\/font><\/p>\n

mss=<\/b>number<\/i><\/font><\/p>\n

sets the MSS field in TCP packets. If you supply this option, you should also set FASTACCEPT=No in<\/font> shorewall.conf<\/font><\/b> [1]<\/font><\/small> (5) to insure that both the SYN and SYN,ACK packets have their MSS field adjusted.<\/font><\/p>\n

mode=transport<\/b>|tunnel<\/b><\/font><\/p>\n

IPSEC mode<\/font><\/p>\n

tunnel\u2212src=<\/b>address<\/i>[\/mask<\/i>]<\/font><\/p>\n

only available with mode=tunnel<\/font><\/p>\n

tunnel\u2212dst=<\/b>address<\/i>[\/mask<\/i>]<\/font><\/p>\n

only available with mode=tunnel<\/font><\/p>\n

strict<\/b><\/font><\/p>\n

Means that packets must match all rules.<\/font><\/p>\n

next<\/b><\/font><\/p>\n

Separates rules; can only be used with strict<\/font><\/p>\n

The options in the OPTIONS column are applied to both incoming and outgoing traffic. The IN OPTIONS are applied to incoming traffic (in addition to OPTIONS) and the OUT OPTIONS are applied to outgoing traffic.<\/font><\/p>\n

If you wish to leave a column empty but need to make an entry in a following column, use “\u2212”.<\/font><\/p>\n

FILES <\/a> <\/h2>\n

\/etc\/shorewall\/zones<\/font><\/p>\n

\/etc\/shorewall6\/zones<\/font><\/p>\n

SEE ALSO <\/a> <\/h2>\n

https:\/\/shorewall.org\/Multiple_Zones.html<\/font><\/b> [4]<\/font><\/small> .<\/font><\/p>\n

https:\/\/shorewall.org\/configuration_file_basics.htm#Pairs<\/font><\/b> [5]<\/font><\/small><\/p>\n

shorewall(8)<\/font><\/p>\n

NOTES <\/a> <\/h2>\n\n\n
<\/td>\n\n

1.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

shorewall.conf<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/shorewall.org\/manpages\/shorewall.conf.html<\/font><\/p>\n\n\n
<\/td>\n\n

2.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

shorewall-nesting<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/shorewall.org\/manpages\/shorewall-nesting.html<\/font><\/p>\n\n\n
<\/td>\n\n

3.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

shorewall-hosts<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/shorewall.org\/manpages\/shorewall-hosts.html<\/font><\/p>\n\n\n
<\/td>\n\n

4.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

https:\/\/shorewall.org\/Multiple_Zones.html<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/shorewall.org\/Multiple_Zones.html<\/font><\/p>\n\n\n
<\/td>\n\n

5.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

https:\/\/shorewall.org\/configuration_file_basics.htm#Pairs<\/font><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

https:\/\/shorewall.org\/configuration_file_basics.htm#Pairs<\/font><\/p>\n

\n","protected":false},"excerpt":{"rendered":"

zones \u2212 Shorewall zone declaration file <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[959],"tags":[961,1291,1577],"class_list":["post-4640","post","type-post","status-publish","format-standard","hentry","category-5-formatos-de-ficheros","tag-961","tag-man5","tag-shorewall-zones"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4640","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=4640"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4640\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=4640"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=4640"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=4640"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}