MISP Modules

MISP modules logo

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.

252 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
View source for Abuse IPDB
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
View source for AlienVault OTX Lookup
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
View source for alphaMountain_risk
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.2
View source for ANYRUN Sandbox Import
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
View source for ANYRUN Sandbox Submit
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
View source for APIFreaks Lookup
Expansion

APIVoid

apivoid

Query APIVoid v2 for DNS records, SSL certificates and email verification.

Module details
Module Type
expansion hover
Input
A domain, hostname or email attribute.
Output
DNS records, X.509 certificates or an APIVoid email verification object.
Requirements
An APIVoid v2 API key with 2 credits for domain lookups or 1 credit for email verification
Features
This module queries APIVoid v2 for DNS records and SSL certificates of domains and hostnames, or verifies email addresses. Results are returned as MISP objects. Configure `apikey` with a key from the APIVoid v2 dashboard (https://dash.apivoid.com/); v1 keys must be replaced. Each successful API call costs 1 credit: domain and hostname enrichment uses 2 calls, and email verification uses 1. Account overage settings apply.
References
https://www.apivoid.com/ https://docs.apivoid.com/
Author
Christian Studer
Version
0.3
View source for APIVoid
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
View source for AssemblyLine Query
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
View source for AssemblyLine Submit
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
View source for Backscatter.io
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
A reputation object when the BTC address is listed as a scam address.
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.2
View source for BTC Scam Check
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
A btc-wallet object and one btc-transaction object per transaction the address took part in.
Author
Sascha Rommelfangen
Version
0.3
View source for BTC Steroids
Export

CEF Export

cef_export

Module to export a MISP event in CEF format.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Common Event Format file
Features
Exports supported event and object attributes as UTF-8 CEF file records, with standard escaping and field validation. IPv6 address records use CEF:1; other records use CEF:0. Device settings and severity have defaults. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/cef_export.md) for mappings and compatibility changes.
References
https://www.microfocus.com/documentation/arcsight/arcsight-smartconnectors-24.3/pdfdoc/cef-implementation-standard/cef-implementation-standard.pdf
Author
Hannah Ward
Version
2
View source for CEF Export
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
View source for Censys Enrich
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
View source for CIRCL Hashlookup Lookup
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
View source for CIRCL Passive DNS
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
View source for CIRCL Passive SSL
Export

Cisco ASA ACL Export

cisco_asa_export

Export IDS-marked network attributes as Cisco ASA 9.x IPv4/IPv6 extended ACL entries.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded configuration fragment; rule counts, skipped counts and integration warnings.
Features
Exports validated IDS-marked event and object network attributes as deduplicated IPv4/IPv6 configuration fragments. Preserves source/destination address and port constraints. Deleted data is excluded. DNS-only attributes require opt-in resolve_dns. No device connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/cisco_asa_export.md) for configuration, logging semantics and policy integration.
References
https://www.cisco.com/c/en/us/td/docs/security/asa/asa-cli-reference/A-H/asa-command-ref-A-H/aa-ac-commands.html
Author
MISP Project
Version
1.0
View source for Cisco ASA ACL Export
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
View source for Cisco fireSIGHT blockrule Export
Export

Cisco IOS ACL Export

cisco_acl_export

Export IDS-marked network attributes as Cisco IOS/IOS-XE IPv4 and IPv6 ACL fragments.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded IOS/IOS-XE ACL configuration fragments; skipped counts and integration warnings.
Features
Exports validated event and object network attributes as named IPv4 extended and IPv6 ACL fragments. Defaults to deny entries; mode=log emits permit entries with log. Cisco ACL logging is first-match and permits matching traffic, so it cannot preserve later deny decisions. Only to_ids attributes are included; deleted data is excluded. DNS-only attributes require opt-in resolve_dns. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/cisco_acl_export.md).
References
https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/sec-vpn/b-security-vpn/m_sec-create-ip-apply-0.html https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/sec-vpn/b-security-vpn/m_ip6-acls-xe.html
Author
MISP Project
Version
1.0
View source for Cisco IOS ACL Export
Expansion

ClaamAV

clamav

Submit file to ClamAV

Module details
Module Type
expansion
Input
attachment malware-sample
Author
Jakub Onderka
Version
0.1
View source for ClaamAV
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
View source for Cluster25 Expand
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
View source for Country Code
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
View source for CPE Lookup
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
View source for CrowdSec CTI
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
View source for CrowdStrike Falcon
Action

CrowdStrike IOC Publish

crowdstrike_ioc_publish

Create and renew module-owned Falcon custom IOCs from MISP event and object attributes.

Module details
Module Type
action
Input
MISP events in standard, bare or legacy format, supplied in workflow data.
Output
Publishing summary and per-indicator outcomes; an error signals incomplete publication.
Requirements
crowdstrike-falconpy Falcon IOC Management Read/Write API scopes
Features
Publishes to_ids MD5, SHA-256, domain and IP attributes, including attributes in objects. Requires explicit host-group or global scope. Existing IOCs are updated only when both their source and module ownership tag match; foreign IOCs are left unchanged. Credentials come from server-side CROWDSTRIKE_CLIENT_ID and CROWDSTRIKE_CLIENT_SECRET environment variables. Supports expiration, dry runs and per-indicator outcomes. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/crowdstrike_ioc_publish.md).
References
https://www.falconpy.io/Service-Collections/IOC.html
Author
MISP Project
Version
1.0
View source for CrowdStrike IOC Publish
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
View source for CSV Import
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
View source for Cuckoo Sandbox Import
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
View source for Cuckoo Submit
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
View source for CVE Advanced Lookup
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
View source for CVE Lookup
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
View source for Cytomic Orion Lookup
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
View source for Darkmoon Import
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
A reputation object holding the classification Spamhaus DBL gives 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.2
View source for DBL Spamhaus Lookup
Expansion

DNS Record Enumeration

dns_query

Enumerate DNS record types and extract domain, IP, email and URL pivots.

Module details
Module Type
expansion
Input
A supported MISP attribute containing type, value and UUID.
Output
Linked dns-resource-record objects; newly generated attributes have to_ids=false.
Requirements
dnspython PyMISP
Features
Query each dnspython-known DNS data type explicitly, including SOA, TXT, MX, NS, SRV, CAA and DNSSEC. Return complete dns-resource-record objects with owner, type, class, TTL, RDATA and typed pivots. Accept DNS names, URLs, email addresses and IPs (reverse DNS). Query common mail-policy TXT names and optionally resolve discovered names to A/AAAA. Eight workers share a total time budget; failures retain successful results. See documentation/expansion/dns_query.json for configuration and limitations.
References
https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml
Author
MISP
Version
1.0
View source for DNS Record Enumeration
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
A dns-record object holding the A and AAAA records the input resolves to.
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 A and AAAA records resolving the domain are returned as a dns-record object, 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.5
View source for DNS Resolver
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
View source for DOCX Enrich
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
View source for DomainTools Lookup
Export

Elastic ECS Export

elastic_ecs_export

Export event and object indicators as ECS threat indicators in Elasticsearch Bulk NDJSON.

Module details
Module Type
export
Input
A list of MISP events in standard or legacy export format.
Output
Base64-encoded Bulk NDJSON containing ECS indicator documents; optional API warnings.
Features
Exports all supplied events, including object attributes, to ECS 9.2 threat.indicator fields. Bulk index actions use stable source-based IDs. Only to_ids attributes are included by default; include_non_ids enables contextual attributes. Deleted data is excluded. Source UUIDs, object context, tags, observation times and TLP markings are preserved. No Elasticsearch connection is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/elastic_ecs_export.md) for the index template, import procedure, matching fields and lifecycle limitations.
References
https://www.elastic.co/docs/reference/ecs/ecs-threat https://github.com/elastic/ecs/blob/v9.2.0/schemas/threat.yml https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-bulk
Author
MISP Project
Version
1.0
View source for Elastic ECS Export
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
View source for Email Import
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
View source for Email Security Check
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
View source for EQL Query Export
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
View source for EQL Query Generator
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
View source for EUPI Lookup
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
View source for Event to PDF Export
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
View source for Export to Sentinel or Defender
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 reputation object holding the Extuno verdict, its risk score and the advisory it came from.
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
View source for Extuno Lookup
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
View source for Farsight DNSDB Lookup
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
View source for Flowtriq DDoS Intelligence
Export

Fortinet FortiOS ACL Export

fortios_export

Export IDS-marked network attributes as FortiOS 7.4+ address objects, services and firewall policies.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded configuration fragment; rule counts, skipped counts and integration warnings.
Features
Exports validated IDS-marked event and object network attributes as deduplicated IPv4/IPv6 configuration fragments. Preserves source/destination address and port constraints. Deleted data is excluded. DNS-only attributes require opt-in resolve_dns. No device connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/fortios_export.md) for configuration, logging semantics and policy integration.
References
https://docs.fortinet.com/document/fortigate/7.4.8/cli-reference/333889629/config-firewall-policy
Author
MISP Project
Version
1.0
View source for Fortinet FortiOS ACL Export
Expansion

GCVE CPE

gcve_cpe

