MISP Modules

Extend your intelligence with MISP modules

Explore the integrations in misp-modules: enrich indicators, bring in new data, export intelligence, and connect your workflows. Search by service, module name, input type, or requirement.

This catalogue includes the modules in the upstream source. Availability in your instance depends on installed dependencies, service credentials, and configuration. Logos come from the upstream project; modules without a logo use initials.

186 modules

Expansion

Abuse IPDB

abuseipdb

AbuseIPDB MISP expansion module

Module details

Module Type: expansion hover
Input: ip-src ip-dst hostname domain domain|ip
Author: Stephanie S
Version: 0.1

Expansion

AlienVault OTX Lookup

otx

Module to get information from AlienVault OTX.

Module details

Module Type: expansion
Input: A MISP attribute included in the following list: - hostname - domain - ip-src - ip-dst - md5 - sha1 - sha256 - sha512
Output: MISP attributes mapped from the result of the query on OTX, included in the following list: - domain - ip-src - ip-dst - text - md5 - sha1 - sha256 - sha512 - email
Requirements: An access to the OTX API (apikey)
Features: This module takes a MISP attribute as input to query the OTX Alienvault API. The API returns then the result of the query with some types we map into compatible types we add as MISP attributes.
References: https://www.alienvault.com/open-threat-exchange
Author: chrisdoman
Version: 1

Expansion

alphaMountain_risk

alphaMountain

alphaMountain threat intelligence lookup for IPs, domains, hostnames, and URLs - adds risk score tags

Module details

Module Type: expansion hover
Input: ip ip-src ip-dst ip-src|port ip-dst|port domain hostname url uri link
Output: text comment
Author: alphaMountain
Version: 1.0

Import

ANYRUN Sandbox Import

anyrun_sandbox_import

A module designed to retrieve an analysis report from the ANY.RUN Sandbox by its unique ID and extract results (such as verdict, malware tags, and IOCs), converting them into MISP attributes within your event.

Module details

Module Type: import
Input: ANY.RUN Sandbox analysis UUID.
Output: Analysis external references, verdict, IOCs (hashes, IPs, URLs), malware tags, MITRE ATT&CK Techniques
Requirements: anyrun-sdk: ANY.RUN API python3 library ANY.RUN Sandbox API-KEY
Features: Fetches detailed JSON reports using the ANY.RUN API; parses key elements like verdict, extracted IOCs (hashes, IPs, URLs), malware tags; maps data to MISP attributes and galaxies (e.g., malware family or MITRE ATT&CK Techniques).
References: https://any.run
Author: ANY.RUN integrations team
Version: 0.1

Expansion

ANYRUN Sandbox Submit

anyrun_sandbox_submit

A module designed to submit URLs or files to the ANY.RUN Sandbox for analysis and return the unique analysis link and ID.

Module details

Module Type: expansion
Input: Attachment, malware-sample or url to submit to ANY.RUN Sandbox.
Output: ANY.RUN Sandbox analysis URL and UUID.
Requirements: anyrun-sdk: ANY.RUN API python3 library ANY.RUN Sandbox API-KEY
Features: Supports submission of URLs and files via the ANY.RUN API; requires an API key for authentication; returns the task ID and permanent URL for tracking analysis progress; integrates seamlessly with MISP events by enriching attributes with submission results.
References: https://any.run
Author: ANY.RUN integrations team
Version: 0.1

Expansion

APIFreaks Lookup

apifreaks

An expansion module for https://apifreaks.com/ that provides an enriched analysis of a domain, hostname, IP address, ASN or email address, including WHOIS, DNS, subdomains and domain-availability information.

Module details

Module Type: expansion hover
Input: A domain, hostname, IP address (ip-src/ip-dst), ASN (AS) or email (email-src/email-dst/target-email/whois-registrant-email) attribute.
Output: MISP attributes resulting from the queries on the APIFreaks API, included in the following list: - domain - hostname - ip-src - ip-dst - AS - whois-registrant-email - whois-registrant-phone - whois-registrant-name - whois-registrar - whois-creation-date - dns-soa-email - email-src - datetime - text
Requirements: An access to the APIFreaks API (apikey)
Features: The module takes a domain, hostname, IP address, ASN or email attribute as input and queries the relevant APIFreaks WHOIS, Domain and DNS endpoints with it. The results of the queries are then parsed to extract as much information as possible and mapped into compatible MISP attributes.
References: https://apifreaks.com/ https://apifreaks.com/api
Author: APIFreaks
Version: 1.0

Expansion

APIVoid

apivoid

Module to query APIVoid with some domain attributes.

Module details

Module Type: expansion hover
Input: A domain attribute.
Output: DNS records and SSL certificates related to the domain.
Requirements: A valid APIVoid API key with enough credits to proceed 2 queries
Features: This module takes a domain name and queries API Void to get the related DNS records and the SSL certificates. It returns then those pieces of data as MISP objects that can be added to the event. To make it work, a valid API key and enough credits to proceed 2 queries (0.06 + 0.07 credits) are required.
References: https://www.apivoid.com/
Author: Christian Studer
Version: 0.2

Expansion

AssemblyLine Query

assemblyline_query

A module tu query the AssemblyLine API with a submission ID to get the submission report and parse it.

Module details

Module Type: expansion
Input: Link of an AssemblyLine submission report.
Output: MISP attributes & objects parsed from the AssemblyLine submission.
Features: The module requires the address of the AssemblyLine server you want to query as well as your credentials used for this instance. Credentials include the used-ID and an API key or the password associated to the user-ID. The submission ID extracted from the submission link is then used to query AssemblyLine and get the full submission report. This report is parsed to extract file objects and the associated IPs, domains or URLs the files are connecting to. Some more data may be parsed in the future.
References: https://www.cyber.gc.ca/en/assemblyline
Author: Christian Studer
Version: 1

Expansion

AssemblyLine Submit

assemblyline_submit

A module to submit samples and URLs to AssemblyLine for advanced analysis, and return the link of the submission.

Module details

Module Type: expansion
Input: Sample, or url to submit to AssemblyLine.
Output: Link of the report generated in AssemblyLine.
Features: The module requires the address of the AssemblyLine server you want to query as well as your credentials used for this instance. Credentials include the user-ID and an API key or the password associated to the user-ID. If the sample or url is correctly submitted, you get then the link of the submission.
References: https://www.cyber.gc.ca/en/assemblyline
Author: Christian Studer
Version: 1

Expansion

Backscatter.io

backscatter_io

Backscatter.io module to bring mass-scanning observations into MISP.

Module details

Module Type: expansion hover
Input: IP addresses.
Output: Text containing a history of the IP addresses especially on scanning based on backscatter.io information .
Requirements: backscatter python library
Features: The module takes a source or destination IP address as input and displays the information known by backscatter.io.
References: https://pypi.org/project/backscatter/
Author: brandon@backscatter.io
Version: 1

Expansion

BTC Scam Check

btc_scam_check

An expansion hover module to query a special dns blacklist to check if a bitcoin address has been abused.

Module details

Module Type: hover
Input: btc address attribute.
Output: Text to indicate if the BTC address has been abused.
Requirements: dnspython3: dns python library
Features: The module queries a dns blacklist directly with the bitcoin address and get a response if the address has been abused.
References: https://btcblack.it/
Author: Christian Studer
Version: 0.1

Expansion

BTC Steroids

btc_steroids

An expansion hover module to get a blockchain balance from a BTC address in MISP.

Module details

Module Type: hover
Input: btc address attribute.
Output: Text to describe the blockchain balance and the transactions related to the btc address in input.
Author: Sascha Rommelfangen
Version: 0.1

Export

CEF Export

cef_export

Module to export a MISP event in CEF format.

Module details

Module Type: export
Input: MISP Event attributes
Output: Common Event Format file
Features: The module takes a MISP event in input, to look every attribute. Each attribute matching with some predefined types is then exported in Common Event Format. Thus, there is no particular feature concerning MISP Events since any event can be exported. However, 4 configuration parameters recognized by CEF format are required and should be provided by users before exporting data: the device vendor, product and version, as well as the default severity of data.
References: https://community.softwaregrp.com/t5/ArcSight-Connectors/ArcSight-Common-Event-Format-CEF-Guide/ta-p/1589306?attachment-id=65537
Author: Hannah Ward
Version: 1

Expansion

Censys Enrich

censys_enrich

An expansion module to enrich attributes in MISP by quering the censys.io API

Module details

Module Type: expansion hover
Input: IP, domain or certificate fingerprint (md5, sha1 or sha256)
Output: MISP objects retrieved from censys, including open ports, ASN, Location of the IP, x509 details
Requirements: API credentials to censys.io
Features: This module takes an IP, hostname or a certificate fingerprint and attempts to enrich it by querying the Censys API.
References: https://www.censys.io
Author: Loïc Fortemps
Version: 0.1

Expansion

CIRCL Hashlookup Lookup

hashlookup

An expansion module to query the CIRCL hashlookup services to find it if a hash is part of a known set such as NSRL.

Module details

Module Type: expansion hover
Input: File hashes (MD5, SHA1)
Output: Object with the filename associated hashes if the hash is part of a known set.
Features: The module takes file hashes as input such as a MD5 or SHA1. It queries the public CIRCL.lu hashlookup service and return all the hits if the hashes are known in an existing dataset. The module can be configured with a custom hashlookup url if required. The module can be used an hover module but also an expansion model to add related MISP objects.
References: https://www.circl.lu/services/hashlookup/
Author: Alexandre Dulaunoy
Version: 2

Expansion

CIRCL Passive DNS

circl_passivedns

Module to access CIRCL Passive DNS.

Module details

Module Type: expansion hover
Input: Hostname, domain, or ip-address attribute.
Requirements: pypdns: Passive DNS python library A CIRCL passive DNS account with username & password
Features: This module takes a hostname, domain or ip-address (ip-src or ip-dst) attribute as input, and queries the CIRCL Passive DNS REST API to get the asssociated passive dns entries and return them as MISP objects. To make it work a username and a password are thus required to authenticate to the CIRCL Passive DNS API.
References: https://www.circl.lu/services/passive-dns/ https://datatracker.ietf.org/doc/draft-dulaunoy-dnsop-passive-dns-cof/
Author: Alexandre Dulaunoy
Version: 0.2

Expansion

CIRCL Passive SSL

circl_passivessl

Modules to access CIRCL Passive SSL.

Module details

Module Type: expansion hover
Input: IP address attribute.
Output: x509 certificate objects seen by the IP address(es).
Requirements: pypssl: Passive SSL python library A CIRCL passive SSL account with username & password
Features: This module takes an ip-address (ip-src or ip-dst) attribute as input, and queries the CIRCL Passive SSL REST API to gather the related certificates and return the corresponding MISP objects. To make it work a username and a password are required to authenticate to the CIRCL Passive SSL API.
References: https://www.circl.lu/services/passive-ssl/
Author: Raphaël Vinot
Version: 0.2

Export

Cisco fireSIGHT blockrule Export

cisco_firesight_manager_ACL_rule_export

Module to export malicious network activity attributes to Cisco fireSIGHT manager block rules.

Module details

Module Type: export
Input: Network activity attributes (IPs, URLs).
Output: Cisco fireSIGHT manager block rules.
Requirements: Firesight manager console credentials
Features: The module goes through the attributes to find all the network activity ones in order to create block rules for the Cisco fireSIGHT manager.
Author: Stanislav Klevtsov
Version: 1

Expansion

ClaamAV

clamav

Submit file to ClamAV

Module details

Module Type: expansion
Input: attachment malware-sample
Author: Jakub Onderka
Version: 0.1

Expansion

Cluster25 Expand

cluster25_expand

Module to query Cluster25 CTI.

Module details

Module Type: expansion hover
Input: An Indicator value of type included in the following list: - domain - email-src - email-dst - filename - md5 - sha1 - sha256 - ip-src - ip-dst - url - vulnerability - btc - xmr ja3-fingerprint-md5
Output: A series of c25 MISP Objects with colletion of attributes mapped from Cluster25 CTI query result.
Requirements: A Cluster25 API access (API id & key)
Features: This module takes a MISP attribute value as input to query the Cluster25CTI API. The result is then mapped into compatible MISP Objects and relative attributes.
References
Author: Milo Volpicelli
Version: 0.1

Expansion

Country Code

countrycode

Module to expand country codes.

Module details

Module Type: hover
Input: Hostname or domain attribute.
Output: Text with the country code the input belongs to.
Features: The module takes a domain or a hostname as input, and returns the country it belongs to. For non country domains, a list of the most common possible extensions is used.
Author: Hannah Ward
Version: 1

Expansion

CPE Lookup

cpe

An expansion module to query the CVE search API with a cpe code to get its related vulnerabilities.

Module details

Module Type: expansion hover
Input: CPE attribute.
Output: The vulnerabilities related to the CPE.
Features: The module takes a cpe attribute as input and queries the CVE search API to get its related vulnerabilities. The list of vulnerabilities is then parsed and returned as vulnerability objects. Users can use their own CVE search API url by defining a value to the custom_API_URL parameter. If no custom API url is given, the default vulnerability.circl.lu api url is used. In order to limit the amount of data returned by CVE serach, users can also the limit parameter. With the limit set, the API returns only the requested number of vulnerabilities, sorted from the highest cvss score to the lowest one.
References: https://vulnerability.circl.lu/api/
Author: Christian Studer
Version: 2

Expansion

CrowdSec CTI

crowdsec

Module to access CrowdSec CTI API.

Module details

Module Type: hover expansion
Input: An IP address.
Output: IP Lookup information from CrowdSec CTI API
Requirements: A CrowdSec CTI API key. Get yours by following https://docs.crowdsec.net/docs/cti_api/getting_started/#getting-an-api-key
Features: This module enables IP lookup from CrowdSec CTI API. It provides information about the IP, such as what kind of attacks it has been participant of as seen by CrowdSec's network. It also includes enrichment by CrowdSec like background noise score, aggressivity over time etc.
References: https://www.crowdsec.net/ https://docs.crowdsec.net/docs/cti_api/getting_started https://app.crowdsec.net/
Author: Shivam Sandbhor <shivam@crowdsec.net>
Version: 2.1

Expansion

CrowdStrike Falcon

crowdstrike_falcon

Module to query CrowdStrike Falcon.

Module details

Module Type: expansion hover
Input: A MISP attribute included in the following list: - domain - email-attachment - email-dst - email-reply-to - email-src - email-subject - filename - hostname - ip-src - ip-dst - md5 - mutex - regkey - sha1 - sha256 - uri - url - user-agent - whois-registrant-email - x509-fingerprint-md5
Output: MISP attributes mapped after the CrowdStrike API has been queried, included in the following list: - hostname - email-src - email-subject - filename - md5 - sha1 - sha256 - ip-dst - ip-dst - mutex - regkey - url - user-agent - x509-fingerprint-md5
Requirements: A CrowdStrike API access (API id & key)
Features: This module takes a MISP attribute as input to query a CrowdStrike Falcon API. The API returns then the result of the query with some types we map into compatible types we add as MISP attributes. Please note that composite attributes composed by at least one of the input types mentionned below (domains, IPs, hostnames) are also supported.
References: https://www.crowdstrike.com/products/crowdstrike-falcon-faq/
Author: Christophe Vandeplas
Version: 0.3

