| 1 |
# |
| 2 |
# Argus Software |
| 3 |
# Copyright (c) 2000-2024 QoSient, LLC |
| 4 |
# All rights reserved. |
| 5 |
# |
| 6 |
# This program is free software; you can redistribute it and/or modify |
| 7 |
# it under the terms of the GNU General Public License as published by |
| 8 |
# the Free Software Foundation; either version 2, or (at your option) |
| 9 |
# any later version. |
| 10 |
# |
| 11 |
# This program is distributed in the hope that it will be useful, |
| 12 |
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 |
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 |
# GNU General Public License for more details. |
| 15 |
# |
| 16 |
# You should have received a copy of the GNU General Public License |
| 17 |
# along with this program; if not, write to the Free Software |
| 18 |
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| 19 |
# |
| 20 |
# |
| 21 |
# Example rapolicy.conf |
| 22 |
# |
| 23 |
# Rapolicy, like most ra* programs, can read a program specific |
| 24 |
# configuration file. This is an example configuration for rapolicy() |
| 25 |
# that provides the opportunity to modify the default behavior of |
| 26 |
# parsing a Cisco ACL definition, and reporting on flows that match |
| 27 |
# aspects of the policy defined by the ACL. |
| 28 |
# |
| 29 |
# This file is read by rapolicy() from the command line using the |
| 30 |
# " -f rapolicy.conf " option. |
| 31 |
# |
| 32 |
# RA_POLICY_DUMP_POLICY is a debugging aid. If it is set to yes, then rapolicy() will read |
| 33 |
# and parse the ACL file and output an English language description of the actions associated |
| 34 |
# with each ACL entry. After outputting the explaination, rapolicy will exit. |
| 35 |
|
| 36 |
#RA_POLICY_DUMP_POLICY="yes" |
| 37 |
|
| 38 |
# The rapolicy client parses a Cisco IOS ACL and constructs a filter which is used |
| 39 |
# to permit or deny flows. Under normal circumstances the packets meeting the |
| 40 |
# criteria for a permit rule are output by the client. There are circumstances where |
| 41 |
# it is useful to see the flows that are dropped. RA_POLICY_SHOW_WHICH can be set |
| 42 |
# to a value of "deny" in these cases. |
| 43 |
|
| 44 |
#RA_POLICY_SHOW_WHICH="permit" |
| 45 |
|
| 46 |
# Under normal operating conditions, only the flow records that match a permit |
| 47 |
# or a deny rule (depending on the value of RA_POLICY_SHOW_WHICH) are output. In |
| 48 |
# some instance like baselining the actions of an ACL, the goal is to have a fully |
| 49 |
# labeled set of flows regardless of the ACL's permit or deny determination. In these |
| 50 |
# instances, a value of yes for RA_POLICY_JUST_LABEL will allow the full processing of |
| 51 |
# the flows and will label them according to the settings of the label flags but all of |
| 52 |
# the flows handled by the ACL will be output |
| 53 |
|
| 54 |
RA_POLICY_JUST_LABEL="no" |
| 55 |
|
| 56 |
|
| 57 |
# A Cisco IP ACL normally has no impact on non-IP traffic eg: ARP, DDCMP, Slotted-Aloha |
| 58 |
# RA_POLICY_PERMIT_OTHERS can be set to "yes" for the normal behavior or "no" to block |
| 59 |
# non-IP traffic |
| 60 |
|
| 61 |
#RA_POLICY_PERMIT_OTHERS="yes" |
| 62 |
|
| 63 |
|
| 64 |
# The rapolicy client can add a label to a flow indicating the action (permit, deny, |
| 65 |
# or implictDeny), the ACL name or number) and the line within the ACL that caused the |
| 66 |
# action. |
| 67 |
# |
| 68 |
# if RA_POLICY_LABEL_LOG is set to "yes" labels will be added to flows matching ACL |
| 69 |
# entries that have a log qualifier. |
| 70 |
|
| 71 |
RA_POLICY_LABEL_LOG="no" |
| 72 |
|
| 73 |
|
| 74 |
# If RA_POLICY_LABEL_ALL is set to "yes" regardless of the value of RA_POLICY_LABEL_LOG, |
| 75 |
# any flow that matches an ACL entry will be labeled |
| 76 |
|
| 77 |
RA_POLICY_LABEL_ALL="no" |
| 78 |
|
| 79 |
|
| 80 |
# Every Cisos IOS ACL has an implicit deny as its last entry. Flows that do not match any |
| 81 |
# ACL entry are usually dropped silently. RA_POLICY_LABEL_IMPLICIT will label flows that |
| 82 |
# are dropped by the implicit deny rule. Under normal circumstances, these flows are not |
| 83 |
# labeled. The values of RA_POLICY_LABEL_ALL and RA_POLICY_LABEL_LOG do not govern the |
| 84 |
# labeling of these flows. |
| 85 |
|
| 86 |
RA_POLICY_LABEL_IMPLICIT="no" |
| 87 |
|
| 88 |
|
| 89 |
# The ACL is contained in a standard ASCII text file which is identified by the value of |
| 90 |
# RA_POLICY_ACL_FILE Since rapolicy is not designed to be a syntax checker, it is a |
| 91 |
# good idea to create the ACL on a Cisco device and take the output of show running |
| 92 |
# (or the appropriate equivalent command) as the input ACL for rapolicy() |
| 93 |
# The policy file should be defined as the last item in the rapolicy.conf file |
| 94 |
# or there may be unexpected side effects |
| 95 |
|
| 96 |
#RA_POLICY_ACL_FILE="/tmp/ACL03.txt" |
| 97 |
|