Expand CPE attributes with GCVE CPE catalog metadata, package mappings and vulnerability references.

Module details
Module Type
expansion hover
Input
CPE attribute.
Output
A catalog annotation and related vulnerability objects in MISP standard format.
Requirements
requests pymisp
Features
Query the public CPE Editor API without an API key. Search results are checked for an exact CPE URI match. Catalog metadata, deprecation information and PURL mappings are retained in a related annotation. Vulnerability references become vulnerability objects with their cpe_applicability and rationale preserved. Only references marked vulnerable populate vulnerable-configuration; other applicability states are context. api_url defaults to https://cpe.gcve.eu (instance root, without /api); timeout defaults to 30 seconds per request (maximum 120); max_pages defaults to 5 (1-20), with 100 search results per page. Blank or null settings use defaults. CPE 2.3 and URI bindings are looked up literally, without conversion.
References
https://cpe.gcve.eu/api/docs https://cpe.gcve.eu/api/openapi.yaml
Author
MISP Project
Version
1
View source for GCVE CPE
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
An asn object describing the AS the IP address is announced by.
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.2
View source for GeoIP ASN Lookup
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
A geolocation object describing 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.2
View source for GeoIP City Lookup
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
A geolocation object holding the country the IP address is located in.
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.3
View source for GeoIP Country Lookup
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
View source for GeoIP Enrichment
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
View source for GoAML Export
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
View source for GoAML Import
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
View source for Google Threat Intelligence Lookup
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
View source for GreyNoise Lookup
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
View source for Hashdd Lookup
Expansion

Have I Been Pwned Lookup

hibp

Module to access haveibeenpwned.com API.

Module details
Module Type
hover
Input
An email address
Output
One breach object per data breach the email address appears in.
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, and returns one breach object per breach it appears in.
References
https://haveibeenpwned.com/
Author
Corsin Camichel, Aurélien Schwab
Version
0.3
View source for Have I Been Pwned Lookup
Expansion

Host.io

hostio

Retrieve Host.io DNS, website and co-hosted domain observations.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses Bearer authentication and GET /api/full/{domain} or /api/domains/ip/{ip}. max_results defaults to 5 (1-100), matching the free plan page size. A single page is requested; a notice identifies additional domains. DNS records become a dns-record object; website, IPinfo and related-domain metadata remain in a referenced annotation.
References
https://host.io/docs
Author
MISP Project
Version
1
View source for Host.io
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
View source for HTML to Markdown
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
View source for HYAS Insight Lookup
Expansion

Hybrid Analysis Sandbox

hybrid_analysis

Look up Hybrid Analysis reports or submit a file or URL for sandbox analysis.

Module details
Module Type
expansion
Input
md5, sha1, sha256, attachment, url, text MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Hashes use GET /search/hash; text accepts a report ID (job ID or SHA256:environment-ID) and uses GET /report/{id}/summary. Files and URLs use POST /submit/file and /submit/url, returning the receipt without polling or retrying a submission. environment_id defaults to 110. max_results defaults to 25 (1-100); max_size_mb defaults to 25 (1-100). Reports and receipts become sandbox-report objects with links. Submissions send the supplied content to the service under your account sharing policy.
References
https://hybrid-analysis.com/docs/api/v2
Author
MISP Project
Version
1
View source for Hybrid Analysis Sandbox
Expansion

Hygiene Warninglist Check

hygiene

Check an observable against local MISP warninglists and record the matching lists.

