diff --git a/pymisp/tools/openioc.py b/pymisp/tools/openioc.py old mode 100644 new mode 100755 index ef04d1f..76ee0c5 --- a/pymisp/tools/openioc.py +++ b/pymisp/tools/openioc.py @@ -1,4 +1,4 @@ -#!/usr/bin/env python +#!/usr/bin/env python3 # -*- coding: utf-8 -*- import os @@ -10,67 +10,136 @@ try: except ImportError: has_bs4 = False - 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/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/Sha256sum': {'type': 'sha256'}, + '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. '}, - 'ServiceItem/serviceDLLmd5sum': {'type': 'md5', 'category': 'Payload installation'}, - 'ServiceItem/serviceDLLsha1sum': {'type': 'sha1', 'category': 'Payload installation'}, - 'ServiceItem/serviceDLLsha256sum': {'type': 'sha256', 'category': 'Payload installation'}, + 'FormHistoryItem/HostName': {'type': 'hostname', 'comment': 'FormHistory. '}, - 'TaskItem/md5sum': {'type': 'md5'}, - 'TaskItem/sha1sum': {'type': 'sha1'}, - 'TaskItem/Sha256sum': {'type': 'sha256'}, + 'Network/URI' : {'type': 'uri'}, + 'Network/DNS' : {'type': 'domain'}, + 'Network/String' : {'type': 'url'}, + 'Network/IPRange' : {'type': 'ip-dst'}, + 'Network/UserAgent' : {'type': 'user-agent'}, - 'FileItem/FileName': {'type': 'filename'}, - 'FileItem/FullPath': {'type': 'filename'}, - 'FileItem/FilePath': {'type': 'filename'}, - 'DriverItem/DriverName': {'type': 'filename'}, + 'PortItem/localIP' : {'type': 'ip-src'}, + 'PortItem/remoteIP' : {'type': 'ip-dst'}, + 'PortItem/remotePort' : {'type': 'pattern-in-traffic', 'comment': 'RemotePort. '}, - 'Network/URI': {'type': 'uri'}, - 'Network/DNS': {'type': 'domain'}, - 'Network/String': {'type': 'ip-dst'}, + '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'}, - 'Network/UserAgent': {'type': 'user-agent'}, + 'RouteEntryItem/Destination/IP' : {'type': 'ip-dst', 'comment': 'RouteDestination. '}, + 'RouteEntryItem/Destination/string' : {'type': 'url', 'comment': 'RouteDestination. '}, - 'PortItem/localIP': {'type': 'ip-src'}, - 'PortItem/remoteIP': {'type': 'ip-dst'}, - 'ProcessItem/name': {'type': 'pattern-in-memory', 'comment': 'ProcessName.'}, - 'ProcessItem/path': {'type': 'pattern-in-memory', 'comment': 'ProcessPath.'}, - 'ProcessItem/Mutex': {'type': 'mutex'}, - 'ProcessItem/Pipe/Name': {'type': 'named pipe'}, - 'ProcessItem/Mutex/Name': {'type': 'mutex', 'comment': 'MutexName.'}, + '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. '}, - 'CookieHistoryItem/HostName': {'type': 'hostname'}, - 'FormHistoryItem/HostName': {'type': 'hostname'}, - 'SystemInfoItem/HostName': {'type': 'hostname'}, - 'UrlHistoryItem/HostName': {'type': 'hostname'}, - 'DnsEntryItem/RecordName': {'type': 'hostname'}, - 'DnsEntryItem/Host': {'type': 'hostname'}, + 'Snort/Snort' : {'type': 'snort'}, - # Is it the regkey value? - # 'RegistryItem/Text': {'type': 'regkey', 'RegistryText. '}, - 'RegistryItem/KeyPath': {'type': 'regkey'}, - 'RegistryItem/Path': {'type': 'regkey'}, + 'SystemInfoItem/HostName': {'type': 'hostname', 'comment': 'SystemInfo. '}, - 'ServiceItem/name': {'type': 'windows-service-name'}, - 'ServiceItem/type': {'type': 'pattern-in-memory', 'comment': 'ServiceType. '}, + '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. '}, - 'Snort/Snort': {'type': 'snort'}, + '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'}, } @@ -124,18 +193,107 @@ def get_mapping(openioc_type): 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, ignoring - # print(item.find('context')) - continue + # Unknown mapping, assign to default + attribute_values.update({'category': 'External analysis', 'type': 'other'}) + #continue else: continue value = extract_field(item, 'Content') @@ -148,8 +306,22 @@ def set_all_attributes(openioc, misp_event): 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()) + from pymisp import PyMISP + misp = PyMISP('http://misp.local', 'xxxxx') + r = misp.add_event(mispEvent) + print(r)