msys.dp_config.audit_series.connections
Connection rate limiting
Find below the sample excerpt included in the dp_config.lua file.
msys.dp_config.audit_series.connections = {
type = "cidr",
interval = 900,
buckets = 4,
thresholds = {
{ check = true,
key = "/32",
startv = 0,
endv = 3,
threshold = 100,
honor_whitelist = { "global" } },
{ check = true,
key = "/24",
startv = 0,
endv = 3,
threshold = 1000,
honor_whitelist = { "global" } }
},
options = {
persist = true
}
};
The elements of this configuration table are as follows:
- type
-
Legal values for this element are
cidrand, 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
-
Count over which rejection happens.
thresholdsis 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 for this specific CIDR mask. When this threshold is exceeded code
421is issued along with the messageconnection rate limit exceeded. - honor_whitelist
-
A table listing any applicable whitelists set in the
msys.dp_config.whitelisttable.
- options
-
This item is a table with the following possible keys:
- serialize
-
Write audit series to log. The value may be
trueorfalse;falseis the default.When
true, the log will be written to the directory defined by theserialize_diroption 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
clusterto send to all nodes, ormanagerto send only to cluster manager nodes. This requires explicit configuration in the cluster 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.