msys.dp_config.audit_series.invalid_recipients
This table sets the Directory Harvest Attack (DHA) parameters.
Find below the sample excerpt included in the dp_config.lua
file.
msys.dp_config.audit_series.invalid_recipients = {
type = "cidr",
interval = 900,
buckets = 4,
thresholds = {
{ check = true,
key = "/32",
startv = 0,
endv = 3,
threshold = 50 },
{ check = true,
key = "/24",
startv = 0,
endv = 3,
threshold = 500 }
},
options = {
persist = true
}
};
The elements of this configuration table are as follows:
- type
-
Legal values for this element are
cidr
and, as of version 3.4,cidr_ipv6
. - interval
-
The time interval that you wish to look at measured in seconds. A reasonable value might be
900
. - buckets
-
A bucket is a window of time of the length defined by "interval". A reasonable value might be
4
. - thresholds
-
thresholds
is a nested table within this configuration option. The following list defines the attributes of the individual thresholds.- check
-
Whether or not to use this configuration item.
- key
-
The CIDR mask length for the threshold (the leading forward slash is required).
- startv
-
The starting bucket (0 is the current bucket) to query across.
- endv
-
The ending bucket.
- threshold
-
The threshold defining the maximum number of invalid recipients. When this threshold is exceeded code
451
is issued along with the messageDHA limit exceeded
.
- options
-
This item is a table with the following possible keys:
- serialize
-
Write audit series to log. The value may be
true
orfalse
;false
is the default.When
true
, the log will be written to the directory defined by theserialize_dir
option in the inbound_audit module. The default value for this option is/var/log/ecelerity/audit_series_persist
. - replicate
-
Defaults to none, but can be
cluster
to send to all nodes, ormanager
to send only to cluster manager nodes. This requires explicit configuration in thecluster
stanza to operate correctly. For more information see Data Replication. - persist
-
When set to
true
, the audit series will be persisted. The persisted series will be reloaded when the engine restarts. The default value isfalse
.