mirror of
https://github.com/ntop/ntopng.git
synced 2026-04-29 07:29:32 +00:00
99 lines
3.6 KiB
Lua
99 lines
3.6 KiB
Lua
--
|
|
-- (C) 2019-24 - ntop.org
|
|
--
|
|
--
|
|
-- (C) 2019-24 - ntop.org
|
|
--
|
|
|
|
-- ##############################################
|
|
|
|
local flow_alert_keys = require "flow_alert_keys"
|
|
-- Import the classes library.
|
|
local classes = require "classes"
|
|
-- Make sure to import the Superclass!
|
|
local alert = require "alert"
|
|
local json = require "dkjson"
|
|
-- Import Mitre Att&ck utils
|
|
local mitre = require "mitre_utils"
|
|
local format_utils = require "format_utils"
|
|
|
|
-- ##############################################
|
|
|
|
local alert_elephant_flow = classes.class(alert)
|
|
|
|
-- ##############################################
|
|
|
|
alert_elephant_flow.meta = {
|
|
alert_key = flow_alert_keys.flow_alert_elephant_flow,
|
|
i18n_title = "flow_details.elephant_flow",
|
|
icon = "fas fa-fw fa-exclamation",
|
|
|
|
-- Mitre Att&ck Matrix values
|
|
mitre_values = {
|
|
mitre_tactic = mitre.tactic.collection,
|
|
mitre_technique = mitre.technique.data_from_conf_repo,
|
|
mitre_sub_technique = mitre.sub_technique.network_device_conf_dump,
|
|
mitre_id = "T1602.002"
|
|
},
|
|
}
|
|
|
|
-- #######################################################
|
|
|
|
-- @brief Prepare an alert table used to generate the alert
|
|
-- @param l2r_threshold Local-to-Remote threshold, in bytes, for a flow to be considered an elephant
|
|
-- @param r2l_threshold Remote-to-Local threshold, in bytes, for a flow to be considered an elephant
|
|
-- @return A table with the alert built
|
|
function alert_elephant_flow:init()
|
|
-- Call the parent constructor
|
|
self.super:init()
|
|
end
|
|
|
|
-- #######################################################
|
|
|
|
-- @brief Format an alert into a human-readable string
|
|
-- @param ifid The integer interface id of the generated alert
|
|
-- @param alert The alert description table, including alert data such as the generating entity, timestamp, granularity, type
|
|
-- @param alert_type_params Table `alert_type_params` as built in the `:init` method
|
|
-- @return A human-readable string
|
|
function alert_elephant_flow.format(ifid, alert, alert_type_params)
|
|
local threshold = ""
|
|
local res = ""
|
|
|
|
if alert_type_params and (alert_type_params["l2r_bytes"] or alert_type_params["r2l_bytes"]) then
|
|
|
|
res = string.format("%s<sup><i class='fas fa-info-circle' aria-hidden='true' title='"..i18n("flow_details.elephant_flow_descr").."'></i></sup>", res)
|
|
|
|
if alert_type_params["l2r_bytes"] and
|
|
alert_type_params["l2r_threshold"] and
|
|
alert_type_params["l2r_threshold"] > 0 and
|
|
alert_type_params["l2r_bytes"] > alert_type_params["l2r_threshold"] then
|
|
local l2r_bytes = bytesToSize(alert_type_params["l2r_bytes"])
|
|
local l2r_threshold = bytesToSize(alert_type_params["l2r_threshold"])
|
|
res = res .. " " .. i18n("flow_details.elephant_exceeded_l2r", {value = l2r_bytes, threshold = l2r_threshold})
|
|
end
|
|
|
|
if alert_type_params["r2l_bytes"] and
|
|
alert_type_params["r2l_threshold"] and
|
|
alert_type_params["l2r_threshold"] > 0 and
|
|
alert_type_params["r2l_bytes"] > alert_type_params["r2l_threshold"] then
|
|
local r2l_bytes = bytesToSize(alert_type_params["r2l_bytes"])
|
|
local r2l_threshold = bytesToSize(alert_type_params["r2l_threshold"])
|
|
res = res .. " " .. i18n("flow_details.elephant_exceeded_r2l", {value = r2l_bytes, threshold = r2l_threshold})
|
|
end
|
|
end
|
|
|
|
if alert["json"] then
|
|
local alert_json = json.decode(alert["json"])
|
|
if alert_json and not isEmptyString(alert_json["info"]) then
|
|
res = string.format("%s [%s]", res, alert_json["info"])
|
|
end
|
|
end
|
|
|
|
return res
|
|
end
|
|
|
|
-- #######################################################
|
|
|
|
return alert_elephant_flow
|
|
|
|
-- #######################################################
|