shorewall-tunnels(5)
NAME
tunnels - Shorewall VPN definition file
SYNOPSIS
/etc/shorewall/tunnels
DESCRIPTION
The tunnels file is used to define rules for encapsulated (usually
encrypted) traffic to pass between the Shorewall system and a remote
gateway. Traffic flowing through the tunnel is handled using the normal
zone/policy/rule mechanism. See
http://www.shorewall.net/VPNBasics.html[1] for details.
The columns in the file are as follows.
TYPE -
{ipsec[:{noah|ah}]|ipsecnat|ipip|gre|l2tp|pptpclient|pptpserver|?COMMENT|{openvpn|openvpnclient|openvpnserver}[:{tcp|udp}][:port]|generic:protocol[:port]}
Types are as follows:
6to4 or 6in4 - 6to4 or 6in4 tunnel. The 6in4 synonym was added in 4.4.24.
ipsec - IPv4 IPSEC
ipsecnat - IPv4 IPSEC with NAT Traversal (UDP port 4500 encapsulation)
ipip - IPv4 encapsulated in IPv4 (Protocol 4)
gre - Generalized Routing Encapsulation (Protocol 47)
l2tp - Layer 2 Tunneling Protocol (UDP port 1701)
pptpclient - PPTP Client runs on the firewall
pptpserver - PPTP Server runs on the firewall
openvpn - OpenVPN in point-to-point mode
openvpnclient - OpenVPN client runs on the firewall
openvpnserver - OpenVPN server runs on the firewall
generic - Other tunnel type
tinc - TINC (added in Shorewall 4.6.6)
If the type is ipsec, it may be followed by :ah to indicate that
the Authentication Headers protocol (51) is used by the tunnel (the
default is :noah which means that protocol 51 is not used). NAT
traversal is only supported with ESP (protocol 50) so ipsecnat
tunnels don't allow the ah option (ipsecnat:noah may be specified
but is redundant).
If type is openvpn, openvpnclient or openvpnserver it may
optionally be followed by ":" and tcp or udp to specify the
protocol to be used. If not specified, udp is assumed.
If type is openvpn, openvpnclient or openvpnserver it may
optionally be followed by ":" and the port number used by the
tunnel. if no ":" and port number are included, then the default
port of 1194 will be used. . Where both the protocol and port are
specified, the protocol must be given first (e.g.,
openvpn:tcp:4444).
If type is generic, it must be followed by ":" and a protocol name
(from /etc/protocols) or a protocol number. If the protocol is tcp
or udp (6 or 17), then it may optionally be followed by ":" and a
port number.
Comments may be attached to Netfilter rules generated from entries
in this file through the use of /COMMENT lines. These lines begin
with ?COMMENT; the remainder of the line is treated as a comment
which is attached to subsequent rules until another ?COMMENT line
is found or until the end of the file is reached. To stop adding
comments to rules, use a line containing only ?COMMENT.
Note
Beginning with Shorewall 4.5.11, ?COMMENT is a synonym for
COMMENT and is preferred.
ZONE - zone
The zone of the physical interface through which tunnel traffic
passes. This is normally your internet zone.
GATEWAY(S) (gateway or gateways) - address-or-range [ , ... ]
The IP address of the remote tunnel gateway. If the remote gateway
has no fixed address (Road Warrior) then specify the gateway as
0.0.0.0/0. May be specified as a network address and if your kernel
and iptables include iprange match support then IP address ranges
are also allowed.
Beginning with Shorewall 4.5.3, a list of addresses or ranges may
be given. Exclusion (shorewall-exclusion[2] (5) ) is not supported.
GATEWAY ZONES (gateway_zone or gateway_zones) - [zone[,zone]...]
Optional. If the gateway system specified in the third column is a
standalone host then this column should contain a comma-separated
list of the names of the zones that the host might be in. This
column only applies to IPSEC tunnels where it enables ISAKMP
traffic to flow through the tunnel to the remote gateway(s).
EXAMPLE
Example 1:
IPSec tunnel.
The remote gateway is 4.33.99.124 and the remote subnet is
192.168.9.0/24. The tunnel does not use the AH protocol
#TYPE ZONE GATEWAY
ipsec:noah net 4.33.99.124
Example 2:
Road Warrior (LapTop that may connect from anywhere) where the "gw"
zone is used to represent the remote LapTop
#TYPE ZONE GATEWAY GATEWAY ZONES
ipsec net 0.0.0.0/0 gw
Example 3:
Host 4.33.99.124 is a standalone system connected via an ipsec
tunnel to the firewall system. The host is in zone gw.
#TYPE ZONE GATEWAY GATEWAY ZONES
ipsec net 4.33.99.124 gw
Example 4:
Road Warriors that may belong to zones vpn1, vpn2 or vpn3. The
FreeS/Wan _updown script will add the host to the appropriate zone
using the shorewall add command on connect and will remove the host
from the zone at disconnect time.
#TYPE ZONE GATEWAY GATEWAY ZONES
ipsec net 0.0.0.0/0 vpn1,vpn2,vpn3
Example 5:
You run the Linux PPTP client on your firewall and connect to
server 192.0.2.221.
#TYPE ZONE GATEWAY GATEWAY ZONES
pptpclient net 192.0.2.221
Example 6:
You run a PPTP server on your firewall.
#TYPE ZONE GATEWAY GATEWAY ZONES
pptpserver net 0.0.0.0/0
Example 7:
OPENVPN tunnel. The remote gateway is 4.33.99.124 and openvpn uses
port 7777.
#TYPE ZONE GATEWAY GATEWAY ZONES
openvpn:7777 net 4.33.99.124
Example 8:
You have a tunnel that is not one of the supported types. Your
tunnel uses UDP port 4444. The other end of the tunnel is
4.3.99.124.
#TYPE ZONE GATEWAY GATEWAY ZONES
generic:udp:4444 net 4.3.99.124
Example 9:
TINC tunnel where the remote gateways are not specified. If you
wish to specify a list of gateways, you can do so in the GATEWAY
column.
#TYPE ZONE GATEWAY GATEWAY ZONES
tinc net 0.0.0.0/0
FILES
/etc/shorewall/tunnels
SEE ALSO
http://www.shorewall.net/configuration_file_basics.htm#Pairs[3] shorewall(8), shorewall-accounting(5), shorewall-actions(5), shorewall-blacklist(5), shorewall-hosts(5), shorewall_interfaces(5), shorewall-ipsets(5), shorewall-maclist(5), shorewall-masq(5), shorewall-nat(5), shorewall-netmap(5), shorewall-params(5), shorewall-policy(5), shorewall-providers(5), shorewall-proxyarp(5), shorewall-rtrules(5), shorewall-routestopped(5), shorewall-rules(5), shorewall.conf(5), shorewall-secmarks(5), shorewall-tcclasses(5), shorewall-tcdevices(5), shorewall-mangle(5), shorewall-tos(5), shorewall-zones(5)
NOTES
1. http://www.shorewall.net/VPNBasics.html
http://www.shorewall.net/VPNBasics.html
2. shorewall-exclusion
http://www.shorewall.net/manpages/shorewall-exclusion.html
3. http://www.shorewall.net/configuration_file_basics.htm#Pairs
http://www.shorewall.net/configuration_file_basics.htm#Pairs
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