Import

CSV Import

csvimport

Module to import MISP attributes from a csv file.

Module details

Module Type: import
Input: CSV format file.
Output: MISP Event attributes
Requirements: PyMISP
Features: In order to parse data from a csv file, a header is required to let the module know which column is matching with known attribute fields / MISP types. This header either comes from the csv file itself or is part of the configuration of the module and should be filled out in MISP plugin settings, each field separated by COMMAS. Fields that do not match with any type known in MISP or are not MISP attribute fields should be ignored in import, using a space or simply nothing between two separators (example: 'ip-src, , comment, '). If the csv file already contains a header that does not start by a '#', you should tick the checkbox 'has_header' to avoid importing it and have potential issues. You can also redefine the header even if it is already contained in the file, by following the rules for headers explained earlier. One reason why you would redefine a header is for instance when you want to skip some fields, or some fields are not valid types.
References: https://tools.ietf.org/html/rfc4180 https://tools.ietf.org/html/rfc7111
Author: Christian Studer
Version: 0.2

Import

CSV Test Import

testimport

Simple CSV import tool with mapable columns

Module details

Module Type: import
Author: Andras Iklody
Version: 0.2

Import

Cuckoo Sandbox Import

cuckooimport

Module to import Cuckoo JSON.

Module details

Module Type: import
Input: Cuckoo JSON file
Output: MISP Event attributes
Features: Import a Cuckoo archive (zipfile or bzip2 tarball), either downloaded manually or exported from the API (/tasks/report/<task_id>/all).
References: https://cuckoosandbox.org/ https://github.com/cuckoosandbox/cuckoo
Author: Pierre-Jean Grenier
Version: 1.1

Expansion

Cuckoo Submit

cuckoo_submit

Submit files and URLs to Cuckoo Sandbox

Module details

Module Type: expansion hover
Input: A malware-sample or attachment for files. A url or domain for URLs.
Output: A text field containing 'Cuckoo task id: <id>'
Requirements: Access to a Cuckoo Sandbox API and an API key if the API requires it. (api_url and api_key)
Features: The module takes a malware-sample, attachment, url or domain and submits it to Cuckoo Sandbox. The returned task id can be used to retrieve results when the analysis completed.
References: https://cuckoosandbox.org/ https://cuckoo.sh/docs/
Author: Evert Kors
Version: 0.1

Expansion

CVE Advanced Lookup

cve_advanced

An expansion module to query the CIRCL CVE search API for more information about a vulnerability (CVE).

Module details

Module Type: expansion hover
Input: Vulnerability attribute.
Output: Additional information about the vulnerability, such as its cvss score, some references, or the related weaknesses and attack patterns.
Features: The module takes a vulnerability attribute as input and queries the CIRCL CVE search API to gather additional information. The result of the query is then parsed to return additional information about the vulnerability, like its cvss score or some references, as well as the potential related weaknesses and attack patterns. The vulnerability additional data is returned in a vulnerability MISP object, and the related additional information are put into weakness and attack-pattern MISP objects.
References: https://vulnerability.circl.lu https://cve/mitre.org/
Author: Christian Studer
Version: 2

Expansion

CVE Lookup

cve

An expansion hover module to expand information about CVE id.

Module details

Module Type: expansion hover
Input: Vulnerability attribute.
Output: Additional information on the vulnerability, gathered from the Vulnerability Lookup API.
Features: The module takes a vulnerability attribute as input and queries Vulnerability Lookup to get additional information based on the Vulnerability ID.
References: https://cve.circl.lu/ https://cve.mitre.org/
Author: Alexandre Dulaunoy
Version: 2

Expansion

Cytomic Orion Lookup

cytomic_orion

An expansion module to enrich attributes in MISP by quering the Cytomic Orion API

Module details

Module Type: expansion
Input: MD5, hash of the sample / malware to search for.
Output: MISP objects with sightings of the hash in Cytomic Orion. Includes files and machines.
Requirements: Access (license) to Cytomic Orion
Features: This module takes an MD5 hash and searches for occurrences of this hash in the Cytomic Orion database. Returns observed files and machines.
References: https://www.vanimpe.eu/2020/03/10/integrating-misp-and-cytomic-orion/ https://www.cytomicmodel.com/solutions/
Author: Koen Van Impe
Version: 0.3

Import

Darkmoon Import

darkmoon_import

Module to import the JSON findings of the Darkmoon autonomous AI penetration testing platform.

Module details

Module Type: import
Input: Darkmoon JSON findings file
Output: MISP vulnerability and url objects
Requirements: PyMISP
Features: Takes the JSON findings file written by the Darkmoon open source CLI (either a list of findings or an object with a `findings` list) and creates one `vulnerability` object per finding, with the CVE, the CVSS score and vector, the description, the remediation and the evidence that proves it. The endpoint of the finding is added as a `url` object that the vulnerability affects. The severity, the exploitation status (exploited, confirmed or unconfirmed) and the MITRE ATT&CK technique are added as tags.
References: https://github.com/ASCIT31/Dark-Moon
Author: ASC-IT
Version: 0.1

Expansion

DBL Spamhaus Lookup

dbl_spamhaus

Checks Spamhaus DBL for a domain name.

Module details

Module Type: expansion hover
Input: Domain or hostname attribute.
Output: Information about the nature of the input.
Requirements: dnspython3: DNS python3 library
Features: This modules takes a domain or a hostname in input and queries the Domain Block List provided by Spamhaus to determine what kind of domain it is. DBL then returns a response code corresponding to a certain classification of the domain we display. If the queried domain is not in the list, it is also mentionned. Please note that composite MISP attributes containing domain or hostname are supported as well.
References: https://www.spamhaus.org/faq/section/Spamhaus%20DBL
Author: Christian Studer
Version: 0.1

Expansion

DNS Resolver

dns

Simple DNS expansion service to resolve IP address from MISP attributes

Module details

Module Type: expansion hover
Input: Domain or hostname attribute.
Output: IP address resolving the input.
Requirements: dnspython3: DNS python3 library
Features: The module takes a domain of hostname attribute as input, and tries to resolve it. If no error is encountered, the IP address that resolves the domain is returned, otherwise the origin of the error is displayed. The address of the DNS resolver to use is also configurable, but if no configuration is set, we use the Google public DNS address (8.8.8.8). Please note that composite MISP attributes containing domain or hostname are supported as well.
Author: Alexandre Dulaunoy
Version: 0.3

Expansion

DOCX Enrich

docx_enrich

Module to extract freetext from a .docx document.

Module details

Module Type: expansion
Input: Attachment attribute containing a .docx document.
Output: Text and freetext parsed from the document.
Requirements: docx python library
Features: The module reads the text contained in a .docx document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Expansion

DomainTools Lookup

domaintools

DomainTools MISP expansion module.

Module details

Module Type: expansion hover
Input: A MISP attribute included in the following list: - domain - hostname - email-src - email-dst - target-email - whois-registrant-email - whois-registrant-name - whois-registrant-phone - ip-src - ip-dst
Output: MISP attributes mapped after the Domaintools API has been queried, included in the following list: - whois-registrant-email - whois-registrant-phone - whois-registrant-name - whois-registrar - whois-creation-date - text - domain
Requirements: Domaintools python library A Domaintools API access (username & apikey)
Features: This module takes a MISP attribute as input to query the Domaintools API. The API returns then the result of the query with some types we map into compatible types we add as MISP attributes. Please note that composite attributes composed by at least one of the input types mentionned below (domains, IPs, hostnames) are also supported.
References: https://www.domaintools.com/
Author: Raphaël Vinot
Version: 0.1

Import

Email Import

email_import

Email import module for MISP

Module details

Module Type: import
Input: E-mail file
Output: MISP Event attributes
Features: This module can be used to import e-mail text as well as attachments and urls. Configuration parameters are used to unzip attachments, guess zip attachment passwords, extract urls, and remove common subject markers: set each one of them to True or False to process or not the respective corresponding actions.
Author: Seamus Tuohy, Raphaël Vinot
Version: 0.2

Expansion

Email Security Check

email_security_check

Check email security posture (SPF, DKIM, DMARC, MTA-STS) for a domain.

Module details

Module Type: expansion hover
Input: A domain or hostname attribute.
Output: Domain-ip MISP object with email security assessment attributes.
Requirements: dnspython
Features: The module takes a domain or hostname attribute as input and queries DNS for email security records: SPF (TXT), DMARC (_dmarc), DKIM (common selectors), and MTA-STS (_mta-sts). Returns structured MISP attributes with a domain-ip object linking the findings to the queried domain.
References: https://tools.ietf.org/html/rfc7208 https://tools.ietf.org/html/rfc7489
Author: Mihai Saveanu
Version: 0.2

Export

EQL Query Export

mass_eql_export

Export MISP event in Event Query Language

Module details

Module Type: export
Input: MISP Event attributes
Output: Text file containing one or more EQL queries
Features: This module produces EQL queries for all relevant attributes in a MISP event.
References: https://eql.readthedocs.io/en/latest/
Author: 92 COS DOM
Version: 0.1

Expansion

EQL Query Generator

eql

EQL query generation for a MISP attribute.

Module details

Module Type: expansion
Input: A filename or ip attribute.
Output: Attribute containing EQL for a network or file attribute.
Features: This module adds a new attribute to a MISP event containing an EQL query for a network or file attribute.
References: https://eql.readthedocs.io/en/latest/
Author: 92 COS DOM
Version: 0.1

Expansion

EUPI Lookup

eupi

