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.
- {misp_modules-3.0.10 → misp_modules-3.0.11}/PKG-INFO +3 -1
- {misp_modules-3.0.10 → misp_modules-3.0.11}/README.md +2 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/_malwagon_api.py +337 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/extuno.py +336 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/html_to_markdown.py +42 -9
- misp_modules-3.0.11/misp_modules/modules/expansion/ipgeolocation.py +614 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ismalicious.py +50 -12
- misp_modules-3.0.11/misp_modules/modules/expansion/lamis_network.py +234 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/malwagon.py +105 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/malwagon_submit.py +247 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/otilabs.py +309 -0
- misp_modules-3.0.11/misp_modules/modules/expansion/rulezet_validator.py +185 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/scanmalware.py +33 -2
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/cisco_firesight_manager_ACL_rule_export.py +19 -9
- misp_modules-3.0.11/misp_modules/modules/import_mod/darkmoon_import.py +183 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/openapi.py +14 -1
- {misp_modules-3.0.10 → misp_modules-3.0.11}/pyproject.toml +1 -1
- {misp_modules-3.0.10 → misp_modules-3.0.11}/LICENSE +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/__main__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/LICENSE +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/odtreader.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/ODTReader/win32_unicode_argv.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/parser.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/_vmray/rest_api.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/config.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/parser.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/anyrun_sandbox/submitter.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/LICENSE-2.0.txt +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/cof2misp/cof.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/LICENSE +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/api.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/dnstrails/exception.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/joe_mapping.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/joe_parser.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/lastline_api.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/qintel_helper.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/synonymsToTagNames.json +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/errors.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/parsers.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/rules.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/helpers/wrappers.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/base.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/lib/vt_graph_parser/importers/pymisp_response.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/_utils/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/_utils/utils.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/export_sentinel.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/mattermost.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/nextcloud_talk.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/slack.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/action_mod/testaction.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_assemblyline_api.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/COPYRIGHT +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/LICENSE +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/README.md +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_dnsdb_query/dnsdb_query.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_ransomcoindb/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_ransomcoindb/ransomcoindb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_rstcloud/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_rstcloud/client.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_vulnerability_parser/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/_vulnerability_parser/vulnerability_parser.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/abuseipdb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/alphaMountain.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/anyrun_sandbox_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apifreaks.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apiosintds.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/apivoid.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/assemblyline_query.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/assemblyline_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/backscatter_io.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/btc_scam_check.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/btc_steroids.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/censys_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/circl_passivedns.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/circl_passivessl.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/clamav.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cluster25_expand.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/convert_markdown_to_pdf.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/countrycode.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cpe.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/crowdsec.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/crowdstrike_falcon.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cuckoo_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cve.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cve_advanced.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/cytomic_orion.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/dbl_spamhaus.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/dns.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/docx_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/domaintools.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/email_security_check.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/eql.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/eupi.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/extract_url_components.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/farsight_passivedns.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/flowtriq.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_asn.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_city.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/geoip_country.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/google_safe_browsing.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/google_threat_intelligence.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/greynoise.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hashdd.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hashlookup.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hibp.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/hyasinsight.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/intel471.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/intelmq_eventdb.py.experimental +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ip2locationio.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipasn.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipinfo.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ipqs_fraud_and_risk_scoring.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/iprep.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/jinja_template_rendering.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/joesandbox_query.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/joesandbox_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/lastline_query.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/lastline_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macaddress_io.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macadress_com.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/macvendors.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/malshare_upload.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/malwarebazaar.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mcafee_insights_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mmdb_lookup.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/module.py.skeleton +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/module_misp_standard.py.skeleton +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/mwdb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ocr_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ods_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/odt_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onion_lookup.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onyphe.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/onyphe_full.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/otx.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/passive_ssh.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/passivetotal.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/pdf_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/pptx_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/qintel_qsentry.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/qrcode.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ransomcoindb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ransomlook.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rapid7_attackerkb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rbl.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rdap.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/recordedfuture.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/reversedns.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/reversinglabs_spectra_analyze.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_cs_beacon.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_favicon.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_html.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_ioc.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_noise_control.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_screenshot.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_ssl.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/rst_whois.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/securitytrails.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/shodan.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigma_queries.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigma_syntax_validator.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sigmf_expand.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/socialscan.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/socradar_lookup.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sophoslabs_intelix.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/sourcecache.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/ssh_fingerprint.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/stairwell.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/stix2_pattern_syntax_validator.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatcrowd.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatfox.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/threatminer.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/tls_certificate_check.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/triage_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/trustar_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/tweetfeed.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/urlhaus.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/urlscan.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/validin.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/variotdbs.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal_public.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/virustotal_upload.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vmray_submit.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vmware_nsx.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulndb.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulnerability_lookup.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vulners.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/vysion.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whisper.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whois.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/whoisfreaks.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/wiki.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xforceexchange.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xlsx_enrich.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/xposedornot.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yara_query.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yara_syntax_validator.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/expansion/yeti.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/cef_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/defender_endpoint_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/goamlexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/liteexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/mass_eql_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/nexthinkexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/osqueryexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/pdfexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/testexport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/threatStream_misp_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/threat_connect_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/virustotal_collections.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/vt_graph.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/export_mod/yara_export.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/__init__.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/anyrun_sandbox_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/cof2misp.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/csvimport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/cuckooimport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/email_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/goamlimport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/import_blueprint.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/joe_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/lastline_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/mispjson.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/ocr.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/openiocimport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/socradar_taxii_feed.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/taxii21.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/testimport.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/threatanalyzer_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/url_import.py +0 -0
- {misp_modules-3.0.10 → misp_modules-3.0.11}/misp_modules/modules/import_mod/vmray_import.py +0 -0
- {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.
|
|
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}
|