mirror of
https://gitlab.com/shorewall/code.git
synced 2024-11-28 02:23:20 +01:00
8e54f47816
git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@843 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
119 lines
8.7 KiB
HTML
Executable File
119 lines
8.7 KiB
HTML
Executable File
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Language" content="en-us">
|
||
<meta http-equiv="Content-Type"
|
||
content="text/html; charset=windows-1252">
|
||
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
|
||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||
<title>Shorewall Accounting</title>
|
||
<meta name="author" content="Tom Eastep">
|
||
</head>
|
||
<body>
|
||
<h1 style="text-align: center;">Shorewall and Traffic Accounting<br>
|
||
</h1>
|
||
Shorewall Traffic Accounting support was added in Shorewall release
|
||
1.4.7.<br>
|
||
<br>
|
||
Shorewall accounting rules are described in the file
|
||
/etc/shorewall/accounting. By default, the accounting rules are placed
|
||
in a chain called "accounting" and can thus be displayed using
|
||
"shorewall show accounting". All traffic passing into, out of or
|
||
through the firewall traverses the accounting chain including traffic
|
||
that will later be rejected by <a href="Documentation.htm#Interfaces">interface
|
||
options</a> such as "tcpflags" and "maclist". If your kernel doesn't
|
||
support the connection tracking match extension (Kernel 2.4.21) then
|
||
some traffic rejected under 'norfc1918' will not traverse the
|
||
accounting chain.<br>
|
||
<br>
|
||
The columns in the accounting file are as follows:<br>
|
||
<ul>
|
||
<li><span style="font-weight: bold;">ACTION</span> - What to do when
|
||
a
|
||
match is found. Possible values are:</li>
|
||
<ul>
|
||
<li>COUNT- Simply count the match and continue trying to
|
||
match the
|
||
packet with the following accounting rules</li>
|
||
<li>DONE- Count the match and don't attempt to match any following
|
||
accounting rules.</li>
|
||
<li><<span style="font-style: italic;">chain</span>> - The
|
||
name of a chain to jump to. Shorewall will create the chain
|
||
automatically. If the name of the chain is followed by ":COUNT" then a
|
||
COUNT rule matching this rule will automatically be added to <<span
|
||
style="font-style: italic;">chain</span>>. Chain names must start
|
||
with a letter, must be composed of letters and digits, and may contain
|
||
underscores ("_") and periods ("."). Beginning with Shorewall version
|
||
1.4.8, chain names man also contain embedded dashes ("-") and are not
|
||
required to start with a letter.<br>
|
||
</li>
|
||
</ul>
|
||
<li><span style="font-weight: bold;">CHAIN </span>- The name of the
|
||
chain where the accounting rule is to be added. If empty or "-" then
|
||
the
|
||
"accounting" chain is assumed.<br>
|
||
</li>
|
||
<li><span style="font-weight: bold;">SOURCE</span> - Packet Source.
|
||
The name of an interface, an address (host or net) or an interface name
|
||
followed by ":" and a host or net address.</li>
|
||
<li><span style="font-weight: bold;">DESTINATION</span> - Packet
|
||
Destination Format the same as the SOURCE column.</li>
|
||
<li><span style="font-weight: bold;">PROTOCOL</span> - A protocol
|
||
name
|
||
(from /etc/protocols) or a protocol number.</li>
|
||
<li><span style="font-weight: bold;">DEST PORT</span> - Destination
|
||
Port number. Service name from /etc/services or port number. May only
|
||
be
|
||
specified if the protocol is TCP or UDP (6 or 17).</li>
|
||
<li><span style="font-weight: bold;">SOURCE PORT</span>- Source Port
|
||
number. Service name from /etc/services or port number. May only be
|
||
specified if the protocol is TCP or UDP (6 or 17).<br>
|
||
</li>
|
||
</ul>
|
||
In all columns except ACTION and CHAIN, the values "-","any" and "all"
|
||
are treated as wild-cards.<br>
|
||
<br>
|
||
The accounting rules are evaluated in the Netfilter 'filter' table.
|
||
This is the same environment where the 'rules' file rules are evaluated
|
||
and in this environment, DNAT has already occurred in inbound packets
|
||
and SNAT has not yet occurred on outbound ones.<br>
|
||
<br>
|
||
Accounting rules are not stateful -- each rule only handles traffic in
|
||
one direction. For example, if eth0 is your internet interface and you
|
||
have a web server in your DMZ connected to eth1 then to count HTTP
|
||
traffic in both directions requires two rules: <br>
|
||
<pre> #ACTION CHAIN SOURCE DESTINATION PROTOCOL DEST SOURCE<br> # PORT PORT<br> DONE - eth0 eth1 tcp 80<br> DONE - eth1 eth0 tcp - 80</pre>
|
||
Associating a counter with a chain allows for nice reporting. For
|
||
example:<br>
|
||
<pre> #ACTION CHAIN SOURCE DESTINATION PROTOCOL DEST SOURCE<br> # PORT PORT<br> web:COUNT - eth0 eth1 tcp 80<br> web:COUNT - eth1 eth0 tcp - 80<br> web:COUNT - eth0 eth1 tcp 443<br> web:COUNT - eth1 eth0 tcp - 443<br> DONE web<br></pre>
|
||
Now "shorewall show web" will give you a breakdown of your web traffic:<br>
|
||
<div style="margin-left: 40px;">
|
||
<pre>[root@gateway shorewall]# shorewall show web<br>Shorewall-1.4.6-20030821 Chain web at gateway.shorewall.net - Wed Aug 20 09:48:56 PDT 2003<br> <br>Counters reset Wed Aug 20 09:48:00 PDT 2003<br> <br>Chain web (4 references)<br> pkts bytes target prot opt in out source destination<br> 11 1335 tcp -- eth0 eth1 0.0.0.0/0 0.0.0.0/0 tcp dpt:80<br> 18 1962 tcp -- eth1 eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:80<br> 0 0 tcp -- eth0 eth1 0.0.0.0/0 0.0.0.0/0 tcp dpt:443<br> 0 0 tcp -- eth1 eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:443<br> 29 3297 RETURN all -- * * 0.0.0.0/0 0.0.0.0/0<br>[root@gateway shorewall]#</pre>
|
||
</div>
|
||
Here's a slightly different example:<br>
|
||
<pre> #ACTION CHAIN SOURCE DESTINATION PROTOCOL DEST SOURCE<br> # PORT PORT<br> web - eth0 eth1 tcp 80<br> web - eth1 eth0 tcp - 80<br> web - eth0 eth1 tcp 443<br> web - eth1 eth0 tcp - 443<br><br> COUNT web eth0 eth1<br> COUNT web eth1 eth0<br></pre>
|
||
Now "shorewall show web" simply gives you a breakdown by input and
|
||
output:<br>
|
||
<br>
|
||
<pre style="margin-left: 40px;">[root@gateway shorewall]# shorewall show accounting web <br>Shorewall-1.4.6-20030821 Chains accounting web at gateway.shorewall.net - Wed Aug 20 10:27:21 PDT 2003<br> <br>Counters reset Wed Aug 20 10:24:33 PDT 2003<br> <br>Chain accounting (3 references)<br> pkts bytes target prot opt in out source destination<br> 8767 727K web tcp -- eth0 eth1 0.0.0.0/0 0.0.0.0/0 tcp dpt:80<br> 0 0 web tcp -- eth0 eth1 0.0.0.0/0 0.0.0.0/0 tcp dpt:443<br>11506 13M web tcp -- eth1 eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:80<br> 0 0 web tcp -- eth1 eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:443<br>Chain web (4 references)<br> pkts bytes target prot opt in out source destination<br> 8767 727K all -- eth0 eth1 0.0.0.0/0 0.0.0.0/0<br>11506 13M all -- eth1 eth0 0.0.0.0/0 0.0.0.0/0<br>[root@gateway shorewall]#<br></pre>
|
||
Here's how the same example would be constructed on an HTTP server
|
||
(READ THAT FOLKS -- IT SAYS <span style="text-decoration: underline;"><span
|
||
style="font-weight: bold;">SERVER</span></span>. If you want to
|
||
account for web browsing, you have to reverse the rules below) with
|
||
only
|
||
one interface (eth0):<br>
|
||
<pre style="margin-left: 40px;">#ACTION CHAIN SOURCE DESTINATION PROTOCOL DEST SOURCE<br># PORT PORT<br>web - eth0 - tcp 80<br>web - - eth0 tcp - 80<br>web - eth0 - tcp 443<br>web - - eth0 tcp - 443<br><br>COUNT web eth0 -<br>COUNT web - eth0<br></pre>
|
||
Note that with only one interface, only the SOURCE (for input rules) or
|
||
the DESTINATION (for output rules) is specified in each rule.<br>
|
||
<br>
|
||
Here's the output:<br>
|
||
<pre style="margin-left: 40px;">[root@mail shorewall]# shorewall show accounting web <br>Shorewall-1.4.7 Chains accounting web at mail.shorewall.net - Sun Oct 12 10:27:21 PDT 2003<br> <br>Counters reset Sat Oct 11 08:12:57 PDT 2003<br> <br>Chain accounting (3 references)<br> pkts bytes target prot opt in out source destination<br> 8767 727K web tcp -- eth0 * 0.0.0.0/0 0.0.0.0/0 tcp dpt:80<br> 0 0 web tcp -- eth0 * 0.0.0.0/0 0.0.0.0/0 tcp dpt:443<br>11506 13M web tcp -- * eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:80<br> 0 0 web tcp -- * eth0 0.0.0.0/0 0.0.0.0/0 tcp spt:443<br>Chain web (4 references)<br> pkts bytes target prot opt in out source destination<br> 8767 727K all -- eth0 * 0.0.0.0/0 0.0.0.0/0<br>11506 13M all -- * eth0 0.0.0.0/0 0.0.0.0/0<br>[root@mail shorewall]#<br></pre>
|
||
<p align="left"><font size="2">Last updated 12/06/2003 - <a
|
||
href="support.htm">Tom Eastep</a></font></p>
|
||
<p><font face="Trebuchet MS"><a href="copyright.htm"><font size="2">Copyright</font>
|
||
<EFBFBD> <font size="2">2003 Thomas M. Eastep.</font></a></font></p>
|
||
<br>
|
||
<br>
|
||
</body>
|
||
</html>
|