A module to query the Phishing Initiative service (https://phishing-initiative.lu).

Module details

Module Type: expansion hover
Input: A domain, hostname or url MISP attribute.
Output: Text containing information about the input, resulting from the query on Phishing Initiative.
Requirements: pyeupi: eupi python library An access to the Phishing Initiative API (apikey & url)
Features: This module takes a domain, hostname or url MISP attribute as input to query the Phishing Initiative API. The API returns then the result of the query with some information about the value queried. Please note that composite attributes containing domain or hostname are also supported.
References: https://phishing-initiative.eu/?lang=en
Author: Raphaël Vinot
Version: 0.1

Export

Event to PDF Export

pdfexport

Simple export of a MISP event to PDF.

Module details

Module Type: export
Input: MISP Event
Output: MISP Event in a PDF file.
Requirements: PyMISP reportlab
Features: The module takes care of the PDF file building, and work with any MISP Event. Except the requirement of reportlab, used to create the file, there is no special feature concerning the Event. Some parameters can be given through the config dict. 'MISP_base_url_for_dynamic_link' is your MISP URL, to attach an hyperlink to your event on your MISP instance from the PDF. Keep it clear to avoid hyperlinks in the generated pdf. 'MISP_name_for_metadata' is your CERT or MISP instance name. Used as text in the PDF' metadata 'Activate_textual_description' is a boolean (True or void) to activate the textual description/header abstract of an event 'Activate_galaxy_description' is a boolean (True or void) to activate the description of event related galaxies. 'Activate_related_events' is a boolean (True or void) to activate the description of related event. Be aware this might leak information on confidential events linked to the current event ! 'Activate_internationalization_fonts' is a boolean (True or void) to activate Noto fonts instead of default fonts (Helvetica). This allows the support of CJK alphabet. Be sure to have followed the procedure to download Noto fonts (~70Mo) in the right place (/tools/pdf_fonts/Noto_TTF), to allow PyMisp to find and use them during PDF generation. 'Custom_fonts_path' is a text (path or void) to the TTF file of your choice, to create the PDF with it. Be aware the PDF won't support bold/italic/special style anymore with this option
References: https://acrobat.adobe.com/us/en/acrobat/about-adobe-pdf.html
Author: Vincent Falconieri (prev. Raphaël Vinot)
Version: 2

Action

Export to Sentinel or Defender

export_sentinel

Export indicators to Microsoft Sentinel or Microsoft Defender. Requires an existing installation of MISP2Sentinel or MISP2Defender.

Module details

Module Type: action
Author: Koen Van Impe
Version: 0.1

Expansion

Extuno Lookup

extuno

Query Extuno for the reputation of a browser extension, an IDE extension or a package, identified by its store id or its listing URL.

Module details

Module Type: expansion hover
Input: A store listing URL, or a text attribute holding `store:id` (e.g. `chrome:cjpalhd...`).
Output: A text attribute carrying the verdict, and a link to the advisory or store listing.
Requirements: An Extuno API key
Features: The module takes a store listing URL, or a `store:id` pair in a text attribute, and reports what Extuno knows about that artifact: whether it appears in the known-malicious catalog, with the threat type and the advisory it came from, and whether Extuno's own static and sandbox analysis reached a verdict on it. It covers browser extensions (Chrome, Firefox, Edge), IDE extensions (VS Code, JetBrains, Eclipse), Discord client mods and the npm, PyPI, Packagist, Maven, WordPress and Open VSX registries. Browser and IDE extensions are the reason the module exists: they are not covered by OSV or any other public advisory database, so an extension id found on a workstation cannot be checked against one. Only the identifier being looked up leaves the MISP instance. The lookup is read-only and never submits the artifact for analysis.
References: https://extuno.com https://extuno.com/pip-scanner
Author: extuno.com Tolga SEZER
Version: 1.0

Expansion

Farsight DNSDB Lookup

farsight_passivedns

Module to access Farsight DNSDB Passive DNS.

Module details

Module Type: expansion hover
Input: A domain, hostname or IP address MISP attribute.
Output: Passive-dns objects, resulting from the query on the Farsight Passive DNS API.
Requirements: An access to the Farsight Passive DNS API (apikey)
Features: This module takes a domain, hostname or IP address MISP attribute as input to query the Farsight Passive DNS API. The results of rdata and rrset lookups are then returned and parsed into passive-dns objects. An API key is required to submit queries to the API. It is also possible to define a custom server URL, and to set a limit of results to get. This limit is set for each lookup, which means we can have an up to the limit number of passive-dns objects resulting from an rdata query about an IP address, but an up to the limit number of passive-dns objects for each lookup queries about a domain or a hostname (== twice the limit).
References: https://www.farsightsecurity.com/ https://docs.dnsdb.info/dnsdb-api/
Author: Christophe Vandeplas
Version: 0.5

Expansion

Flowtriq DDoS Intelligence

flowtriq

Query Flowtriq for DDoS attack intelligence on IP addresses

Module details

Module Type: expansion hover
Input: An IP address attribute (ip-src or ip-dst).
Output: MISP attributes and objects describing DDoS attack activity associated with the queried IP: attack types, timestamps, severity, peak traffic, related IPs, and threat intel matches.
Requirements: Flowtriq API key and API URL
Features: Queries the Flowtriq IP threat lookup API to check whether an IP has been observed as a DDoS attack source. Returns structured enrichment data including attack families, severity breakdown, peak PPS, ASN, country, risk score, and related attacker IPs.
References: https://flowtriq.com
Author: Flowtriq
Version: 1.0

Expansion

GeoIP ASN Lookup

geoip_asn

Query a local copy of the Maxmind Geolite ASN database (MMDB format)

Module details

Module Type: expansion hover
Input: An IP address MISP attribute.
Output: Text containing information about the AS number of the IP address.
Requirements: A local copy of Maxmind's Geolite database
Features: The module takes an IP address attribute as input and queries a local copy of the Maxmind's Geolite database to get information about the related AS number.
References: https://www.maxmind.com/en/home
Author: GlennHD
Version: 0.1

Expansion

GeoIP City Lookup

geoip_city

An expansion module to query a local copy of Maxmind's Geolite database with an IP address, in order to get information about the city where it is located.

Module details

Module Type: expansion hover
Input: An IP address MISP attribute.
Output: Text containing information about the city where the IP address is located.
Requirements: A local copy of Maxmind's Geolite database
Features: The module takes an IP address attribute as input and queries a local copy of the Maxmind's Geolite database to get information about the city where this IP address is located.
References: https://www.maxmind.com/en/home
Author: GlennHD
Version: 0.1

Expansion

GeoIP Country Lookup

geoip_country

Query a local copy of Maxminds Geolite database, updated for MMDB format

Module details

Module Type: expansion hover
Input: An IP address MISP Attribute.
Output: Text containing information about the location of the IP address.
Requirements: A local copy of Maxmind's Geolite database
Features: This module takes an IP address MISP attribute as input and queries a local copy of the Maxmind's Geolite database to get information about the location of this IP address. Please note that composite attributes domain|ip are also supported.
References: https://www.maxmind.com/en/home
Author: Andreas Muehlemann
Version: 0.2

Expansion

GeoIP Enrichment

mmdb_lookup

A hover and expansion module to enrich an ip with geolocation and ASN information from an mmdb server instance, such as CIRCL's ip.circl.lu.

Module details

Module Type: expansion hover
Input: An IP address attribute (for example ip-src or ip-src|port).
Output: Geolocation and asn objects.
Features: The module takes an IP address related attribute as input. It queries the public CIRCL.lu mmdb-server instance, available at ip.circl.lu, by default. The module can be configured with a custom mmdb server url if required. It is also possible to filter results on 1 db_source by configuring db_source_filter.
References: https://data.public.lu/fr/datasets/geo-open-ip-address-geolocation-per-country-in-mmdb-format/ https://github.com/adulau/mmdb-server
Author: Jeroen Pinoy
Version: 1

Export

GoAML Export

goamlexport

This module is used to export MISP events containing transaction objects into GoAML format.

Module details

Module Type: export
Input: MISP objects (transaction, bank-account, person, legal-entity, geolocation), with references, describing financial transactions and their origin and target.
Output: GoAML format file, describing financial transactions, with their origin and target (bank accounts, persons or entities).
Requirements: PyMISP MISP objects
Features: The module works as long as there is at least one transaction object in the Event. Then in order to have a valid GoAML document, please follow these guidelines: - For each transaction object, use either a bank-account, person, or legal-entity object to describe the origin of the transaction, and again one of them to describe the target of the transaction. - Create an object reference for both origin and target objects of the transaction. - A bank-account object needs a signatory, which is a person object, put as object reference of the bank-account. - A person can have an address, which is a geolocation object, put as object reference of the person. Supported relation types for object references that are recommended for each object are the folowing: - transaction: - 'from', 'from_my_client': Origin of the transaction - at least one of them is required. - 'to', 'to_my_client': Target of the transaction - at least one of them is required. - 'address': Location of the transaction - optional. - bank-account: - 'signatory': Signatory of a bank-account - the reference from bank-account to a signatory is required, but the relation-type is optional at the moment since this reference will always describe a signatory. - 'entity': Entity owning the bank account - optional. - person: - 'address': Address of a person - optional.
References: http://goaml.unodc.org/
Author: Christian Studer
Version: 1

Import

GoAML Import

goamlimport

Module to import MISP objects about financial transactions from GoAML files.

Module details

Module Type: import
Input: GoAML format file, describing financial transactions, with their origin and target (bank accounts, persons or entities).
Output: MISP objects (transaction, bank-account, person, legal-entity, geolocation), with references, describing financial transactions and their origin and target.
Requirements: PyMISP
Features: Unlike the GoAML export module, there is here no special feature to import data from GoAML external files, since the module will import MISP Objects with their References on its own, as it is required for the export module to rebuild a valid GoAML document.
References: http://goaml.unodc.org/
Author: Christian Studer
Version: 1

Expansion

Google Safe Browsing Lookup

google_safe_browsing

Google safe browsing expansion module

Module details

Module Type: expansion hover
Input: url
Author: Stephanie S
Version: 0.1

Expansion

Google Threat Intelligence Lookup

google_threat_intelligence

An expansion module to have the observable's threat score assessed by Google Threat Intelligence.

Module details

Module Type: expansion
Input: A domain, hash (md5, sha1, sha256 or sha512), hostname or IP address attribute.
Output: Text fields containing the threat score, the severity, the verdict and the threat label of the observable inspected.
Requirements: An access to the Google Threat Intelligence API (apikey), with a high request rate limit.
Features: GTI assessment for the given observable, this include information about level of severity, a clear verdict (malicious, suspicious, undetected and benign) and additional information provided by the Mandiant expertise combined with the VirusTotal database. [Output example screeshot](https://github.com/MISP/MISP/assets/4747608/e275db2f-bb1e-4413-8cc0-ec3cb05e0414)
References: https://www.virustotal.com/ https://gtidocs.virustotal.com/reference
Author: Google Threat Intelligence team
Version: 2

Expansion

GreyNoise Lookup

greynoise

Module to query IP and CVE information from GreyNoise

Module details

Module Type: expansion hover
Input: An IP address or CVE ID
Output: IP Lookup information or CVE scanning profile for past 7 days
Requirements: A Greynoise API key. Both Enterprise (Paid) and Community (Free) API keys are supported, however Community API users will only be able to perform IP lookups.
Features: This module supports: 1) Query an IP from GreyNoise to see if it is internet background noise or a common business service 2) Query a CVE from GreyNoise to see the total number of internet scanners looking for the CVE in the last 7 days.
References: https://greynoise.io/ https://docs.greyniose.io/ https://www.greynoise.io/viz/account/
Author: Brad Chiappetta <brad@greynoise.io>
Version: 2.0

Expansion

Hashdd Lookup

hashdd

A hover module to check hashes against hashdd.com including NSLR dataset.

Module details

Module Type: hover
Input: A hash MISP attribute (md5).
Output: Text describing the known level of the hash in the hashdd databases.
Features: This module takes a hash attribute as input to check its known level, using the hashdd API. This information is then displayed.
References: https://hashdd.com/
Author: Alexandre Dulaunoy
Version: 0.2

Expansion

Have I Been Pwned Lookup

hibp

Module to access haveibeenpwned.com API.

Module details

Module Type: hover
Input: An email address
Output: Additional information about the email address.
Features: The module takes an email address as input and queries haveibeenpwned.com API to find additional information about it. This additional information actually tells if any account using the email address has already been compromised in a data breach.
References: https://haveibeenpwned.com/
Author: Corsin Camichel, Aurélien Schwab
Version: 0.2

Expansion

HTML to Markdown

html_to_markdown

Expansion module to fetch the html content from an url and convert it into markdown.

Module details

Module Type: expansion
Input: URL attribute.
Output: Markdown content converted from the HTML fetched from the url.
Requirements: The markdownify python library
Features: The module take an URL as input and the HTML content is fetched from it. This content is then converted into markdown that is returned as text.
Author: Sami Mokaddem
Version: 0.1

Expansion

HYAS Insight Lookup

hyasinsight

HYAS Insight integration to MISP provides direct, high volume access to HYAS Insight data. It enables investigators and analysts to understand and defend against cyber adversaries and their infrastructure.

Module details

Module Type: expansion hover
Input: A MISP attribute of type IP Address(ip-src, ip-dst), Domain(hostname, domain), Email Address(email, email-src, email-dst, target-email, whois-registrant-email), Phone Number(phone-number, whois-registrant-phone), MDS(md5, x509-fingerprint-md5, ja3-fingerprint-md5, hassh-md5, hasshserver-md5), SHA1(sha1, x509-fingerprint-sha1), SHA256(sha256, x509-fingerprint-sha256), SHA512(sha512)
Output: Hyas Insight objects, resulting from the query on the HYAS Insight API.
Requirements: A HYAS Insight API Key.
Features: This Module takes the IP Address, Domain, URL, Email, Phone Number, MD5, SHA1, Sha256, SHA512 MISP Attributes as input to query the HYAS Insight API. The results of the HYAS Insight API are than are then returned and parsed into Hyas Insight Objects. An API key is required to submit queries to the HYAS Insight API.
References: https://www.hyas.com/hyas-insight/
Author: Mike Champ
Version: 0.1

Expansion

IBM X-Force Exchange Lookup

xforceexchange

An expansion module for IBM X-Force Exchange.

Module details

Module Type: expansion hover
Input: A MISP attribute included in the following list: - ip-src - ip-dst - vulnerability - md5 - sha1 - sha256
Output: MISP attributes mapped from the result of the query on X-Force Exchange.
Requirements: An access to the X-Force API (apikey)
Features: This module takes a MISP attribute as input to query the X-Force API. The API returns then additional information known in their threats data, that is mapped into MISP attributes.
References: https://exchange.xforce.ibmcloud.com/
Author: Joerg Stephan (@johest)
Version: 2

Import

Import Blueprint

import_blueprint

Generic blueprint to be copy-pasted to quickly boostrap creation of import module.

Module details

Module Type: import
Output: MISP Format
Author: Sami Mokaddem
Version: 0.1

Expansion

Intel471 Lookup

intel471

Module to access Intel 471

Module details

Module Type: hover expansion
Input: A MISP attribute whose type is included in the following list: - hostname - domain - url - ip-src - ip-dst - email-src - email-dst - target-email - whois-registrant-email - whois-registrant-name - md5 - sha1 - sha256
Output: Freetext
Requirements: The intel471 python library
Features: The module uses the Intel471 python library to query the Intel471 API with the value of the input attribute. The result of the query is then returned as freetext so the Freetext import parses it.
References: https://public.intel471.com/
Author: Raphaël Vinot
Version: 0.1

Expansion

IP2Location.io Lookup

ip2locationio

An expansion module to query IP2Location.io to gather more information on a given IP address.

Module details

