mirror of
https://github.com/mvt-project/mvt.git
synced 2024-07-01 08:29:03 +00:00
Compare commits
3 Commits
2f620f3a04
...
4bb493651e
Author | SHA1 | Date | |
---|---|---|---|
|
4bb493651e | ||
|
013282dbba | ||
|
ac157a4421 |
138
mvt/common/alerting.py
Normal file
138
mvt/common/alerting.py
Normal file
|
@ -0,0 +1,138 @@
|
||||||
|
# Mobile Verification Toolkit (MVT)
|
||||||
|
# Copyright (c) 2021-2023 The MVT Authors.
|
||||||
|
# Use of this software is governed by the MVT License 1.1 that can be found at
|
||||||
|
# https://license.mvt.re/1.1/
|
||||||
|
from enum import Enum
|
||||||
|
|
||||||
|
|
||||||
|
class AlertLevel(Enum):
|
||||||
|
"""
|
||||||
|
informational: Rule is intended for enrichment of events, e.g. by tagging them. No case or alerting should be triggered by such rules because it is expected that a huge amount of events will match these rules.
|
||||||
|
low: Notable event but rarely an incident. Low rated events can be relevant in high numbers or combination with others. Immediate reaction shouldn’t be necessary, but a regular review is recommended.
|
||||||
|
medium: Relevant event that should be reviewed manually on a more frequent basis.
|
||||||
|
high: Relevant event that should trigger an internal alert and requires a prompt review.
|
||||||
|
critical: Highly relevant event that indicates an incident. Critical events should be reviewed immediately.
|
||||||
|
"""
|
||||||
|
|
||||||
|
INFORMATIONAL = 0
|
||||||
|
LOW = 10
|
||||||
|
MEDIUM = 20
|
||||||
|
HIGH = 30
|
||||||
|
CRITICAL = 40
|
||||||
|
|
||||||
|
|
||||||
|
class AlertStore(object):
|
||||||
|
"""
|
||||||
|
Track all of the alerts and detections generated during an analysis.
|
||||||
|
|
||||||
|
Results can be logged as log messages or in JSON format for processing by other tools.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self) -> None:
|
||||||
|
self.alerts = []
|
||||||
|
|
||||||
|
def add_alert(
|
||||||
|
self, level, message=None, event_time=None, event=None, ioc=None, detected=True
|
||||||
|
):
|
||||||
|
"""
|
||||||
|
Add an alert to the alert store.
|
||||||
|
"""
|
||||||
|
self.alerts.append(
|
||||||
|
Alert(
|
||||||
|
level=level,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
def informational(
|
||||||
|
self, message=None, event_time=None, event=None, ioc=None, detected=False
|
||||||
|
):
|
||||||
|
self.add_alert(
|
||||||
|
AlertLevel.INFORMATIONAL,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
|
||||||
|
def low(self, message=None, event_time=None, event=None, ioc=None, detected=False):
|
||||||
|
self.add_alert(
|
||||||
|
AlertLevel.LOW,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
|
||||||
|
def medium(
|
||||||
|
self, message=None, event_time=None, event=None, ioc=None, detected=False
|
||||||
|
):
|
||||||
|
self.add_alert(
|
||||||
|
AlertLevel.MEDIUM,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
|
||||||
|
def high(self, message=None, event_time=None, event=None, ioc=None, detected=False):
|
||||||
|
self.add_alert(
|
||||||
|
AlertLevel.HIGH,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
|
||||||
|
def critical(
|
||||||
|
self, message=None, event_time=None, event=None, ioc=None, detected=False
|
||||||
|
):
|
||||||
|
self.add_alert(
|
||||||
|
AlertLevel.CRITICAL,
|
||||||
|
message=message,
|
||||||
|
event_time=event_time,
|
||||||
|
event=event,
|
||||||
|
ioc=ioc,
|
||||||
|
detected=detected,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
class Alert(object):
|
||||||
|
"""
|
||||||
|
An alert generated by an MVT module.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self, level, message, event_time, event, ioc, detected):
|
||||||
|
self.level = level
|
||||||
|
self.message = message
|
||||||
|
self.event_time = event_time
|
||||||
|
self.event = event
|
||||||
|
self.ioc = ioc
|
||||||
|
self.detected = detected
|
||||||
|
|
||||||
|
def __repr__(self):
|
||||||
|
return f"<Alert level={self.level} message={self.message} event_time={self.event_time} event={self.event}>"
|
||||||
|
|
||||||
|
def __str__(self):
|
||||||
|
return f"{self.level} {self.message} {self.event_time} {self.event}"
|
||||||
|
|
||||||
|
def to_log(self):
|
||||||
|
return f"{self.level} {self.message} {self.event_time} {self.event}"
|
||||||
|
|
||||||
|
def to_json(self):
|
||||||
|
return {
|
||||||
|
"level": self.level,
|
||||||
|
"message": self.message,
|
||||||
|
"event_time": self.event_time,
|
||||||
|
"event": self.event,
|
||||||
|
"ioc": self.ioc,
|
||||||
|
"detected": self.detected,
|
||||||
|
}
|
|
@ -44,28 +44,34 @@ class SMS(IOSExtraction):
|
||||||
def serialize(self, record: dict) -> Union[dict, list]:
|
def serialize(self, record: dict) -> Union[dict, list]:
|
||||||
text = record["text"].replace("\n", "\\n")
|
text = record["text"].replace("\n", "\\n")
|
||||||
sms_data = f"{record['service']}: {record['guid']} \"{text}\" from {record['phone_number']} ({record['account']})"
|
sms_data = f"{record['service']}: {record['guid']} \"{text}\" from {record['phone_number']} ({record['account']})"
|
||||||
return [
|
sms_data = [
|
||||||
{
|
{
|
||||||
"timestamp": record["isodate"],
|
"timestamp": record["isodate"],
|
||||||
"module": self.__class__.__name__,
|
"module": self.__class__.__name__,
|
||||||
"event": "sms_received",
|
"event": "sms_received",
|
||||||
"data": sms_data,
|
"data": sms_data,
|
||||||
},
|
},
|
||||||
{
|
|
||||||
"timestamp": record["isodate_read"],
|
|
||||||
"module": self.__class__.__name__,
|
|
||||||
"event": "sms_read",
|
|
||||||
"data": sms_data,
|
|
||||||
},
|
|
||||||
]
|
]
|
||||||
|
# If the message was read, we add an extra event.
|
||||||
|
if record["isodate_read"]:
|
||||||
|
sms_data.append(
|
||||||
|
{
|
||||||
|
"timestamp": record["isodate_read"],
|
||||||
|
"module": self.__class__.__name__,
|
||||||
|
"event": "sms_read",
|
||||||
|
"data": sms_data,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
return sms_data
|
||||||
|
|
||||||
def check_indicators(self) -> None:
|
def check_indicators(self) -> None:
|
||||||
for message in self.results:
|
for message in self.results:
|
||||||
alert = "ALERT: State-sponsored attackers may be targeting your iPhone"
|
alert = "ALERT: State-sponsored attackers may be targeting your iPhone"
|
||||||
if message.get("text", "").startswith(alert):
|
if message.get("text", "").startswith(alert):
|
||||||
self.log.warning(
|
self.alerts.medium(
|
||||||
"Apple warning about state-sponsored attack received on the %s",
|
f"Apple warning about state-sponsored attack received on the {message['isodate']}",
|
||||||
message["isodate"],
|
event_time=message["isodate"],
|
||||||
|
event=message,
|
||||||
)
|
)
|
||||||
|
|
||||||
if not self.indicators:
|
if not self.indicators:
|
||||||
|
|
|
@ -55,6 +55,10 @@ class SMSAttachments(IOSExtraction):
|
||||||
|
|
||||||
def check_indicators(self) -> None:
|
def check_indicators(self) -> None:
|
||||||
for attachment in self.results:
|
for attachment in self.results:
|
||||||
|
# Check for known malicious filenames.
|
||||||
|
if self.indicators.check_file_path(attachment["filename"]):
|
||||||
|
self.detected.append(attachment)
|
||||||
|
|
||||||
if (
|
if (
|
||||||
attachment["filename"].startswith("/var/tmp/")
|
attachment["filename"].startswith("/var/tmp/")
|
||||||
and attachment["filename"].endswith("-1")
|
and attachment["filename"].endswith("-1")
|
||||||
|
|
|
@ -17,7 +17,7 @@ class TestSMSModule:
|
||||||
m = SMS(target_path=get_ios_backup_folder())
|
m = SMS(target_path=get_ios_backup_folder())
|
||||||
run_module(m)
|
run_module(m)
|
||||||
assert len(m.results) == 1
|
assert len(m.results) == 1
|
||||||
assert len(m.timeline) == 2 # SMS received and read events.
|
assert len(m.timeline) == 1
|
||||||
assert len(m.detected) == 0
|
assert len(m.detected) == 0
|
||||||
|
|
||||||
def test_detection(self, indicator_file):
|
def test_detection(self, indicator_file):
|
||||||
|
|
Loading…
Reference in New Issue
Block a user