mirror of
https://github.com/ntop/ntopng.git
synced 2026-04-30 16:09:32 +00:00
191 lines
8.4 KiB
C++
191 lines
8.4 KiB
C++
/*
|
|
*
|
|
* (C) 2013-17 - ntop.org
|
|
*
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*
|
|
*/
|
|
|
|
#ifndef _ALERTS_MANAGER_H_
|
|
#define _ALERTS_MANAGER_H_
|
|
|
|
#include "ntop_includes.h"
|
|
|
|
class Flow;
|
|
|
|
class AlertsManager : protected StoreManager {
|
|
private:
|
|
char queue_name[CONST_MAX_LEN_REDIS_KEY];
|
|
bool store_opened, store_initialized;
|
|
u_int32_t num_alerts_engaged;
|
|
bool alerts_stored;
|
|
int openStore();
|
|
|
|
/* methods used for alerts that have a timespan */
|
|
bool isAlertEngaged(AlertEngine alert_engine, AlertEntity alert_entity, const char *alert_entity_value, const char *engaged_alert_id,
|
|
AlertType *alert_type, AlertLevel *alert_severity, char **alert_json, char **alert_source, char **alert_target, time_t *alert_tstamp);
|
|
void markForMakeRoom(bool on_flows);
|
|
int engageAlert(AlertEngine alert_engine, AlertEntity alert_entity, const char *alert_entity_value,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
const char *alert_origin, const char *alert_target);
|
|
int releaseAlert(AlertEngine alert_engine, AlertEntity alert_entity, const char *alert_entity_value,
|
|
const char *engaged_alert_id);
|
|
int storeAlert(AlertEntity alert_entity, const char *alert_entity_value,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
const char *alert_origin, const char *alert_target,
|
|
bool check_maximum);
|
|
|
|
const char* getAlertEntity(AlertEntity alert_entity);
|
|
const char* getAlertLevel(AlertLevel alert_severity);
|
|
const char* getAlertType(AlertType alert_type);
|
|
SlackNotificationChoice getSlackNotificationChoice(char* choice);
|
|
|
|
void notifySlack (AlertEntity alert_entity, const char *alert_entity_value,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity,
|
|
const char *alert_json,
|
|
const char *alert_origin, const char *alert_target,
|
|
bool engage);
|
|
void notifyAlert(AlertEntity alert_entity, const char *alert_entity_value,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
const char *alert_origin, const char *alert_target,
|
|
bool engage);
|
|
|
|
int engageReleaseHostAlert(const char *host_ip, u_int16_t host_vlan,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
const char *alert_origin, const char *alert_target,
|
|
bool engage);
|
|
|
|
int engageReleaseNetworkAlert(const char *cidr,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
bool engage);
|
|
int engageReleaseInterfaceAlert(NetworkInterface *n,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
bool engage);
|
|
|
|
/* methods used to retrieve alerts and counters with possible sql clause to filter */
|
|
int queryAlertsRaw(lua_State *vm, const char *selection, const char *clauses, const char *table_name, bool ignore_disabled);
|
|
int getNumAlerts(bool engaged, const char *sql_where_clause, bool ignore_disabled=false);
|
|
int getNumFlowAlerts(const char *sql_where_clause);
|
|
|
|
/* private methods to check the goodness of submitted inputs and possible return the input database string */
|
|
bool isValidHost(Host *h, char *host_string, size_t host_string_len);
|
|
bool isValidFlow(Flow *f);
|
|
bool isValidNetwork(const char *cidr);
|
|
bool isValidInterface(NetworkInterface *n);
|
|
|
|
inline void refreshCachedNumAlerts() {
|
|
num_alerts_engaged = getNumAlerts(true, static_cast<char*>(NULL), true);
|
|
alerts_stored = (getNumAlerts(false, static_cast<char*>(NULL), true) + getNumFlowAlerts()) > 0;
|
|
}
|
|
|
|
public:
|
|
AlertsManager(int interface_id, const char *db_filename);
|
|
~AlertsManager() {};
|
|
|
|
/*
|
|
========== HOST alerts API =========
|
|
*/
|
|
inline int engageHostAlert(const char *host_ip, u_int16_t host_vlan,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseHostAlert(host_ip, host_vlan, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, NULL, NULL, true /* engage */);
|
|
};
|
|
inline int releaseHostAlert(const char *host_ip, u_int16_t host_vlan,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseHostAlert(host_ip, host_vlan, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, NULL, NULL, false /* release */);
|
|
};
|
|
int storeHostAlert(Host *h, AlertType alert_type, AlertLevel alert_severity, const char *alert_json,
|
|
Host *alert_origin, Host *alert_target);
|
|
inline int storeHostAlert(Host *h, AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return storeHostAlert(h, alert_type, alert_severity, alert_json, NULL, NULL);
|
|
}
|
|
int getNumHostAlerts(Host *h, bool engaged);
|
|
|
|
/*
|
|
========== FLOW alerts API =========
|
|
*/
|
|
int storeFlowAlert(Flow *f, AlertType alert_type, AlertLevel alert_severity, const char *alert_json);
|
|
inline int getNumFlowAlerts() {
|
|
return getNumFlowAlerts(NULL);
|
|
};
|
|
/*
|
|
========== NETWORK alerts API ======
|
|
*/
|
|
inline int engageNetworkAlert(const char *cidr,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseNetworkAlert(cidr, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, true /* engage */);
|
|
};
|
|
inline int releaseNetworkAlert(const char *cidr,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseNetworkAlert(cidr, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, false /* release */);
|
|
};
|
|
int storeNetworkAlert(const char *cidr, AlertType alert_type, AlertLevel alert_severity, const char *alert_json);
|
|
|
|
/*
|
|
========== INTERFACE alerts API ======
|
|
*/
|
|
inline int engageInterfaceAlert(NetworkInterface *n,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseInterfaceAlert(n, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, true /* engage */);
|
|
};
|
|
inline int releaseInterfaceAlert(NetworkInterface *n,
|
|
AlertEngine alert_engine,
|
|
const char *engaged_alert_id,
|
|
AlertType alert_type, AlertLevel alert_severity, const char *alert_json) {
|
|
return engageReleaseInterfaceAlert(n, alert_engine, engaged_alert_id, alert_type, alert_severity, alert_json, false /* release */);
|
|
};
|
|
int storeInterfaceAlert(NetworkInterface *n, AlertType alert_type, AlertLevel alert_severity, const char *alert_json);
|
|
|
|
/*
|
|
========== counters API ======
|
|
*/
|
|
int getCachedNumAlerts(lua_State *vm);
|
|
inline int getNumAlerts(bool engaged) {
|
|
/* must force the cast or the compiler will go crazy with ambiguous calls */
|
|
return getNumAlerts(engaged, "alert_severity=2" /* errors only */);
|
|
}
|
|
|
|
/*
|
|
========== raw API ======
|
|
*/
|
|
inline int queryAlertsRaw(lua_State *vm, bool engaged, const char *selection, const char *clauses, bool ignore_disabled) {
|
|
return queryAlertsRaw(vm, selection, clauses,
|
|
engaged ? ALERTS_MANAGER_ENGAGED_TABLE_NAME : ALERTS_MANAGER_TABLE_NAME, ignore_disabled);
|
|
};
|
|
inline int queryFlowAlertsRaw(lua_State *vm, const char *selection, const char *clauses, bool ignore_disabled) {
|
|
return queryAlertsRaw(vm, selection, clauses, ALERTS_MANAGER_FLOWS_TABLE_NAME, ignore_disabled);
|
|
};
|
|
};
|
|
|
|
#endif /* _ALERTS_MANAGER_H_ */
|