Module Type: expansion hover
Input: IP address attribute.
Output: Additional information on the IP address, such as geolocation, proxy and so on. Refer to the Response Format section in https://www.ip2location.io/ip2location-documentation to find out the full format of the data returned.
Requirements: An IP2Location.io token
Features: The module takes an IP address attribute as input and queries the IP2Location.io API. Free plan user will get the basic geolocation informaiton, and different subsription plan will get more information on the IP address. Refer to [pricing page](https://www.ip2location.io/pricing) for more information on data available for each plan. More information on the responses content is available in the [documentation](https://www.ip2location.io/ip2location-documentation).
References: https://www.ip2location.io/ip2location-documentation
Author: IP2Location.io
Version: 1

Expansion

IPASN-History Lookup

ipasn

Module to query an IP ASN history service (https://github.com/D4-project/IPASN-History).

Module details

Module Type: expansion hover
Input: An IP address MISP attribute.
Output: Asn object(s) objects related to the IP address used as input.
Requirements: pyipasnhistory: Python library to access IPASN-history instance
Features: This module takes an IP address attribute as input and queries the CIRCL IPASN service. The result of the query is the latest asn related to the IP address, that is returned as a MISP object.
References: https://github.com/D4-project/IPASN-History
Author: Raphaël Vinot
Version: 0.3

Expansion

IPGeolocation.io Lookup

ipgeolocation

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.

Module details

Module Type: expansion hover
Input: An IP address attribute (ip-src, ip-dst, ip-src|port, ip-dst|port or domain|ip).
Output: geolocation, asn and domain-ip objects, and an ipgeolocation-ip object with the threat score, anonymisation signals, company and abuse contact.
Requirements: An IPGeolocation.io API key, or IPGeolocation.io MMDB databases stored on the misp-modules host
Features: The module takes an IP address attribute as input and answers from one of two sources: - `api_key`: the [IPGeolocation.io API](https://ipgeolocation.io/documentation/ip-location-api.html). Free plans return geolocation and ASN. Paid plans also return the company, threat intelligence (`include=security`), the abuse contact (`include=abuse`) and the hostname; the `include` setting chooses these modules (default `security,abuse,hostname`, `none` for the base lookup only). If the plan does not allow them, the module falls back to the base lookup. Results are cached in memory for `cache_ttl` seconds (default 3600) to save credits on repeated lookups such as hover. - `mmdb_paths`: comma-separated `.mmdb` files or directories of IPGeolocation.io databases: Location, Country, ISP, ASN, Company, Abuse Contact, Security (all versions), Residential Proxy and Hosting, or their combined editions. Names are returned in English. Lookups run locally and nothing is sent to IPGeolocation.io, which suits air-gapped instances and indicators that must not leave the organisation. Several databases are combined; for a field present in more than one, the first file in the list wins. Updated files are picked up automatically within a minute. When `mmdb_paths` is set, the API is never called.
References: https://ipgeolocation.io/documentation/ip-location-api.html https://ipgeolocation.io/ip-security-database.html
Author: IPGeolocation.io
Version: 1

Expansion

IPInfo.io Lookup

ipinfo

An expansion module to query ipinfo.io to gather more information on a given IP address.

Module details

Module Type: expansion hover
Input: IP address attribute.
Output: Additional information on the IP address, like its geolocation, the autonomous system it is included in, and the related domain(s).
Requirements: An ipinfo.io token
Features: The module takes an IP address attribute as input and queries the ipinfo.io API. The geolocation information on the IP address is always returned. Depending on the subscription plan, the API returns different pieces of information then: - With a basic plan (free) you get the AS number and the AS organisation name concatenated in the `org` field. - With a paid subscription, the AS information is returned in the `asn` field with additional AS information, and depending on which plan the user has, you can also get information on the privacy method used to protect the IP address, the related domains, or the point of contact related to the IP address in case of an abuse. More information on the responses content is available in the [documentation](https://ipinfo.io/developers).
References: https://ipinfo.io/developers
Author: Christian Studer
Version: 1

Expansion

IPQualityScore Lookup

ipqs_fraud_and_risk_scoring

IPQualityScore MISP Expansion Module for IP reputation, Email Validation, Phone Number Validation, Malicious Domain,Malicious URL Scanner,Malicious File Scanner & Compromised username, Password, Email

Module details

Module Type: expansion hover
Input: A MISP attribute of type IP Address(ip-src, ip-dst),Domain(hostname, domain), URL(url, uri), Email Address(email, email-src, email-dst, target-email, whois-registrant-email) and Phone Number(phone-number, whois-registrant-phone), Username(first-name, last-name, middle-name, github-username), Password(text).
Output: IPQualityScore object, resulting from the query on the IPQualityScore API.
Requirements: A IPQualityScore API Key.
Features: This Module takes the IP Address, Domain, URL, Email, Phone Number, Username,Password, and MISP Attributes as input to query the IPQualityScore API. The results of the IPQualityScore API are then returned as an IPQS Fraud, Risk,and Exposure Scoring Object. The object contains a copy of the enriched attribute with added tags presenting the verdict based on fraud score, risk score, darkweb exposure status, and other attributes from IPQualityScore. This module also contains IPQS Darkweb Leak, IPQS Malware File Scanner API's IPQS Darkweb Leak - Monitor Dark Web Activity & Compromised User Accounts, IPQS Malware File Scanner - Detect malicious files.
References: https://www.ipqualityscore.com/
Author: David Mackler
Version: 0.1

Expansion

IPRep Lookup

iprep

Module to query IPRep data for IP addresses.

Module details

Module Type: expansion
Input: An IP address MISP attribute.
Output: Text describing additional information about the input after a query on the IPRep API.
Requirements: An access to the packetmail API (apikey)
Features: This module takes an IP address attribute as input and queries the database from packetmail.net to get some information about the reputation of the IP.
References: https://github.com/mahesh557/packetmail
Author: Keith Faber
Version: 1.0

Expansion

isMalicious Lookup

ismalicious

Query isMalicious for IP, domain, hostname, and URL reputation.

Module details

Module Type: expansion hover
Input: An IP address, domain, hostname or URL.
Output: Text attributes with the isMalicious reputation summary.
Requirements: An isMalicious API key (free accounts are available): the X-API-KEY value, Base64 of apiKey:apiSecret, shown under API credentials on the isMalicious account page.
Features: The module takes an IP, domain, hostname or URL attribute (the domain side of a domain|ip) and queries GET /check on the isMalicious API. It returns a text summary with the malicious flag, risk score, categories and source count. Only threat listings are counted: listings that describe what an indicator is (cloud and CDN ranges, Tor exits, DoH resolvers, ad lists, allowlists) are left out of the categories and of the source count. Hover and expansion share the same handler. The queried indicator is sent over TLS; nothing else leaves the MISP instance besides the configured API key.
References: https://ismalicious.com/integrations/misp https://ismalicious.com/api-docs
Author: isMalicious
Version: 1.1

Expansion

Joe Sandbox Import

joesandbox_query

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.

Module details

Module Type: expansion
Input: Link of a Joe Sandbox sample or url submission.
Output: MISP attributes & objects parsed from the analysis report.
Requirements: jbxapi: Joe Sandbox API python3 library
Features: Module using the new format of modules able to return attributes and objects. The module returns the same results as the import module [joe_import](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/import_mod/joe_import.py) taking directly the json report as input. Even if the introspection will allow all kinds of links to call this module, obviously only the ones presenting a sample or url submission in the Joe Sandbox API will return results. To make it work you will need to fill the 'apikey' configuration with your Joe Sandbox API key and provide a valid link as input.
References: https://www.joesecurity.org https://www.joesandbox.com/
Author: Christian Studer
Version: 0.2

Import

Joe Sandbox Import

joe_import

A module to import data from a Joe Sandbox analysis json report.

Module details

Module Type: import
Input: Json report of a Joe Sandbox analysis.
Output: MISP attributes & objects parsed from the analysis report.
Features: Module using the new format of modules able to return attributes and objects. The module returns the same results as the expansion module [joesandbox_query](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/expansion/joesandbox_query.py) using the submission link of the analysis to get the json report.
References: https://www.joesecurity.org https://www.joesandbox.com/
Author: Christian Studer
Version: 0.2

Expansion

Joe Sandbox Submit

joesandbox_submit

A module to submit files or URLs to Joe Sandbox for an advanced analysis, and return the link of the submission.

Module details

Module Type: expansion
Input: Sample, url (or domain) to submit to Joe Sandbox for an advanced analysis.
Output: Link of the report generated in Joe Sandbox.
Requirements: jbxapi: Joe Sandbox API python3 library
Features: The module requires a Joe Sandbox API key to submit files or URL, and returns the link of the submitted analysis. It is then possible, when the analysis is completed, to query the Joe Sandbox API to get the data related to the analysis, using the [joesandbox_query module](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/expansion/joesandbox_query.py) directly on this submission link.
References: https://www.joesecurity.org https://www.joesandbox.com/
Author: Joe Security LLC
Version: 1.0

Expansion

Lamis Network Lookup

lamis_network

Lamis Network IP Intelligence and Risk Scoring expansion module.

Module details

Module Type: expansion hover
Input: IP address attribute (ip-src, ip-dst).
Output: Enriched ASN, geolocation, proxy indicators, and risk score.
Requirements: A Lamis Network API Key
Features: Takes an IP address (ip-src, ip-dst) and queries the Lamis Network API to enrich it with ASN details, infrastructure type (datacenter/hosting), proxy indicators (VPN, Tor, Proxy), and a contextual risk score (0-100).
References: https://lamisnetwork.com/community.html https://docs.lamisnetwork.com
Author: Vito Grecciani
Version: 0.1

Import

Lastline Import

lastline_import

Deprecation notice: this module will be deprecated by December 2021, please use vmware_nsx module. Module to import and parse reports from Lastline analysis links.

Module details

Module Type: import
Input: Link to a Lastline analysis.
Output: MISP attributes and objects parsed from the analysis report.
Features: The module requires a Lastline Portal `username` and `password`. The module uses the new format and it is able to return MISP attributes and objects. The module returns the same results as the [lastline_query](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/expansion/lastline_query.py) expansion module.
References: https://www.lastline.com
Author: Stefano Ortolani
Version: 0.1

Expansion

Lastline Lookup

lastline_query

Deprecation notice: this module will be deprecated by December 2021, please use vmware_nsx module. Query Lastline with an analysis link and parse the report into MISP attributes and objects.

Module details

Module Type: expansion
Input: Link to a Lastline analysis.
Output: MISP attributes and objects parsed from the analysis report.
Features: The module requires a Lastline Portal `username` and `password`. The module uses the new format and it is able to return MISP attributes and objects. The module returns the same results as the [lastline_import](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/import_mod/lastline_import.py) import module.
References: https://www.lastline.com
Author: Stefano Ortolani
Version: 0.1

Expansion

Lastline Submit

lastline_submit

Deprecation notice: this module will be deprecated by December 2021, please use vmware_nsx module. Module to submit a file or URL to Lastline.

Module details

Module Type: expansion hover
Input: File or URL to submit to Lastline.
Output: Link to the report generated by Lastline.
Features: The module requires a Lastline Analysis `api_token` and `key`. When the analysis is completed, it is possible to import the generated report by feeding the analysis link to the [lastline_query](https://github.com/MISP/misp-modules/tree/main/misp_modules/modules/expansion/lastline_query.py) module.
References: https://www.lastline.com
Author: Stefano Ortolani
Version: 0.1

Export

Lite Export

liteexport

Lite export of a MISP event.

Module details

Module Type: export
Input: MISP Event attributes
Output: Lite MISP Event
Features: This module is simply producing a json MISP event format file, but exporting only Attributes from the Event. Thus, MISP Events exported with this module should have attributes that are not internal references, otherwise the resulting event would be empty.
Author: TM
Version: 1

Expansion

Macaddress.io Lookup

macaddress_io

MISP hover module for macaddress.io

Module details

Module Type: hover
Input: MAC address MISP attribute.
Output: Text containing information on the MAC address fetched from a query on macaddress.io.
Requirements: maclookup: macaddress.io python library An access to the macaddress.io API (apikey)
Features: This module takes a MAC address attribute as input and queries macaddress.io for additional information. This information contains data about: - MAC address details - Vendor details - Block details
References: https://macaddress.io/ https://github.com/CodeLineFi/maclookup-python
Author: CodeLine OY - macaddress.io
Version: 1.0

Expansion

macadress.com Lookup

macadress_com

Module to access macadress.com API.

Module details

Module Type: hover
Input: A MAC address.
Output: Additional information about the MAC address.
Requirements: An access to the macadress.com API (apikey)
Features: This module takes a MAC address attribute as input and queries macadress.com for additional information. This information contains data about: - Vendor identity (organization, OUI, matched registry prefix, country) - Device category inference - Virtualization/container-network detection - Special-use address classification (broadcast, multicast, VRRP, HSRP, STP, LACP, 802.1X, LLDP) - Randomization confidence (locally administered / SLAP quadrant signals)
References: https://macadress.com/ https://macadress.com/docs
Author: Samy Massoud
Version: 1.0

Expansion

Macvendors Lookup

macvendors

Module to access Macvendors API.

Module details

Module Type: hover
Input: A MAC address.
Output: Additional information about the MAC address.
Features: The module takes a MAC address as input and queries macvendors.com for some information about it. The API returns the name of the vendor related to the address.
References: https://macvendors.com/ https://macvendors.com/api
Author: Aurélien Schwab
Version: 0.1

Expansion

MalShare Upload

malshare_upload

Module to push malware samples to MalShare

Module details

Module Type: expansion
Input: attachment malware-sample
Output: link
Requirements: requests library
Author: Karen Yousefi
Version: 1

Expansion

Malwagon Lookup

malwagon

Look up a SHA256 digest in the Malwagon sandbox and return the scans it already has for it.

Module details

Module Type: expansion hover
Input: A sha256 or filename|sha256 attribute.
Output: A file object for the sample and one sandbox-report object per Malwagon analysis, with the verdict expressed as MISP taxonomy tags.
Requirements: A Malwagon API key with the read scope.
Features: The module takes a sha256 or filename|sha256 attribute and asks Malwagon which analyses it already holds for that digest. The lookup is free and answers immediately, so it is safe to use on hover: no sample leaves the MISP instance and no detonation quota is spent. Only the digest is sent. Each analysis comes back as a sandbox-report object carrying the verdict, the score and a permalink to the report, referenced from a file object for the sample. The verdict is translated into MISP's own vocabulary - a misp:threat-level tag, plus ioc:artifact-state where the verdict is conclusive - rather than being passed through as a vendor string. To detonate something Malwagon has never seen, use the Malwagon Submit module instead.
References: https://malwagon.com https://malwagon.com/docs/api https://www.misp-project.org/taxonomies.html
Author: Tolga Sezer
Version: 1

Expansion

Malwagon Submit

malwagon_submit

Detonate a sample or a URL in the Malwagon sandbox and return the analysis.

Module details

Module Type: expansion
Input: An attachment, malware-sample or url attribute.
Output: A file object for the sample and a sandbox-report object for the Malwagon analysis, with the verdict expressed as MISP taxonomy tags.
Requirements: A Malwagon API key with the submit scope.
Features: The module takes an attachment, malware-sample or url attribute and detonates it in the Malwagon sandbox. A malware-sample arrives zip-encrypted with the password infected and is unpacked before submission. A file is looked up by its SHA256 first. If Malwagon has already analysed that digest the existing analysis is returned, which is free, instant, and spends no detonation quota; set always_submit to force a fresh detonation instead. The module then polls the scan until it finishes or until poll_timeout seconds have passed, and returns what it has either way, so a long detonation gives back a permalink rather than an error. This module submits the sample itself to a third party, so it is deliberately expansion-only and never runs on hover. Submission is blocked when the attribute carries a TLP tag more restrictive than max_tlp, and scans are created private unless private is set to false. The sandbox image is chosen by the platform from the sample; on the free and community tiers the analysis virtual machine has no internet access at all, which is structural rather than a quota, so network-dependent samples will look inert there.
References: https://malwagon.com https://malwagon.com/docs/api https://www.misp-project.org/taxonomies.html
Author: Tolga Sezer
Version: 1

Expansion

Malware Bazaar Lookup

malwarebazaar

Query Malware Bazaar to get additional information about the input hash.

Module details

Module Type: expansion hover
Input: A hash attribute (md5, sha1 or sha256).
Output: File object(s) related to the input attribute found on MALWAREbazaar databases.
Features: The module takes a hash attribute as input and queries MALWAREbazaar's API to fetch additional data about it. The result, if the payload is known on the databases, is at least one file object describing the file the input hash is related to. The module is using the new format of modules able to return object since the result is one or multiple MISP object(s).
References: https://bazaar.abuse.ch/
Author: Christian Studer
Version: 0.1

Expansion

Markdown to PDF converter

convert_markdown_to_pdf

Render the markdown (under GFM) into PDF. Requires pandoc (https://pandoc.org/), wkhtmltopdf (https://wkhtmltopdf.org/) and mermaid dependencies.

Module details

Module Type: expansion
Input: text
Output: text
Requirements: pandoc
References: 1. Install pandoc for your distribution 2. Install wkhtmltopdf - Ensure You have install the version with patched qt - Ensure it supports margin options - You can check the above by inspecting the extended help `wkhtmltopdf --extended-help` 3. Install mermaid - `npm install --global @mermaid-js/mermaid-cli` 4. Install the pandoc-mermaid-filter from https://github.com/DavidCruciani/pandoc-mermaid-filter - Easiest is to install the following: ```bash pip3 install git+https://github.com/DavidCruciani/pandoc-mermaid-filter ```
Author: Sami Mokaddem
Version: 0.3

Action

Mattermost

mattermost

Simplistic module to send message to a Mattermost channel.

Module details

Module Type: action
Author: Sami Mokaddem
Version: 0.1

Expansion

McAfee MVISION Insights Lookup

mcafee_insights_enrich

Lookup McAfee MVISION Insights Details

Module details

Module Type: hover
Input: md5 sha1 sha256
Author: Martin Ohl
Version: 1

Export

Microsoft Defender for Endpoint KQL Export

defender_endpoint_export

Defender for Endpoint KQL hunting query export module

Module details

Module Type: export
Input: MISP Event attributes
Output: Defender for Endpoint KQL queries
Features: This module export an event as Defender for Endpoint KQL queries that can then be used in your own python3 or Powershell tool. If you are using Microsoft Sentinel, you can directly connect your MISP instance to Sentinel and then create queries using the `ThreatIntelligenceIndicator` table to match events against imported IOC.
References: https://docs.microsoft.com/en-us/windows/security/threat-protection/microsoft-defender-atp/advanced-hunting-schema-reference
Author: Julien Bachmann, Hacknowledge, Maik Wuerth
Version: 1.1

Import

MISP JSON Import

mispjson

Module to import MISP JSON format for merging MISP events.

Module details

Module Type: import
Input: MISP Event
Output: MISP Event attributes
Features: The module simply imports MISP Attributes from an other MISP Event in order to merge events together. There is thus no special feature to make it work.
Author: Richard van den Berg
Version: 0.1

Expansion

MWDB Submit

mwdb

Module to push malware samples to a MWDB instance

Module details

Module Type: expansion
Input: Attachment or malware sample
Output: Link attribute that points to the sample at the MWDB instane
Requirements: * mwdblib installed (pip install mwdblib) ; * (optional) keys.py file to add tags of events/attributes to MWDB * (optional) MWDB attribute created for the link back to MISP (defined in mwdb_misp_attribute)
Features: An expansion module to push malware samples to a MWDB (https://github.com/CERT-Polska/mwdb-core) instance. This module does not push samples to a sandbox. This can be achieved via Karton (connected to the MWDB). Does: * Upload of attachment or malware sample to MWDB * Tags of events and/or attributes are added to MWDB. * Comment of the MISP attribute is added to MWDB. * A link back to the MISP event is added to MWDB via the MWDB attribute. * A link to the MWDB attribute is added as an enrichted attribute to the MISP event.
Author: Koen Van Impe
Version: 1

Action

Nextcloud talk

nextcloud_talk

Simplistic module to send a message to a Nextcloud talk conversation.

Module details

Module Type: action
Author: Jeroen Pinoy
Version: 0.1

Export

Nexthink NXQL Export

nexthinkexport

Nexthink NXQL query export module

Module details

Module Type: export
Input: MISP Event attributes
Output: Nexthink NXQL queries
Features: This module export an event as Nexthink NXQL queries that can then be used in your own python3 tool or from wget/powershell
References: https://doc.nexthink.com/Documentation/Nexthink/latest/APIAndIntegrations/IntroducingtheWebAPIV2
Author: Julien Bachmann, Hacknowledge
Version: 1.0

Expansion

Ninja Template Rendering

jinja_template_rendering

Render the template with the data passed

Module details

Module Type: expansion
Input: text
Output: text
Author: Sami Mokaddem
Version: 0.1

Expansion

OCR Enrich

ocr_enrich

Module to process some optical character recognition on pictures.

Module details

Module Type: expansion
Input: A picture attachment.
Output: Text and freetext fetched from the input picture.
Requirements: cv2: The OpenCV python library.
Features: The module takes an attachment attributes as input and process some optical character recognition on it. The text found is then passed to the Freetext importer to extract potential IoCs.
Author: Sascha Rommelfangen
Version: 0.2

Import

OCR Import

ocr

Optical Character Recognition (OCR) module for MISP.

Module details

Module Type: import
Input: Image
Output: freetext MISP attribute
Features: The module tries to recognize some text from an image and import the result as a freetext attribute, there is then no special feature asked to users to make it work.
Author: Alexandre Dulaunoy
Version: 0.2

Expansion

ODS Enrich

ods_enrich

Module to extract freetext from a .ods document.

Module details

Module Type: expansion
Input: Attachment attribute containing a .ods document.
Output: Text and freetext parsed from the document.
Requirements: ezodf: Python package to create/manipulate OpenDocumentFormat files. pandas_ods_reader: Python library to read in ODS files.
Features: The module reads the text contained in a .ods document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Expansion

ODT Enrich

odt_enrich

Module to extract freetext from a .odt document.

Module details

Module Type: expansion
Input: Attachment attribute containing a .odt document.
Output: Text and freetext parsed from the document.
Requirements: ODT reader python library.
Features: The module reads the text contained in a .odt document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Expansion

Onion Lookup

onion_lookup

MISP module using the MISP standard. Uses the onion-lookup service to get information about an onion.

Module details

Module Type: expansion hover
Input: onion-address
References: https://onion.ail-project.org/
Author: Sami Mokaddem
Version: 1

Expansion

Onyphe Full Lookup

onyphe_full

Module to process a full query on Onyphe.

Module details

Module Type: expansion hover
Input: A domain, hostname or IP address MISP attribute.
Output: MISP attributes and objects fetched from the Onyphe queries.
Requirements: pyonyphe python library, version 3.0.3 or later An access to the Onyphe API (apikey)
Features: This module takes a domain, hostname, or IP address attribute as input and runs one ONYPHE Query Language search per category (datascan, vulnscan, resolver, ctl, pastries, threatlist). The parsing is here more advanced than the one of the onyphe module, and returns more attributes, since more categories and more fields of the query results are watched and parsed. Categories the API key is not entitled to are skipped rather than failing the whole query, and are listed in a comment attribute so the analyst knows the event is partial.
References: https://www.onyphe.io/ https://github.com/onyphe/pyonyphe
Author: Sebastien Larinier @sebdraven
Version: 2

Expansion

Onyphe Lookup

onyphe

Module to process a query on Onyphe.

Module details

Module Type: expansion hover
Input: A domain, hostname or IP address MISP attribute.
Output: MISP attributes fetched from the Onyphe query.
Requirements: pyonyphe python library, version 3.0.3 or later An access to the Onyphe API (apikey)
Features: This module takes a domain, hostname, or IP address attribute as input in order to query the Onyphe Summary API. Data fetched from the query is then parsed and MISP attributes and objects are extracted.
References: https://www.onyphe.io/ https://github.com/onyphe/pyonyphe
Author: Sebastien Larinier @sebdraven
Version: 3

Import

OpenIOC Import

openiocimport

Module to import OpenIOC packages.

Module details

Module Type: import
Input: OpenIOC packages
Output: MISP Event attributes
Requirements: PyMISP
Features: The module imports MISP Attributes from OpenIOC packages, there is then no special feature for users to make it work.
References: https://www.fireeye.com/blog/threat-research/2013/10/openioc-basics.html
Author: Raphaël Vinot
Version: 0.1

Expansion

OSINT DigitalSide

apiosintds

On demand query API for OSINT.digitalside.it project.

Module details

Module Type: expansion hover
Input: A domain, ip, url or hash attribute.
Output: Hashes and urls resulting from the query to OSINT.digitalside.it
Requirements: The apiosintDS python library to query the OSINT.digitalside.it API.
Features: The module simply queries the API of OSINT.digitalside.it with a domain, ip, url or hash attribute. The result of the query is then parsed to extract additional hashes or urls. A module parameters also allows to parse the hashes related to the urls. Furthermore, it is possible to cache the urls and hashes collected over the last 7 days by OSINT.digitalside.it
References: https://osint.digitalside.it/#About
Author: Davide Baglieri aka davidonzo
Version: 0.2

Export

OSQuery Export

osqueryexport

OSQuery export of a MISP event.

Module details

Module Type: export
Input: MISP Event attributes
Output: osquery SQL queries
Features: This module export an event as osquery queries that can be used in packs or in fleet management solution like Kolide.
Author: Julien Bachmann, Hacknowledge
Version: 1.1

Expansion

OTI Labs Domain Intelligence

otilabs

An expansion module for the OTI Labs Domain Intelligence API (https://oti-labs.com/domain-intelligence-api). One request returns WHOIS/RDAP registration, DNS records, the certificate the domain serves, live subdomains with their IP addresses and the SPF, DMARC and DKIM records.

Module details

Module Type: expansion hover
Input: A domain or a hostname.
Output: whois, x509, dns-record and domain-ip objects describing the domain and its live subdomains.
Requirements: A RapidAPI key subscribed to the OTI Labs Domain Intelligence API (the free plan includes 1,000 requests a month).
Features: The module takes a domain or a hostname and queries the /lookup endpoint of the OTI Labs Domain Intelligence API. The response is mapped to a whois object (registrar, creation, update and expiry dates, nameservers), an x509 object (issuer, subject, serial number, validity dates, SANs), a dns-record object (MX, NS, TXT, SOA), a domain-ip object for the domain (A/AAAA records plus the SPF, DMARC and DKIM results as text) and one domain-ip object per live subdomain with its IP address. The number of subdomain objects is capped by the subdomain_limit setting (default 50).
References: https://oti-labs.com/domain-intelligence-api https://github.com/osiris-technical-institute/domain-intelligence-api
Author: OTI Labs
Version: 1

Expansion

Passive SSH Enrichment

passive_ssh

An expansion module to enrich, SSH key fingerprints and IP addresses with information collected by passive-ssh

Module details

Module Type: expansion hover
Input: ip-src ip-dst ssh-fingerprint
Author: Jean-Louis Huynen
Version: 1

Expansion

PassiveTotal Lookup

passivetotal

The PassiveTotal MISP expansion module brings the datasets derived from Internet scanning directly into your MISP instance. This module supports passive DNS, historic SSL, WHOIS, and host attributes. In order to use the module, you must have a valid PassiveTotal account username and API key. Registration is free and can be done by visiting https://www.passivetotal.org/register

Module details

Module Type: expansion hover
Input: A MISP attribute included in the following list: - hostname - domain - ip-src - ip-dst - x509-fingerprint-sha1 - email-src - email-dst - target-email - whois-registrant-email - whois-registrant-phone - text - whois-registrant-name - whois-registrar - whois-creation-date
Output: MISP attributes mapped from the result of the query on PassiveTotal, included in the following list: - hostname - domain - ip-src - ip-dst - x509-fingerprint-sha1 - email-src - email-dst - target-email - whois-registrant-email - whois-registrant-phone - text - whois-registrant-name - whois-registrar - whois-creation-date - md5 - sha1 - sha256 - link
Requirements: Passivetotal python library An access to the PassiveTotal API (apikey)
Features: The PassiveTotal MISP expansion module brings the datasets derived from Internet scanning directly into your MISP instance. This module supports passive DNS, historic SSL, WHOIS, and host attributes. In order to use the module, you must have a valid PassiveTotal account username and API key. Registration is free and can be done by visiting https://www.passivetotal.org/register
References: https://www.passivetotal.org/register
Author: Brandon Dixon
Version: 1.0

Expansion

PDF Enrich

pdf_enrich

Module to extract freetext from a PDF document.

Module details

Module Type: expansion
Input: Attachment attribute containing a PDF document.
Output: Text and freetext parsed from the document.
Requirements: pdftotext: Python library to extract text from PDF.
Features: The module reads the text contained in a PDF document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Import

PDNS COF Importer

cof2misp

Passive DNS Common Output Format (COF) MISP importer

Module details

Module Type: import
Input: Passive DNS output in Common Output Format (COF)
Output: MISP objects
Requirements: PyMISP
Features: Takes as input a valid COF file or the output of the dnsdbflex utility and creates MISP objects for the input.
References: https://tools.ietf.org/id/draft-dulaunoy-dnsop-passive-dns-cof-08.html
Author: Aaron Kaplan
Version: 0.3

Expansion

PPTX Enrich

pptx_enrich

Module to extract freetext from a .pptx document.

Module details

Module Type: expansion
Input: Attachment attribute containing a .pptx document.
Output: Text and freetext parsed from the document.
Requirements: pptx: Python library to read PowerPoint files.
Features: The module reads the text contained in a .pptx document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Expansion

PTR Classification

ptrclassify

Classify PTR hostnames and tag queried attributes with the ptrclassify taxonomy.

Module details

Module Type: expansion hover
Input: An ip-src, ip-dst, domain|ip, hostname or domain attribute.
Output: The tagged input attribute, one ptrclassify object per hostname, and a dns-record object for IP lookups.
Requirements: ptrclassify and dnspython Python libraries; DNS access for IP lookups
Features: IPv4 and IPv6 attributes are reverse-resolved and every distinct PTR hostname is classified locally using ptrclassify's built-in rules, retaining the queried address to detect IP-encoded naming. Hostname and domain attributes are classified directly, without DNS or an API key. Matching ptrclassify taxonomy tags are added to the queried attribute, retaining its UUID and existing tags, and to PTR answers in a `dns-record` object. One `ptrclassify` object per hostname holds the classification labels, confidence, evidence, rule IDs and potential location hints. Repeated classification fields share the machine tag as their attribute comment; location fields share a rule-ID/code comment. Classification objects reference the queried attribute and, for IP lookups, the DNS object. No match returns an object with `matched=0` without adding tags. Configure `nameserver` to use a specific DNS server; otherwise the system resolver is used. DNS lookups have a five-second lifetime. Classification is heuristic: PTR names are operator-controlled, and inferred locations are hints, not verified geolocation. Hover displays the enrichment; importing the expansion applies the returned tags in MISP. Enable the ptrclassify taxonomy in MISP to manage these tags, and install the ptrclassify MISP object template. The module bundles the template so it also works with PyMISP versions that do not yet include it.
References: https://github.com/adulau/ptrclassify https://misp-project.org/taxonomies.html#_ptrclassify
Author: MISP Project
Version: 2

Expansion

Qintel QSentry Lookup

qintel_qsentry

A hover and expansion module which queries Qintel QSentry for ip reputation data

Module details

Module Type: hover expansion
Input: ip address attribute
Output: ip-src ip-dst AS freetext
Requirements: A Qintel API token
Features: This module takes an ip-address (ip-src or ip-dst) attribute as input, and queries the Qintel QSentry API to retrieve ip reputation data
References: https://www.qintel.com/products/qsentry/
Author: Qintel, LLC
Version: 1.0

Expansion

QR Code Decode

qrcode

Decode QR codes from attachments OR remote URLs (Anti-Quishing).

Module details

Module Type: expansion hover
Input: A QR code stored as attachment attribute or a remote URL.
Output: The URL or bitcoin address the QR code is pointing to.
Requirements: cv2 pyzbar requests numpy
Author: Sascha Rommelfangen
Version: 0.3

Expansion

RandomcoinDB Lookup

ransomcoindb

Module to access the ransomcoinDB (see https://ransomcoindb.concinnity-risks.com)

Module details

Module Type: expansion hover
Input: A hash (md5, sha1 or sha256) or btc attribute.
Output: Hashes associated to a btc address or btc addresses associated to a hash.
Requirements: A ransomcoinDB API key.
Features: The module takes either a hash attribute or a btc attribute as input to query the ransomcoinDB API for some additional data. If the input is a btc address, we will get the associated hashes returned in a file MISP object. If we query ransomcoinDB with a hash, the response contains the associated btc addresses returned as single MISP btc attributes.
References: https://ransomcoindb.concinnity-risks.com
Author: Aaron Kaplan
Version: 0.1

Expansion

RansomLook Lookup

ransomlook

Query the RansomLook API and return matching ransomware leak-site posts as MISP objects.

Module details

Note: Input/output attributes are computed dynamically; see source.
Module Type: expansion hover
Input: Any MISP attribute value to search in RansomLook posts.
Output: RansomLook hits represented as ransomware-group-post MISP objects.
Requirements: No API key required.
Features: The module accepts any MISP attribute value, including text and free-text attributes, and searches across RansomLook posts using the /api/search endpoint. Matching posts are converted to the MISP ransomware-group-post object format.
References: https://www.ransomlook.io/ https://www.ransomlook.io/doc/ https://github.com/MISP/misp-objects/blob/main/objects/ransomware-group-post/definition.json
Author: MISP Project
Version: 1.0

Expansion

Rapid7 AttackerKB lookup

rapid7_attackerkb

Module to lookup CVE attributes in Rapid7 AttackerKB.

Module details

Module Type: expansion hover
Input: A vulnerability attribute containing a CVE ID, or a comment that includes one or more CVEs.
Output: Enriched information about the CVE, including: Vulnerability description and link to Rapid7 AttackerKB topic CVSS base score Attacker value and exploitability ratings External references related to the CVE Rapid7’s analysis (if available) Community assessments with contributor names, scores, and notes
Requirements: A valid public Rapid7 AttackerKB API key https://api.attackerkb.com/v1/api-docs/docs
Features: The module takes a CVE attribute and queries Rapid7 AttackerKB to retrieve information about the vulnerability. It returns details such as the CVSS score, exploitability, attacker value, available references, Rapid7 analysis, and community assessments.
References: https://attackerkb.com/
Author: R7 Labs
Version: 1

Expansion

RDAP Lookup

rdap

An expansion module to query the public RDAP bootstrap (rdap.org) for registration data of a domain, hostname, IP address or URL. RDAP (Registration Data Access Protocol, RFC 9082/9083) is the free, unauthenticated and structured successor to WHOIS.

Module details

Module Type: expansion hover
Input: A domain, hostname, IP address or URL attribute.
Output: A whois object holding the registration data returned by RDAP.
Features: The module takes a domain, hostname, IP address or URL attribute as input, resolves a URL to its host, and queries the rdap.org bootstrap which redirects to the authoritative RDAP server for the object. The registrar, registration and expiration dates, name servers, status and registrant information are parsed into a MISP whois object.
References: https://about.rdap.org/ https://rdap.org/
Author: Ali Bhutto
Version: 1

Expansion

Real-time Blackhost Lists Lookup

rbl

Module to check an IPv4 address against known RBLs.

Module details

Module Type: expansion hover
Input: IP address attribute.
Output: Text with additional data from Real-time Blackhost Lists about the IP address.
Requirements: dnspython3: DNS python3 library
Features: This module takes an IP address attribute as input and queries multiple know Real-time Blackhost Lists to check if they have already seen this IP address. We display then all the information we get from those different sources.
References: [RBLs list](https://github.com/MISP/misp-modules/blob/8817de476572a10a9c9d03258ec81ca70f3d926d/misp_modules/modules/expansion/rbl.py#L20)
Author: Christian Studer
Version: 0.2

Expansion

Recorded Future Enrich

recordedfuture

Module to enrich attributes with threat intelligence from Recorded Future.

Module details

Module Type: expansion hover
Input: A MISP attribute of one of the following types: ip, ip-src, ip-dst, domain, hostname, md5, sha1, sha256, uri, url, vulnerability, weakness.
Output: A MISP object containing a copy of the enriched attribute with added tags from Recorded Future and a list of new attributes related to the enriched attribute.
Requirements: A Recorded Future API token.
Features: Enrich an attribute to add a custom enrichment object to the event. The object contains a copy of the enriched attribute with added tags presenting risk score and triggered risk rules from Recorded Future. Malware and Threat Actors related to the enriched indicator in Recorded Future is matched against MISP's galaxy clusters and applied as galaxy tags. The custom enrichment object also includes a list of related indicators from Recorded Future (IP's, domains, hashes, URL's and vulnerabilities) added as additional attributes.
References: https://www.recordedfuture.com/
Author: Recorded Future
Version: 2.0.1

Expansion

Reverse DNS

reversedns

Simple Reverse DNS expansion service to resolve reverse DNS from MISP attributes.

Module details

Module Type: expansion hover
Input: An IP address attribute.
Output: Hostname attribute the input is resolved into.
Requirements: DNS python library
Features: The module takes an IP address as input and tries to find the hostname this IP address is resolved into. The address of the DNS resolver to use is also configurable, but if no configuration is set, we use the Google public DNS address (8.8.8.8). Please note that composite MISP attributes containing IP addresses are supported as well.
Author: Andreas Muehlemann
Version: 0.1

Expansion

ReversingLabs Spectra Analyze

reversinglabs_spectra_analyze

Module to enrich file hashes, domains, IPs and URLs with ReversingLabs Spectra Analyze threat intelligence.

Module details

Module Type: expansion
Input: A MISP attribute of one of the following types: md5, sha1, sha256, domain, hostname, ip, ip-src, ip-dst, url.
Output: MISP objects including file objects, domain-ip mappings, DNS records, URL objects, and IP-port objects with detailed threat intelligence.
Requirements: A ReversingLabs Spectra Analyze API token.
Features: This module enriches MISP attributes with threat intelligence from ReversingLabs Spectra Analyze. It supports file hashes (MD5, SHA1, SHA256), domains, hostnames, IP addresses, and URLs. The module returns detailed file analysis including classification, threat indicators, and related network infrastructure as MISP objects.
References: https://github.com/reversinglabs/reversinglabs-misp
Author: ReversingLabs
Version: 1.0.0

Expansion

RST Cloud Cobalt Strike Beacon

rst_cs_beacon

Scan a target IP[:port] for a Cobalt Strike beacon configuration via RST Scan API.

Module details

Module Type: expansion
Input: IP, URL, domain, or hostname attribute (optional port via config).
Output: file MISP object(s) with beacon hashes and Cobalt Strike galaxy tag.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Probes the target for Cobalt Strike beacon configurations via RST Scan GET /scan/cs-beacon. On a hit, returns file MISP object(s) with pivotable SHA-256 hashes tagged to the Cobalt Strike galaxy.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.2

Expansion

RST Cloud Favicon

rst_favicon

Fetch a target's favicon (image + all hashes for Shodan/Netlas/Censys pivoting) via RST Scan API.

Module details

Module Type: expansion
Input: URL, domain, hostname, or IP attribute.
Output: file MISP object, favicon-hash attribute, and resolved favicon URL.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Retrieves the favicon image and cryptographic hashes via RST Scan GET /scan/favicon. Returns a file MISP object with MD5/SHA-1/SHA-256 for Censys/Netlas pivoting and a standalone Murmur3 favicon-hash attribute for Shodan/FOFA-style pivoting.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.3

Expansion

RST Cloud HTML Fetcher

rst_html

Fetch rendered HTML body or extracted JavaScript for a URL/IP target via RST Scan API.

Module details

Module Type: expansion
Input: URL, domain, hostname, or IP attribute (optional port via config).
Output: file MISP object (page.html or page.js) with hashes and HTTP metadata.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Fetches the rendered HTML body or extracted JavaScript from the target via RST Scan. Returns a file MISP object with the page attached and pivotable content hashes. Configurable mode: body (default) or js.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.2

Expansion

RST Cloud IoC Lookup

rst_ioc

Enrich indicators with RST Cloud threat intelligence. Returns an rst-ioc object (score, attribution, geo/ASN for IPs, DNS/WHOIS for domains, parsed components for URLs, related hashes for file hashes) linked back to the enriched attribute.

Module details

Module Type: expansion hover
Input: IP, domain, hostname, URL, or hash attribute (incl. host|port composites).
Output: rst-ioc MISP object, galaxy/score tags, and optional related attributes.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Queries RST Cloud GET /ioc for threat scores, attribution, geo/ASN, DNS, WHOIS, TTPs, CVEs, and related indicators. Returns a structured rst-ioc MISP object with galaxy tags and optional pivotable related hashes/IPs. When misp_url and misp_key are configured, also writes score/threat tags onto the enriched attribute via the MISP API.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.4

Expansion

RST Cloud Noise Control

rst_noise_control

Check whether a value (IP, domain, URL or hash) is known-good / noise via RST Noise Control. Returns an rst-noise object (verdict, category) linked back to the enriched attribute.

Module details

Module Type: expansion hover
Input: IP, domain, hostname, URL, or hash attribute (incl. host|port composites).
Output: rst-noise MISP object with verdict, category, and risk/noise tags.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Queries RST Cloud GET /benign/lookup for benign/noisy verdicts. Returns an rst-noise MISP object with false-positive risk tags. When misp_url and misp_key are configured, also annotates the source attribute in place (tags, comment, to_ids, false-positive sightings).
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.4

Expansion

RST Cloud Screenshot

rst_screenshot

Capture a page screenshot (first/full/last frame) of a URL/IP target via RST Scan API.

Module details

Module Type: expansion
Input: URL, domain, hostname, or IP attribute (optional port via config).
Output: image MISP object with PNG attachment linked to the enriched attribute.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Renders the target page and returns a PNG screenshot as an image MISP object (inline in MISP). Configurable frame: first, full (default), or last.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.2

Expansion

RST Cloud SSL Certificate

rst_ssl

Fetch the SSL certificate for an IP[:port] as an x509 object via RST Scan API.

Module details

Module Type: expansion
Input: IP, hostname, or domain attribute (optional port via config or composite).
Output: x509 MISP object referencing the enriched attribute.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Connects to the target service and retrieves the TLS certificate via RST Scan GET /scan/ssl/certificate. Returns an x509 MISP object with pivotable fingerprints (SHA-1/256/MD5), subject, issuer, and validity dates.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.2

Expansion

RST Cloud Whois

rst_whois

Retrieve parsed WHOIS information for a domain via RST Cloud.

Module details

Module Type: expansion hover
Input: Domain or hostname attribute.
Output: whois MISP object with registration and nameserver fields.
Requirements: An RST Cloud API key. rstapi>=1.2.0 (PyPI).
Features: Queries RST Cloud GET /whois for parsed domain registration data. Returns a standard whois MISP object (registrar, registrant, dates, nameservers) linked back to the enriched attribute.
References: https://api.rstcloud.net/ https://pypi.org/project/rstapi/
Author: RST Cloud
Version: 0.2

Expansion

Rulezet Rule Validator

rulezet_validator

Validate the syntax of detection rules (YARA, Sigma, Suricata, Zeek, NOVA, Wazuh, Kunai, NSE, CRS, Splunk, Elastic, KQL, ATR, PLUM, Sagan) with the Rulezet API.

Module details

Module Type: expansion hover
Input: A rule attribute (yara, sigma, snort, zeek, bro, kusto-query) or a rule object as exported by Rulezet (yara, sigma, suricata, nova-rule, wazuh-rule, owasp-crs-rule, splunk-rule, rulezet-metadata...).
Output: A rule-validation MISP object.
Requirements: Access to a Rulezet instance (https://rulezet.org by default)
Features: This module sends a rule, taken from an attribute (yara, sigma, snort, zeek, bro, kusto-query) or from an object (yara, sigma, suricata, zeek, nse, nse-script, nova-rule, wazuh-rule, kunai-rule, owasp-crs-rule, splunk-rule, elastic-detection-rule, kql-analytics-rule, atr, plum, sagan, rulezet-metadata), to the public validation endpoint of Rulezet (/api/rule/public/validate). Nothing is stored on Rulezet: it is a dry run of the syntax check Rulezet performs on rule creation. The result is returned as a `rule-validation` MISP object holding the format, the validity, and each error and warning reported by the validator, referencing the validated attribute or object.
References: https://rulezet.org https://github.com/rulezet/rulezet-core
Author: Theo Geffe
Version: 0.1

Expansion

ScanMalware Lookup

scanmalware

Query ScanMalware for subdomains, browser-observed hosts and sandbox scan results.

Module details

Module Type: expansion hover
Input: A domain, hostname, URL or IP address.
Output: Domain attributes for the hosts found, plus text and link attributes describing the scan.
Features: The module takes a domain, hostname, URL or IP attribute and queries the public ScanMalware API. For a domain or hostname it returns subdomains seen in Certificate Transparency DNS records, and the hosts a browser actually resolved and requested while rendering pages on that domain. For a URL it returns the most recent sandboxed scan of that host, with its verdict and a link to the full report. For an IP it returns the URLs in the public scan archive that resolved to that address. No API key is required: the ScanMalware API is anonymous, and a key only raises the rate limit. Only the queried indicator leaves the MISP instance.
References: https://scanmalware.com https://scanmalware.com/api-docs
Author: Jonas Lejon
Version: 1.0

Expansion

SecurityTrails Lookup

securitytrails

An expansion modules for SecurityTrails.

Module details

Module Type: expansion hover
Input: A domain, hostname or IP address attribute.
Output: MISP attributes resulting from the query on SecurityTrails API, included in the following list: - hostname - domain - ip-src - ip-dst - dns-soa-email - whois-registrant-email - whois-registrant-phone - whois-registrant-name - whois-registrar - whois-creation-date - domain
Requirements: dnstrails python library An access to the SecurityTrails API (apikey)
Features: The module takes a domain, hostname or IP address attribute as input and queries the SecurityTrails API with it. Multiple parsing operations are then processed on the result of the query to extract a much information as possible. From this data extracted are then mapped MISP attributes.
References: https://securitytrails.com/
Author: Sebastien Larinier @sebdraven
Version: 1

Expansion

Shodan Lookup

shodan

Module to query on Shodan.

Module details

Module Type: expansion
Input: An IP address MISP attribute.
Output: Text with additional data about the input, resulting from the query on Shodan.
Requirements: shodan python library An access to the Shodan API (apikey)
Features: The module takes an IP address as input and queries the Shodan API to get some additional data about it.
References: https://www.shodan.io/
Author: Raphaël Vinot
Version: 0.2

Expansion

Sigma Rule Converter

sigma_queries

An expansion hover module to display the result of sigma queries.

Module details

Module Type: expansion hover
Input: A Sigma attribute.
Output: Text displaying results of queries on the Sigma attribute.
Requirements: Sigma python library
Features: This module takes a Sigma rule attribute as input and tries all the different queries available to convert it into different formats recognized by SIEMs.
References: https://github.com/Neo23x0/sigma/wiki
Author: Christian Studer
Version: 0.1

Expansion

Sigma Syntax Validator

sigma_syntax_validator

An expansion hover module to perform a syntax check on sigma rules.

Module details

Module Type: expansion hover
Input: A Sigma attribute.
Output: Text describing the validity of the Sigma rule.
Requirements: Sigma python library Yaml python library
Features: This module takes a Sigma rule attribute as input and performs a syntax check on it. It displays then that the rule is valid if it is the case, and the error related to the rule otherwise.
References: https://github.com/Neo23x0/sigma/wiki
Author: Christian Studer
Version: 0.1

Expansion

SigMF Expansion

sigmf_expand

Expands a SigMF Recording object into a SigMF Expanded Recording object, extracts a SigMF archive into a SigMF Recording object.

Module details

Module Type: expansion
Input: sigmf-recording sigmf-archive
Output: MISP objects
Author: Luciano Righetti
Version: 0.1

Action

Slack

slack

Simplistic module to send messages to a Slack channel.

Module details

Module Type: action
Author: goodlandsecurity
Version: 0.1

Expansion

Socialscan Lookup

socialscan

A hover module to get information on the availability of an email address or username on some online platforms.

Module details

Module Type: hover
Input: An email address or usename attribute.
Output: Text containing information about the availability of an email address or a username in some online platforms.
Requirements: The socialscan python library
Features: The module takes an email address or username as input and check its availability on some online platforms. The results for each platform are then returned to see if the email address or the username is used, available or if there is an issue with it.
References: https://github.com/iojw/socialscan
Author: Christian Studer
Version: 1

Import

SOCRadar TAXII Feed Import

socradar_taxii_feed

Import threat indicators from SOCRadar TAXII 2.1 feed with MITRE ATT&CK, malware family, confidence, and geo tagging. Leave collection_id empty and type 'list' to discover available collections.

Module details

Module Type: import
Input: SOCRadar TAXII 2.1 collection endpoint.
Output: MISP attributes with rich tagging.
Requirements: requests
Features: Connect to SOCRadar TAXII 2.1 server and import enriched threat indicators into MISP. Indicators are automatically tagged with MITRE ATT&CK techniques, malware families, confidence levels, feed sources, and country information. Supports collection auto-discovery — leave collection_id empty and type 'list' to see all available collections.
References: https://socradar.io https://docs.socradar.io/taxii
Author: SOCRadar
Version: 1.1

Expansion

SOCRadar Threat Intelligence

socradar_lookup

Enrich MISP attributes with SOCRadar threat intelligence. Queries SOCRadar IoC Enrichment API for categorization, malware families, threat actors, confidence scores, feed source history, and geographic attribution.

Module details

Module Type: expansion hover
Input: A MISP attribute of type ip-src, ip-dst, domain, hostname, url, md5, sha1, sha256, email-src, or email-dst.
Output: Enrichment data including categorization, malware families, threat actors, confidence score, SOCRadar threat score, feed source history, and country attribution.
Requirements: requests
Features: Query SOCRadar IoC Enrichment API to enrich MISP attributes with threat intelligence context. Supports IP, domain, URL, hash, and email lookups. Two modes: STIX (fast) and Full (detailed with categorization, history, and optional AI insight). Requires a SOCRadar Advanced Threat Intelligence API key.
References: https://socradar.io https://platform.socradar.com
Author: SOCRadar
Version: 1.0

Expansion

SophosLabs Intelix Lookup

sophoslabs_intelix

An expansion module to query the Sophoslabs intelix API to get additional information about an ip address, url, domain or sha256 attribute.

Module details

Module Type: expansion
Input: An ip address, url, domain or sha256 attribute.
Output: SophosLabs Intelix report and lookup objects
Requirements: A client_id and client_secret pair to authenticate to the SophosLabs Intelix API
Features: The module takes an ip address, url, domain or sha256 attribute and queries the SophosLabs Intelix API with the attribute value. The result of this query is a SophosLabs Intelix hash report, or an ip or url lookup, that is then parsed and returned in a MISP object.
References: https://aws.amazon.com/marketplace/pp/B07SLZPMCS
Author: Ben Verschaeren
Version: 1.0

Expansion

SSH Fingerprint

ssh_fingerprint

Grab SSH server fingerprint from an IP and return as passive-ssh MISP object.

Module details

Module Type: expansion hover
Input: An IP address attribute (ip-src or ip-dst).
Output: passive-ssh MISP object with banner and fingerprint.
Features: The module takes an IP address attribute as input, connects to port 22, performs the SSH protocol version exchange and key exchange init to extract the server host key algorithms and SSH banner. Returns a structured passive-ssh MISP object. Useful for detecting MitM attacks or verifying server identity.
References: https://tools.ietf.org/html/rfc4253
Author: Mihai Saveanu
Version: 0.2

Expansion

Stairwell Lookup

stairwell

Module to query the Stairwell API to get additional information about the input hash attribute

Module details

Module Type: expansion
Input: A hash attribute (md5, sha1, sha256).
Output: File object related to the input attribute found on Stairwell platform.
Requirements: Access to Stairwell platform (apikey)
Features: The module takes a hash attribute as input and queries Stariwell's API to fetch additional data about it. The result, if the payload is observed in Stariwell, is a file object describing the file the input hash is related to.
References: https://stairwell.com https://docs.stairwell.com
Author: goodlandsecurity
Version: 0.1

Expansion

STIX2 Pattern Syntax Validator

stix2_pattern_syntax_validator

An expansion hover module to perform a syntax check on stix2 patterns.

Module details

Module Type: hover
Input: A STIX2 pattern attribute.
Output: Text describing the validity of the STIX2 pattern.
Requirements: stix2patterns python library
Features: This module takes a STIX2 pattern attribute as input and performs a syntax check on it. It displays then that the rule is valid if it is the case, and the error related to the rule otherwise.
References: [STIX2.0 patterning specifications](http://docs.oasis-open.org/cti/stix/v2.0/cs01/part5-stix-patterning/stix-v2.0-cs01-part5-stix-patterning.html)
Author: Christian Studer
Version: 0.1

Import

TAXII 2.1 Import

taxii21

Import content from a TAXII 2.1 server

Module details

Module Type: import
Output: MISP objects
Requirements: misp-lib-stix2 misp-stix
Author: Abc
Version: 0.2

Action

Test action

testaction

This module is merely a test, always returning true. Triggers on event publishing.

Module details

Module Type: action
Author: Andras Iklody
Version: 0.1

Export

Test Export

testexport

Skeleton export module.

Module details

Module Type: export
Author: Andras Iklody
Version: 0.1

Import

ThreadAnalyzer Sandbox Import

threatanalyzer_import

Module to import ThreatAnalyzer archive.zip / analysis.json files.

Module details

Module Type: import
Input: ThreatAnalyzer format file
Output: MISP Event attributes
Features: The module imports MISP Attributes from a ThreatAnalyzer format file. This file can be either ZIP, or JSON format. There is by the way no special feature for users to make the module work.
References: https://www.threattrack.com/malware-analysis.aspx
Author: Christophe Vandeplas
Version: 0.10

Export

ThreadConnect Export

threat_connect_export

Module to export a structured CSV file for uploading to ThreatConnect.

Module details

Module Type: export
Input: MISP Event attributes
Output: ThreatConnect CSV format file
Requirements: csv
Features: The module takes a MISP event in input, to look every attribute. Each attribute matching with some predefined types is then exported in a CSV format recognized by ThreatConnect. Users should then provide, as module configuration, the source of data they export, because it is required by the output format.
References: https://www.threatconnect.com
Author: CenturyLink CIRT
Version: 0.1

Expansion

ThreadFox Lookup

threatfox

Module to search for an IOC on ThreatFox by abuse.ch.

Module details

Module Type: hover expansion
Input: md5 sha1 sha256 domain url email-src ip-dst|port ip-src|port
Output: text
Author: Corsin Camichel
Version: 0.1

Expansion

ThreatCrowd Lookup

threatcrowd

Module to get information from ThreatCrowd.

Module details

Module Type: expansion
Input: A MISP attribute included in the following list: - hostname - domain - ip-src - ip-dst - md5 - sha1 - sha256 - sha512 - whois-registrant-email
Output: MISP attributes mapped from the result of the query on ThreatCrowd, included in the following list: - domain - ip-src - ip-dst - text - md5 - sha1 - sha256 - sha512 - hostname - whois-registrant-email
Features: This module takes a MISP attribute as input and queries ThreatCrowd with it. The result of this query is then parsed and some data is mapped into MISP attributes in order to enrich the input attribute.
References: https://www.threatcrowd.org/
Author: chrisdoman
Version: 1

Expansion

ThreatMiner Lookup

threatminer

Module to get information from ThreatMiner.

Module details

Module Type: expansion
Input: A MISP attribute included in the following list: - hostname - domain - ip-src - ip-dst - md5 - sha1 - sha256 - sha512
Output: MISP attributes mapped from the result of the query on ThreatMiner, included in the following list: - domain - ip-src - ip-dst - text - md5 - sha1 - sha256 - sha512 - ssdeep - authentihash - filename - whois-registrant-email - url - link
Features: This module takes a MISP attribute as input and queries ThreatMiner with it. The result of this query is then parsed and some data is mapped into MISP attributes in order to enrich the input attribute.
References: https://www.threatminer.org/
Author: KX499
Version: 1

Export

ThreatStream Export

threatStream_misp_export

Module to export a structured CSV file for uploading to threatStream.

Module details

Module Type: export
Input: MISP Event attributes
Output: ThreatStream CSV format file
Requirements: csv
Features: The module takes a MISP event in input, to look every attribute. Each attribute matching with some predefined types is then exported in a CSV format recognized by ThreatStream.
References: https://www.anomali.com/platform/threatstream https://github.com/threatstream
Author: Robert Nixon, based off of the ThreatConnect MISP Module written by the CenturyLink CIRT
Version: 1.0

Expansion

TLS Certificate Check

tls_certificate_check

Extract TLS certificate details from a domain and return as x509 MISP object.

Module details

Module Type: expansion hover
Input: A domain or hostname attribute.
Output: x509 MISP object with certificate details.
Features: The module takes a domain or hostname attribute as input, connects to port 443, performs a TLS handshake and extracts certificate details. Returns a structured x509 MISP object with subject, issuer, validity, SANs, serial number, and protocol version. No external API required.
References: https://tools.ietf.org/html/rfc5246
Author: Mihai Saveanu
Version: 0.2

Expansion

Triage Submit

triage_submit

Module to submit samples to tria.ge

Module details

Module Type: expansion hover
Input: attachment malware-sample url
Output: link
Author: Karen Yousefi
Version: 1

Expansion

TruSTAR Enrich

trustar_enrich

Module to get enrich indicators with TruSTAR.

Module details

Module Type: hover expansion
Input: Any of the following MISP attributes: - btc - domain - email-src - filename - hostname - ip-src - ip-dst - md5 - sha1 - sha256 - url
Output: MISP attributes enriched with indicator summary data from the TruSTAR API. Data includes a severity level score and additional source and scoring info.
Features: This module enriches MISP attributes with scoring and metadata from TruSTAR. The TruSTAR indicator summary is appended to the attributes along with links to any associated reports.
References: https://docs.trustar.co/api/v13/indicators/get_indicator_summaries.html
Author: Jesse Hedden
Version: 0.1

Expansion

TweetFeed Lookup

tweetfeed

Look up an IOC in TweetFeed (tweetfeed.live), the free CC0 feed of URLs, domains, IPs and hashes shared by the infosec community on X/Twitter: who reported it and when, the source tweets and hashtags, cross-feed corroboration, AI-generated context and campaign membership.

Module details

Module Type: expansion hover
Input: An IP address, domain, hostname, URL, MD5 or SHA-256 attribute.
Output: microblog objects for the source tweets, domain-ip / text / link attributes with registration, network, corroboration, AI context and campaign data.
Requirements: No API key required.
Features: The module takes an IP, domain, hostname, URL, MD5 or SHA-256 attribute and queries the TweetFeed API for it. Matches come back as microblog objects for the source tweets (reporter, hashtags, first/last seen), plus attributes for co-reported IOCs, AI-generated context, domain registration and hosting, IP network metadata, corroboration from other feeds and campaign membership. Everything returned is community reported and unverified: no MISP tag or confidence score is set from it. The live 365-day window is queried first, and IOCs older than that are looked up in TweetFeed's separate archive.
References: https://tweetfeed.live https://tweetfeed.live/api/ https://tweetfeed.live/hunt/
Author: Daniel López
Version: 1

Expansion

URL Archiver

sourcecache

Module to cache web pages of analysis reports, OSINT sources. The module returns a link of the cached page.

Module details

Module Type: expansion
Input: A link or url attribute.
Output: A malware-sample attribute describing the cached page.
Requirements: urlarchiver: python library to fetch and archive URL on the file-system
Features: This module takes a link or url attribute as input and caches the related web page. It returns then a link of the cached page.
References: https://github.com/adulau/url_archiver
Author: Alexandre Dulaunoy
Version: 0.1

Expansion

URL Components Extractor

extract_url_components

Extract URL components

Module details

Module Type: expansion hover
Input: url
Author: MISP Team
Version: 1

Import

URL Import

url_import

Simple URL import tool with Faup

Module details

Module Type: import
Output: MISP Format
Author: Sami Mokaddem
Version: 0.1

Expansion

URLhaus Lookup

urlhaus

Query of the URLhaus API to get additional information about the input attribute.

Module details

Module Type: expansion hover
Input: A domain, hostname, url, ip, md5 or sha256 attribute.
Output: MISP attributes & objects fetched from the result of the URLhaus API query.
Features: Module using the new format of modules able to return attributes and objects. The module takes one of the attribute type specified as input, and query the URLhaus API with it. If any result is returned by the API, attributes and objects are created accordingly.
References: https://urlhaus.abuse.ch/
Author: Christian Studer
Version: 0.1

Expansion

URLScan Lookup

urlscan

An expansion module to query urlscan.io.

Module details

Module Type: expansion
Input: A domain, hostname or url attribute.
Output: MISP attributes mapped from the result of the query on urlscan.io.
Requirements: An access to the urlscan.io API
Features: This module takes a MISP attribute as input and queries urlscan.io with it. The result of this query is then parsed and some data is mapped into MISP attributes in order to enrich the input attribute.
References: https://urlscan.io/
Author: Dave Johnson
Version: 0.1

Expansion

Validin DNS History

validin

Validin internet dataset expansion. Returns dns-records, web crawls, registration (WHOIS) records, and certificates from Validin's historic internet intelligence dataset.

Module details

Module Type: expansion hover
Input: domain, hostname, or IP address.
Output: MISP dns-record objects plus optional subdomain attributes.
Requirements: requests pymisp
Features: Queries Validin's datasets for: DNS history, subdomains, host responses, certificates and registration records (enterprise users only) to enrich domains and IPs in MISP. The configured lookback is 14 days for DNS, 21 days for web crawls, and 30 days for registration history. To set this up correctly, you need to configure: a Validin api key, a Validin endpoint (e.g. app.validin.com), and a result_limit, which defaults to 100.
Author: Validin
Version: 1.2

Expansion

VARIoT db Lookup

variotdbs

An expansion module to query the VARIoT db API for more information about a vulnerability.

Module details

Module Type: expansion hover
Input: Vulnerability attribute.
Output: Additional information about the vulnerability, as it is stored on the VARIoT db, about the vulnerability itself, and the potential related exploits.
Requirements: A VARIoT db API key (if you do not want to be limited to 100 queries / day)
Features: The module takes a vulnerability attribute as input and queries que VARIoT db API to gather additional information. The `vuln` endpoint is queried first to look for additional information about the vulnerability itself. The `exploits` endpoint is also queried then to look for the information of the potential related exploits, which are parsed and added to the results using the `exploit` object template.
References: https://www.variotdbs.pl/
Author: Christian Studer
Version: 1

Export

VirusTotal Collections Export

virustotal_collections

Creates a VT Collection from an event iocs.

Module details

Module Type: export
Input: A domain, hash (md5, sha1, sha256 or sha512), hostname, url or IP address attribute.
Output: A VirusTotal collection in VT.
Requirements: An access to the VirusTotal API (apikey).
Features: This export module which takes advantage of a new endpoint in VT APIv3 to create VT Collections from IOCs contained in a MISP event. With this module users will be able to create a collection just using the Download as... button.
References: https://www.virustotal.com/ https://blog.virustotal.com/2021/11/introducing-virustotal-collections.html
Author: VirusTotal
Version: 1.0

Export

VirusTotal Graph Export

vt_graph

This module is used to create a VirusTotal Graph from a MISP event.

Module details

Module Type: export
Input: A MISP event.
Output: Link of the VirusTotal Graph created for the event.
Requirements: vt_graph_api, the python library to query the VirusTotal graph API
Features: The module takes the MISP event as input and queries the VirusTotal Graph API to create a new graph out of the event. Once the graph is ready, we get the url of it, which is returned so we can view it on VirusTotal.
References: https://www.virustotal.com/gui/graph-overview
Author: VirusTotal
Version: 0.1

Expansion

VirusTotal Public API Lookup

virustotal_public

Enrich observables with the VirusTotal v3 public API

Module details

Module Type: expansion hover
Input: A domain, hostname, ip, url or hash (md5, sha1, sha256 or sha512) attribute.
Output: MISP attributes and objects resulting from the parsing of the VirusTotal report concerning the input attribute.
Requirements: An access to the VirusTotal API (apikey)
Features: New format of modules able to return attributes and objects. A module to take a MISP attribute as input and query the VirusTotal API to get additional data about it. Compared to the [more advanced VirusTotal expansion module](https://github.com/MISP/misp-modules/blob/main/misp_modules/modules/expansion/virustotal.py), this module is made for VirusTotal users who have a low request rate limit. Thus, it only queries the API once and returns the results that is parsed into MISP attributes and objects.
References: https://www.virustotal.com https://docs.virustotal.com/reference/overview
Author: Christian Studer
Version: 2

Expansion

VirusTotal Upload

virustotal_upload

Module to push malware samples to VirusTotal

Module details

Module Type: expansion
Input: attachment malware-sample
Output: link
Requirements: requests library
Author: Karen Yousefi
Version: 1

Expansion

VirusTotal v3 Lookup

virustotal

Enrich observables with the VirusTotal v3 API

Module details

Module Type: expansion
Input: A domain, hash (md5, sha1, sha256 or sha512), hostname or IP address attribute.
Output: MISP attributes and objects resulting from the parsing of the VirusTotal report concerning the input attribute.
Requirements: An access to the VirusTotal API (apikey), with a high request rate limit.
Features: New format of modules able to return attributes and objects. A module to take a MISP attribute as input and query the VirusTotal API to get additional data about it. Compared to the [standard VirusTotal expansion module](https://github.com/MISP/misp-modules/blob/main/misp_modules/modules/expansion/virustotal_public.py), this module is made for advanced parsing of VirusTotal report, with a recursive analysis of the elements found after the first request. Thus, it requires a higher request rate limit to avoid the API to return a 204 error (Request rate limit exceeded), and the data parsed from the different requests are returned as MISP attributes and objects, with the corresponding relations between each one of them.
References: https://www.virustotal.com/ https://docs.virustotal.com/reference/overview
Author: Hannah Ward
Version: 6

Import

VMRay API Import

vmray_import

Module to import VMRay (VTI) results.

Module details

Module Type: import
Input: VMRay format
Output: MISP Event attributes
Requirements: vmray_rest_api
Features: The module imports MISP Attributes from VMRay format, using the VMRay api. Users should then provide as the module configuration the API Key as well as the server url in order to fetch their data to import.
References: https://www.vmray.com/
Author: Jens Thom (VMRay), Koen van Impe
Version: 0.4

Expansion

VMRay Submit

vmray_submit

Module to submit a sample to VMRay.

Module details

Module Type: expansion
Input: An attachment or malware-sample attribute.
Output: MISP attributes mapped from the result of the query on VMRay API, included in the following list: - text - sha1 - sha256 - md5 - link
Requirements: An access to the VMRay API (apikey & url)
Features: This module takes an attachment or malware-sample attribute as input to query the VMRay API. The sample contained within the attribute in then enriched with data from VMRay mapped into MISP attributes.
References: https://www.vmray.com/
Author: Koen Van Impe
Version: 0.3

Import

VMRay Summary JSON Import

vmray_summary_json_import

Import a VMRay Summary JSON report.

Module details

Module Type: import
Output: MISP objects MISP attributes
Author: VMRay
Version: 0.1

Expansion

VMware NSX Defender Enrich

vmware_nsx

Module to enrich a file or URL with VMware NSX Defender.

Module details

Module Type: expansion hover
Input: File hash, attachment or URL to be enriched with VMware NSX Defender.
Output: Objects and tags generated by VMware NSX Defender.
Requirements: The module requires a VMware NSX Defender Analysis `api_token` and `key`.
Features: This module takes an IoC such as file hash, file attachment, malware-sample or url as input to query VMware NSX Defender. The IoC is then enriched with data from VMware NSX Defender.
References: https://www.vmware.com
Author: Jason Zhang, Stefano Ortolani
Version: 0.2

Expansion

VulnDB Lookup

vulndb

Module to query VulnDB (RiskBasedSecurity.com).

Module details

Module Type: expansion hover
Input: A vulnerability attribute.
Output: Additional data enriching the CVE input, fetched from VulnDB.
Requirements: An access to the VulnDB API (apikey, apisecret)
Features: This module takes a vulnerability attribute as input and queries VulnDB in order to get some additional data about it. The API gives the result of the query which can be displayed in the screen, and/or mapped into MISP attributes to add in the event.
References: https://vulndb.cyberriskanalytics.com/
Author: Koen Van Impe
Version: 0.1

Expansion

Vulnerability Lookup

vulnerability_lookup

An expansion module to query Vulnerability Lookup

Module details

Module Type: expansion hover
Input: Vulnerability Attribute
Output: Additional information on the vulnerability, gathered from the Vulnerability Lookup API.
Features: The module takes a vulnerability attribute as input and queries Vulnerability Lookup to gather additional information based on the Vulnerability ID. The result of the query is then parsed and converted into MISP content which can be added to the original event to enrich the input attribute.
References: https://vulnerability.circl.lu
Author: Christian Studer
Version: 2

Expansion

Vulners Lookup

vulners

An expansion hover module to expand information about CVE id using Vulners API.

Module details

Module Type: hover
Input: A vulnerability attribute.
Output: Text giving additional information about the CVE in input.
Requirements: Vulners python library An access to the Vulners API
Features: This module takes a vulnerability attribute as input and queries the Vulners API in order to get some additional data about it. The API then returns details about the vulnerability.
References: https://vulners.com/
Author: Igor Ivanov
Version: 0.1

Expansion

Vysion Enrich

vysion

Module to enrich the information by making use of the Vysion API.

Module details

Module Type: expansion
Input: company(target-org), country, info, BTC, XMR and DASH address.
Output: MISP objects containing title, link to our webapp and TOR, i2p or clearnet URLs.
Requirements: Vysion python library Vysion API Key
Features: This module gets correlated information from Byron Labs' dark web intelligence database. With this you will get several objects containing information related to, for example, an organization victim of a ransomware attack.
References: https://vysion.ai/ https://developers.vysion.ai/ https://github.com/ByronLabs/vysion-cti/tree/main
Author: Byron Labs
Version: 1

Expansion

Whisper

whisper

Enrich IPs, domains, and ASNs with threat intelligence and infrastructure context from the Whisper graph.

Module details

Module Type: expansion hover
Input: An IP address, domain, hostname or AS MISP attribute.
Output: MISP attributes and objects with the related infrastructure and threat intelligence context from the Whisper graph.
Requirements: An access to the Whisper graph API (api_url + api_key)
Features: The module queries the Whisper graph for the input attribute and returns related infrastructure (DNS, ASN/BGP, WHOIS) and threat intelligence context as MISP attributes and objects.
References: https://whisper.security
Author: Whisper
Version: 0.0.1

Expansion

Whois Lookup

whois

Module to query a local instance of uwhois (https://github.com/rafiot/uwhoisd).

Module details

Module Type: expansion
Input: A domain or IP address attribute.
Output: Text describing the result of a whois request for the input value.
Requirements: uwhois: A whois python library
Features: This module takes a domain or IP address attribute as input and queries a 'Univseral Whois proxy server' to get the correct details of the Whois query on the input value (check the references for more details about this whois server).
References: https://github.com/Lookyloo/uwhoisd
Author: Raphaël Vinot
Version: 0.1

Expansion

WhoisFreaks Lookup

whoisfreaks

An expansion module for https://whoisfreaks.com/ that enriches a domain or an IP address. For a domain it queries the WHOIS, DNS and Domain Reputation APIs; for an IP address it queries the IP WHOIS, Geolocation and IP Security APIs. All lookups for a given attribute are executed in parallel.

Module details

Module Type: expansion hover
Input: A domain or an IP address (ip-src, ip-dst or ip).
Output: MISP attributes, objects and tags resulting from the WhoisFreaks WHOIS, DNS, Domain Reputation, IP WHOIS, Geolocation and IP Security APIs.
Requirements: An access to the Whoisfreaks API_KEY
Features: The module takes a domain or an IP address as input. For a domain it queries the Whoisfreaks WHOIS (v1.0), DNS (v2.0) and Domain Reputation APIs in parallel. For an IP address it queries the IP WHOIS, Geolocation and IP Security APIs in parallel. The results are mapped to MISP attributes, objects (geolocation, asn, reputation and security) and tags.
References: https://whoisfreaks.com/
Author: WhoisFreaks
Version: 3

Expansion

Wikidata Lookup

wiki

An expansion hover module to extract information from Wikidata to have additional information about particular term for analysis.

Module details

Module Type: hover
Input: Text attribute.
Output: Text attribute.
Requirements: SPARQLWrapper python library
Features: This module takes a text attribute as input and queries the Wikidata API. If the text attribute is clear enough to define a specific term, the API returns a wikidata link in response.
References: https://www.wikidata.org
Author: Roman Graf
Version: 0.2

Expansion

XLXS Enrich

xlsx_enrich

Module to extract freetext from a .xlsx document.

Module details

Module Type: expansion
Input: Attachment attribute containing a .xlsx document.
Output: Text and freetext parsed from the document.
Requirements: pandas: Python library to perform data analysis, time series and statistics.
Features: The module reads the text contained in a .xlsx document. The result is passed to the freetext import parser so IoCs can be extracted out of it.
Author: Sascha Rommelfangen
Version: 0.1

Expansion

XposedOrNot Lookup

xposedornot

Query the XposedOrNot API to check whether an email address appears in known data breaches.

Module details

Module Type: expansion hover
Input: An email address.
Output: Breach exposure details for the email address, one text attribute per breach.
Requirements: No API key required.
Features: The module takes an email address as input and queries the XposedOrNot API to determine whether the address appears in known data breaches. Each exposure is returned as a text attribute holding the breach name, with the breach year, number of exposed records, affected domain, exposed data classes and password storage risk in its comment. Without any configuration the free keyless API is used (rate limits apply: 2 requests/second, 25/hour per IP); an optional commercial api_key switches to the higher-limit Plus API. The queried email address is sent over TLS to xposedornot.com; nothing else leaves the MISP instance.
References: https://xposedornot.com https://api.xposedornot.com/docs
Author: XposedOrNot
Version: 1.0

Export

YARA Rule Export

yara_export

This module is used to export MISP events to YARA.

Module details

Module Type: export
Input: Attributes and Objects.
Output: A YARA file that can be used with the YARA scanning tool.
Requirements: yara-python python library
Features: The module will dynamically generate YARA rules for attributes that are marked as to IDS. Basic metadata about the event is added to the rule. Attributes that are already YARA rules are also exported, with a rewritten rule name.
References: https://virustotal.github.io/yara/
Author: Christophe Vandeplas
Version: 0.1

Expansion

YARA Rule Generator

yara_query

The module takes a hash attribute (md5, sha1, sha256, imphash) as input, and is returning a YARA rule from it.

Module details

Module Type: expansion hover
Input: MISP Hash attribute (md5, sha1, sha256, imphash, or any of the composite attribute with filename and one of the previous hash type).
Output: YARA rule.
Requirements: yara-python python library
Features: The module takes a hash attribute (md5, sha1, sha256, imphash) as input, and is returning a YARA rule from it. This YARA rule is also validated using the same method as in 'yara_syntax_validator' module. Both hover and expansion functionalities are supported with this module, where the hover part is displaying the resulting YARA rule and the expansion part allows you to add the rule as a new attribute, as usual with expansion modules.
References: https://virustotal.github.io/yara/ https://github.com/virustotal/yara-python
Author: Christian STUDER
Version: 1

Expansion

YARA Syntax Validator

yara_syntax_validator

An expansion hover module to perform a syntax check on if yara rules are valid or not.

Module details

Module Type: hover
Input: YARA rule attribute.
Output: Text to inform users if their rule is valid.
Requirements: yara_python python library
Features: This modules simply takes a YARA rule as input, and checks its syntax. It returns then a confirmation if the syntax is valid, otherwise the syntax error is displayed. This modules can compile YARA rule even if there is externals variables or miss modules
References: http://virustotal.github.io/yara/
Author: Dennis Rand and Theo Geffe
Version: 0.2

Expansion

Yeti Lookup

yeti

Module to process a query on Yeti.

Module details

Module Type: expansion hover
Input: A domain, hostname,IP, sha256,sha1, md5, url of MISP attribute.
Output: MISP attributes and objects fetched from the Yeti instances.
Requirements: pyeti API key
Features: This module add context and links between observables using yeti
References: https://github.com/yeti-platform/yeti https://github.com/sebdraven/pyeti
Author: Sebastien Larinier @sebdraven
Version: 1

Generated from misp-modules · revision 4663c7f1d627.

Use modules with MISP

Follow the installation guide to run the module service and connect it to MISP. Each module’s details and source describe its inputs, outputs, and requirements. Module types are expansion (including enrichment and hover lookups), import, export, and workflow action.

Download catalogue metadata · Read the module documentation · Contribute a module

© MISP project. Software released under approved open source licenses and content of this website released as CC BY-SA 3.0.

Template by Bootstrapious. Ported to Hugo by DevCows.