1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
# @summary This defined resource manages a single rule in a specific chain
#
# @example Jump to the 'SSH' chain for all incoming SSH traffic (see chain.pp examples on how to create the chain)
# ferm::rule{'incoming-ssh':
# chain => 'INPUT',
# action => 'SSH',
# proto => 'tcp',
# dport => 22,
# }
#
# @example Create a rule in the 'SSH' chain to allow connections from localhost
# ferm::rule{'allow-ssh-localhost':
# chain => 'SSH',
# action => 'ACCEPT',
# proto => 'tcp',
# dport => 22,
# saddr => '127.0.0.1',
# }
#
#
# @example Confuse people that do a traceroute/mtr/ping to your system
# ferm::rule{'drop-icmp-time-exceeded':
# chain => 'OUTPUT',
# policy => 'DROP',
# proto => 'icmp',
# proto_options => 'icmp-type time-exceeded',
# }
#
# @example allow multiple protocols
# ferm::rule{'allow_consul':
# chain => 'INPUT',
# policy => 'ACCEPT',
# proto => ['udp', 'tcp'],
# dport => 8301,
# }
#
# @param chain Configure the chain where we want to add the rule
# @param proto Which protocol do we want to match, typically UDP or TCP
# @param comment A comment that will be added to the ferm config and to ip{,6}tables
# @param action Configure what we want to do with the packet (drop/accept/reject, can also be a target chain name)
# Default value: undef
# Allowed values: (RETURN|ACCEPT|DROP|REJECT|NOTRACK|LOG|MARK|DNAT|SNAT|MASQUERADE|REDIRECT|String[1])
# @param policy Configure what we want to do with the packet (drop/accept/reject, can also be a target chain name) [DEPRECATED]
# Default value: undef
# Allowed values: (RETURN|ACCEPT|DROP|REJECT|NOTRACK|LOG|MARK|DNAT|SNAT|MASQUERADE|REDIRECT|String[1])
# @param dport The destination port, can be a single port number as integer or an Array of integers (which will then use the multiport matcher)
# @param sport The source port, can be a single port number as integer or an Array of integers (which will then use the multiport matcher)
# @param saddr The source address we want to match
# @param daddr The destination address we want to match
# @param proto_options Optional parameters that will be passed to the protocol (for example to match specific ICMP types)
# @param interface an Optional interface where this rule should be applied
# @param ensure Set the rule to present or absent
# @param table Select the target table (filter/raw/mangle/nat)
# Default value: filter
# Allowed values: (filter|raw|mangle|nat) (see Ferm::Tables type)
define ferm::rule (
String[1] $chain,
Ferm::Protocols $proto,
String $comment = $name,
Optional[Ferm::Actions] $action = undef,
Optional[Ferm::Policies] $policy = undef,
Optional[Ferm::Port] $dport = undef,
Optional[Ferm::Port] $sport = undef,
Optional[Variant[Array, String[1]]] $saddr = undef,
Optional[Variant[Array, String[1]]] $daddr = undef,
Optional[String[1]] $proto_options = undef,
Optional[String[1]] $interface = undef,
Enum['absent','present'] $ensure = 'present',
Ferm::Tables $table = 'filter',
) {
if $policy and $action {
fail('Cannot specify both policy and action. Do not provide policy when using the new action param.')
} elsif $policy and ! $action {
warning('The param "policy" is deprecated (superseded by "action") and will be dropped in a future release.')
$action_temp = $policy
} elsif $action and ! $policy {
$action_temp = $action
} else {
fail('Exactly one of "action" or the deprecated "policy" param is required.')
}
if $action_temp in ['RETURN', 'ACCEPT', 'DROP', 'REJECT', 'NOTRACK', 'LOG', 'MARK', 'DNAT', 'SNAT', 'MASQUERADE', 'REDIRECT'] {
$action_real = $action_temp
} else {
# assume the action contains a target chain, so prefix it with the "jump" statement
$action_real = "jump ${action_temp}"
# make sure the target chain is created before we try to add rules to it
Ferm::Chain <| chain == $action_temp and table == $table |> -> Ferm::Rule[$name]
}
$proto_real = $proto ? {
Array => "proto (${join($proto, ' ')})",
String => "proto ${proto}",
Integer => "proto ${proto}",
}
if $dport =~ Array {
$dports = join($dport, ' ')
$dport_real = "mod multiport destination-ports (${dports})"
} elsif $dport =~ Integer {
$dport_real = "dport ${dport}"
} elsif String($dport) =~ /^\d*:\d+$/ {
$portrange = split($dport, /:/)
$lower = $portrange[0] ? {
'' => 0,
default => Integer($portrange[0]),
}
$upper = Integer($portrange[1])
assert_type(Tuple[Stdlib::Port, Stdlib::Port], [$lower, $upper]) |$expected, $actual| {
fail("The data type should be \'${expected}\', not \'${actual}\'. The data is [${lower}, ${upper}])}.")
''
}
if $lower > $upper {
fail("Lower port number of the port range is larger than upper. ${lower}:${upper}")
}
$dport_real = "dport ${lower}:${upper}"
} elsif String($dport) == '' {
$dport_real = ''
} else {
fail("invalid destination-port: ${dport}")
}
if $sport =~ Array {
$sports = join($sport, ' ')
$sport_real = "mod multiport source-ports (${sports})"
} elsif $sport =~ Integer {
$sport_real = "sport ${sport}"
} elsif String($sport) =~ /^\d*:\d+$/ {
$portrange = split($sport, /:/)
$lower = $portrange[0] ? {
'' => 0,
default => Integer($portrange[0]),
}
$upper = Integer($portrange[1])
assert_type(Tuple[Stdlib::Port, Stdlib::Port], [$lower, $upper]) |$expected, $actual| {
fail("The data type should be \'${expected}\', not \'${actual}\'. The data is [${lower}, ${upper}])}.")
''
}
if $lower > $upper {
fail("Lower port number of the port range is larger than upper. ${lower}:${upper}")
}
$sport_real = "sport ${lower}:${upper}"
} elsif String($sport) == '' {
$sport_real = ''
} else {
fail("invalid source-port: ${sport}")
}
if $saddr =~ Array {
assert_type(Array[Stdlib::IP::Address], flatten($saddr)) |$expected, $actual| {
fail( "The data type should be \'${expected}\', not \'${actual}\'. The data is ${flatten($saddr)}." )
''
}
}
$saddr_real = $saddr ? {
undef => '',
Array => "saddr @ipfilter((${join(flatten($saddr).unique, ' ')}))",
String => "saddr @ipfilter((${saddr}))",
default => '',
}
if $daddr =~ Array {
assert_type(Array[Stdlib::IP::Address], flatten($daddr)) |$expected, $actual| {
fail( "The data type should be \'${expected}\', not \'${actual}\'. The data is ${flatten($daddr)}." )
''
}
}
$daddr_real = $daddr ? {
undef => '',
Array => "daddr @ipfilter((${join(flatten($daddr).unique, ' ')}))",
String => "daddr @ipfilter((${daddr}))",
default => '',
}
$proto_options_real = $proto_options ? {
undef => '',
default => $proto_options
}
$comment_real = "mod comment comment '${comment}'"
# prevent unmanaged files due to new naming schema
# keep the default "filter" chains in the original location
# only prefix chains in other tables with the table name
if $table == 'filter' and $chain in ['INPUT', 'FORWARD', 'OUTPUT'] {
$filename = "${ferm::configdirectory}/chains/${chain}.conf"
} else {
$filename = "${ferm::configdirectory}/chains/${table}-${chain}.conf"
}
$rule = squeeze("${comment_real} ${proto_real} ${proto_options_real} ${dport_real} ${sport_real} ${daddr_real} ${saddr_real} ${action_real};", ' ')
if $ensure == 'present' {
if $interface {
unless defined(Concat::Fragment["${chain}-${interface}-aaa"]) {
concat::fragment { "${chain}-${interface}-aaa":
target => $filename,
content => "interface ${interface} {\n",
order => $interface,
}
}
concat::fragment { "${chain}-${interface}-${name}":
target => $filename,
content => " ${rule}\n",
order => $interface,
}
unless defined(Concat::Fragment["${chain}-${interface}-zzz"]) {
concat::fragment { "${chain}-${interface}-zzz":
target => $filename,
content => "}\n",
order => $interface,
}
}
} else {
concat::fragment { "${chain}-${name}":
target => $filename,
content => "${rule}\n",
}
}
}
}
|