mirror of
https://github.com/ntop/ntopng.git
synced 2026-04-28 15:09:33 +00:00
128 lines
4.4 KiB
C++
128 lines
4.4 KiB
C++
/*
|
|
*
|
|
* (C) 2013-25 - 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 _HOST_ALERT_H_
|
|
#define _HOST_ALERT_H_
|
|
|
|
#include "ntop_includes.h"
|
|
|
|
class HostCheck;
|
|
|
|
class HostAlert {
|
|
private:
|
|
Host *host;
|
|
bool released; /* to be released */
|
|
bool last_released_for_host; /* there no other engaged alert at the time this has been released */
|
|
bool expiring; /* engaged, under re-evaluation */
|
|
HostCheckID check_id;
|
|
std::string check_name;
|
|
u_int64_t rowid; /* row id used by engaged alert in the in-memory table */
|
|
time_t engage_time;
|
|
time_t release_time;
|
|
time_t timeout_time; /* used by alerts with no C++ Check to automatically disengage */
|
|
risk_percentage cli_pctg; /* The fraction of total risk that goes to the client */
|
|
bool is_attacker, is_victim; /* Whether the host of this alert is considered
|
|
to be an attacker o a victim */
|
|
/*
|
|
Adds to the passed `serializer` (generated with `getAlertSerializer`)
|
|
information specific to this alert
|
|
*/
|
|
virtual ndpi_serializer *getAlertJSON(ndpi_serializer *serializer) {
|
|
return serializer;
|
|
}
|
|
void init(HostCheckID _check_id, std::string _check_name, Host *h,
|
|
risk_percentage _cli_pctg);
|
|
|
|
public:
|
|
HostAlert(HostCheckID check_id, std::string check_name, Host *h,
|
|
risk_percentage _cli_pctg);
|
|
HostAlert(HostCheck *c, Host *h, risk_percentage _cli_pctg);
|
|
virtual ~HostAlert();
|
|
|
|
inline u_int8_t getCliScore() const {
|
|
return (cli_pctg * getAlertScore()) / 100;
|
|
}
|
|
inline u_int8_t getSrvScore() const {
|
|
return (getAlertScore() - getCliScore());
|
|
}
|
|
/*
|
|
An alert is assumed to be client if the client score is positive and greater
|
|
than the server score. Similarly, it is assumed to be server when the server
|
|
score is positive and greater than the client score.
|
|
*/
|
|
inline bool isClient() const {
|
|
return getCliScore() > 0 && getCliScore() > getSrvScore();
|
|
}
|
|
inline bool isServer() const {
|
|
return getSrvScore() > 0 && getSrvScore() > getCliScore();
|
|
}
|
|
|
|
inline void setAttacker() { is_attacker = true; }
|
|
inline void setVictim() { is_victim = true; }
|
|
inline bool isAttacker() const { return is_attacker; }
|
|
inline bool isVictim() const { return is_victim; }
|
|
|
|
virtual HostAlertType getAlertType() const = 0;
|
|
virtual u_int8_t getAlertScore() const { return SCORE_LEVEL_NOTICE; };
|
|
|
|
/* Alert automatically released when the condition is no longer satisfied. */
|
|
virtual bool hasAutoRelease() { return true; }
|
|
|
|
inline Host *getHost() const { return (host); }
|
|
inline HostCheckID getCheckType() const { return (check_id); }
|
|
inline std::string getCheckName() const { return (check_name); }
|
|
|
|
inline void setEngaged(u_int64_t _rowid) { expiring = released = false; rowid = _rowid; }
|
|
|
|
inline void setExpiring() { expiring = true; }
|
|
inline bool isExpired() { return expiring; }
|
|
|
|
inline void setTimeout(time_t t) { timeout_time = t; }
|
|
inline time_t getTimeout() { return timeout_time; }
|
|
|
|
inline void release() {
|
|
released = true;
|
|
release_time = time(NULL);
|
|
}
|
|
inline bool isReleased() { return released; }
|
|
|
|
inline void setLastReleased() {
|
|
last_released_for_host = true;
|
|
}
|
|
inline bool isLastReleased() { return last_released_for_host; }
|
|
|
|
inline time_t getEngageTime() { return engage_time; }
|
|
inline time_t getReleaseTime() { return release_time; }
|
|
inline u_int32_t getRowID() { return rowid; }
|
|
|
|
inline bool equals(HostAlertType type) {
|
|
return getAlertType().id == type.id;
|
|
}
|
|
|
|
virtual bool autoAck() const { return false; };
|
|
|
|
/* Generates the JSON alert serializer with base information and per-check
|
|
* information gathered with `getAlertJSON`. NOTE: memory must be freed by the
|
|
* caller. */
|
|
ndpi_serializer *getSerializedAlert();
|
|
};
|
|
|
|
#endif /* _HOST_ALERT_H_ */
|