#!/usr/bin/env python # -*- coding: utf-8 -*- import os from pymisp import MISPEvent try: from bs4 import BeautifulSoup has_bs4 = True except ImportError: has_bs4 = False unknowMapping = {'category': 'Artifacts dropped', 'type': 'other'}, iocMispMapping = { #~ @Link https://wiki.ops.fr/doku.php/manuels:misp:event-guidelines 'CookieHistoryItem/HostName': {'type': 'hostname', 'comment': 'CookieHistory.'}, 'DriverItem/DriverName': {'category': 'Artifacts dropped', 'type': 'other', 'comment': 'DriverName.'}, 'DriverItem/CertificateIssuer' : {'category': 'Artifacts dropped', 'type': 'other', 'comment': 'DriverCertificateIssuer.'}, 'DriverItem/DeviceItem/AttachedDeviceName' : {'category': 'Artifacts dropped','type': 'other', 'comment': 'DriverDeviceName. '}, 'DnsEntryItem/Host': {'type': 'domain'}, 'DnsEntryItem/RecordName' : {'type': 'domain'}, 'Email/To': {'type': 'target-email'}, 'Email/Date': {'type': 'comment', 'comment': 'EmailDate.'}, 'Email/Body': {'type': 'email-subject'}, 'Email/From': {'type': 'email-dst'}, 'Email/Subject': {'type': 'email-subject'}, 'Email/Attachment/Name': {'type': 'email-attachment'}, 'FileItem/Md5sum' : {'type': 'md5'}, 'FileItem/Sha1sum' : {'type': 'sha1'}, 'FileItem/FileName' : {'type': 'filename'}, 'FileItem/FullPath' : {'type': 'filename'}, 'FileItem/FilePath' : {'type': 'filename'}, 'FileItem/Sha256sum' : {'type': 'sha256'}, 'FileItem/DevicePath' : {'type': 'comment', 'comment': 'DevicePath. '}, 'FileItem/SizeInBytes' : {'type': 'size-in-bytes'}, 'FileItem/PEInfo/Type' : {'type': 'comment','comment': 'PE Type. '}, 'FileItem/FileExtension' : {'type': 'comment','comment': 'FileExtension. '}, 'FileItem/FilenameCreated' : {'type': 'filename', 'comment': 'FilenameCreated. '}, 'FileItem/StringList/string' : {'type': 'pattern-in-file', 'comment': 'string list. '}, 'FileItem/PEInfo/PETimeStamp' : {'type': 'pattern-in-file', 'comment': 'PE TimeStamp. '}, 'FileItem/PEInfo/Exports/DllName' : {'type': 'pattern-in-memory', 'comment': 'PE export DllName. '}, 'FileItem/PEInfo/Sections/Section/Name' : {'type': 'pattern-in-memory', 'comment': 'PE SectionName. '}, 'FileItem/PEInfo/DetectedAnomalies/string' : {'type': 'pattern-in-file', 'comment': 'PE DEtected AnomaliesString. '}, 'FileItem/PEInfo/Exports/NumberOfFunctions' : {'type': 'pattern-in-file', 'comment': 'PE Export NumberOfFunctions. '}, 'FileItem/PEInfo/ImportedModules/Module/Name' : {'type': 'pattern-in-file', 'comment': 'PE ImportedModulesName. '}, 'FileItem/PEInfo/DigitalSignature/Description' : {'type': 'comment', 'comment': 'PE DigitalSignatureDescription. '}, 'FileItem/PEInfo/DigitalSignature/SignatureExists' : {'type': 'comment','comment': 'PE SignatureExists. '}, 'FileItem/PEInfo/Exports/ExportedFunctions/string' : {'type': 'comment', 'comment': 'PE ExportedFunctions. '}, 'FileItem/PEInfo/DigitalSignature/CertificateIssuer' : {'type': 'comment', 'comment': 'PE SignatureCertificateIssuer. '}, 'FileItem/PEInfo/DigitalSignature/SignatureVerified' : {'type': 'comment', 'comment': 'PE SignatureVerified. '}, 'FileItem/PEInfo/DigitalSignature/CertificateSubject' : {'type': 'other', 'comment': 'PE CertificateDigitalSignatureSubject. '}, 'FileItem/PEInfo/ResourceInfoList/ResourceInfoItem/Name' : {'type': 'comment', 'comment': 'PE ResourceName. '}, 'FileItem/PEInfo/ResourceInfoList/ResourceInfoItem/Type' : {'type': 'comment', 'comment': 'PE ResourceType. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/Language' : {'type': 'pattern-in-file', 'comment': 'PE LanguageVersion. '}, 'FileItem/PEInfo/ResourceInfoList/ResourceInfoItem/Language' : {'type': 'pattern-in-file', 'comment': 'PE LanguageResource. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/CompanyName' : {'type': 'pattern-in-file','comment': 'PE versionInfo CompanyName. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/FileVersion' : {'type': 'pattern-in-file', 'comment': 'PE Version. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/ProductName' : {'type': 'pattern-in-file', 'comment': 'PE ProductName. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/InternalName' : {'type': 'pattern-in-file', 'comment': 'PE InternalName. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/LegalCopyright' : {'type': 'pattern-in-file', 'comment': 'PE LegalCopyright. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/ProductVersion' : {'type': 'pattern-in-file', 'comment': 'PE ProductVersion. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/FileDescription' : {'type': 'comment', 'comment': 'PE FileDescription .'}, 'FileItem/PEInfo/ImportedModules/Module/ImportedFunctions/string' : {'type': 'pattern-in-file', 'comment': 'PE ImportedModules. '}, 'FileItem/PEInfo/VersionInfoList/VersionInfoItem/OriginalFilename' : {'type': 'pattern-in-file', 'comment': 'OriginalFilename of PE. '}, 'FormHistoryItem/HostName': {'type': 'hostname', 'comment': 'FormHistory. '}, 'Network/URI' : {'type': 'uri'}, 'Network/DNS' : {'type': 'domain'}, 'Network/String' : {'type': 'url'}, 'Network/IPRange' : {'type': 'ip-dst'}, 'Network/UserAgent' : {'type': 'user-agent'}, 'PortItem/localIP' : {'type': 'ip-src'}, 'PortItem/remoteIP' : {'type': 'ip-dst'}, 'PortItem/remotePort' : {'type': 'pattern-in-traffic', 'comment': 'RemotePort. '}, 'ProcessItem/name' : {'type': 'pattern-in-memory', 'comment': 'ProcessName. '}, 'ProcessItem/path' : {'type': 'pattern-in-memory', 'comment': 'ProcessPath. '}, 'ProcessItem/Mutex' : {'type': 'mutex', 'comment': 'mutex'}, 'ProcessItem/arguments' : {'type': 'pattern-in-memory', 'comment': 'ProcessArguments. '}, 'ProcessItem/NamedPipe' : {'type': 'named pipe'}, 'ProcessItem/Pipe/Name' : {'type': 'named pipe'}, 'ProcessItem/Mutex/Name' : {'type': 'mutex', 'comment': 'MutexName. '}, 'ProcessItem/Event/Name' : {'type': 'pattern-in-memory', 'comment': 'ProcessEventName. '}, 'ProcessItem/StringList/string' : {'type': 'pattern-in-memory', 'comment': 'StringlistName. '}, 'ProcessItem/HandleList/Handle/Name' : {'type': 'pattern-in-memory', 'comment': 'ProcessHandleListName'}, 'ProcessItem/HandleList/Handle/Type' : {'type': 'pattern-in-memory', 'comment': 'ProcessHandleType'}, 'ProcessItem/SectionList/MemorySection/Name' : {'type': 'pattern-in-memory', 'comment': 'ProcessSectionMemoryName'}, 'ProcessItem/SectionList/MemorySection/PEInfo/Exports/DllName' : {'type': 'pattern-in-memory', 'comment': 'ProcessMemoryPEExportsDllName'}, 'ProcessItem/SectionList/MemorySection/PEInfo/Sections/Section/Name' : {'type': 'pattern-in-memory', 'comment': 'Section name from PE in process memory section'}, 'RegistryItem/Text' : {'type': 'regkey', 'comment': 'RegistryText. '}, 'RegistryItem/Path' : {'type': 'regkey', 'comment': 'RegistryPath. '}, 'RegistryItem/Value' : {'type': 'regkey', 'comment': 'RegistryValue. '}, 'RegistryItem/KeyPath' : {'type': 'regkey', 'comment': 'RegistryKeyPath. '}, 'RegistryItem/ValueName' : {'type': 'regkey', 'comment': 'RegistryValueName. '}, 'RouteEntryItem/Destination': {'type': 'ip-dst'}, 'RouteEntryItem/Destination/IP' : {'type': 'ip-dst', 'comment': 'RouteDestination. '}, 'RouteEntryItem/Destination/string' : {'type': 'url', 'comment': 'RouteDestination. '}, 'ServiceItem/name' : {'type': 'windows-service-name'}, 'ServiceItem/type' : {'type': 'pattern-in-memory', 'comment': 'ServiceType. '}, 'ServiceItem/startedAs' : {'type': 'pattern-in-memory', 'comment': 'ServiceStartedAs. '}, 'ServiceItem/serviceDLL' : {'type': 'pattern-in-memory', 'comment': 'ServiceDll. '}, 'ServiceItem/description' : {'type': 'comment', 'comment': 'ServiceDescription. '}, 'ServiceItem/descriptiveName' : {'type': 'windows-service-displayname'}, 'ServiceItem/serviceDLLmd5sum': {'type': 'md5', 'comment': 'ServiceDLL. '}, 'ServiceItem/serviceDLLsha1sum': {'type': 'sha1', 'comment': 'ServiceDLL. '}, 'ServiceItem/serviceDLLsha256sum': {'type': 'sha256', 'comment': 'ServiceDLL. '}, 'ServiceItem/serviceDLLSignatureVerified' : {'type': 'pattern-in-memory', 'comment': 'ServiceDllSignatureVerified. '}, 'Snort/Snort' : {'type': 'snort'}, 'SystemInfoItem/HostName': {'type': 'hostname', 'comment': 'SystemInfo. '}, 'TaskItem/Name' : {'type': 'windows-scheduled-task', 'comment': 'TaskName. '}, 'TaskItem/sha1sum' : {'type': 'windows-scheduled-task', 'comment': 'TashSha1. '}, 'TaskItem/sha256sum' : {'type': 'windows-scheduled-task', 'comment': 'TashSha256. '}, 'TaskItem/AccountName' : {'type': 'windows-scheduled-task', 'comment': 'TaskAccountName'}, 'TaskItem/ActionList/Action/ExecProgramPath' : {'type': 'windows-scheduled-task', 'comment': 'TaskExecProgramPath. '}, 'TaskItem/TriggerList/Trigger/TriggerFrequency' : {'type': 'windows-scheduled-task', 'comment': 'TaskTriggerFrequency. '}, 'UrlHistoryItem/URL' : {'type': 'url','comment': 'UrlHistory. '}, 'UrlHistoryItem/HostName': {'type': 'hostname','comment': 'UrlHistory. '}, 'Yara/Yara' : {'type': 'yara'}, # mapping for composite object # maybe later filename|sizeinbyte 'FileItem/FileName|FileItem/Md5sum' : {'type': 'filename|md5'}, 'FileItem/FileName|FileItem/Sha1sum' : {'type': 'filename|sha1'}, 'FileItem/FileName|FileItem/Sha256sum' : {'type': 'filename|sha256'}, 'Network/DNS|PortItem/remoteIP' : {'type': 'domain|ip'}, 'PortItem/remoteIP|PortItem/remotePort' : {'comment': 'ip-dst|port'}, 'RegistryItem/Path|RegistryItem/Value' : {'type': 'regkey|value'}, 'RegistryItem/KeyPath|RegistryItem/Value' : {'type': 'regkey|value'}, } def extract_field(report, field_name): data = report.find(field_name.lower()) if data and hasattr(data, 'text'): return data.text return None def load_openioc_file(openioc_path): if not os.path.exists(openioc_path): raise Exception("Path doesn't exists.") with open(openioc_path, 'r') as f: return load_openioc(f) def load_openioc(openioc): # Takes a opened file, or a string if not has_bs4: raise Exception('You need to install BeautifulSoup: pip install bs4') misp_event = MISPEvent() iocreport = BeautifulSoup(openioc, "html.parser") # Set event fields info = extract_field(iocreport, 'short_description') if info: misp_event.info = info date = extract_field(iocreport, 'authored_date') if date: misp_event.set_date(date) # Set special attributes description = extract_field(iocreport, 'description') if description: if not misp_event.info: misp_event.info = description else: misp_event.add_attribute('comment', description) if not misp_event.info: misp_event.info = 'OpenIOC import' author = extract_field(iocreport, 'authored_by') if author: misp_event.add_attribute('comment', author) misp_event = set_all_attributes(iocreport, misp_event) return misp_event def get_mapping(openioc_type): t = openioc_type.lower() for k, v in iocMispMapping.items(): if k.lower() == t: return v return False def set_composite_values(value1, value2): attribute_values = {'comment': ''} # construct attribut composite type compositeMapping = value1.find('context')['search']+'|'+value2.find('context')['search'] mapping = get_mapping(compositeMapping) if mapping: attribute_values.update(mapping) else: # prevent some mistake error attribute_values.update({'category': 'External analysis', 'type': 'other'}) # construct attribut composite value compositeValue = value1.find('content').text + "|" +value2.find('content').text if compositeValue: attribute_values['value'] = compositeValue # construct composite comment compositeComment = "" if value1.find('comment'): compositeComment += value1.find('comment').text if value2.find('comment'): compositeComment += value2.find('comment').text attribute_values["comment"] = compositeComment return attribute_values def set_all_attributes(openioc, misp_event): processed = set() hashName = ["FileItem/Md5sum","FileItem/Sha1sum","FileItem/Sha256sum"] # check for composite item for composite in openioc.find_all("indicator", operator="AND"): # check for composite number under childs = composite.find_all('indicatoritem') if len(childs) == 2: childList = [child.find('context')['search'] for child in childs] if ('FileItem/FileName' in childList) and\ (set(hashName) - set(childList) != set(hashName)): if childs[0].find('context')['search'] == 'FileItem/FileName': value1, value2 = childs[0], childs[1] else: value1, value2 = childs[1], childs[0] attribute_values = set_composite_values(value1, value2) misp_event.add_attribute(**attribute_values) processed.add(childs[0]['id']) processed.add(childs[1]['id']) elif ("Network/DNS" and "PortItem/RemoteIP") in childList: if childs[0].find('context')['search'] == 'Network/DNS': value1, value2 = childs[0], childs[1] else: value1, value2 = childs[1], childs[0] attribute_values = set_composite_values(value1, value2) misp_event.add_attribute(**attribute_values) processed.add(childs[0]['id']) processed.add(childs[1]['id']) elif ("PortItem/RemoteIP" and "PortItem/RemotePort") in childList: if childs[0].find('context')['search'] == 'PortItem/RemoteIP': value1, value2 = childs[0], childs[1] else: value1, value2 = childs[1], childs[0] attribute_values = set_composite_values(value1, value2) misp_event.add_attribute(**attribute_values) processed.add(childs[0]['id']) processed.add(childs[1]['id']) elif ("RegistryItem/Path" and "RegistryItem/Value") in childList: if childs[0].find('context')['search'] == 'RegistryItem/PathP': value1, value2 = childs[0], childs[1] else: value1, value2 = childs[1], childs[0] attribute_values = set_composite_values(value1, value2) misp_event.add_attribute(**attribute_values) processed.add(childs[0]['id']) processed.add(childs[1]['id']) for item in openioc.find_all("indicatoritem"): # check if id in processed list if item['id'] in processed: continue attribute_values = {'comment': ''} if item.find('context'): mapping = get_mapping(item.find('context')['search']) if mapping: attribute_values.update(mapping) else: # Unknown mapping, assign to default attribute_values.update({'category': 'External analysis', 'type': 'other'}) #continue else: continue value = extract_field(item, 'Content') if value: attribute_values['value'] = value else: # No value, ignoring continue comment = extract_field(item, 'Comment') if comment: attribute_values["comment"] = '{} {}'.format(attribute_values["comment"], comment) # change value to composite # 127.0.0.1:80 ip-* to 127.0.0.1|80 ip-*|port if mapping['type'] in ['ip-src', 'ip-dst'] and value.count(':') == 1: attribute_values['type'] = mapping['type'] + '|port' attribute_values['value'] = attribute_values['value'].replace(':', '|') misp_event.add_attribute(**attribute_values) return misp_event if __name__ == '__main__': # test file for composite # https://github.com/fireeye/iocs/blob/master/BlogPosts/9cee306d-5441-4cd3-932d-f3119752634c.ioc x = open('test.ioc', 'r') mispEvent = load_openioc(x.read()) print(mispEvent._json_full())