mirror of https://github.com/CIRCL/AIL-framework
112 lines
3.6 KiB
Python
Executable File
112 lines
3.6 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
# -*-coding:UTF-8 -*
|
|
"""
|
|
The Tracker_Yara trackers module
|
|
===================
|
|
|
|
"""
|
|
|
|
##################################
|
|
# Import External packages
|
|
##################################
|
|
import os
|
|
import sys
|
|
import time
|
|
import yara
|
|
|
|
sys.path.append(os.environ['AIL_BIN'])
|
|
##################################
|
|
# Import Project packages
|
|
##################################
|
|
from modules.abstract_module import AbstractModule
|
|
from lib.objects import ail_objects
|
|
from lib import Tracker
|
|
|
|
from exporter.MailExporter import MailExporterTracker
|
|
from exporter.WebHookExporter import WebHookExporterTracker
|
|
|
|
|
|
class Tracker_Yara(AbstractModule):
|
|
"""
|
|
Tracker_Yara module for AIL framework
|
|
"""
|
|
def __init__(self, queue=True):
|
|
super(Tracker_Yara, self).__init__(queue=queue)
|
|
self.pending_seconds = 5
|
|
|
|
# Load Yara rules
|
|
self.rules = Tracker.get_tracked_yara_rules()
|
|
self.last_refresh = time.time()
|
|
|
|
self.obj = None
|
|
|
|
# Exporter
|
|
self.exporters = {'mail': MailExporterTracker(),
|
|
'webhook': WebHookExporterTracker()}
|
|
|
|
self.redis_logger.info(f"Module: {self.module_name} Launched")
|
|
|
|
def compute(self, obj_id, obj_type='item', subtype=''):
|
|
# refresh YARA list
|
|
if self.last_refresh < Tracker.get_tracker_last_updated_by_type('yara'):
|
|
self.rules = Tracker.get_tracked_yara_rules()
|
|
self.last_refresh = time.time()
|
|
self.redis_logger.debug('Tracked set refreshed')
|
|
print('Tracked set refreshed')
|
|
|
|
self.obj = ail_objects.get_object(obj_type, subtype, obj_id)
|
|
obj_type = self.obj.get_type()
|
|
|
|
# Object Filter
|
|
if obj_type not in self.rules:
|
|
return None
|
|
|
|
content = self.obj.get_content(r_type='bytes')
|
|
|
|
try:
|
|
yara_match = self.rules[obj_type].match(data=content, callback=self.yara_rules_match,
|
|
which_callbacks=yara.CALLBACK_MATCHES, timeout=60)
|
|
if yara_match:
|
|
self.redis_logger.warning(f'tracker yara: new match {self.obj.get_id()}: {yara_match}')
|
|
print(f'{self.obj.get_id()}: {yara_match}')
|
|
except yara.TimeoutError:
|
|
print(f'{self.obj.get_id()}: yara scanning timed out')
|
|
self.redis_logger.info(f'{self.obj.get_id()}: yara scanning timed out')
|
|
|
|
def yara_rules_match(self, data):
|
|
tracker_name = data['namespace']
|
|
obj_id = self.obj.get_id()
|
|
for tracker_uuid in Tracker.get_trackers_by_tracked_obj_type('yara', self.obj.get_type(), tracker_name):
|
|
tracker = Tracker.Tracker(tracker_uuid)
|
|
|
|
# Filter Object
|
|
filters = tracker.get_filters()
|
|
if ail_objects.is_filtered(self.obj, filters):
|
|
continue
|
|
|
|
tracker.add(self.obj.get_type(), self.obj.get_subtype(r_str=True), obj_id)
|
|
|
|
# Tags
|
|
for tag in tracker.get_tags():
|
|
if self.obj.get_type() == 'item':
|
|
msg = f'{tag};{obj_id}'
|
|
self.add_message_to_queue(msg, 'Tags')
|
|
else:
|
|
self.obj.add_tag(tag)
|
|
|
|
# Mails
|
|
if tracker.mail_export():
|
|
# TODO add matches + custom subjects
|
|
self.exporters['mail'].export(tracker, self.obj)
|
|
|
|
# Webhook
|
|
if tracker.webhook_export():
|
|
self.exporters['webhook'].export(tracker, self.obj)
|
|
|
|
return yara.CALLBACK_CONTINUE
|
|
|
|
|
|
if __name__ == '__main__':
|
|
module = Tracker_Yara()
|
|
module.run()
|