Module details
Module Type
expansion
Input
domain, hostname, url, ip-src, ip-dst, md5, sha1, sha256, email-src, email-dst MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
pymispwarninglists>=1.7.0
Features
Uses the warninglists bundled with pymispwarninglists without downloading during enrichment. Optional warninglists_path points to a local repository containing lists/*/list.json. slow_search defaults to true for CIDR and hostname-aware matching; false selects exact matching. Matching-list name, version, type and description become warninglist-match objects. max_results defaults to 25 (1-100). Matches are context for analyst review, not proof of benignness; source detection flags and scores are preserved.
References
https://github.com/MISP/misp-warninglists https://github.com/MISP/PyMISPWarningLists
Author
MISP Project
Version
1
View source for Hygiene Warninglist Check
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
View source for IBM X-Force Exchange Lookup
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
View source for Import Blueprint
Expansion

Import External Reference

import_external_reference

Capture a public web reference as Markdown or a PDF attachment.

Module details
Module Type
expansion
Input
url MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
urllib3 certifi beautifulsoup4 markdownify
Features
Downloads a public HTTP(S) URL on ports 80 or 443, with a 30-second wall-clock deadline and at most five redirects. Resolves and validates every hop, connects directly to the validated public address and verifies TLS against the original hostname. Private, reserved and mixed public/private DNS answers are rejected. No proxy or browser is used. max_size_mb defaults to 5 (1-25), enforced while streaming content. HTML is converted into Markdown; PDFs are preserved. Returns a page-capture object referencing the URL attribute.
References
https://www.misp-project.org/objects.html#_page_capture
Author
MISP Project
Version
1
View source for Import External Reference
Expansion

Intel 471 Hunter

intel471_hunt

Retrieve Intel 471 Hunter hunt packages, Sigma rules and analyst guidance.

Module details
Module Type
expansion
Input
vulnerability, text MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses GET /es/query with Authorization: API-Key and indexes=cyborg_usecases. CVEs use exploit_or_vulns; text uses search_type, default mitre_technique_ids, with actors, threat_names, mitre_technique_names and mitre_tactic_names also supported. max_results defaults to 25 (1-100). Sigma rules become sigma objects; package metadata and runbooks are preserved in annotations. Requires a Hunter subscription, separate from Titan IOC access.
References
https://hunter.cyborgsecurity.io/ https://api.hunter.cyborgsecurity.io/docs
Author
MISP Project
Version
1
View source for Intel 471 Hunter
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
View source for Intel471 Lookup
Expansion

Intezer Sandbox

intezer

Retrieve Intezer Analyze file reports or submit an attachment for analysis.

Module details
Module Type
expansion
Input
md5, sha1, sha256, attachment, text MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Exchanges the API key through POST /get-access-token, then authenticates with a Bearer token. Hashes retrieve an existing report via GET /files/{hash}; text accepts an analysis UUID for GET /analyses/{id}. Attachments use POST /analyze once and return the receipt, without polling. max_size_mb defaults to 25 (1-100). Report status, verdict, family and privacy remain in sandbox-report objects. Attachment submissions send content to your Intezer account.
References
https://intezer-python-sdk.readthedocs.io/
Author
MISP Project
Version
1
View source for Intezer Sandbox
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
View source for IP2Location.io Lookup
Expansion

ipapi.is Lookup

ipapi_is

An expansion and hover module to enrich an IP address with geolocation, ASN, company and abuse contact data, and VPN (with the provider), proxy, Tor and datacenter detection from ipapi.is.

Module details
Module Type
expansion hover
Input
An IP address attribute (ip-src or ip-dst).
Output
geolocation and asn objects, and an ipapi-is-ip object with the detection flags, the VPN and hosting providers, the company with its abuser score, and the abuse contact.
Requirements
An ipapi.is API key (optional: without one the API returns location and network owner only, 30 requests a day)
Features
The module takes an IP address attribute as input and looks it up with the [ipapi.is API](https://ipapi.is/developers.html). It returns a geolocation object, an asn object and an ipapi-is-ip object with the detection flags that are set (VPN, proxy, Tor, datacenter, abuser, crawler, mobile, satellite and anycast), the VPN provider, the hosting provider, the organisation the address is registered to with its abuser score, and the abuse contact. The `api_key` is optional: a free ipapi.is account includes 1,000 requests a day. Without a key the API answers 30 requests a day per IP address with the location and the network owner only, without detection flags. The key is sent in the body of a POST request, never in the URL. Private and reserved addresses are not looked up.
References
https://ipapi.is/developers.html
Author
ipapi.is
Version
1
View source for ipapi.is Lookup
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
View source for IPASN-History Lookup
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
View source for IPGeolocation.io Lookup
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
View source for IPInfo.io Lookup
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
View source for IPQualityScore Lookup
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
View source for IPRep Lookup
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
View source for isMalicious Lookup
Expansion

IVRE

ivre

Retrieve active scan observations from an IVRE web API.

Module details
Module Type
expansion
Input
ip-src, ip-dst, domain, hostname MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
url is the complete HTTPS view endpoint, for example https://ivre.example/cgi/view. Sends a structured f filter (host or domain) and q=limit:N, with JSON output and string dates. Optional username/password use HTTP Basic authentication. max_results defaults to 25 (1-100). Returns domain-ip and ip-port objects for open ports, with scan context in annotations. This module performs no scans and requires the IVRE view API to be exposed.
References
https://doc.ivre.rocks/en/latest/usage/web-ui.html https://github.com/ivre/ivre/blob/master/ivre/web/app.py
Author
MISP Project
Version
1
View source for IVRE
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
View source for Joe Sandbox Import
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
View source for Joe Sandbox Import
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
View source for Joe Sandbox Submit
Export

Juniper Junos ACL Export

junos_export

Export IDS-marked network attributes as Junos inet/inet6 stateless firewall filter set commands.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded configuration fragment; rule counts, skipped counts and integration warnings.
Features
Exports validated IDS-marked event and object network attributes as deduplicated IPv4/IPv6 configuration fragments. Preserves source/destination address and port constraints. Deleted data is excluded. DNS-only attributes require opt-in resolve_dns. No device connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/junos_export.md) for configuration, logging semantics and policy integration.
References
https://www.juniper.net/documentation/us/en/software/junos/routing-policy/topics/concept/firewall-filter-overview.html
Author
MISP Project
Version
1.0
View source for Juniper Junos ACL Export
Expansion

Kaspersky Threat Intelligence Portal

kaspersky

Retrieve Kaspersky commercial Threat Intelligence Portal reports.

Module details
Module Type
expansion
Input
md5, sha1, sha256, ip-src, ip-dst, domain, hostname, url MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses Bearer authentication with GET /api/hash, /api/ip, /api/domain or /api/url and explicit report sections. url defaults to https://tip.kaspersky.com. Requires a commercial TIP key; this is separate from the public OpenTIP API. File hashes, sizes and names become file objects; DNS resolutions become domain-ip objects. Zone, license/quota and report sections are retained as provider context without changing detection flags. max_results defaults to 25 (1-100) for files and DNS resolutions.
References
https://tip.kaspersky.com/
Author
MISP Project
Version
1
View source for Kaspersky Threat Intelligence Portal
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
View source for Lamis Network Lookup
Expansion

LastInfoSec

lastinfosec

Retrieve LastInfoSec STIX 2.1 intelligence and convert it to MISP.

Module details
Module Type
expansion
Input
md5, sha1, sha256, ip-src, ip-dst, domain, hostname, url MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests misp-stix
Features
Posts {value: observable} to /stix21/search/ at url (default https://api.client.lastinfosec.com/v2). The legacy API requires api_key in query parameters; configure proxy and access-log redaction accordingly. HTTP 422 means no match. Converts all returned message bundles up to max_results (default 25, 1-100), preserving relationships and markings with misp-stix and indicating partial conversions. Requires a working legacy LastInfoSec endpoint and subscription.
References
https://api.client.lastinfosec.com/v2/
Author
MISP Project
Version
1
View source for LastInfoSec
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
View source for Lastline Import
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
View source for Lastline Lookup
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
View source for Lastline Submit
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
View source for Lite Export
Expansion

Lookyloo capture

lookyloo_capture

Enrich a Lookyloo capture link or UUID with observed resources and analysis context.

Module details
Module Type
expansion
Input
Lookyloo /tree/<uuid> link or a text attribute containing a capture UUID.
Output
lookyloo-capture, url, file, image and optional cookie objects and contact attributes.
Requirements
requests A Lookyloo instance; API key optional lookyloo-capture object template (bundled)
Features
Retrieve capture metadata, status, redirects, IPs, hostnames, URLs, SHA-512 hashes, statistics, cached module results and comparables. Optional cookies, favicons, extended JSON, MISP export and contact lookup. Links to screenshot and binary exports are returned.
References
https://lookyloo.circl.lu/doc/
Author
MISP Project
Version
1.0
View source for Lookyloo capture
Expansion

Lookyloo lookup

lookyloo

Find Lookyloo captures containing an IP, hostname, URL, resource hash or favicon hash.

Module details
Module Type
expansion
Input
IPv4/IPv6, domain, hostname, URL or SHA-512 attribute.
Output
Related lookyloo-capture objects and observed URL/file objects, with optional capture enrichment.
Requirements
requests A Lookyloo instance; API key optional lookyloo-capture object template (bundled)
Features
Pivot on existing captures using ip_info, hostname_info, url_info, hash_info and favicon_info. Optionally enrich matching captures. All new attributes use to_ids=false.
References
https://lookyloo.circl.lu/doc/
Author
MISP Project
Version
1.0
View source for Lookyloo lookup
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
View source for Macaddress.io Lookup
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
View source for macadress.com Lookup
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
View source for Macvendors Lookup
Expansion

MalBeacon

malbeacon

Retrieve MalBeacon C2 and actor infrastructure observations.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses GET /v1/c2/c2/{value} with X-Api-Key authentication. max_results defaults to 25 (1-100). Beacon records retain timestamps, provider context, tags and user agents in referenced annotations; actor IPs, hostnames and C2 domains become pivotable attributes.
References
https://malbeacon.com/
Author
MISP Project
Version
1
View source for MalBeacon
Expansion

Malpedia lookup

malpedia

Search Malpedia families and actors, or expand a sample hash or Malpedia record URL.

Module details
Module Type
expansion hover
Input
Family/actor name, alias or ID, Malpedia details/actor URL, MD5 or SHA-256 attribute.
Output
MISP malware, intrusion-set, file and optional yara objects, reference links and actor attributions.
Requirements
requests PyMISP Optional Malpedia API token; required for sample hash lookups.
Features
Query family and actor names or aliases, canonical family IDs, Malpedia record URLs, and MD5/SHA-256 hashes. Return related malware, intrusion-set and file objects with source links. Optionally fetch family YARA rules with their TLP tags. Existing MISP object templates suffice. New attributes use to_ids=false. Configure apikey, timeout (default 30 seconds), max_results (default 5, maximum 20 per collection), and include_yara (default false). No sample binaries are downloaded.
References
https://malpedia.caad.fkie.fraunhofer.de/usage/api
Author
MISP Project
Version
1.0
View source for Malpedia lookup
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
View source for MalShare Upload
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
View source for Malwagon Lookup
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
View source for Malwagon Submit
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
View source for Malware Bazaar Lookup
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
View source for Markdown to PDF converter
Action

Matrix

matrix

Send a message to an unencrypted Matrix room.

Module details
Module Type
action
Input
Workflow data or matchingData, and an optional Jinja2 message template.
Output
Boolean success; errors indicate an unsuccessful or unacknowledged send.
Requirements
requests
Features
Renders Jinja2 templates using matchingData when present, otherwise data, with a JSON fallback. Sends plain-text m.room.message events using a bot access token. The bot must already be a room member with permission to send messages. End-to-end encrypted rooms and HTML/Markdown formatting are unsupported. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/matrix.md).
References
https://spec.matrix.org/latest/client-server-api/#put_matrixclientv3roomsroomidsendeventtypetxnid
Author
MISP Project
Version
0.1
View source for Matrix
Action

Mattermost

mattermost

Simplistic module to send message to a Mattermost channel.

Module details
Module Type
action
Author
Sami Mokaddem
Version
0.1
View source for Mattermost
Expansion

Metras Enrichment

metras

Enrich file hashes and IP addresses with Metras EDR inventory and fleet context.

Module details
Module Type
expansion
Input
md5, sha1, sha256, ip-src, ip-dst MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
url defaults to https://api.metras.sa/api. Uses X-API-KEY authentication. Hash lookups query binary details (MD5) or binary inventory (SHA-1/SHA-256). IP lookups query EDR alerts and endpoint inventory. max_results defaults to 25 (1-100). Results retain binary metadata, alert context and fleet hostnames; additional pages are reported as truncated.
References
https://metras.sa/
Author
MISP Project
Version
1
View source for Metras Enrichment
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
View source for Microsoft Defender for Endpoint KQL Export
Export

MikroTik RouterOS ACL Export

mikrotik_export

Export IDS-marked network attributes as RouterOS IPv4/IPv6 firewall filter commands.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded configuration fragment; rule counts, skipped counts and integration warnings.
Features
Exports validated IDS-marked event and object network attributes as deduplicated IPv4/IPv6 configuration fragments. Preserves source/destination address and port constraints. Deleted data is excluded. DNS-only attributes require opt-in resolve_dns. No device connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/mikrotik_export.md) for configuration, logging semantics and policy integration.
References
https://help.mikrotik.com/docs/spaces/ROS/pages/48660574/Filter
Author
MISP Project
Version
1.0
View source for MikroTik RouterOS ACL Export
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
View source for MISP JSON Import
Expansion

MODAT Magnify

modat

Enrich internet infrastructure using MODAT Magnify host, service and DNS observations.

Module details
Note
Input/output attributes are computed dynamically; see source.
Module Type
expansion
Input
IPs, domains, network composites, certificate/SSH fingerprints, web hashes and CVEs.
Output
MISP objects and source JSON attachments; discovered attributes have to_ids disabled.
Requirements
requests PyMISP MODAT Magnify API key Install the bundled modat-service and modat-dns-record object templates in MISP
Features
Typed service and DNS observations linked to existing MISP infrastructure objects.
References
https://api.magnify.modat.io/docs https://magnify.modat.io/docs
Author
MISP
Version
1.0
View source for MODAT Magnify
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
View source for MWDB Submit
Export

Netfilter nftables Export

netfilter_export

Export IDS-marked event and object network attributes as nftables block or logging rules.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded nftables chain-body fragment; skipped counts and warnings in the API response.
Features
Exports validated IPv4/IPv6 addresses and networks, IP/port pairs, domain/IP pairs, ports and source MAC addresses as deduplicated nftables chain-body rules. Defaults to dropping matches; mode=log logs without changing the firewall verdict. Only to_ids attributes are included, and deleted data is excluded. DNS-only attributes require opt-in resolve_dns and are resolved to address snapshots at export time. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/netfilter_export.md).
References
https://netfilter.org/projects/nftables/ https://www.netfilter.org/projects/nftables/manpage.html
Author
MISP Project
Version
1.0
View source for Netfilter nftables Export
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
View source for Nextcloud talk
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
View source for Nexthink NXQL Export
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
View source for Ninja Template Rendering
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
View source for OCR Enrich
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
View source for OCR Import
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
View source for ODS Enrich
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
View source for ODT Enrich
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
View source for Onion Lookup
Expansion

Onyphe Full Lookup

onyphe_full

Module to process a full query on Onyphe.

Module details
Module Type
expansion hover
Input
An IP, domain, hostname, URL, CPE or X.509 fingerprint MISP attribute.
Output
MISP attributes and objects fetched from the Onyphe queries.
Requirements
pyonyphe python library, version 3.1.0 or later An access to the Onyphe API (apikey)
Features
Searches the layered ctiscan/ctiurl and flat riskscan/vulnscan/datascan models, plus legacy CTI categories. Returns observed services, endpoints, certificates and CVE identifiers with source verdicts and JSON. Subscription-denied categories are reported as partial results. Search covers 30 days by default and is bounded to 10,000 results per category. Install the bundled onyphe-service template in MISP.
References
https://www.onyphe.io/ https://github.com/onyphe/pyonyphe https://github.com/onyphe/material/tree/master/openapi
Author
Sebastien Larinier @sebdraven
Version
3
View source for Onyphe Full Lookup
Expansion

Onyphe Lookup

onyphe

Module to process a query on Onyphe.

Module details
Note
Input/output attributes are computed dynamically; see source.
Module Type
expansion hover
Input
An IP, domain, hostname, URL, CPE or X.509 fingerprint MISP attribute.
Output
MISP attributes fetched from the Onyphe query.
Requirements
pyonyphe python library, version 3.1.0 or later An access to the Onyphe API (apikey)
Features
Enriches IPs and hostnames using ctiscan Search and domains using riskscan/vulnscan Search. Uses category-specific field names and returns service observations, endpoints, certificates and CVEs. Set mode=summary to keep the legacy Summary lookup, which does not return ctiscan/ctiurl. Install the bundled onyphe-service template in MISP for Search results.
References
https://www.onyphe.io/ https://github.com/onyphe/pyonyphe https://github.com/onyphe/material/tree/master/openapi
Author
Sebastien Larinier @sebdraven
Version
4
View source for Onyphe Lookup
Export

OpenBSD PF Export

pf_export

Export IDS-marked event and object network attributes as OpenBSD PF block or logging rules.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded PF ruleset fragment; skipped counts and warnings in the API response.
Features
Exports validated IPv4/IPv6 addresses and networks, IP/port pairs, domains, hostnames, domain/IP pairs, hostname/port pairs and ports as deduplicated block drop quick rules by default, or match log (all) rules with mode=log. Logging preserves the existing pass/block policy. Only to_ids attributes are included; deleted data is excluded. DNS names are resolved by PF at ruleset load time. No network access or additional Python dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/pf_export.md).
References
https://man.openbsd.org/pf.conf https://man.openbsd.org/pfctl
Author
MISP Project
Version
1.0
View source for OpenBSD PF Export
Expansion

OpenCTI Lookup

opencti

Query an OpenCTI instance for exact observable matches and their context and source references.

Module details
Note
Input/output attributes are computed dynamically; see source.
Module Type
expansion
Input
A domain, hostname, IP address, URL, email address or file hash (including filename|hash).
Output
MISP text and link attributes with provenance and TLP tags.
Requirements
requests An OpenCTI instance and an API token with knowledge read access.
Features
Read-only GraphQL lookup using OpenCTI's FilterGroup API (OpenCTI 5.12 or later). Set url to the instance base URL (optionally ending in /graphql) and token to its API token. max_results defaults to 20 (1-100) and timeout to 30 seconds (1-120). Domains and IPs are normalized; file hashes, including filename|hash attributes, are matched against the specific hash algorithm. Results contain text context (description, score, author, labels, markings and timestamps), links to OpenCTI and external references. Imported attributes have to_ids=false; TLP markings are retained as tags and other markings as text. Custom markings and OpenCTI access controls are not translated into MISP sharing restrictions. No data is written to OpenCTI and no relationship traversal or synchronization is performed. A result cap notice is returned when more matches are available. No matches produce an empty Attribute list.
References
https://docs.opencti.io/latest/reference/api/
Author
MISP Project
Version
1
View source for OpenCTI Lookup
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
View source for OpenIOC Import
Expansion

Orange Cyberdefense Datalake

orange_cyberdefense

Look up indicators in the Orange Cyberdefense Datalake API.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst, url, md5, sha1, sha256, email-src, email-dst MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Queries the documented v3/mrti/threats/lookup endpoint using a long-term token in the Authorization header and requests JSON. IPs, domains and hashes are normalized before exact lookup. Scores, whitelisting, classifications, source evidence and other returned context remain in a referenced annotation; scores do not automatically change MISP IDS flags.
References
https://datalake.cert.orangecyberdefense.com/ https://github.com/cert-orangecyberdefense/datalake
Author
MISP Project
Version
1
View source for Orange Cyberdefense Datalake
Expansion

Orion Malware

orion_malware

Retrieve existing Orion Malware reports by file hash.

Module details
Module Type
expansion
Input
md5, sha1, sha256 MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Set url to the Orion Malware HTTPS server. Uses apikey header authentication and POST /orion/api/v4.0/search with an exact hash, then GET /orion/api/v4.0/filereports/{id}. max_results defaults to 25 (1-100). Returns full report context and report links; samples are not uploaded and incomplete jobs are not polled.
References
https://orion-malware.com/
Author
MISP Project
Version
1
View source for Orion Malware
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
View source for OSINT DigitalSide
Expansion

OSINT Industries

osint_industries

Find OSINT Industries account and identity context for an email, phone, username or wallet.

Module details
Module Type
expansion
Input
email-src, email-dst, phone-number, github-username, btc MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses POST /v2/request with api-key header authentication, exact_match=true and premium lookups disabled. Username attributes query the username selector; BTC addresses query wallet. max_results defaults to 25 (1-100). Module-level results retain provenance in annotations; registered accounts become user-account objects and valid profile URLs become links. Lookups can consume API credits.
References
https://docs.osint.industries/
Author
MISP Project
Version
1
View source for OSINT Industries
Export

OSQuery Export

osqueryexport

Export MISP event and object indicators as an osquery query pack.

Module details
Module Type
export
Input
MISP events and object attributes.
Output
Base64-encoded JSON query pack (default) or SQL text, with counts and provenance.
Features
Produces a JSON query pack with per-query platform selectors and intervals. Validated against osquery 5.24.0. Defaults to IDS-marked attributes, includes object attributes and excludes deleted data. File scans require an explicit scan_path. Set format=sql for legacy SQL text. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/osqueryexport.md).
References
https://osquery.readthedocs.io/en/stable/deployment/configuration/
Author
Julien Bachmann, Hacknowledge; MISP Project
Version
2.0
View source for OSQuery Export
Action

OSQuery Pack Publish

osquery_pack_publish

Publish a MISP query pack to a configured local osquery pack directory.

Module details
Module Type
action
Input
Selected MISP events and object attributes in workflow data.
Output
Publication status, pack content, counts, provenance and content SHA-256.
Requirements
OSQUERY_PACK_DIRECTORY on the module server; filesystem pack distribution and config reload
Features
Atomically publishes a named pack under OSQUERY_PACK_DIRECTORY. Defaults to dry run; existing packs require explicit overwrite. Reuses the export's platform selectors, IDS filtering and bounded scan paths. Publication does not execute queries or reload osquery. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/osquery_pack_publish.md).
References
https://osquery.readthedocs.io/en/stable/deployment/configuration/#query-packs
Author
MISP Project
Version
1.0
View source for OSQuery Pack Publish
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
View source for OTI Labs Domain Intelligence
Export

OWASP CRS Export

owasp_crs_export

Export IDS-marked proxy and HTTP indicators as custom ModSecurity rules alongside OWASP CRS.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded ModSecurity .conf fragment; skipped counts and integration warnings in the response.
Features
Exports validated source addresses/networks, source address/port pairs, domains, hostnames, hostname/port pairs, HTTP(S) URLs, request URIs and user agents. Only to_ids attributes are included; deleted data is excluded. Produces deterministic, deduplicated phase 1 deny rules with configurable local rule IDs. No network access or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/owasp_crs_export.md).
References
https://coreruleset.org/ https://github.com/owasp-modsecurity/ModSecurity/wiki/Reference-Manual-(v2.x)
Author
MISP Project
Version
1.0
View source for OWASP CRS Export
Export

Palo Alto PAN-OS ACL Export

panos_export

Export IDS-marked network attributes as PAN-OS local security policy set commands.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded configuration fragment; rule counts, skipped counts and integration warnings.
Features
Exports validated IDS-marked event and object network attributes as deduplicated IPv4/IPv6 configuration fragments. Preserves source/destination address and port constraints. Deleted data is excluded. DNS-only attributes require opt-in resolve_dns. No device connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/panos_export.md) for configuration, logging semantics and policy integration.
References
https://docs.paloaltonetworks.com/pan-os/11-1/pan-os-cli-quick-start
Author
MISP Project
Version
1.0
View source for Palo Alto PAN-OS ACL Export
Expansion

Palo Alto WildFire

paloalto_wildfire

Retrieve WildFire verdicts and XML reports, or submit an attachment for analysis.

Module details
Module Type
expansion
Input
md5, sha256, attachment MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
url defaults to https://wildfire.paloaltonetworks.com/publicapi and can select a regional cloud or appliance. Hashes query get/verdict and get/report; unknown (-102) and pending (-100) verdicts remain distinct from benign verdicts. Attachment inputs submit raw base64-decoded bytes to submit/file and return the sample hash for a subsequent lookup. max_size_mb defaults to 25 (1-100). No polling or automatic resubmission is performed.
References
https://docs.paloaltonetworks.com/wildfire/u-v/wildfire-api
Author
MISP Project
Version
1
View source for Palo Alto WildFire
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
View source for Passive SSH Enrichment
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
View source for PassiveTotal Lookup
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
View source for PDF Enrich
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
View source for PDNS COF Importer
Expansion

PGP Keyserver

pgp_keyserver

Pivot on OpenPGP key IDs, fingerprints, email addresses and UIDs using an HKP keyserver.

Module details
Module Type
expansion hover
Input
A text attribute containing a key ID, fingerprint or UID, or an email attribute.
Output
Linked pgp-key and pgp-meta objects, optional pgp-sign objects, and the original attribute.
Requirements
requests PyMISP Install the pgp-key and pgp-message object templates in MISP Install pgp-sign in MISP when extract_signatures is enabled
Features
Query the machine-readable HKP index, using https://pgp.circl.lu by default. Return one pgp-key object per result and a pgp-meta object referencing it with extracted-from. Preserve complete UIDs, names, emails, key IDs, fingerprints, dates and server flags. Fetch ASCII-armored public keys by full fingerprint only. Search and retrieval are bounded; individual retrieval failures retain index metadata with an object comment. Keyserver UIDs and flags are unverified claims; signatures and ownership are not validated. pgp-message is provided for message artifacts linked to pgp-meta; this module does not retrieve or decrypt messages. Configuration: keyserver, timeout (default 10 seconds per HTTP request), max_results (default 10, maximum 100). New object templates are bundled for older PyMISP versions. Enable extract_signatures to return pgp-sign objects with the original signature packets, issuer IDs and fingerprints, signature metadata and UID/subkey context. max_signatures limits signature objects across the lookup (default 100, maximum 1000). Issuer claims are preserved without verification.
References
https://pgp.circl.lu https://www.ietf.org/archive/id/draft-shaw-openpgp-hkp-00.html
Author
MISP Project
Version
1.1
View source for PGP Keyserver
Expansion

phishunt Lookup

phishunt

Look up a host in phishunt (phishunt.io), the free CC0 feed of live phishing domains: the phishing URLs detected on that exact host, the brand they target, when they were first seen, where they are hosted and which other feeds flag them.

Module details
Module Type
expansion hover
Input
A domain, hostname or URL attribute.
Output
phishing objects with the detected URLs, hostname, IP, targeted brand and first seen time, and a link attribute to the phishunt search page.
Requirements
No API key required.
Features
The module takes a domain, hostname or URL attribute (for a URL only the host is used) and queries the phishunt search API for it. The API does a substring match, so only the rows whose host is exactly the queried one are kept. Matches come back as phishing objects (URL, hostname, IP, targeted brand, first seen time) with hosting, TLS issuer, provider IP range and the other feeds that flag the same URL (OpenPhish, PhishTank, urlscan.io, Google Safe Browsing, TweetFeed) in the object comment, plus a link to the phishunt search page. At most 25 objects are returned. Only the read-only search endpoint is used: the phishunt analyze endpoints, which would submit the value for analysis, are never called. Detections are automated and can contain false positives, so no MISP tag or confidence score is set from them.
References
https://phishunt.io https://phishunt.io/api/ https://phishunt.io/openapi.yaml
Author
Daniel López
Version
1
View source for phishunt Lookup
Expansion

PolySwarm Enrichment

polyswarm

Retrieve PolySwarm sample reputation, engine verdicts and file metadata.

Module details
Module Type
expansion
Input
md5, sha1, sha256 MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Queries the v3 search/hash endpoint using the Authorization header. community defaults to default; max_results defaults to 25 (1-100). Validates the requested hash against each result, returns file objects and full scan context, and reports truncation. PolyScore zero and benign engine results are retained. No samples are uploaded or rescanned.
References
https://docs.polyswarm.io/
Author
MISP Project
Version
1
View source for PolySwarm Enrichment
Expansion

PolySwarm Sandbox

polyswarm_sandbox

Retrieve PolySwarm sandbox tasks or submit an existing PolySwarm sample for sandbox analysis.

Module details
Module Type
expansion
Input
sha256, text MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
mode defaults to lookup: SHA-256 inputs retrieve the latest sandbox task; text inputs retrieve a task by ID. provider defaults to triage. mode=submit submits a SHA-256 already present in PolySwarm using its scan instance ID and requires provider and vm. community defaults to default. Task status, report and provenance are returned without polling. Submission can consume service credits; no file is downloaded or uploaded.
References
https://docs.polyswarm.io/
Author
MISP Project
Version
1
View source for PolySwarm Sandbox
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
View source for PPTX Enrich
Expansion

Proofpoint ET Intelligence

proofpoint_et_intelligence

Enrich domains, IPv4 addresses and MD5 hashes using Proofpoint ET Intelligence.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst, md5 MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Uses the v1 API with Authorization header authentication. IP and domain queries return reputation plus passive DNS pivots; MD5 queries return sample details. IPv6 is rejected before querying because the service contract is IPv4. max_results defaults to 25 (1-100). Reputation scores are retained as context, including score zero, and do not change source IDS flags.
References
https://eti.emergingthreats.net/
Author
MISP Project
Version
1
View source for Proofpoint ET Intelligence
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
View source for PTR Classification
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
View source for Qintel QSentry Lookup
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
View source for QR Code Decode
Export

QRadar Reference Set Export

qradar_reference_set_export

Export deduplicated, typed MISP indicators as QRadar reference-set CSV or JSON values.

Module details
Module Type
export
Input
MISP events, including object attributes, in standard, bare or legacy format.
Output
Base64-encoded UTF-8 CSV or JSON; counts and provenance are returned separately from the file.
Features
Exports one selected indicator type from supplied event and object attributes, with validation, normalization and deduplication. Produces a headerless single-column CSV for Reference Set Management, or a JSON value array. Defaults to IDS-marked IPv4 addresses; IPv6 uses a separate text set. No QRadar connection is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/qradar_reference_set_export.md).
References
https://www.ibm.com/docs/en/qradar-on-cloud?topic=overview-importing-iocs-reference-set
Author
MISP Project
Version
1.0
View source for QRadar Reference Set Export
Action

QRadar Reference Set Publish

qradar_reference_set_publish

Publish typed MISP indicators to an existing QRadar reference set and explicit domain.

Module details
Module Type
action
Input
Selected MISP events and object attributes in workflow data.
Output
Counts and per-value created, updated, planned or failed outcomes with MISP provenance.
Requirements
requests QRadar API 20.0 and an authorized service token with reference-data access
Features
Adds or refreshes IDS-marked event and object indicators through reference_data_collections/set_entries. Requires an existing reference-set ID and explicit domain ID, validates the target entry type and checks each write acknowledgement. Supports credential-free dry runs and reports partial failures. Set expiry remains controlled by QRadar. Credentials come from the module server environment. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/qradar_reference_set_publish.md).
References
https://ibmsecuritydocs.github.io/qradar_api_20.0/20.0--reference_data_collections-set_entries-POST.html https://ibmsecuritydocs.github.io/qradar_api_20.0/20.0--reference_data_collections-sets-id-GET.html
Author
MISP Project
Version
1.0
View source for QRadar Reference Set Publish
Expansion

Qualys CVE Enrichment

qualys_cve

Retrieve Qualys KnowledgeBase vulnerability details for a CVE identifier.

Module details
Module Type
expansion
Input
vulnerability MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
Set url to the HTTPS API URL for your Qualys platform. Uses Basic authentication and GET /api/4.0/fo/knowledge_base/vuln/ with action=list, details=All and the cve filter. max_results defaults to 25 (1-100). All matching QIDs retain title, diagnosis, solution, severity and CVSS data. Only entries explicitly containing the requested CVE are imported. Does not query customer host inventories.
References
https://docs.qualys.com/en/vm/api/
Author
MISP Project
Version
1
View source for Qualys CVE Enrichment
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
View source for RandomcoinDB Lookup
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
View source for RansomLook Lookup
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
View source for Rapid7 AttackerKB lookup
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. A hostname, subdomain or URL host is looked up at its registered domain (ICANN section of the Public Suffix List), and the object's comment says so.
References
https://about.rdap.org/ https://rdap.org/
Author
Ali Bhutto
Version
2
View source for RDAP Lookup
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
One reputation object per Real-time Blackhost List the IP address is listed on.
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. Each list that answers produces a reputation object naming the zone and carrying its TXT record.
References
[RBLs list](https://github.com/MISP/misp-modules/blob/8817de476572a10a9c9d03258ec81ca70f3d926d/misp_modules/modules/expansion/rbl.py#L20)
Author
Christian Studer
Version
0.3
View source for Real-time Blackhost Lists Lookup
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
View source for Recorded Future Enrich
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
A dns-record object holding the PTR records the input resolves to.
Requirements
DNS python library
Features
The module takes an IP address as input and tries to find the hostnames this IP address is resolved into, returned as a dns-record object. 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.2
View source for Reverse DNS
Expansion

ReversingLabs Malware Presence

reversinglabs_malware_presence

Retrieve ReversingLabs file reputation and malware presence.

Module details
Module Type
expansion
Input
md5, sha1, sha256 MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
url defaults to https://data.reversinglabs.com. Uses Basic authentication against the documented malware_presence/query/{hash-type}/{hash} endpoint, requesting extended context and sample hashes. UNKNOWN, KNOWN, SUSPICIOUS and MALICIOUS remain distinct service classifications; UNKNOWN is not interpreted as benign. Query hashes are validated against the response.
References
https://docs.reversinglabs.com/SpectraIntelligence/API/
Author
MISP Project
Version
1
View source for ReversingLabs Malware Presence
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
View source for ReversingLabs Spectra Analyze
Expansion

ReversingLabs Spectra Intelligence Submission

reversinglabs_spectra_intel_submission

Submit a file hash, URL or attachment to ReversingLabs Spectra Intelligence dynamic analysis.

Module details
Module Type
expansion
Input
md5, sha1, sha256, url, attachment MISP attribute.
Output
Referenced enrichment objects and pivotable attributes.
Requirements
requests
Features
url defaults to https://data.reversinglabs.com; platform defaults to windows10. Uses Basic authentication. mode=submit (default) submits an existing cloud sample by hash or a URL; attachments are uploaded to /api/spex/upload/{sha1} before detonation. max_size_mb defaults to 25 (1-100). mode=report retrieves the latest completed report by hash or URL. The returned analysis receipt can be pending; no polling or retries create duplicate submissions. Submission may consume service credits.
References
https://docs.reversinglabs.com/SpectraIntelligence/API/
Author
MISP Project
Version
1
View source for ReversingLabs Spectra Intelligence Submission
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
View source for RST Cloud Cobalt Strike Beacon
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
View source for RST Cloud Favicon
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
View source for RST Cloud HTML Fetcher
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
View source for RST Cloud IoC Lookup
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
View source for RST Cloud Noise Control
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
View source for RST Cloud Screenshot
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
View source for RST Cloud SSL Certificate
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
View source for RST Cloud Whois
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
View source for Rulezet Rule Validator
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
View source for ScanMalware Lookup
Expansion

SecurityTrails Lookup

securitytrails

An expansion modules for SecurityTrails.

Module details
Module Type
expansion hover
Input
A domain, hostname or IP address attribute.
Output
passive-dns, whois and domain-ip objects describing what SecurityTrails knows about the input.
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. The current and historical DNS records are returned as passive-dns objects carrying the dates SecurityTrails saw them, the registration data as whois objects, and the domains hosted on an IP address as domain-ip objects.
References
https://securitytrails.com/
Author
Sebastien Larinier @sebdraven
Version
2
View source for SecurityTrails Lookup
Action

SentinelOne IOC Publish

sentinelone_ioc_publish

Publish MISP event and object indicators to SentinelOne Threat Intelligence with explicit scope.

Module details
Module Type
action
Input
MISP events in standard, bare or legacy format, supplied in workflow data.
Output
Per-indicator publication outcomes and counts; errors signal incomplete publication.
Requirements
requests SentinelOne Threat Intelligence.view and Threat Intelligence.manage permissions
Features
Publishes IDS-marked hashes, domains, URLs and IP addresses from supplied events and objects. Requires account or site scope, uses stable external IDs, checks existing records, and supports expiry and dry runs. Existing records are not changed or deleted. Credentials and console URL come from the module server environment. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/sentinelone_ioc_publish.md).
References
https://github.com/Sentinel-One/ai-siem/blob/main/plugins/s1-secops-skills/skills/mgmt-console-api/references/tags/Threat_Intelligence.md
Author
MISP Project
Version
1.0
View source for SentinelOne IOC Publish
Expansion

ShadowTrackr

shadowtrackr

Enrich IP addresses with ShadowTrackr false-positive and infrastructure context.

Module details
Module Type
expansion
Input
ip-src, ip-dst MISP attribute.
Output
A referenced annotation containing IP intelligence.
Requirements
requests
Features
Posts JSON to /api/v3/ip_info for IPv4 or IPv6; the API key stays out of the URL. Existing attribute tags are sent as labels. Returns the false_positive_estimate, provider details and VPN/CDN/cloud/bogon/Tor/public-DNS flags in a referenced annotation. Scores are reported without changing MISP decay scores or IDS flags.
References
https://shadowtrackr.com/docs_v3/5-API
Author
MISP Project
Version
1
View source for ShadowTrackr
Expansion

Sherlock Lookup

sherlock

Find social media accounts by username with Sherlock.

Module details
Module Type
expansion hover
Input
A target-user, github-username, text, or email attribute. A leading @ on a username is removed.
Output
One user-account object per match, with username, platform, profile link and a reference to the input.
Requirements
Install the sherlock-project CLI separately (for example: pipx install sherlock-project). No API key required.
Features
Runs the Sherlock CLI and returns user-account objects for claimed usernames only. Text is searched as a single literal username, without extracting names or generating variants. Email input uses the local part before @ as a candidate username; matches do not verify email ownership or identity. Install Sherlock for the misp-modules service user and put sherlock on its PATH, or set sherlock_path to the executable's absolute path (not a shell command). Optional sites is a comma-separated list of Sherlock site names; github-username defaults to GitHub only. timeout is the per-site timeout in seconds (default 10); scan_timeout bounds the whole process (default 120). Both must be positive finite numbers. Keep scan_timeout below the MISP enrichment and module-server request timeouts, or raise those timeouts for broad searches. Sherlock contacts the selected sites and downloads its current site definitions. Results can contain false positives and should be reviewed.
References
https://github.com/sherlock-project/sherlock https://sherlockproject.xyz/usage
Author
MISP Project
Version
1.0
View source for Sherlock Lookup
Expansion

Shodan InternetDB

shodan_internetdb

Look up exposed services, hostnames, CPEs and vulnerabilities in the free Shodan InternetDB API.

Module details
Module Type
expansion
Input
ip-src, ip-dst MISP attribute.
Output
An ip-port object and hostname, CPE and vulnerability attributes.
Requirements
requests
Features
No API key is required. Supports IPv4 and IPv6. A 404 means no information is available. Hostnames and vulnerabilities are pivotable attributes; ports are grouped in an ip-port object. Service tags are retained as context, without automatically tagging the source as malicious.
References
https://internetdb.shodan.io/
Author
MISP Project
Version
1
View source for Shodan InternetDB
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
View source for Shodan Lookup
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
View source for Sigma Rule Converter
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
View source for Sigma Syntax Validator
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
View source for SigMF Expansion
Expansion

Silent Push Enrichment

silentpush

Retrieve domain and IP risk and infrastructure context from Silent Push.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst, url MISP attribute.
Output
A context annotation and related ASN and hostname attributes.
Requirements
requests
Features
Uses the documented enrich endpoint with x-api-key authentication. URL inputs query only the hostname. IPv4 and IPv6 use their respective endpoints. Risk scores and flags remain in a referenced annotation; AS numbers, reverse DNS and nameservers become pivotable attributes. Does not submit or scan URLs.
References
https://help.silentpush.com/docs/get-enrichment-data
Author
MISP Project
Version
1
View source for Silent Push Enrichment
Action

Slack

slack

Simplistic module to send messages to a Slack channel.

Module details
Module Type
action
Author
goodlandsecurity
Version
0.1
View source for Slack
Expansion

SoChain

sochain

Get the balance, activity, counterparties and address poisoning findings of a BTC, LTC, DOGE or ZEC address from SoChain.

Module details
Module Type
expansion hover
Input
A btc attribute, or a coin-address object with a BTC, LTC, DOGE or ZEC address.
Output
coin-address objects: the address, its recent counterparties and any look-alike addresses.
Requirements
requests PyMISP
Features
Query the SoChain API v3 for a btc attribute or a coin-address object. A btc attribute is looked up on Bitcoin. A coin-address object is looked up on the network named by its symbol (BTC, LTC, DOGE or ZEC); without a symbol, the network is the first of Bitcoin, Litecoin, Dogecoin and Zcash on which SoChain says the address is valid. The result is a coin-address object with the balance, total received and sent, the number of transactions and the first and last activity, referencing the input. Recent counterparties are returned as coin-address objects linked with `paid` references (5 on hover, 50 when the magnifying glass is clicked), whose comments give the amount, transaction and block. When look-alike addresses sent the address dust to poison its history, each one is returned as a coin-address object that `impersonates` the address it copies. No API key is needed for up to 2,500 lookups a day per IP. With a key from https://sochain.com/dashboard, lookups count against that account's plan.
References
https://sochain.com/docs https://sochain.com/api/v3/openapi.json
Author
Atif Nazir
Version
1.0
View source for SoChain
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
One user-account object per online platform the email address or username has an account on.
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
2
View source for Socialscan Lookup
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
View source for SOCRadar TAXII Feed Import
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
View source for SOCRadar Threat Intelligence
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
View source for SophosLabs Intelix Lookup
Expansion

SpamCop Lookup

spamcop

Check an IPv4 address against the SpamCop Blocking List (SCBL).

Module details
Module Type
expansion hover
Input
An ip-src or ip-dst attribute containing an IPv4 address.
Output
A reputation object describing a SpamCop listing and referencing the original IP attribute.
Requirements
dnspython
Features
Queries bl.spamcop.net using the reversed IPv4 address and accepts the documented 127.0.0.2 A record as a listing. A positive result produces a suspicious reputation object linked to the input attribute, with a SpamCop lookup URL. An address that is not listed produces an informational error, not a benign verdict. DNS failures and unexpected response codes are reported separately. No API key is required. The optional timeout setting is a positive number of seconds (default: 5). IPv6 addresses are not supported.
References
https://www.spamcop.net/fom-serve/cache/351.html https://www.spamcop.net/fom-serve/cache/291.html
Author
MISP Project
Version
0.1
View source for SpamCop Lookup
Export

Splunk Lookup Export

splunk_export

Export event and object indicators as a Splunk CSV lookup with CIM field mapping hints.

Module details
Module Type
export
Input
A list of MISP events in standard or legacy export format.
Output
Base64-encoded UTF-8 CSV lookup; optional warnings describe skipped indicators.
Features
Exports attributes from every supplied event, including object attributes, to a UTF-8 CSV lookup. Only attributes marked to_ids are included by default; set include_non_ids to true to include other attributes. Deleted attributes and objects are always excluded. Composite attributes are split into independent hunting pivots while retaining the original value, port, UUIDs and object context. Event, object and attribute tags are combined in a JSON array. Unsupported or malformed indicators are counted in the API response warnings. No Splunk connection or additional Python package is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/splunk_export.md) for supported types, lookup setup and bounded SPL examples.
References
https://help.splunk.com/en/splunk-enterprise/search/spl-search-reference/9.4/search-commands/lookup https://help.splunk.com/en/data-management/common-information-model/6.0/overview/overview-of-the-splunk-common-information-model
Author
MISP Project
Version
1.0
View source for Splunk Lookup Export
Export

Squid Proxy Export

squid_export

Export IDS-marked event and object attributes as Squid proxy ACLs and deny rules.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded Squid .conf fragment; skipped counts and integration warnings in the API response.
Features
Exports validated addresses/networks, domains, hostnames, HTTP(S) URLs and destination ports as deduplicated Squid ACLs with http_access deny rules. Composite attributes retain their constraints. Only to_ids attributes are included; deleted data is excluded. No network access or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/squid_export.md).
References
https://www.squid-cache.org/Doc/config/acl/ https://www.squid-cache.org/Doc/config/http_access/
Author
MISP Project
Version
1.0
View source for Squid Proxy Export
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
View source for SSH Fingerprint
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
View source for Stairwell Lookup
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
View source for STIX2 Pattern Syntax Validator
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
View source for TAXII 2.1 Import
Expansion

Team Cymru Scout

team_cymru_scout

Retrieve Scout foundation intelligence for an IP address or search for a domain.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst MISP attribute.
Output
MISP attributes, objects and tags converted from Scout STIX intelligence.
Requirements
requests misp-stix (included in the all extra)
Features
Uses Bearer authentication against /ip/foundation?ips= for IPv4/IPv6 or /search?query= for domains. Returned STIX 2 bundles are converted using misp-stix, preserving relationships, source context and markings. No data is submitted to an analysis queue. Install the all dependency extra for misp-stix support.
References
https://scout.cymru.com/
Author
MISP Project
Version
1
View source for Team Cymru Scout
Expansion

Team Cymru Scout Search

team_cymru_scout_search

Run an explicit Scout search query and import the returned intelligence.

Module details
Module Type
expansion
Input
text MISP attribute.
Output
MISP attributes, objects and tags converted from Scout search results.
Requirements
requests misp-stix (included in the all extra)
Features
The text attribute is used verbatim as Scout search syntax; no MISP or STIX pattern is inferred. Uses GET /search with query and days parameters. days defaults to 7 (1-90). STIX 2 results are converted by misp-stix, preserving relationships, source context and markings. Install the all dependency extra for misp-stix support.
References
https://scout.cymru.com/
Author
MISP Project
Version
1
View source for Team Cymru Scout Search
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
View source for Test action
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
View source for ThreadAnalyzer Sandbox Import
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
View source for ThreadConnect Export
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
View source for ThreadFox Lookup
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
View source for ThreatCrowd Lookup
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
View source for ThreatMiner Lookup
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
View source for ThreatStream Export
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
View source for TLS Certificate Check
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
View source for Triage Submit
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
View source for TruSTAR Enrich
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
View source for TweetFeed Lookup
Expansion

UnpacMe Lookup

unpac_me

Find existing UnpacMe unpacking results for a SHA-256 hash.

Module details
Module Type
expansion
Input
sha256 MISP attribute.
Output
Submission annotations and unpacked-child file objects.
Requirements
requests
Features
Queries /api/v1/private/search/hash using Key authentication. max_results defaults to 25 (1-100). Each matching submission becomes a referenced annotation with its status, submission ID and timestamps. Unpacked child hashes become file objects linked to the original hash. Does not upload or download samples or wait for incomplete jobs. Result truncation is explicitly reported.
References
https://api.unpac.me/
Author
MISP Project
Version
1
View source for UnpacMe Lookup
Expansion

URL Archiver

sourcecache

Module to cache web pages of analysis reports, OSINT sources. The module returns a page-capture object holding the cached page.

Module details
Module Type
expansion
Input
A link or url attribute.
Output
A page-capture object holding 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 a page-capture object holding the cached page, the URL it was fetched from and the date of the capture.
References
https://github.com/adulau/url_archiver
Author
Alexandre Dulaunoy
Version
0.2
View source for URL Archiver
Expansion

URL DNS and ASN Expansion

url_dns

Resolve URL hosts into IPv4/IPv6 IP-port objects and IPv4 ASN objects.

Module details
Module Type
expansion
Input
A URL attribute with type, value and UUID.
Output
Linked ip-port objects for IPv4/IPv6 and asn objects for public IPv4 addresses.
Requirements
dnspython PyMISP
Features
Resolve all A and AAAA records, create one TCP ip-port object per address, and query Team Cymru DNS for IPv4 origin ASNs. Explicit ports override HTTP/HTTPS defaults. Every object references the original URL attribute. ASN failures preserve endpoint results with an explanatory comment.
References
https://www.team-cymru.com/ip-asn-mapping
Author
MISP
Version
1.0
View source for URL DNS and ASN Expansion
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
View source for URL Import
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
View source for URLhaus Lookup
Expansion

URLScan Lookup

urlscan

An expansion module to query urlscan.io.

Module details
Module Type
expansion
Input
A domain, hostname or url attribute.
Output
url, domain-ip, geolocation, asn, x509, image and reputation objects describing the scan.
Requirements
An access to the urlscan.io API
Features
This module takes a MISP attribute as input and queries urlscan.io with it. The scan result is returned as the objects it describes - the url and the domain-ip it resolved to, where it is hosted, the certificate it presented, the screenshot urlscan took and any verdict against it - rather than as a flat list of attributes that drops the relationships between them.
References
https://urlscan.io/
Author
Dave Johnson
Version
0.2
View source for URLScan Lookup
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
View source for Validin DNS History
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
View source for VARIoT db Lookup
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
View source for VirusTotal Collections Export
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
View source for VirusTotal Graph Export
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
View source for VirusTotal Public API Lookup
Expansion

VirusTotal Sample Downloader

virustotal_downloader

Download an existing file from VirusTotal by hash.

Module details
Module Type
expansion
Input
md5, sha1, sha256 MISP attribute.
Output
A file object with a binary attachment and verified hashes.
Requirements
requests
Features
Requires a VirusTotal API key with file download entitlement. Uses GET /api/v3/files/{hash}/download. Streams at most max_size_mb (default 50, range 1-100) and verifies the downloaded file against the requested hash. Signed HTTPS redirects are followed without forwarding the API key. Returns raw bytes as a MISP attachment in a file object with MD5, SHA-1 and SHA-256 hashes; no sample is executed or submitted.
References
https://docs.virustotal.com/reference/files-download
Author
MISP Project
Version
1
View source for VirusTotal Sample Downloader
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
View source for VirusTotal Upload
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
View source for VirusTotal v3 Lookup
Expansion

VMRay Analyzer Lookup

vmray_analyzer

Retrieve existing VMRay sample and analysis context by file hash.

Module details
Module Type
expansion
Input
md5, sha1, sha256 MISP attribute.
Output
File objects, report links and referenced analysis annotations.
Requirements
requests
Features
Set url to the HTTPS VMRay server URL and apikey to its API key. Queries /rest/sample/{hash-type}/{hash}, followed by /rest/analysis/sample/{sample_id}. Returns sample hashes, names, classifications, threat names, score, analysis status and report links. max_results defaults to 25 (1-100) for samples and analyses; continuation pages are reported as truncated. This lookup does not submit samples or wait for pending analyses. For full artifact import, use the VMRay import module.
References
https://www.vmray.com/
Author
MISP Project
Version
1
View source for VMRay Analyzer Lookup
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
View source for VMRay API Import
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
View source for VMRay Submit
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
View source for VMware NSX Defender Enrich
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
View source for VulnDB Lookup
Expansion

Vulnerability Lookup

vulnerability_lookup

Expand vulnerabilities and CPEs with Vulnerability Lookup advisories and enrichment

Module details
Module Type
expansion hover
Input
Vulnerability or CPE attribute
Output
Vulnerability, weakness, annotation, sighting, EPSS and KEV objects. Relationships are included in each object's ObjectReference list and in a deduplicated results.ObjectReference list, with source and target UUIDs and relationship types.
Requirements
requests pymisp
Features
Query vulnerability identifiers or CPEs. Import linked advisories, comments, bundles, sightings, storage metadata, EPSS scores and known-exploited assertions as related MISP content. Enable with_timeline to include dated milestones as an annotation. api_url defaults to https://vulnerability.circl.lu (instance root, without /api). timeout defaults to 30 seconds per request (maximum 120). max_related defaults to 50 (0-100): it bounds alias lookup attempts, CPE results and each enrichment section. with_linked, with_comments, with_bundles, with_sightings, with_meta, with_epss and with_kev default to true; with_timeline defaults to false. Boolean options accept true/false or their string equivalents. Unset options (null or blank strings from MISP) use their documented defaults. The request's top-level timeout limits total module execution independently of config.timeout. CPE lookup uses cpe_source (default cvelistv5) and cpe_page (default 1). Results match vendor and product; exact version applicability must be checked. CPE search imports advisories from one bounded page; the optional community and priority lookups apply to vulnerability ID input. Original advisory JSON is retained as a base64 payload; community, EPSS and KEV records retain JSON attachments. Unavailable optional data does not discard the advisory. The companion vulnerability-sighting, epss-score and known-exploited-vulnerability templates are bundled for compatibility with existing PyMISP releases.
References
https://vulnerability.circl.lu https://vulnerability.circl.lu/api/swagger.json
Author
Christian Studer
Version
4
View source for Vulnerability Lookup
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
A vulnerability object, one exploit object per public exploit, and the Vulners AI score.
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, the public exploits Vulners knows about, and the Vulners AI score.
References
https://vulners.com/
Author
Igor Ivanov
Version
0.3
View source for Vulners Lookup
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
View source for Vysion Enrich
Export

Wazuh CDB Export

wazuh_cdb_export

Export MISP event and object indicators as a typed Wazuh CDB source list.

Module details
Module Type
export
Input
MISP events, including object attributes, in standard, bare or legacy format.
Output
Base64-encoded CDB source text, with counts, warnings and provenance outside the file.
Features
Produces a sorted, deduplicated key-only CDB list for one indicator type: IPv4, IPv6, domain, MD5, SHA-1, SHA-256 or SHA-512. Defaults to to_ids IPv4 attributes. Includes object attributes, normalizes values, quotes IPv6 keys and excludes deleted data. No Wazuh connection is needed. Register the list and reload analysisd through the Wazuh API to activate detection. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/wazuh_cdb_export.md).
References
https://documentation.wazuh.com/current/user-manual/ruleset/cdb-list.html
Author
MISP Project
Version
1.0
View source for Wazuh CDB Export
Action

Wazuh CDB Publish

wazuh_cdb_publish

Upload MISP event and object indicators to an explicitly named Wazuh CDB source list.

Module details
Module Type
action
Input
Selected MISP events and object attributes in workflow data.
Output
Upload and reload status, selected filename, indicator counts, content SHA-256 and activation notice.
Requirements
requests Wazuh server API credentials with lists:update and lists:delete permissions Optional reload: manager:read/manager:restart or cluster:read/cluster:restart permissions
Features
Uploads one typed, deduplicated list of to_ids indicators using PUT /lists/files/{filename}. Credentials come from the module server environment. Supports a credential-free dry run and explicit overwrite; overwrite replaces the entire list with the supplied snapshot. Checks the Wazuh acknowledgement, refuses empty lists and optionally requests an analysisd reload on the manager or cluster without a full manager restart. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/action_mod/wazuh_cdb_publish.md).
References
https://documentation.wazuh.com/current/user-manual/api/reference.html#tag/Lists https://documentation.wazuh.com/current/user-manual/api/reference.html#tag/Manager https://documentation.wazuh.com/current/user-manual/api/reference.html#tag/Cluster https://documentation.wazuh.com/current/user-manual/ruleset/cdb-list.html
Author
MISP Project
Version
1.0
View source for Wazuh CDB Publish
Expansion

Webarchive (Wayback Machine)

webarchive

Query the Internet Archive Wayback Machine for an existing web page snapshot.

Module details
Module Type
expansion
Input
A url, link, domain or hostname attribute with type, value and UUID.
Output
A page-capture object linked to the original attribute, with to_ids=false on generated attributes.
Requirements
requests PyMISP
Features
Query the Wayback Availability API for the latest accessible snapshot, or the snapshot closest to an optional timestamp (1-14 digits, YYYYMMDDhhmmss). Return a page-capture object containing the queried URL, archive link and UTC capture date, referencing the original attribute. Domain and hostname inputs query http://<value>/. No API key is needed. Only existing snapshots are queried; pages are neither submitted for archiving nor downloaded. No accessible snapshot returns an explanatory error.
References
https://archive.org/help/wayback_api.php
Author
MISP
Version
1.0
View source for Webarchive (Wayback Machine)
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.2
View source for Whisper
Expansion

Whois Lookup

whois

Module to query a local instance of uwhois (https://github.com/rafiot/uwhoisd). It returns the registration record as raw text; the rdap module answers the same question as a structured whois object, over an unauthenticated protocol and without a local server, and is the better choice wherever RDAP covers the registry.

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. See the rdap module for objects.
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 https://about.rdap.org/
Author
Raphaël Vinot
Version
0.2
View source for Whois Lookup
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
View source for WhoisFreaks Lookup
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
View source for Wikidata Lookup
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
View source for XLXS Enrich
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
One breach object per data breach the email address appears in.
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 breach object holding the breach name, date, number of exposed records, affected domain, exposed data classes and password storage risk. 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.1
View source for XposedOrNot Lookup
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
View source for YARA Rule Export
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
View source for YARA Rule Generator
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
View source for YARA Syntax Validator
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
View source for Yeti Lookup
Export

Zeek Intel Export

zeek_intel_export

Export validated MISP event and object indicators as a Zeek Intel Framework feed.

Module details
Module Type
export
Input
MISP events and object attributes in standard, bare or legacy export format.
Output
Base64-encoded ASCII Zeek Intel TSV, with skipped counts and provenance in the API response.
Features
Produces a tab-separated Intel input file with native indicator types, escaped fields, stable source labels and MISP provenance. Supports addresses/subnets, domains, HTTP(S) URLs, emails, file names/hashes, certificate SHA-1 hashes and SSH MD5 fingerprints. Defaults to IDS-marked attributes and excludes deleted data. No Zeek connection or additional dependency is required. See the [usage guide](https://github.com/MISP/misp-modules/blob/main/documentation/export_mod/zeek_intel_export.md).
References
https://docs.zeek.org/en/current/frameworks/intel.html https://docs.zeek.org/en/current/scripts/base/frameworks/intel/main.zeek.html
Author
MISP Project
Version
1.0
View source for Zeek Intel Export
Expansion

Zetalytics Passive DNS

zetalytics

Look up passive DNS records in Zetalytics.

Module details
Module Type
expansion
Input
domain, hostname, ip-src, ip-dst MISP attribute.
Output
Referenced DNS record objects with observation times.
Requirements
requests
Features
Uses the Zonecruncher v2 domain2rrtypes or ip endpoint with token authentication. max_results defaults to 25 (1-100). Returns DNS record objects for A, AAAA, CNAME, MX, NS, PTR and TXT, with first/last observation times when available. Duplicate records are suppressed and unsupported record types remain in annotations. No additional SDK is required.
References
https://zonecruncher.com/ https://github.com/ZETAlytics/community/tree/master/zetalytics-api
Author
MISP Project
Version
1
View source for Zetalytics Passive DNS

Generated from misp-modules · revision 6058c097aac2.

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