misp-modules 3.0.10__tar.gz → 3.0.11__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. {misp_modules-3.0.10 → misp_modules-3.0.11}/PKG-INFO +3 -1
  2. {misp_modules-3.0.10 → misp_modules-3.0.11}/README.md +2 -0
  3. misp_modules-3.0.11/misp_modules/modules/expansion/_malwagon_api.py +337 -0
  4. misp_modules-3.0.11/misp_modules/modules/expansion/extuno.py +336 -0
  5. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/html_to_markdown.py +42 -9
  6. misp_modules-3.0.11/misp_modules/modules/expansion/ipgeolocation.py +614 -0
  7. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ismalicious.py +50 -12
  8. misp_modules-3.0.11/misp_modules/modules/expansion/lamis_network.py +234 -0
  9. misp_modules-3.0.11/misp_modules/modules/expansion/malwagon.py +105 -0
  10. misp_modules-3.0.11/misp_modules/modules/expansion/malwagon_submit.py +247 -0
  11. misp_modules-3.0.11/misp_modules/modules/expansion/otilabs.py +309 -0
  12. misp_modules-3.0.11/misp_modules/modules/expansion/rulezet_validator.py +185 -0
  13. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/scanmalware.py +33 -2
  14. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/cisco_firesight_manager_ACL_rule_export.py +19 -9
  15. misp_modules-3.0.11/misp_modules/modules/import_mod/darkmoon_import.py +183 -0
  16. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/openapi.py +14 -1
  17. {misp_modules-3.0.10 → misp_modules-3.0.11}/pyproject.toml +1 -1
  18. {misp_modules-3.0.10 → misp_modules-3.0.11}/LICENSE +0 -0
  19. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/__init__.py +0 -0
  20. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/__main__.py +0 -0
  21. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/LICENSE +0 -0
  22. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/__init__.py +0 -0
  23. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/odtreader.py +0 -0
  24. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/win32_unicode_argv.py +0 -0
  25. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/__init__.py +0 -0
  26. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/__init__.py +0 -0
  27. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/parser.py +0 -0
  28. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/rest_api.py +0 -0
  29. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/__init__.py +0 -0
  30. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/config.py +0 -0
  31. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/parser.py +0 -0
  32. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/submitter.py +0 -0
  33. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/LICENSE-2.0.txt +0 -0
  34. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/__init__.py +0 -0
  35. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/cof.py +0 -0
  36. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/LICENSE +0 -0
  37. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/__init__.py +0 -0
  38. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/api.py +0 -0
  39. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/exception.py +0 -0
  40. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/joe_mapping.py +0 -0
  41. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/joe_parser.py +0 -0
  42. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/lastline_api.py +0 -0
  43. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/qintel_helper.py +0 -0
  44. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/synonymsToTagNames.json +0 -0
  45. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/__init__.py +0 -0
  46. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/errors.py +0 -0
  47. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/__init__.py +0 -0
  48. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/parsers.py +0 -0
  49. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/rules.py +0 -0
  50. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/wrappers.py +0 -0
  51. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/__init__.py +0 -0
  52. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/base.py +0 -0
  53. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/pymisp_response.py +0 -0
  54. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/__init__.py +0 -0
  55. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/__init__.py +0 -0
  56. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/_utils/__init__.py +0 -0
  57. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/_utils/utils.py +0 -0
  58. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/export_sentinel.py +0 -0
  59. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/mattermost.py +0 -0
  60. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/nextcloud_talk.py +0 -0
  61. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/slack.py +0 -0
  62. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/testaction.py +0 -0
  63. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/__init__.py +0 -0
  64. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_assemblyline_api.py +0 -0
  65. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/COPYRIGHT +0 -0
  66. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/LICENSE +0 -0
  67. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/README.md +0 -0
  68. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/__init__.py +0 -0
  69. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/dnsdb_query.py +0 -0
  70. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_ransomcoindb/__init__.py +0 -0
  71. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_ransomcoindb/ransomcoindb.py +0 -0
  72. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_rstcloud/__init__.py +0 -0
  73. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_rstcloud/client.py +0 -0
  74. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_vulnerability_parser/__init__.py +0 -0
  75. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_vulnerability_parser/vulnerability_parser.py +0 -0
  76. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/abuseipdb.py +0 -0
  77. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/alphaMountain.py +0 -0
  78. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/anyrun_sandbox_submit.py +0 -0
  79. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apifreaks.py +0 -0
  80. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apiosintds.py +0 -0
  81. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apivoid.py +0 -0
  82. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/assemblyline_query.py +0 -0
  83. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/assemblyline_submit.py +0 -0
  84. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/backscatter_io.py +0 -0
  85. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/btc_scam_check.py +0 -0
  86. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/btc_steroids.py +0 -0
  87. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/censys_enrich.py +0 -0
  88. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/circl_passivedns.py +0 -0
  89. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/circl_passivessl.py +0 -0
  90. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/clamav.py +0 -0
  91. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cluster25_expand.py +0 -0
  92. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/convert_markdown_to_pdf.py +0 -0
  93. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/countrycode.py +0 -0
  94. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cpe.py +0 -0
  95. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/crowdsec.py +0 -0
  96. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/crowdstrike_falcon.py +0 -0
  97. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cuckoo_submit.py +0 -0
  98. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cve.py +0 -0
  99. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cve_advanced.py +0 -0
  100. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cytomic_orion.py +0 -0
  101. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/dbl_spamhaus.py +0 -0
  102. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/dns.py +0 -0
  103. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/docx_enrich.py +0 -0
  104. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/domaintools.py +0 -0
  105. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/email_security_check.py +0 -0
  106. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/eql.py +0 -0
  107. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/eupi.py +0 -0
  108. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/extract_url_components.py +0 -0
  109. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/farsight_passivedns.py +0 -0
  110. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/flowtriq.py +0 -0
  111. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_asn.py +0 -0
  112. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_city.py +0 -0
  113. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_country.py +0 -0
  114. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/google_safe_browsing.py +0 -0
  115. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/google_threat_intelligence.py +0 -0
  116. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/greynoise.py +0 -0
  117. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hashdd.py +0 -0
  118. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hashlookup.py +0 -0
  119. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hibp.py +0 -0
  120. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hyasinsight.py +0 -0
  121. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/intel471.py +0 -0
  122. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/intelmq_eventdb.py.experimental +0 -0
  123. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ip2locationio.py +0 -0
  124. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipasn.py +0 -0
  125. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipinfo.py +0 -0
  126. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipqs_fraud_and_risk_scoring.py +0 -0
  127. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/iprep.py +0 -0
  128. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/jinja_template_rendering.py +0 -0
  129. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/joesandbox_query.py +0 -0
  130. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/joesandbox_submit.py +0 -0
  131. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/lastline_query.py +0 -0
  132. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/lastline_submit.py +0 -0
  133. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macaddress_io.py +0 -0
  134. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macadress_com.py +0 -0
  135. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macvendors.py +0 -0
  136. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/malshare_upload.py +0 -0
  137. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/malwarebazaar.py +0 -0
  138. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mcafee_insights_enrich.py +0 -0
  139. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mmdb_lookup.py +0 -0
  140. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/module.py.skeleton +0 -0
  141. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/module_misp_standard.py.skeleton +0 -0
  142. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mwdb.py +0 -0
  143. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ocr_enrich.py +0 -0
  144. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ods_enrich.py +0 -0
  145. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/odt_enrich.py +0 -0
  146. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onion_lookup.py +0 -0
  147. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onyphe.py +0 -0
  148. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onyphe_full.py +0 -0
  149. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/otx.py +0 -0
  150. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/passive_ssh.py +0 -0
  151. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/passivetotal.py +0 -0
  152. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/pdf_enrich.py +0 -0
  153. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/pptx_enrich.py +0 -0
  154. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/qintel_qsentry.py +0 -0
  155. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/qrcode.py +0 -0
  156. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ransomcoindb.py +0 -0
  157. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ransomlook.py +0 -0
  158. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rapid7_attackerkb.py +0 -0
  159. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rbl.py +0 -0
  160. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rdap.py +0 -0
  161. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/recordedfuture.py +0 -0
  162. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/reversedns.py +0 -0
  163. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/reversinglabs_spectra_analyze.py +0 -0
  164. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_cs_beacon.py +0 -0
  165. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_favicon.py +0 -0
  166. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_html.py +0 -0
  167. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_ioc.py +0 -0
  168. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_noise_control.py +0 -0
  169. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_screenshot.py +0 -0
  170. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_ssl.py +0 -0
  171. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_whois.py +0 -0
  172. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/securitytrails.py +0 -0
  173. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/shodan.py +0 -0
  174. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigma_queries.py +0 -0
  175. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigma_syntax_validator.py +0 -0
  176. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigmf_expand.py +0 -0
  177. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/socialscan.py +0 -0
  178. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/socradar_lookup.py +0 -0
  179. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sophoslabs_intelix.py +0 -0
  180. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sourcecache.py +0 -0
  181. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ssh_fingerprint.py +0 -0
  182. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/stairwell.py +0 -0
  183. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/stix2_pattern_syntax_validator.py +0 -0
  184. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatcrowd.py +0 -0
  185. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatfox.py +0 -0
  186. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatminer.py +0 -0
  187. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/tls_certificate_check.py +0 -0
  188. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/triage_submit.py +0 -0
  189. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/trustar_enrich.py +0 -0
  190. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/tweetfeed.py +0 -0
  191. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/urlhaus.py +0 -0
  192. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/urlscan.py +0 -0
  193. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/validin.py +0 -0
  194. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/variotdbs.py +0 -0
  195. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal.py +0 -0
  196. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal_public.py +0 -0
  197. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal_upload.py +0 -0
  198. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vmray_submit.py +0 -0
  199. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vmware_nsx.py +0 -0
  200. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulndb.py +0 -0
  201. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulnerability_lookup.py +0 -0
  202. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulners.py +0 -0
  203. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vysion.py +0 -0
  204. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whisper.py +0 -0
  205. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whois.py +0 -0
  206. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whoisfreaks.py +0 -0
  207. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/wiki.py +0 -0
  208. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xforceexchange.py +0 -0
  209. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xlsx_enrich.py +0 -0
  210. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xposedornot.py +0 -0
  211. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yara_query.py +0 -0
  212. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yara_syntax_validator.py +0 -0
  213. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yeti.py +0 -0
  214. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/__init__.py +0 -0
  215. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/cef_export.py +0 -0
  216. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/defender_endpoint_export.py +0 -0
  217. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/goamlexport.py +0 -0
  218. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/liteexport.py +0 -0
  219. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/mass_eql_export.py +0 -0
  220. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/nexthinkexport.py +0 -0
  221. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/osqueryexport.py +0 -0
  222. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/pdfexport.py +0 -0
  223. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/testexport.py +0 -0
  224. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/threatStream_misp_export.py +0 -0
  225. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/threat_connect_export.py +0 -0
  226. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/virustotal_collections.py +0 -0
  227. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/vt_graph.py +0 -0
  228. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/yara_export.py +0 -0
  229. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/__init__.py +0 -0
  230. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/anyrun_sandbox_import.py +0 -0
  231. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/cof2misp.py +0 -0
  232. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/csvimport.py +0 -0
  233. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/cuckooimport.py +0 -0
  234. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/email_import.py +0 -0
  235. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/goamlimport.py +0 -0
  236. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/import_blueprint.py +0 -0
  237. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/joe_import.py +0 -0
  238. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/lastline_import.py +0 -0
  239. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/mispjson.py +0 -0
  240. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/ocr.py +0 -0
  241. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/openiocimport.py +0 -0
  242. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/socradar_taxii_feed.py +0 -0
  243. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/taxii21.py +0 -0
  244. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/testimport.py +0 -0
  245. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/threatanalyzer_import.py +0 -0
  246. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/url_import.py +0 -0
  247. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/vmray_import.py +0 -0
  248. {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/vmray_summary_json_import.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: misp-modules
3
- Version: 3.0.10
3
+ Version: 3.0.11
4
4
  Summary: MISP modules are autonomous modules that can be used for expansion and other services in MISP
5
5
  License-Expression: AGPL-3.0-only
6
6
  License-File: LICENSE
@@ -226,9 +226,11 @@ For further Information see the [license file](https://misp.github.io/misp-modul
226
226
  * [Intel471 Lookup](https://misp.github.io/misp-modules/expansion/#intel471-lookup) - Module to access Intel 471
227
227
  * [IP2Location.io Lookup](https://misp.github.io/misp-modules/expansion/#ip2location.io-lookup) - An expansion module to query IP2Location.io to gather more information on a given IP address.
228
228
  * [IPASN-History Lookup](https://misp.github.io/misp-modules/expansion/#ipasn-history-lookup) - Module to query an IP ASN history service (https://github.com/D4-project/IPASN-History).
229
+ * [IPGeolocation.io Lookup](https://misp.github.io/misp-modules/expansion/#ipgeolocation.io-lookup) - An expansion and hover module to enrich an IP address with geolocation, ASN, company, threat intelligence (threat score, VPN, proxy, Tor, bot and spam signals) and abuse contact information from IPGeolocation.io, either through the API or from local IPGeolocation.io MMDB databases.
229
230
  * [IPInfo.io Lookup](https://misp.github.io/misp-modules/expansion/#ipinfo.io-lookup) - An expansion module to query ipinfo.io to gather more information on a given IP address.
230
231
  * [IPQualityScore Lookup](https://misp.github.io/misp-modules/expansion/#ipqualityscore-lookup) - IPQualityScore MISP Expansion Module for IP reputation, Email Validation, Phone Number Validation, Malicious Domain,Malicious URL Scanner,Malicious File Scanner & Compromised username, Password, Email
231
232
  * [IPRep Lookup](https://misp.github.io/misp-modules/expansion/#iprep-lookup) - Module to query IPRep data for IP addresses.
233
+ * [isMalicious Lookup](https://misp.github.io/misp-modules/expansion/#ismalicious-lookup) - Query isMalicious for IP, domain, hostname, and URL reputation.
232
234
  * [Ninja Template Rendering](https://misp.github.io/misp-modules/expansion/#ninja-template-rendering) - Render the template with the data passed
233
235
  * [Joe Sandbox Import](https://misp.github.io/misp-modules/expansion/#joe-sandbox-import) - Query Joe Sandbox API with a submission url to get the json report and extract its data that is parsed and converted into MISP attributes and objects.
234
236
  * [Joe Sandbox Submit](https://misp.github.io/misp-modules/expansion/#joe-sandbox-submit) - A module to submit files or URLs to Joe Sandbox for an advanced analysis, and return the link of the submission.
@@ -91,9 +91,11 @@ For further Information see the [license file](https://misp.github.io/misp-modul
91
91
  * [Intel471 Lookup](https://misp.github.io/misp-modules/expansion/#intel471-lookup) - Module to access Intel 471
92
92
  * [IP2Location.io Lookup](https://misp.github.io/misp-modules/expansion/#ip2location.io-lookup) - An expansion module to query IP2Location.io to gather more information on a given IP address.
93
93
  * [IPASN-History Lookup](https://misp.github.io/misp-modules/expansion/#ipasn-history-lookup) - Module to query an IP ASN history service (https://github.com/D4-project/IPASN-History).
94
+ * [IPGeolocation.io Lookup](https://misp.github.io/misp-modules/expansion/#ipgeolocation.io-lookup) - An expansion and hover module to enrich an IP address with geolocation, ASN, company, threat intelligence (threat score, VPN, proxy, Tor, bot and spam signals) and abuse contact information from IPGeolocation.io, either through the API or from local IPGeolocation.io MMDB databases.
94
95
  * [IPInfo.io Lookup](https://misp.github.io/misp-modules/expansion/#ipinfo.io-lookup) - An expansion module to query ipinfo.io to gather more information on a given IP address.
95
96
  * [IPQualityScore Lookup](https://misp.github.io/misp-modules/expansion/#ipqualityscore-lookup) - IPQualityScore MISP Expansion Module for IP reputation, Email Validation, Phone Number Validation, Malicious Domain,Malicious URL Scanner,Malicious File Scanner & Compromised username, Password, Email
96
97
  * [IPRep Lookup](https://misp.github.io/misp-modules/expansion/#iprep-lookup) - Module to query IPRep data for IP addresses.
98
+ * [isMalicious Lookup](https://misp.github.io/misp-modules/expansion/#ismalicious-lookup) - Query isMalicious for IP, domain, hostname, and URL reputation.
97
99
  * [Ninja Template Rendering](https://misp.github.io/misp-modules/expansion/#ninja-template-rendering) - Render the template with the data passed
98
100
  * [Joe Sandbox Import](https://misp.github.io/misp-modules/expansion/#joe-sandbox-import) - Query Joe Sandbox API with a submission url to get the json report and extract its data that is parsed and converted into MISP attributes and objects.
99
101
  * [Joe Sandbox Submit](https://misp.github.io/misp-modules/expansion/#joe-sandbox-submit) - A module to submit files or URLs to Joe Sandbox for an advanced analysis, and return the link of the submission.
@@ -0,0 +1,337 @@
1
+ """Shared client and MISP result builder for the Malwagon expansion modules.
2
+
3
+ The leading underscore keeps this file out of module discovery: misp_modules
4
+ only imports files that do not start with "_", so this is a library, not a
5
+ module. Same arrangement as _assemblyline_api.py.
6
+
7
+ Two modules use it: malwagon (free, instant hash lookup) and malwagon_submit
8
+ (detonation, which costs a submit quota). Both end up holding the same scan
9
+ summary, so the parsing and the MISP object building live here once.
10
+ """
11
+
12
+ import re
13
+ from urllib.parse import quote, urlparse
14
+
15
+ import requests
16
+ from pymisp import MISPEvent, MISPObject
17
+
18
+ DEFAULT_API_URL = "https://malwagon.com/api/v1"
19
+
20
+ # Every request carries an explicit timeout. requests has no default one, so a
21
+ # hung endpoint would otherwise hold a MISP enrichment worker open forever.
22
+ DEFAULT_TIMEOUT = 30
23
+
24
+ USER_AGENT = "malwagon-misp/1.0 (+https://github.com/MISP/misp-modules)"
25
+
26
+ # The scan summary is an allowlist on the server side. Mirroring it here means a
27
+ # field added later cannot silently become an attribute nobody reviewed.
28
+ SCAN_SUMMARY_KEYS = (
29
+ "scan_id",
30
+ "status",
31
+ "verdict",
32
+ "score",
33
+ "module",
34
+ "mime",
35
+ "size",
36
+ "tags",
37
+ "submitted_at",
38
+ "finished_at",
39
+ )
40
+
41
+ # Map the vendor verdict onto MISP's own vocabulary rather than passing the
42
+ # string through raw: misp:threat-level is the platform's severity scale and
43
+ # ioc:artifact-state is what the correlation and filtering side reads.
44
+ VERDICT_TAGS = {
45
+ "clean": ('misp:threat-level="no-risk"', 'ioc:artifact-state="not-malicious"'),
46
+ "suspicious": ('misp:threat-level="medium-risk"',),
47
+ "malicious": ('misp:threat-level="high-risk"', 'ioc:artifact-state="malicious"'),
48
+ }
49
+
50
+ SHA256_RE = re.compile(r"^[0-9a-f]{64}$", re.IGNORECASE)
51
+
52
+ # Remote strings become MISP attribute values. Cap them so a hostile or merely
53
+ # broken response cannot push an unbounded blob into an event.
54
+ MAX_VALUE_LENGTH = 512
55
+ MAX_TAGS = 32
56
+
57
+
58
+ class MalwagonError(Exception):
59
+ """An error worth showing to the analyst in the MISP interface.
60
+
61
+ Every message raised here is written by this file. Nothing derived from the
62
+ submitted sample, and nothing derived from the API key, is ever put in one.
63
+ """
64
+
65
+
66
+ def is_sha256(value):
67
+ return bool(SHA256_RE.match(str(value or "").strip()))
68
+
69
+
70
+ def clean_text(value):
71
+ """Flatten one remote value into something safe to put in an attribute."""
72
+ text = str(value).replace("\r", " ").replace("\n", " ").strip()
73
+ if len(text) > MAX_VALUE_LENGTH:
74
+ text = f"{text[:MAX_VALUE_LENGTH]}..."
75
+ return text
76
+
77
+
78
+ def scan_summary(payload):
79
+ """Keep only the documented summary keys, whatever wrapper they arrived in."""
80
+ if not isinstance(payload, dict):
81
+ return {}
82
+ if isinstance(payload.get("scan"), dict):
83
+ payload = payload["scan"]
84
+ return {key: payload[key] for key in SCAN_SUMMARY_KEYS if payload.get(key) is not None}
85
+
86
+
87
+ def scan_summaries(payload):
88
+ """Pull the list of scan summaries out of a hash-lookup response.
89
+
90
+ The lookup answers with scans of one digest. Accepting either a bare list or
91
+ a list under a container key means a wrapper change does not turn a real
92
+ answer into "not found", which is the failure mode that misleads an analyst.
93
+ """
94
+ if isinstance(payload, list):
95
+ candidates = payload
96
+ elif isinstance(payload, dict):
97
+ candidates = None
98
+ for key in ("scans", "results", "data"):
99
+ value = payload.get(key)
100
+ # Every list on this API arrives wrapped with its own accounting,
101
+ # `{"items": [...], "returned": n, "total": n, "truncated": bool}`,
102
+ # so that a truncated answer can never be mistaken for a complete
103
+ # one. Unwrap that before looking for a bare list: reading only the
104
+ # bare form turned a real answer into "not found", which is exactly
105
+ # the failure mode this function exists to avoid.
106
+ if isinstance(value, dict) and isinstance(value.get("items"), list):
107
+ candidates = value["items"]
108
+ break
109
+ if isinstance(value, list):
110
+ candidates = value
111
+ break
112
+ if candidates is None:
113
+ single = scan_summary(payload)
114
+ candidates = [single] if single else []
115
+ else:
116
+ candidates = []
117
+ return [summary for summary in (scan_summary(item) for item in candidates) if summary]
118
+
119
+
120
+ def is_finished(summary):
121
+ """Whether a scan has reached a terminal state.
122
+
123
+ Keyed off the two documented facts - a verdict is absent while a scan is
124
+ unfinished, and finished_at is set when it is done - rather than off a list
125
+ of status strings, which is not part of the published contract.
126
+ """
127
+ return bool(summary.get("verdict") or summary.get("finished_at"))
128
+
129
+
130
+ class MalwagonClient:
131
+ """Minimal Malwagon REST client built on requests."""
132
+
133
+ def __init__(self, api_key, api_url=None, timeout=DEFAULT_TIMEOUT):
134
+ if not api_key:
135
+ raise MalwagonError("A Malwagon API key is required.")
136
+ self.api_key = api_key
137
+ self.api_url = self._validate_url(api_url or DEFAULT_API_URL)
138
+ self.timeout = timeout
139
+
140
+ @staticmethod
141
+ def _validate_url(api_url):
142
+ url = str(api_url).strip().rstrip("/")
143
+ parsed = urlparse(url)
144
+ if parsed.scheme not in ("http", "https") or not parsed.netloc:
145
+ raise MalwagonError("The configured Malwagon API URL is not a valid http(s) URL.")
146
+ return url
147
+
148
+ def _headers(self):
149
+ # Header only. The key never goes in a URL, a query string or a log line.
150
+ return {
151
+ "Authorization": f"Bearer {self.api_key}",
152
+ "Accept": "application/json",
153
+ "User-Agent": USER_AGENT,
154
+ }
155
+
156
+ def _request(self, method, path, **kwargs):
157
+ try:
158
+ response = requests.request(
159
+ method,
160
+ f"{self.api_url}{path}",
161
+ headers=self._headers(),
162
+ timeout=self.timeout,
163
+ # A redirect would re-send the Authorization header to whatever
164
+ # host the response names. Refuse instead of following.
165
+ allow_redirects=False,
166
+ **kwargs,
167
+ )
168
+ except requests.exceptions.RequestException:
169
+ # The exception text can contain the full request URL; the message
170
+ # here is written by us so nothing from the request can leak.
171
+ raise MalwagonError("Could not reach the Malwagon API.")
172
+ return self._handle(response)
173
+
174
+ @staticmethod
175
+ def _handle(response):
176
+ status = response.status_code
177
+ if status in (301, 302, 303, 307, 308):
178
+ raise MalwagonError("The Malwagon API answered with a redirect, which is not followed.")
179
+ if status == 401:
180
+ raise MalwagonError("Malwagon rejected the API key.")
181
+ if status == 403:
182
+ raise MalwagonError("The Malwagon API key does not carry the scope this request needs.")
183
+ if status == 404:
184
+ return None
185
+ if status == 429:
186
+ retry_after = response.headers.get("Retry-After")
187
+ # Report and stop. Retrying in a loop is what turns one throttled
188
+ # user into a throttled tenant.
189
+ if retry_after:
190
+ raise MalwagonError(f"Malwagon rate limit reached, retry after {clean_text(retry_after)} seconds.")
191
+ raise MalwagonError("Malwagon rate limit reached.")
192
+ if status >= 400:
193
+ raise MalwagonError(f"The Malwagon API answered with HTTP {status}.")
194
+ try:
195
+ return response.json()
196
+ except ValueError:
197
+ raise MalwagonError("The Malwagon API answered with a body that is not JSON.")
198
+
199
+ def lookup_hash(self, sha256):
200
+ if not is_sha256(sha256):
201
+ raise MalwagonError("A Malwagon hash lookup needs a SHA256 digest.")
202
+ # Validated against the regex above, so it cannot walk out of the path.
203
+ return scan_summaries(self._request("GET", f"/hashes/{sha256.lower()}"))
204
+
205
+ def scan_status(self, scan_id):
206
+ return scan_summary(self._request("GET", f"/scans/{quote(str(scan_id), safe='')}"))
207
+
208
+ def submit_file(self, filename, content, options=None):
209
+ data = {key: value for key, value in (options or {}).items() if value is not None}
210
+ payload = self._request(
211
+ "POST",
212
+ "/scans/file",
213
+ files={"file": (filename or "sample", content)},
214
+ data=data,
215
+ )
216
+ return scan_summary(payload)
217
+
218
+ def submit_target(self, module, target, options=None):
219
+ body = {"module": module, "target": target}
220
+ body.update({key: value for key, value in (options or {}).items() if value is not None})
221
+ return scan_summary(self._request("POST", "/scans", json=body))
222
+
223
+ def report_url(self, scan_id):
224
+ """Where a human reads the report for this scan.
225
+
226
+ The API endpoint answers 401 without a bearer token, so pointing an
227
+ analyst at it hands them a login wall instead of a report. The public
228
+ permalink resolves anonymously for a scan that was left public, which
229
+ is what a permalink in a MISP object is for. It is only ever attached
230
+ to a scan we know is public; a private one has no page to link to.
231
+ """
232
+ base = self.api_url.split("/api/", 1)[0]
233
+ return f"{base}/s/{quote(str(scan_id), safe='')}"
234
+
235
+
236
+ class MalwagonResults:
237
+ """Builds the misp_standard result payload out of scan summaries."""
238
+
239
+ def __init__(self, client, sha256=None, attribute_uuid=None):
240
+ self.client = client
241
+ self.sha256 = sha256.lower() if sha256 and is_sha256(sha256) else None
242
+ self.attribute_uuid = attribute_uuid
243
+ self.misp_event = MISPEvent()
244
+ self.tagged = False
245
+
246
+ def add_scan(self, summary):
247
+ if not summary:
248
+ return
249
+ file_object, anchor = self._add_file_object(summary)
250
+ report = self._add_report_object(summary)
251
+ if report is None:
252
+ return
253
+ # One verdict tag per enrichment, on the indicator when there is one and
254
+ # on the verdict line otherwise, so the tag is never orphaned.
255
+ if not self.tagged:
256
+ target = anchor if anchor is not None else self._verdict_attribute(report)
257
+ if target is not None and self._tag(target, summary.get("verdict")):
258
+ self.tagged = True
259
+ if file_object is not None:
260
+ report.add_reference(file_object.uuid, "analysed-with")
261
+
262
+ def _add_file_object(self, summary):
263
+ """A file object for the sample, when the scan describes one."""
264
+ if not self.sha256:
265
+ return None, None
266
+ misp_object = MISPObject("file")
267
+ anchor = misp_object.add_attribute("sha256", type="sha256", value=self.sha256)
268
+ if summary.get("mime"):
269
+ misp_object.add_attribute("mimetype", type="mime-type", value=clean_text(summary["mime"]))
270
+ size = summary.get("size")
271
+ if isinstance(size, int) and size >= 0:
272
+ misp_object.add_attribute("size-in-bytes", type="size-in-bytes", value=size)
273
+ if self.attribute_uuid:
274
+ misp_object.add_reference(self.attribute_uuid, "related-to")
275
+ self.misp_event.add_object(misp_object)
276
+ return misp_object, anchor
277
+
278
+ def _add_report_object(self, summary):
279
+ scan_id = summary.get("scan_id")
280
+ if not scan_id:
281
+ return None
282
+ misp_object = MISPObject("sandbox-report")
283
+ # The report is only retrievable with a key, so this is a saas sandbox
284
+ # in the object template's vocabulary, not a web one.
285
+ misp_object.add_attribute("sandbox-type", type="text", value="saas")
286
+ misp_object.add_attribute("saas-sandbox", type="text", value="malwagon")
287
+ misp_object.add_attribute("permalink", type="link", value=self.client.report_url(scan_id))
288
+ score = summary.get("score")
289
+ if isinstance(score, (int, float)):
290
+ misp_object.add_attribute("score", type="text", value=str(score))
291
+ for line in self._result_lines(summary):
292
+ misp_object.add_attribute("results", type="text", value=line, disable_correlation=True)
293
+ if self.attribute_uuid:
294
+ misp_object.add_reference(self.attribute_uuid, "related-to")
295
+ self.misp_event.add_object(misp_object)
296
+ return misp_object
297
+
298
+ @staticmethod
299
+ def _verdict_attribute(report):
300
+ for attribute in report.attributes:
301
+ if attribute.object_relation == "results" and attribute.value.startswith("verdict:"):
302
+ return attribute
303
+ return None
304
+
305
+ @staticmethod
306
+ def _result_lines(summary):
307
+ lines = []
308
+ if summary.get("verdict"):
309
+ # First, so _verdict_attribute finds it and so an analyst reading the
310
+ # object sees the conclusion before the metadata.
311
+ lines.append(f"verdict: {clean_text(summary['verdict'])}")
312
+ for key in ("status", "module", "submitted_at", "finished_at"):
313
+ if summary.get(key):
314
+ lines.append(f"{key}: {clean_text(summary[key])}")
315
+ tags = summary.get("tags")
316
+ if isinstance(tags, list) and tags:
317
+ # Reported as text on purpose. Turning a remote string into a MISP
318
+ # tag would let the service write into the instance's taxonomies.
319
+ joined = ", ".join(clean_text(tag) for tag in tags[:MAX_TAGS])
320
+ lines.append(f"tags: {joined}")
321
+ return lines
322
+
323
+ @staticmethod
324
+ def _tag(attribute, verdict):
325
+ tags = VERDICT_TAGS.get(str(verdict or "").lower())
326
+ if not tags:
327
+ return False
328
+ for tag in tags:
329
+ attribute.add_tag(tag)
330
+ return True
331
+
332
+ def get_results(self, empty_message):
333
+ event = self.misp_event.to_dict()
334
+ results = {key: event[key] for key in ("Attribute", "Object") if event.get(key)}
335
+ if not results:
336
+ return {"error": empty_message}
337
+ return {"results": results}