Skip to content

Expansion Modules

Abuse IPDB

AbuseIPDB MISP expansion module [source code]

  • features:

  • config:

    • api_key
    • max_age_in_days
    • abuse_threshold

alphaMountain_risk

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

  • features:

  • config:

    • license
    • scan_depth
    • partner_type

ANY.RUN Threat Intelligence Lookup

Search ANY.RUN threat intelligence for existing observations without submitting a sandbox task. lookup_days defaults to 180 (1–365). Each result section is capped by max_results. Returned summaries preserve provider threat levels, tags and observation dates. [source code]

  • features:

    Search ANY.RUN threat intelligence for existing observations without submitting a sandbox task. lookup_days defaults to 180 (1–365). Each result section is capped by max_results. Returned summaries preserve provider threat levels, tags and observation dates.

  • config:

    • api_key
    • lookup_days
    • max_results

  • data-source:

    external

  • input:

    domain, hostname, ip-src, ip-dst, url, md5, sha1, sha256

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://github.com/anyrun/anyrun-sdk

  • requirements:

    • requests
    • pymisp

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. [source code]

  • 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.

  • config:

    • api_key
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password
    • os_type
    • opt_timeout
    • opt_network_connect
    • opt_network_fakenet
    • opt_network_tor
    • opt_network_geo
    • opt_network_mitm
    • opt_network_residential_proxy
    • opt_network_residential_proxy_geo
    • opt_privacy_type
    • obj_ext_extension
    • obj_ext_browser
    • env_locale
    • env_version
    • env_bitness
    • env_type
    • obj_ext_startfolder
    • obj_ext_cmd
    • obj_force_elevation
    • run_as_root

  • input:

    Attachment, malware-sample or url to submit to ANY.RUN Sandbox.

  • output:

    ANY.RUN Sandbox analysis URL and UUID.

  • references:

    https://any.run

  • requirements:

    • anyrun-sdk: ANY.RUN API python3 library
    • ANY.RUN Sandbox API-KEY

APIFreaks Lookup

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. [source code]

  • 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.

  • config:

    • apikey
    • do_whois
    • do_dns
    • do_subdomains
    • do_availability
    • do_history
    • do_reverse_dns

  • 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

  • references:

  • requirements:

    An access to the APIFreaks API (apikey)

OSINT DigitalSide

On demand query API for OSINT.digitalside.it project. [source code]

  • 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

  • config:

    • STIX2_details
    • import_related
    • cache
    • cache_directory
    • cache_timeout_h
    • local_directory

  • input:

    A domain, ip, url or hash attribute.

  • output:

    Hashes and urls resulting from the query to OSINT.digitalside.it

  • references:

    https://osint.digitalside.it/#About

  • requirements:

    The apiosintDS python library to query the OSINT.digitalside.it API.

APIVoid

Query APIVoid v2 for DNS records, SSL certificates and email verification. [source code]

  • 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.

  • config:

    apikey

  • input:

    A domain, hostname or email attribute.

  • output:

    DNS records, X.509 certificates or an APIVoid email verification object.

  • references:

  • requirements:

    An APIVoid v2 API key with 2 credits for domain lookups or 1 credit for email verification

AssemblyLine Query

A module to query the AssemblyLine API with a submission ID to get the submission report and parse it. [source code]

  • 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.

  • config:

    • apiurl
    • user_id
    • apikey
    • password
    • verifyssl

  • input:

    Link of an AssemblyLine submission report.

  • output:

    MISP attributes & objects parsed from the AssemblyLine submission.

  • references:

    https://www.cyber.gc.ca/en/assemblyline

AssemblyLine Submit

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

  • 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.

  • config:

    • apiurl
    • user_id
    • apikey
    • password
    • verifyssl

  • input:

    Sample, or url to submit to AssemblyLine.

  • output:

    Link of the report generated in AssemblyLine.

  • references:

    https://www.cyber.gc.ca/en/assemblyline

Backscatter.io

Backscatter.io module to bring mass-scanning observations into MISP. [source code]

  • features:

    The module takes a source or destination IP address as input and displays the information known by backscatter.io.

  • config:

    api_key

  • input:

    IP addresses.

  • output:

    Text containing a history of the IP addresses especially on scanning based on backscatter.io information .

  • references:

    https://pypi.org/project/backscatter/

  • requirements:

    backscatter python library

binGraph

Create entropy and byte histogram PNG plots of an attachment or malware sample. [source code]

  • features:

    Local static analysis inspired by geekscrapy/binGraph. Returns an image object referencing the source attribute. graph_type: all (default), ent or hist. chunks: maximum entropy windows (default 750). max_size_mb: maximum input and unpacked sample size (default 10, maximum 50 MiB). MISP malware-sample ZIPs use password infected; the unpacked MD5 is verified.

  • config:

    • graph_type
    • chunks
    • max_size_mb

  • input:

    An attachment or malware-sample attribute with UUID and base64-encoded data.

  • output:

    An image MISP object containing a PNG, analysis metadata and a visualizes reference to the source.

  • references:

    https://github.com/geekscrapy/binGraph

  • requirements:

    • matplotlib
    • numpy
    • pymisp

BTC Scam Check

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

  • features:

    The module queries a dns blacklist directly with the bitcoin address and get a response if the address has been abused.

  • input:

    btc address attribute.

  • output:

    A reputation object when the BTC address is listed as a scam address.

  • references:

    https://btcblack.it/

  • requirements:

    dnspython3: dns python library

BTC Steroids

An expansion hover module to get a blockchain balance from a BTC address in MISP. [source code]

  • features:

  • input:

    btc address attribute.

  • output:

    A btc-wallet object and one btc-transaction object per transaction the address took part in.

CAPE Sandbox Enrichment

Submit supplied samples to CAPEv2 or retrieve a completed JSON report by numeric task ID. Set api_url to the API v2 base, for example https://cape.example/apiv2. api_key is optional when the server permits unauthenticated requests. submit_samples defaults to false. max_size_mb defaults to 25 (1–100). Submission returns task IDs; use a text attribute containing a task ID for a later report lookup. Completed reports yield file hashes, network pivots and extracted configurations. [source code]

  • features:

    Submit supplied samples to CAPEv2 or retrieve a completed JSON report by numeric task ID. Set api_url to the API v2 base, for example https://cape.example/apiv2. api_key is optional when the server permits unauthenticated requests. submit_samples defaults to false. max_size_mb defaults to 25 (1–100). Submission returns task IDs; use a text attribute containing a task ID for a later report lookup. Completed reports yield file hashes, network pivots and extracted configurations.

  • config:

    • api_url
    • api_key
    • submit_samples
    • max_size_mb
    • max_results

  • data-source:

    external

  • input:

    text, attachment, malware-sample

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://capev2.readthedocs.io/en/latest/usage/api.html

  • requirements:

    • requests
    • pymisp

CCCS YARA Metadata Validator

Validate YARA rule metadata against the CCCS YARA specification. [source code]

  • features:

    Checks every rule in a YARA attribute using the upstream CCCS specification and returns errors and warnings per rule. Metadata generation is disabled and the original attribute is preserved. YARA file includes are disabled. Install the ATT&CK dataset before starting the module server; see the setup and examples.

  • input:

    A YARA attribute containing one or more rules.

  • output:

    Text describing CCCS metadata validity, errors and warnings for each rule.

  • references:

    https://github.com/CybercentreCanada/CCCS-Yara

  • requirements:

    • cccs-yara Python library
    • Local MITRE ATT&CK STIX data (MITRE_STIX_DATA_PATH)

Censys Enrich

An expansion module to enrich attributes in MISP by quering the censys.io API [source code]

  • features:

    This module takes an IP, hostname or a certificate fingerprint and attempts to enrich it by querying the Censys API.

  • config:

    • api_id
    • api_secret

  • 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

  • references:

    https://www.censys.io

  • requirements:

    API credentials to censys.io

Censys Enrichment APIs

Retrieve Censys host enrichment, web properties on ports 80 and 443, or certificate metadata. Configure a platform API token and organization ID. Host service results are bounded; the annotation retains provider fields including scores and labels when present. Web property and certificate requests may consume standard credits under the account plan. [source code]

  • features:

    Retrieve Censys host enrichment, web properties on ports 80 and 443, or certificate metadata. Configure a platform API token and organization ID. Host service results are bounded; the annotation retains provider fields including scores and labels when present. Web property and certificate requests may consume standard credits under the account plan.

  • config:

    • api_token
    • organization_id
    • max_results

  • data-source:

    external

  • input:

    ip-src, ip-dst, domain, hostname, x509-fingerprint-sha256

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://docs.censys.com/reference/v3-globaldata-asset-host-enrichment

  • requirements:

    • requests
    • pymisp

CIRCL Passive DNS

Module to access CIRCL Passive DNS. [source code]

  • 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.

  • config:

    • username
    • password

  • input:

    Hostname, domain, or ip-address attribute.

  • ouput:

    Passive DNS objects related to the input attribute.

  • references:

  • requirements:

    • pypdns: Passive DNS python library
    • A CIRCL passive DNS account with username & password

CIRCL Passive SSL

Modules to access CIRCL Passive SSL. [source code]

  • 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.

  • config:

    • username
    • password

  • input:

    IP address attribute.

  • output:

    x509 certificate objects seen by the IP address(es).

  • references:

    https://www.circl.lu/services/passive-ssl/

  • requirements:

    • pypssl: Passive SSL python library
    • A CIRCL passive SSL account with username & password

ClaamAV

Submit file to ClamAV [source code]

  • features:

  • config:

    connection

Cluster25 Expand

Module to query Cluster25 CTI. [source code]

  • 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.

  • config:

    • api_id
    • apikey
    • base_url

  • 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.

  • references:

  • requirements:

    A Cluster25 API access (API id & key)

Markdown to PDF converter

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

  • features:

  • references:

  • Install pandoc for your distribution
  • 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
  • Install mermaid
    • npm install --global @mermaid-js/mermaid-cli

  • Install the pandoc-mermaid-filter from https://github.com/DavidCruciani/pandoc-mermaid-filter

    • Easiest is to install the following: 
          pip3 install git+https://github.com/DavidCruciani/pandoc-mermaid-filter

  • requirements:

    pandoc

Country Code

Module to expand country codes. [source code]

  • 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.

  • input:

    Hostname or domain attribute.

  • output:

    Text with the country code the input belongs to.

CPE Lookup

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

  • 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.

  • config:

    • custom_API_URL
    • limit

  • input:

    CPE attribute.

  • output:

    The vulnerabilities related to the CPE.

  • references:

    https://vulnerability.circl.lu/api/

Criminal IP Enrichment

Retrieve IPv4 risk and infrastructure reports, existing domain scan listings, or a completed domain scan by numeric text ID. Provider JSON retains risk scores, flags and available vulnerability data. submit_unknown defaults to false; true submits a domain only when its report listing is empty. Submission returns a scan receipt without polling. Use its scan_id as text input to retrieve the full report. [source code]

  • features:

    Retrieve IPv4 risk and infrastructure reports, existing domain scan listings, or a completed domain scan by numeric text ID. Provider JSON retains risk scores, flags and available vulnerability data. submit_unknown defaults to false; true submits a domain only when its report listing is empty. Submission returns a scan receipt without polling. Use its scan_id as text input to retrieve the full report.

  • config:

    • api_key
    • submit_unknown
    • max_results

  • data-source:

    external

  • input:

    ip-src, ip-dst, domain, hostname, text

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://www.criminalip.io/developer/api

  • requirements:

    • requests
    • pymisp

CrowdSec CTI

Module to access CrowdSec CTI API. [source code]

CrowdStrike Falcon

Module to query CrowdStrike Falcon. [source code]

  • 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.

  • config:

    • api_id
    • apikey

  • 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

  • references:

    https://www.crowdstrike.com/products/crowdstrike-falcon-faq/

  • requirements:

    A CrowdStrike API access (API id & key)

Cuckoo Submit

Submit files and URLs to Cuckoo Sandbox [source code]

  • 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.

  • config:

    • api_url
    • api_key

  • input:

    A malware-sample or attachment for files. A url or domain for URLs.

  • output:

    A text field containing 'Cuckoo task id: '

  • references:

  • requirements:

    Access to a Cuckoo Sandbox API and an API key if the API requires it. (api_url and api_key)

CVE Lookup

An expansion hover module to expand information about CVE id. [source code]

  • features:

    The module takes a vulnerability attribute as input and queries Vulnerability Lookup to get additional information based on the Vulnerability ID.

  • input:

    Vulnerability attribute.

  • output:

    Additional information on the vulnerability, gathered from the Vulnerability Lookup API.

  • references:

CVE Advanced Lookup

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

  • 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.

  • config:

    custom_API

  • input:

    Vulnerability attribute.

  • output:

    Additional information about the vulnerability, such as its cvss score, some references, or the related weaknesses and attack patterns.

  • references:

Cytomic Orion Lookup

An expansion module to enrich attributes in MISP by quering the Cytomic Orion API [source code]

  • features:

    This module takes an MD5 hash and searches for occurrences of this hash in the Cytomic Orion database. Returns observed files and machines.

  • config:

    • api_url
    • token_url
    • clientid
    • clientsecret
    • clientsecret
    • username
    • password
    • upload_timeframe
    • upload_tag
    • delete_tag
    • upload_ttlDays
    • upload_threat_level_id
    • limit_upload_events
    • limit_upload_attributes

  • 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.

  • references:

  • requirements:

    Access (license) to Cytomic Orion

DBL Spamhaus Lookup

Checks Spamhaus DBL for a domain name. [source code]

  • 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.

  • input:

    Domain or hostname attribute.

  • output:

    A reputation object holding the classification Spamhaus DBL gives the input.

  • references:

    https://www.spamhaus.org/faq/section/Spamhaus%20DBL

  • requirements:

    dnspython3: DNS python3 library

DNS Resolver

Simple DNS expansion service to resolve IP address from MISP attributes [source code]

  • 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.

  • config:

    nameserver

  • data-source:

    external

  • 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

DNS Record Enumeration

Enumerate DNS record types and extract domain, IP, email and URL pivots. [source code]

  • 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.

  • config:

    • nameserver
    • record_types
    • query_timeout
    • max_time
    • max_pivots
    • mail_policy

  • input:

    A supported MISP attribute containing type, value and UUID.

  • output:

    Linked dns-resource-record objects; newly generated attributes have to_ids=false.

  • references:

    https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml

  • requirements:

    • dnspython
    • PyMISP

Run an explicit DNSlytics domain dataset query supplied as a text attribute. One request retrieves page 1; at most max_results domains are imported. Domain metadata preserves active or dropped status when supplied. The premium endpoint consumes credits; a local cap does not reduce the provider charge. This initial module does not perform additional DNS or IP2ASN requests. [source code]

  • features:

    Run an explicit DNSlytics domain dataset query supplied as a text attribute. One request retrieves page 1; at most max_results domains are imported. Domain metadata preserves active or dropped status when supplied. The premium endpoint consumes credits; a local cap does not reduce the provider charge. This initial module does not perform additional DNS or IP2ASN requests.

  • config:

    • api_key
    • max_results

  • data-source:

    external

  • input:

    text

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://dnslytics.com/api

  • requirements:

    • requests
    • pymisp

DNSTwist Domain Enrichment

Generate domain permutations locally with optional DNS resolution. Install dnstwist in the module server Python environment. resolve defaults to false and performs no DNS checks. Set resolve=true to return DNS-resolving candidates with available A, AAAA, NS and MX observations. timeout defaults to 30 seconds (1–120); threads defaults to 4 (1–16). An isolated subprocess prevents changes to the module server argument list and bounds runtime. Generated candidates and resolving domains are investigation leads, not maliciousness assertions. Each result preserves its mutation algorithm. [source code]

  • features:

    Generate domain permutations locally with optional DNS resolution. Install dnstwist in the module server Python environment. resolve defaults to false and performs no DNS checks. Set resolve=true to return DNS-resolving candidates with available A, AAAA, NS and MX observations. timeout defaults to 30 seconds (1–120); threads defaults to 4 (1–16). An isolated subprocess prevents changes to the module server argument list and bounds runtime. Generated candidates and resolving domains are investigation leads, not maliciousness assertions. Each result preserves its mutation algorithm.

  • config:

    • resolve
    • timeout
    • threads
    • max_results

  • data-source:

    external

  • input:

    domain, hostname

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://github.com/elceef/dnstwist

  • requirements:

    • requests
    • pymisp
    • dnstwist

DOCX Enrich

Module to extract freetext from a .docx document. [source code]

  • 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.

  • input:

    Attachment attribute containing a .docx document.

  • output:

    Text and freetext parsed from the document.

  • requirements:

    docx python library

DomainTools Lookup

Legacy DomainTools WHOIS, reputation and reverse lookup expansion module. [source code]

  • features:

    Use domaintools_iris_enrich, domaintools_iris_investigate or domaintools_iris_pivot for Iris services. See https://misp.github.io/misp-modules/domaintools/ for API coverage and the provider-supported MISP integration.

    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.

  • config:

    • username
    • api_key

  • 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

  • references:

    https://www.domaintools.com/

  • requirements:

    • Domaintools python library
    • A Domaintools API access (username & apikey)

DomainTools Iris Enrich

Retrieve DomainTools Iris Enrich results using the provider reference field and query conventions. [source code]

DomainTools Iris Investigate

Retrieve DomainTools Iris Investigate results using the provider reference field and query conventions. [source code]

DomainTools Iris Pivot

Retrieve DomainTools Iris Pivot results using the provider reference field and query conventions. [source code]

  • features:

    See https://misp.github.io/misp-modules/domaintools/ for services, account requirements, limits and result mapping.

  • config:

    • username
    • api_key
    • results_limit
    • guided_pivot_threshold

  • data-source:

    external

  • input:

    domain, hostname, ip-src, ip-dst, whois-registrant-email, email-src, email-dst, whois-registrar, whois-registrant-name, x509-fingerprint-sha1

  • output:

    Referenced domain, WHOIS, DNS, certificate and annotation objects; new attributes use to_ids=false.

  • references:

    https://github.com/DomainTools/domaintools_misp

  • requirements:

    • requests
    • PyMISP

DShield SANS ISC

Look up IP reports, target counts, network ownership and threat-feed observations in DShield / SANS ISC. [source code]

  • features:

    Queries the public ISC IP API without an API key. Set user_agent to identify your deployment and include a contact address, as requested by ISC. IPv4 and IPv6 are accepted; private and reserved addresses are rejected. Returns reported packet and unique target counts, first/last seen dates and per-feed observations as a referenced annotation, plus an ASN object and an abuse-contact email when available. Zero reports do not establish that an address is benign. HTTP 429 is returned as an error without automatic retries; wait at least five minutes and respect Retry-After before another lookup. All enrichment has to_ids disabled.

  • config:

    user_agent

  • input:

    ip-src, ip-dst MISP attribute.

  • output:

    A referenced annotation and ASN object, and an abuse-contact email attribute.

  • references:

    https://www.dshield.org/api/#ip

  • requirements:

    requests

Search DuckDuckGo for web references to an attribute without an API key. [source code]

  • features:

    Searches the attribute value using the ddgs DuckDuckGo backend, without automatic provider fallback. Returns annotation objects containing result links, titles and snippets, related to the input attribute. max_results defaults to 5 (1-25); timeout defaults to 10 seconds (1-60) per search request. Blank settings use defaults. Searches use the library's us-en region and moderate safe search. This unofficial search integration can be rate-limited or broken by upstream changes. The attribute value is sent to DuckDuckGo; result pages are not downloaded. Search results are references for review, not maliciousness verdicts.

  • config:

    • max_results
    • timeout

  • input:

    A URL, domain, hostname or text attribute.

  • output:

    Related annotation objects with search result links, titles and snippets; to_ids is false.

  • references:

  • requirements:

    • ddgs>=9.16.1,<10
    • pymisp

Email Security Check

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

  • 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.

  • input:

    A domain or hostname attribute.

  • output:

    Domain-ip MISP object with email security assessment attributes.

  • references:

  • requirements:

    dnspython

EQL Query Generator

EQL query generation for a MISP attribute. [source code]

  • features:

    This module adds a new attribute to a MISP event containing an EQL query for a network or file attribute.

  • input:

    A filename or ip attribute.

  • output:

    Attribute containing EQL for a network or file attribute.

  • references:

    https://eql.readthedocs.io/en/latest/

ESET Threat Intelligence Report

Download an ESET ETI PDF from a supported report download link and return a report object with its PDF attachment and SHA-256. Only HTTPS report paths on eti.eset.com, www.eset.com or eset.com are accepted. The complete generated api_token is forwarded unchanged as the provider Bearer credential. Redirects are rejected to keep credentials on the selected host. max_size_mb defaults to 25 (1–100); streamed responses are capped before importing. The report content hash supports duplicate detection when reviewing enrichment results. [source code]

  • features:

    Download an ESET ETI PDF from a supported report download link and return a report object with its PDF attachment and SHA-256. Only HTTPS report paths on eti.eset.com, www.eset.com or eset.com are accepted. The complete generated api_token is forwarded unchanged as the provider Bearer credential. Redirects are rejected to keep credentials on the selected host. max_size_mb defaults to 25 (1–100); streamed responses are capped before importing. The report content hash supports duplicate detection when reviewing enrichment results.

  • config:

    • api_token
    • max_size_mb
    • max_results

  • data-source:

    external

  • input:

    link

  • output:

    A report object with title, type, source links and PDF attachment, linked to the original attribute.

  • references:

    https://help.eset.com/eti_portal/en-US/

  • requirements:

    • requests
    • pymisp

EUPI Lookup

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

  • 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.

  • config:

    • apikey
    • url

  • input:

    A domain, hostname or url MISP attribute.

  • output:

    Text containing information about the input, resulting from the query on Phishing Initiative.

  • references:

    https://phishing-initiative.eu/?lang=en

  • requirements:

    • pyeupi: eupi python library
    • An access to the Phishing Initiative API (apikey & url)

URL Components Extractor

Extract URL components [source code]

  • features:

Extuno Lookup

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

  • 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.

  • config:

    • api_key
    • api_url

  • 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.

  • references:

  • requirements:

    An Extuno API key

Farsight DNSDB Lookup

Module to access Farsight DNSDB Passive DNS. [source code]

  • 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). SOA contact emails are also returned as dns-soa-email attributes. For unescaped mailbox names, the Public Suffix List is used to infer the email domain; this is a heuristic. Raw SOA records are preserved.

  • config:

    • apikey
    • server
    • limit
    • flex_queries

  • input:

    A domain, hostname or IP address MISP attribute.

  • output:

    Passive-dns objects, resulting from the query on the Farsight Passive DNS API.

  • references:

  • requirements:

    An access to the Farsight Passive DNS API (apikey)

FIRST EPSS Lookup

Query FIRST directly for a CVE EPSS probability, percentile and score date without requiring another vulnerability service. EPSS estimates exploitation probability over the next 30 days. Values remain in the provider range 0–1. The module reuses the bundled epss-score template. An empty response does not become a zero score. [source code]

  • features:

    Query FIRST directly for a CVE EPSS probability, percentile and score date without requiring another vulnerability service. EPSS estimates exploitation probability over the next 30 days. Values remain in the provider range 0–1. The module reuses the bundled epss-score template. An empty response does not become a zero score.

  • config:

    max_results

  • data-source:

    external

  • input:

    vulnerability

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://www.first.org/epss/api

  • requirements:

    • requests
    • pymisp

Flowtriq DDoS Intelligence

Query Flowtriq for DDoS attack intelligence on IP addresses [source code]

  • 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.

  • config:

    • api_key
    • api_url

  • 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.

  • references:

    https://flowtriq.com

  • requirements:

    Flowtriq API key and API URL

FortiSandbox Enrichment

Authenticate to a FortiSandbox appliance and retrieve an existing rating by SHA-1 or SHA-256. Set api_url to the appliance HTTPS origin, without /jsonrpc. For supplied files, calculate SHA-256 and look up the rating first. submit_samples defaults to false; true permits submission when the rating is unknown. max_size_mb defaults to 25 (1–100). A submission receipt is returned without polling. Provider ratings remain in their original vocabulary. [source code]

  • features:

    Authenticate to a FortiSandbox appliance and retrieve an existing rating by SHA-1 or SHA-256. Set api_url to the appliance HTTPS origin, without /jsonrpc. For supplied files, calculate SHA-256 and look up the rating first. submit_samples defaults to false; true permits submission when the rating is unknown. max_size_mb defaults to 25 (1–100). A submission receipt is returned without polling. Provider ratings remain in their original vocabulary.

  • config:

    • api_url
    • username
    • password
    • submit_samples
    • max_size_mb
    • max_results

  • data-source:

    external

  • input:

    sha1, sha256, attachment, malware-sample

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://www.fortinet.com/products/sandbox/fortisandbox

  • requirements:

    • requests
    • pymisp

GCVE CPE

Expand CPE attributes with GCVE CPE catalog metadata, package mappings and vulnerability references. [source code]

  • 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.

  • config:

    • api_url
    • timeout
    • max_pages

  • input:

    CPE attribute.

  • output:

    A catalog annotation and related vulnerability objects in MISP standard format.

  • references:

  • requirements:

    • requests
    • pymisp

GeoIP ASN Lookup

Query a local copy of the MaxMind GeoLite2 ASN database (MMDB format) [source code]

  • features:

    The module takes an IP address attribute as input and queries a local copy of the MaxMind GeoLite2 ASN database to get information about the related AS number.

  • config:

    • local_geoip_db
    • local_geolite_db

  • descrption:

    An expansion module to query a local copy of MaxMind GeoLite2 ASN database with an IP address, in order to get information about its related AS number.

  • input:

    An IP address MISP attribute.

  • output:

    An asn object describing the AS the IP address is announced by.

  • references:

    https://www.maxmind.com/en/home

  • requirements:

    A local copy of MaxMind GeoLite2 ASN database

GeoIP City Lookup

An expansion module to query a local copy of MaxMind GeoIP2 or GeoLite2 database with an IP address, in order to get information about the city where it is located. [source code]

  • features:

    The module takes an IP address attribute as input and queries a local copy of the MaxMind GeoIP2 or GeoLite2 database to get information about the city where this IP address is located.

  • config:

    • local_geoip_db
    • local_geolite_db

  • input:

    An IP address MISP attribute.

  • output:

    A geolocation object describing where the IP address is located.

  • references:

    https://www.maxmind.com/en/home

  • requirements:

    A local MaxMind GeoIP2 or GeoLite2 City database (.mmdb)

GeoIP Country Lookup

Query a local MaxMind GeoIP2 or GeoLite2 Country database (MMDB format) [source code]

  • features:

    This module takes an IP address MISP attribute as input and queries a local copy of the MaxMind GeoIP2 or GeoLite2 database to get information about the location of this IP address.

    Please note that composite attributes domain|ip are also supported.

  • config:

    • local_geoip_db
    • local_geolite_db

  • input:

    An IP address MISP Attribute.

  • output:

    A geolocation object holding the country the IP address is located in.

  • references:

    https://www.maxmind.com/en/home

  • requirements:

    A local MaxMind GeoIP2 or GeoLite2 Country database (.mmdb)

geoPlugin Lookup

An expansion and hover module to geolocate an IP address with geoPlugin. [source code]

  • features:

    Queries the geoPlugin HTTPS API using the configured api_key. Returns available country, region, city, postal code, coordinates and accuracy radius in a geolocation object linked to the source attribute. Continent and timezone are included as text. Empty fields are omitted. Only public IPv4 addresses are queried, following the API's documented address support. The IP component of domain|ip is used without resolving the domain. See documentation/expansion/geoplugin.md for configuration and an example request.

  • config:

    api_key

  • input:

    A public IPv4 address in an ip-src, ip-dst or domain|ip attribute.

  • output:

    A geolocation object referencing the original attribute. New attributes have to_ids=false.

  • references:

  • requirements:

    • A geoPlugin API key
    • requests

GLIMPS Malware Enrichment

Retrieve GLIMPS Detect results by SHA-256 or analysis UUID supplied as text. Set api_url to the service HTTPS origin. Supplied samples are hashed and looked up first. submit_samples defaults to false; true permits submitting a previously unknown sample. max_size_mb defaults to 25 (1–100). Submission returns an analysis UUID for later text lookup. Provider verdicts and analysis details are retained in a sandbox-report object. The access token for an expert view is excluded from imported report data. [source code]

  • features:

    Retrieve GLIMPS Detect results by SHA-256 or analysis UUID supplied as text. Set api_url to the service HTTPS origin. Supplied samples are hashed and looked up first. submit_samples defaults to false; true permits submitting a previously unknown sample. max_size_mb defaults to 25 (1–100). Submission returns an analysis UUID for later text lookup. Provider verdicts and analysis details are retained in a sandbox-report object. The access token for an expert view is excluded from imported report data.

  • config:

    • api_url
    • api_token
    • submit_samples
    • max_size_mb

  • data-source:

    external

  • input:

    sha256, text, attachment, malware-sample

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://github.com/glimps-re/py-gdetect

  • requirements:

    • requests
    • pymisp

Google Safe Browsing Lookup

Google safe browsing expansion module [source code]

  • features:

  • config:

    api_key

Google Threat Intelligence Lookup

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

  • 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

  • config:

    • apikey
    • event_limit
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password

  • 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.

  • references:

  • requirements:

    An access to the Google Threat Intelligence API (apikey), with a high request rate limit.

GreyNoise Lookup

Module to query IP and CVE information from GreyNoise [source code]

  • 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.

  • config:

    api_key

  • input:

    An IP address or CVE ID

  • output:

    IP Lookup information or CVE scanning profile for past 7 days

  • references:

  • 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.

GreyNoise Vulnerability Intelligence

Retrieve dedicated GreyNoise CVE intelligence, including available exploitation activity, exploit counts, product details and prioritization fields. Provider fields are preserved in a referenced annotation. Coverage depends on the API key entitlement. An absent CVE returns no enrichment and does not imply no exploitation. [source code]

  • features:

    Retrieve dedicated GreyNoise CVE intelligence, including available exploitation activity, exploit counts, product details and prioritization fields. Provider fields are preserved in a referenced annotation. Coverage depends on the API key entitlement. An absent CVE returns no enrichment and does not imply no exploitation.

  • config:

    api_key

  • data-source:

    external

  • input:

    vulnerability

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://docs.greynoise.io/reference/getcve

  • requirements:

    • requests
    • pymisp

Hashdd Lookup

A hover module to check hashes against hashdd.com including NSLR dataset. [source code]

  • features:

    This module takes a hash attribute as input to check its known level, using the hashdd API. This information is then displayed.

  • input:

    A hash MISP attribute (md5).

  • output:

    Text describing the known level of the hash in the hashdd databases.

  • references:

    https://hashdd.com/

CIRCL Hashlookup Lookup

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

  • 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.

  • config:

    custom_API

  • input:

    File hashes (MD5, SHA1)

  • output:

    Object with the filename associated hashes if the hash is part of a known set.

  • references:

    https://www.circl.lu/services/hashlookup/

Have I Been Pwned Lookup

Module to access haveibeenpwned.com API. [source code]

  • 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. Results are available in hover lookups and can be imported into an event through enrichment.

  • config:

    api_key

  • input:

    An email address

  • output:

    One breach object per data breach the email address appears in.

  • references:

    https://haveibeenpwned.com/

  • requirements:

    A Have I Been Pwned API key with access to the breached account API.

Host.io

Retrieve Host.io DNS, website and co-hosted domain observations. [source code]

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    domain, hostname, ip-src, ip-dst MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://host.io/docs

  • requirements:

    requests

HTML to Markdown

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

  • 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.

  • input:

    URL attribute.

  • output:

    Markdown content converted from the HTML fetched from the url.

  • requirements:

    The markdownify python library

HYAS Insight Lookup

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. [source code]

  • 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.

  • config:

    apikey

  • 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.

  • references:

    https://www.hyas.com/hyas-insight/

  • requirements:

    A HYAS Insight API Key.

Hybrid Analysis Sandbox

Look up Hybrid Analysis reports or submit a file or URL for sandbox analysis. [source code]

  • 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.

  • config:

    • apikey
    • environment_id
    • max_results
    • max_size_mb

  • input:

    md5, sha1, sha256, attachment, url, text MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://hybrid-analysis.com/docs/api/v2

  • requirements:

    requests

Hygiene Warninglist Check

Check an observable against local MISP warninglists and record the matching lists. [source code]

  • 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.

  • config:

    • warninglists_path
    • slow_search
    • max_results

  • input:

    domain, hostname, url, ip-src, ip-dst, md5, sha1, sha256, email-src, email-dst MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

  • requirements:

    pymispwarninglists>=1.7.0

Import External Reference

Capture a public web reference as Markdown or a PDF attachment. [source code]

  • 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.

  • config:

    max_size_mb

  • input:

    url MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://www.misp-project.org/objects.html#_page_capture

  • requirements:

    • urllib3
    • certifi
    • beautifulsoup4
    • markdownify

Intel471 Lookup

Module to access Intel 471 [source code]

  • 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.

  • config:

    • email
    • authkey

  • descrption:

    An expansion module to query Intel471 in order to get additional information about a domain, ip address, email address, url or hash.

  • 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

  • references:

    https://public.intel471.com/

  • requirements:

    The intel471 python library

Intel 471 Hunter

Retrieve Intel 471 Hunter hunt packages, Sigma rules and analyst guidance. [source code]

  • 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.

  • config:

    • apikey
    • search_type
    • max_results

  • input:

    vulnerability, text MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

  • requirements:

    requests

Intezer Sandbox

Retrieve Intezer Analyze file reports or submit an attachment for analysis. [source code]

  • 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.

  • config:

    • apikey
    • max_size_mb

  • input:

    md5, sha1, sha256, attachment, text MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://intezer-python-sdk.readthedocs.io/

  • requirements:

    requests

IP2Location.io Lookup

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

  • 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 for more information on data available for each plan.

    More information on the responses content is available in the documentation.

  • config:

    key

  • 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.

  • references:

    https://www.ip2location.io/ip2location-documentation

  • requirements:

    An IP2Location.io token

ipapi.is Lookup

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. [source code]

  • features:

    The module takes an IP address attribute as input and looks it up with the ipapi.is API. 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.

  • config:

    api_key

  • 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.

  • references:

    https://ipapi.is/developers.html

  • requirements:

    An ipapi.is API key (optional: without one the API returns location and network owner only, 30 requests a day)

IPASN-History Lookup

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

  • 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.

  • config:

    custom_api

  • input:

    An IP address MISP attribute.

  • output:

    Asn object(s) objects related to the IP address used as input.

  • references:

    https://github.com/D4-project/IPASN-History

  • requirements:

    pyipasnhistory: Python library to access IPASN-history instance

IPGeolocation.io Lookup

An expansion and hover module to enrich an IP address with geolocation, ASN, company, threat intelligence (threat score, VPN, proxy, Tor, bot and spam signals) and abuse contact information from IPGeolocation.io, either through the API or from local IPGeolocation.io MMDB databases. [source code]

  • features:

    The module takes an IP address attribute as input and answers from one of two sources: - api_key: the IPGeolocation.io API. 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.

  • config:

    • api_key
    • mmdb_paths
    • include
    • cache_ttl

  • 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.

  • references:

  • requirements:

    An IPGeolocation.io API key, or IPGeolocation.io MMDB databases stored on the misp-modules host

IPInfo.io Lookup

An expansion module to query IPinfo for geolocation, ASN and contextual IP intelligence. [source code]

  • features:

    IP address data powered by IPinfo. The module accepts an IP address attribute and returns geolocation, ASN and related domain information when available.

    Set api to lite for the unlimited free country/continent and basic ASN API, or lookup for the paid Core/Plus API with city-level geolocation and network intelligence. legacy (the default when unset) preserves existing configurations using ipinfo.io. Tokens must match the selected API subscription. Lite does not include city, coordinates, postal code, hostname or timezone.

    Privacy/anonymous flags, abuse contacts, company, carrier and other contextual fields returned by the selected plan are preserved in a JSON annotation referencing the input attribute. Explicit false flags are retained; absent fields do not imply a clean address. Hosted domains included in the response are added to the domain-ip object. No additional API endpoints are queried.

  • config:

    • token
    • api

  • input:

    IP address attribute (ip-src or ip-dst).

  • output:

    geolocation, asn and domain-ip objects, plus a referenced annotation for contextual IPinfo data.

  • references:

  • requirements:

    An IPinfo token for the selected API

IPQualityScore Lookup

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

  • 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.

  • config:

    • apikey
    • base_url
    • poll_delay

  • 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.

  • references:

    https://www.ipqualityscore.com/

  • requirements:

    A IPQualityScore API Key.

IPRep Lookup

Module to query IPRep data for IP addresses. [source code]

  • 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.

  • config:

    apikey

  • input:

    An IP address MISP attribute.

  • output:

    Text describing additional information about the input after a query on the IPRep API.

  • references:

    https://github.com/mahesh557/packetmail

  • requirements:

    An access to the packetmail API (apikey)

isMalicious Lookup

Query isMalicious for IP, domain, hostname, and URL reputation. [source code]

  • 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.

  • config:

    • api_key
    • api_url

  • input:

    An IP address, domain, hostname or URL.

  • output:

    Text attributes with the isMalicious reputation summary.

  • references:

  • 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.

IVRE

Retrieve active scan observations from an IVRE web API. [source code]

  • 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.

  • config:

    • url
    • username
    • password
    • max_results

  • input:

    ip-src, ip-dst, domain, hostname MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

  • requirements:

    requests

Ninja Template Rendering

Render the template with the data passed [source code]

  • features:

Joe Sandbox Import

Query Joe Sandbox API with a submission url to get the json report and extract its data that is parsed and converted into MISP attributes and objects. [source code]

  • 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 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.

  • config:

    • apiurl
    • apikey
    • import_executable
    • import_mitre_attack

  • input:

    Link of a Joe Sandbox sample or url submission.

  • output:

    MISP attributes & objects parsed from the analysis report.

  • references:

  • requirements:

    jbxapi: Joe Sandbox API python3 library

Joe Sandbox Submit

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

  • 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 directly on this submission link.

  • config:

    • apiurl
    • apikey
    • accept-tac
    • report-cache
    • systems

  • input:

    Sample, url (or domain) to submit to Joe Sandbox for an advanced analysis.

  • output:

    Link of the report generated in Joe Sandbox.

  • references:

  • requirements:

    jbxapi: Joe Sandbox API python3 library

Kaspersky Threat Intelligence Portal

Retrieve Kaspersky commercial Threat Intelligence Portal reports. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_results

  • input:

    md5, sha1, sha256, ip-src, ip-dst, domain, hostname, url MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://tip.kaspersky.com/

  • requirements:

    requests

Lamis Network Lookup

Lamis Network IP Intelligence and Risk Scoring expansion module. [source code]

  • 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).

  • config:

    • api_key
    • risk_threshold
    • timeout

  • input:

    IP address attribute (ip-src, ip-dst).

  • output:

    Enriched ASN, geolocation, proxy indicators, and risk score.

  • references:

  • requirements:

    A Lamis Network API Key

LastInfoSec

Retrieve LastInfoSec STIX 2.1 intelligence and convert it to MISP. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_results

  • input:

    md5, sha1, sha256, ip-src, ip-dst, domain, hostname, url MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://api.client.lastinfosec.com/v2/

  • requirements:

    • requests
    • misp-stix

Lastline Lookup

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. [source code]

  • 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 import module.

  • config:

    • username
    • password
    • verify_ssl

  • input:

    Link to a Lastline analysis.

  • output:

    MISP attributes and objects parsed from the analysis report.

  • references:

    https://www.lastline.com

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. [source code]

  • 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 module.

  • config:

    • url
    • api_token
    • key

  • input:

    File or URL to submit to Lastline.

  • output:

    Link to the report generated by Lastline.

  • references:

    https://www.lastline.com

Lookyloo lookup

Find Lookyloo captures containing an IP, hostname, URL, resource hash or favicon hash. [source code]

  • 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.

  • config:

    • url
    • apikey
    • timeout
    • max_items
    • include_raw
    • include_cookies
    • include_favicons
    • include_extended
    • include_misp_export
    • include_contacts
    • limit
    • offset
    • hash_lookup
    • enrich_captures
    • max_captures

  • input:

    IPv4/IPv6, domain, hostname, URL or SHA-512 attribute.

  • output:

    Related lookyloo-capture objects and observed URL/file objects, with optional capture enrichment.

  • references:

    https://lookyloo.circl.lu/doc/

  • requirements:

    • requests
    • A Lookyloo instance; API key optional
    • lookyloo-capture object template (bundled)

Lookyloo capture

Enrich a Lookyloo capture link or UUID with observed resources and analysis context. [source code]

  • 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.

  • config:

    • url
    • apikey
    • timeout
    • max_items
    • include_raw
    • include_cookies
    • include_favicons
    • include_extended
    • include_misp_export
    • include_contacts

  • input:

    Lookyloo /tree/ link or a text attribute containing a capture UUID.

  • output:

    lookyloo-capture, url, file, image and optional cookie objects and contact attributes.

  • references:

    https://lookyloo.circl.lu/doc/

  • requirements:

    • requests
    • A Lookyloo instance; API key optional
    • lookyloo-capture object template (bundled)

Macaddress.io Lookup

MISP hover module for macaddress.io [source code]

  • 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

  • config:

    api_key

  • input:

    MAC address MISP attribute.

  • output:

    Text containing information on the MAC address fetched from a query on macaddress.io.

  • references:

  • requirements:

    • maclookup: macaddress.io python library
    • An access to the macaddress.io API (apikey)

macadress.com Lookup

Module to access macadress.com API. [source code]

  • 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)

  • config:

    api_key

  • input:

    A MAC address.

  • output:

    Additional information about the MAC address.

  • references:

  • requirements:

    An access to the macadress.com API (apikey)

Macvendors Lookup

Module to access Macvendors API. [source code]

  • 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.

  • config:

    user-agent

  • input:

    A MAC address.

  • output:

    Additional information about the MAC address.

  • references:

MalBeacon

Retrieve MalBeacon C2 and actor infrastructure observations. [source code]

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    domain, hostname, ip-src, ip-dst MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://malbeacon.com/

  • requirements:

    requests

Malpedia lookup

Search Malpedia families and actors, or expand a sample hash or Malpedia record URL. [source code]

  • 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.

  • config:

    • apikey
    • timeout
    • max_results
    • include_yara

  • 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.

  • references:

    https://malpedia.caad.fkie.fraunhofer.de/usage/api

  • requirements:

    • requests
    • PyMISP
    • Optional Malpedia API token; required for sample hash lookups.

MalShare Upload

Module to push malware samples to MalShare [source code]

  • config:

    malshare_apikey

  • requirements:

    requests library

Malwagon Lookup

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

  • 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.

  • config:

    • apikey
    • api_url
    • max_results

  • 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.

  • references:

  • requirements:

    A Malwagon API key with the read scope.

Malwagon Submit

Detonate a sample or a URL in the Malwagon sandbox and return the analysis. [source code]

  • 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.

  • config:

    • apikey
    • api_url
    • max_tlp
    • private
    • internet
    • poll_timeout
    • always_submit

  • 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.

  • references:

  • requirements:

    A Malwagon API key with the submit scope.

Malware Bazaar Lookup

Query Malware Bazaar to get additional information about the input hash. [source code]

  • 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).

  • config:

    auth_key

  • input:

    A hash attribute (md5, sha1 or sha256).

  • output:

    File object(s) related to the input attribute found on MALWAREbazaar databases.

  • references:

    https://bazaar.abuse.ch/

Manalyze

Analyze PE attachments and malware samples with a local Manalyze installation. [source code]

  • features:

    Runs local static analysis using an explicit set of offline plugins. Returns a file object, one malware-analysis object per plugin verdict, and an annotation containing the complete JSON report. Supports MISP malware-sample ZIPs with password infected. Configuration: binary (default manalyze), timeout (default 60 seconds, 1-300), max_size_mb (default 25, 1-100).

  • config:

    • binary
    • timeout
    • max_size_mb

  • input:

    An attachment or malware-sample attribute with base64 data, type, value and uuid.

  • output:

    Linked file, malware-analysis and annotation objects in misp_standard format.

  • references:

  • requirements:

    Manalyze executable and its rules/plugins installed on the module server

McAfee MVISION Insights Lookup

Lookup McAfee MVISION Insights Details [source code]

  • features:

  • config:

    • api_key
    • client_id
    • client_secret

Metras Enrichment

Enrich file hashes and IP addresses with Metras EDR inventory and fleet context. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_results

  • input:

    md5, sha1, sha256, ip-src, ip-dst MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://metras.sa/

  • requirements:

    requests

GeoIP Enrichment

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. [source code]

MobSF

Submit mobile applications to MobSF or retrieve static analysis reports by MD5. [source code]

  • features:

    Supports Android, iOS and Windows packages accepted by the configured MobSF instance. MD5 retrieves an existing report without starting analysis. Attachments and unpacked MISP malware samples are uploaded and scanned once. Queued scans return a receipt; expand the MD5 later to retrieve results. Uses existing sandbox-report, file, android-app and software templates. See documentation/expansion/mobsf.md.

  • config:

    • url
    • apikey
    • timeout
    • max_size_mb

  • input:

    An MD5 attribute, attachment or malware-sample with base64 data.

  • output:

    Referenced analysis and application objects, with extracted network attributes and the full JSON report.

  • references:

    https://github.com/MobSF/Mobile-Security-Framework-MobSF

  • requirements:

    • requests
    • Access to a MobSF instance and its API key

MODAT Magnify

Enrich internet infrastructure using MODAT Magnify host, service and DNS observations. [source code]

  • features:

    Typed service and DNS observations linked to existing MISP infrastructure objects.

  • config:

    • apikey
    • max_results
    • page_size
    • timeout
    • include_dns
    • reverse_dns

  • 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.

  • references:

  • requirements:

    • requests
    • PyMISP
    • MODAT Magnify API key
    • Install the bundled modat-service and modat-dns-record object templates in MISP

MWDB Submit

Module to push malware samples to a MWDB instance [source code]

  • features:

    Uploads an attachment or unpacked MISP malware sample to MWDB using an API key. Optionally forwards event and attribute tags, the attribute comment and the MISP event ID. Returns a link to the uploaded sample. mwdb_url accepts an instance URL or an API URL ending in /api/. Boolean settings accept true/false, yes/no, on/off and 1/0. mwdb_public defaults to true for compatibility; set it to false to use normal instance sharing. See documentation/expansion/mwdb.md for configuration.

  • config:

    • mwdb_apikey
    • mwdb_url
    • mwdb_misp_attribute
    • mwdb_public
    • include_tags_event
    • include_tags_attribute

  • input:

    Attachment or malware sample

  • output:

    Link attribute pointing to the uploaded MWDB sample

  • references:

    https://mwdb.readthedocs.io/en/latest/user-guide/8-REST-and-mwdblib.html

  • requirements:

    • mwdblib>=4.0.0 and MWDB Core>=2.6.0
    • Optional keys.py file for MISP event and attribute tags
    • Optional MWDB attribute key configured in mwdb_misp_attribute

MWDB Query

Query an MWDB instance for an existing file by hash. [source code]

  • features:

    Looks up MD5, SHA-1, SHA-256 or SHA-512 using GET /file/{hash} with Bearer authentication. Reuses the MWDB Submit configuration names mwdb_apikey and mwdb_url (the API base URL ending in /api/). Returns a file object, a sample link and an annotation containing MWDB tags, file type and upload time. Tags remain contextual data rather than being applied as MISP tags. No samples are uploaded or downloaded.

  • config:

    • mwdb_apikey
    • mwdb_url

  • input:

    md5, sha1, sha256 or sha512 MISP attribute.

  • output:

    File metadata, MWDB context and a link to the sample.

  • references:

    https://mwdb.readthedocs.io/

  • requirements:

    requests

NetAPI Lookup

Check a domain, hostname or URL against the NetAPI compromised feed and get the domain's position in the NetAPI Top 1M. [source code]

  • features:

    The module takes a domain, hostname or URL (by its host) attribute and queries two free methods of the NetAPI JSON API. compromised-check says whether the value, or the registered domain a hostname belongs to, is in the NetAPI feed of hosts that public threat feeds report for malware or phishing: listed now (seen within the last 24 hours), listed in the past only, or never listed, with the first and last seen dates, the reporting feed and the registrar of the domain. domain-rank gives the position of the registered domain in the NetAPI Top 1M, a daily popularity ranking: a top-ranked domain in the feed is more likely a compromised legitimate site than infrastructure set up by the attacker. IP addresses are not covered, so a URL whose host is an IP address is not looked up.

    The answer is a reputation object linked to the queried attribute: classification malicious when the value is listed now, suspicious when only its registered domain is, and unknown when it is listed in the past only or never (the feed holds no opinion on a value it does not list), with the first and last seen dates, a link to the NetAPI domain lookup and the details and the Top 1M rank in its text.

    No API key is required. An optional NetAPI API token only raises the request limits (30 requests a minute and 1,000 a day per IP address without one). Only the queried indicator leaves the MISP instance.

  • config:

    • api_token
    • api_url

  • input:

    A domain, hostname or URL.

  • output:

    A reputation object with the feed listing and the Top 1M rank.

  • references:

NeutrinoAPI IP Blocklist

Enrich public IP addresses with NeutrinoAPI blocklist categories, detection flags, timestamps and sensor context. [source code]

  • features:

    Requires user_id and api_key, sent in HTTP headers to the IP Blocklist API. Set vpn_lookup to true to include public VPN providers (default false). Returns a referenced annotation with the listing status, categories, flags, first/last seen times, counts and sensor details. Missing flags remain unknown; is-vpn is only included when VPN lookup was requested. An unlisted address is not declared benign. All enrichment has to_ids disabled. Supports public IPv4 and IPv6 addresses.

  • config:

    • user_id
    • api_key
    • vpn_lookup

  • input:

    ip-src, ip-dst MISP attribute.

  • output:

    A referenced annotation containing IP blocklist intelligence.

  • references:

    https://www.neutrinoapi.com/api/ip-blocklist/

  • requirements:

    • requests
    • NeutrinoAPI user ID and API key

OCR Enrich

Module to process some optical character recognition on pictures. [source code]

  • 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.

  • input:

    A picture attachment.

  • output:

    Text and freetext fetched from the input picture.

  • requirements:

    cv2: The OpenCV python library.

ODS Enrich

Module to extract freetext from a .ods document. [source code]

  • 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.

  • 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.

ODT Enrich

Module to extract freetext from a .odt document. [source code]

  • 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.

  • input:

    Attachment attribute containing a .odt document.

  • output:

    Text and freetext parsed from the document.

  • requirements:

    ODT reader python library.

Onion Lookup

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

Onyphe Lookup

Module to process a query on Onyphe. [source code]

  • 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.

  • config:

    • apikey
    • mode
    • limit
    • timeout
    • since

  • input:

    An IP, domain, hostname, URL, CPE or X.509 fingerprint MISP attribute.

  • output:

    MISP attributes fetched from the Onyphe query.

  • references:

  • requirements:

    • pyonyphe python library, version 3.1.0 or later
    • An access to the Onyphe API (apikey)

Onyphe Full Lookup

Module to process a full query on Onyphe. [source code]

  • 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.

  • config:

    • apikey
    • limit
    • categories
    • timeout
    • since

  • input:

    An IP, domain, hostname, URL, CPE or X.509 fingerprint MISP attribute.

  • output:

    MISP attributes and objects fetched from the Onyphe queries.

  • references:

  • requirements:

    • pyonyphe python library, version 3.1.0 or later
    • An access to the Onyphe API (apikey)

OpenCTI Lookup

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

  • 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.

  • config:

    • url
    • token
    • max_results
    • timeout

  • 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.

  • references:

    https://docs.opencti.io/latest/reference/api/

  • requirements:

    • requests
    • An OpenCTI instance and an API token with knowledge read access.

Orange Cyberdefense Datalake

Look up indicators in the Orange Cyberdefense Datalake API. [source code]

  • 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.

  • config:

    token

  • input:

    domain, hostname, ip-src, ip-dst, url, md5, sha1, sha256, email-src, email-dst MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

  • requirements:

    requests

Orion Malware

Retrieve existing Orion Malware reports by file hash. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_results

  • input:

    md5, sha1, sha256 MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://orion-malware.com/

  • requirements:

    requests

OSINT Industries

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

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    email-src, email-dst, phone-number, github-username, btc MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.osint.industries/

  • requirements:

    requests

OTI Labs Domain Intelligence

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. [source code]

  • 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).

  • config:

    • apikey
    • subdomain_limit

  • input:

    A domain or a hostname.

  • output:

    whois, x509, dns-record and domain-ip objects describing the domain and its live subdomains.

  • references:

  • requirements:

    A RapidAPI key subscribed to the OTI Labs Domain Intelligence API (the free plan includes 1,000 requests a month).

AlienVault OTX Lookup

Module to get information from AlienVault OTX. [source code]

  • 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.

  • config:

    apikey

  • 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

  • references:

    https://www.alienvault.com/open-threat-exchange

  • requirements:

    An access to the OTX API (apikey)

Palo Alto WildFire

Retrieve WildFire verdicts and XML reports, or submit an attachment for analysis. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_size_mb
    • ca_bundle

  • input:

    md5, sha256, attachment MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.paloaltonetworks.com/wildfire/u-v/wildfire-api

  • requirements:

    requests

Pandora Submit

Submit attachments and malware samples to Pandora and return a link to the analysis. [source code]

  • features:

    Submits files to https://pandora.circl.lu by default. Set url to use another Pandora instance, including a deployment under a path prefix. apikey is optional. timeout defaults to 30 seconds. validity controls the shareable report link lifetime in seconds (default 0: no expiry). password optionally decrypts archives in Pandora. MISP malware-sample ZIPs are unpacked locally with the standard infected password. Submission starts an analysis; the module returns immediately without polling. See documentation/expansion/pandora_submit.md.

  • config:

    • url
    • apikey
    • timeout
    • validity
    • password

  • input:

    An attachment or a malware-sample with base64-encoded data.

  • output:

    A link to the Pandora analysis, including its access seed.

  • references:

  • requirements:

    • requests
    • Access to a Pandora instance; API key optional

Passive SSH Enrichment

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

  • features:

  • config:

    • custom_api_url
    • api_user
    • api_key

PassiveTotal Lookup

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 [source code]

  • 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

  • config:

    • username
    • api_key

  • 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

  • references:

    https://www.passivetotal.org/register

  • requirements:

    • Passivetotal python library
    • An access to the PassiveTotal API (apikey)

PDF Enrich

Module to extract freetext from a PDF document. [source code]

  • 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.

  • input:

    Attachment attribute containing a PDF document.

  • output:

    Text and freetext parsed from the document.

  • requirements:

    pdftotext: Python library to extract text from PDF.

PGP Keyserver

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

  • 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.

  • config:

    • keyserver
    • timeout
    • max_results
    • extract_signatures
    • max_signatures

  • 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.

  • references:

  • requirements:

    • requests
    • PyMISP
    • Install the pgp-key and pgp-message object templates in MISP
    • Install pgp-sign in MISP when extract_signatures is enabled

phishunt Lookup

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. [source code]

  • 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.

  • 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.

  • references:

  • requirements:

    No API key required.

Phone Number Information

Offline phone-number normalization, numbering-plan geography and original carrier lookup. [source code]

  • features:

    Parse phone-number and whois-registrant-phone attributes locally without API credentials or network calls. International numbers beginning with + need no configuration. National numbers and international dialling prefixes require default_region, a two-letter region code such as GB. The region is never guessed. Return a phone-number object with E.164 normalization, calling code, inferred region and a labeled text summary of validity, number type, numbering-plan area, original carrier, possible time zones and library version. Preserve extensions separately in the summary and retain the original attribute and its UUID. language selects the geographic/carrier description language (default en). Missing metadata is Unknown. A parseable but invalid number returns only the original attribute and a non-correlating text diagnostic. Malformed or ambiguous input returns an error. Short codes are outside the module's scope. Location describes numbering-plan allocation, not the subscriber's physical location. Carrier metadata may identify the original carrier rather than the current operator after number portability. Validity does not establish assignment, reachability or ownership.

  • config:

    • default_region
    • language

  • input:

    A phone-number or whois-registrant-phone attribute with type, value and uuid.

  • output:

    The original attribute and a linked phone-number object, or a text diagnostic for invalid numbers.

  • references:

  • requirements:

    phonenumbers >=9.0,<10.0 (included in the minimal and all installation extras)

Plum Island IP History

Retrieve historical scan observations from the Plum Island Discovery API v1. [source code]

  • features:

    Read-only show_ip lookup for IPv4/IPv6. Configure an HTTPS base url and FAB username/password or access_token. hostname selects one requested-hostname group; empty selects IP-only scans. max_results defaults to 25 (1-100), max_pages to 10 (1-20). Optional from_ts/to_ts are UTC epoch seconds. Preserves raw documents, UID tags, observation times, missing-document warnings and hostname choices in referenced annotations with to_ids=False. Requires Discovery API v1, added after v0.2610.0. Never schedules scans.

  • config:

    • url
    • username
    • password
    • access_token
    • max_results
    • max_pages
    • from_ts
    • to_ts
    • hostname

  • data-source:

    external

  • input:

    ip-src or ip-dst attribute containing one IPv4/IPv6 address.

  • output:

    Referenced annotation objects containing scan evidence and pagination completeness.

  • references:

    https://github.com/D4-project/Plum-Island/blob/main/documentation/discovery.md

  • requirements:

    • requests
    • pymisp

Find IPs observed with a domain, hostname, network or certificate fingerprint in Plum Island. [source code]

  • features:

    Uses read-only structured Discovery search, including requested and observed domain/hostname fields. IP attributes may contain CIDRs. Certificate fingerprints use x509 indexes, not file hash indexes. Configure HTTPS url and FAB username/password or access_token. max_results defaults to 25 (1-100), max_pages to 10 (1-20). Optional from_ts/to_ts are UTC epoch seconds; otherwise Plum defaults to the last three calendar months. Follows signed cursors across empty windows. Returns IP pivots with to_ids=False and referenced evidence annotations. Reports incomplete searches when either budget is reached. Requires Discovery API v1, added after v0.2610.0.

  • config:

    • url
    • username
    • password
    • access_token
    • max_results
    • max_pages
    • from_ts
    • to_ts

  • data-source:

    external

  • input:

    IP/CIDR, domain, hostname or x509-fingerprint-md5/sha1/sha256 attribute.

  • output:

    IP destination attributes and referenced annotations with matching UIDs, timestamps and search scope.

  • references:

    https://github.com/D4-project/Plum-Island/blob/main/documentation/discovery.md

  • requirements:

    • requests
    • pymisp

PolySwarm Enrichment

Retrieve PolySwarm sample reputation, engine verdicts and file metadata. [source code]

  • 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.

  • config:

    • apikey
    • community
    • max_results

  • input:

    md5, sha1, sha256 MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.polyswarm.io/

  • requirements:

    requests

PolySwarm Sandbox

Retrieve PolySwarm sandbox tasks or submit an existing PolySwarm sample for sandbox analysis. [source code]

  • 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.

  • config:

    • apikey
    • community
    • mode
    • provider
    • vm

  • input:

    sha256, text MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.polyswarm.io/

  • requirements:

    requests

PPTX Enrich

Module to extract freetext from a .pptx document. [source code]

  • 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.

  • input:

    Attachment attribute containing a .pptx document.

  • output:

    Text and freetext parsed from the document.

  • requirements:

    pptx: Python library to read PowerPoint files.

Proofpoint ET Intelligence

Enrich domains, IPv4 addresses and MD5 hashes using Proofpoint ET Intelligence. [source code]

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    domain, hostname, ip-src, ip-dst, md5 MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://eti.emergingthreats.net/

  • requirements:

    requests

PTR Classification

Classify PTR hostnames and tag queried attributes with the ptrclassify taxonomy. [source code]

  • 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.

  • config:

    nameserver

  • 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.

  • references:

  • requirements:

    ptrclassify and dnspython Python libraries; DNS access for IP lookups

Pulsedive

Look up IP, domain and URL risk, linked threats, feeds and DNS observations in Pulsedive. [source code]

  • features:

    Uses the existing indicator lookup API only; never submits an indicator or starts an active scan. api_key is optional, with stricter service limits for unauthenticated requests. The API requires the key as a query parameter, so avoid logging request URLs. Returns a referenced annotation containing risk, retirement state, risk factors, timestamps, threats and feed provenance. DNS addresses become domain-ip objects. Other DNS names, IP reverse-DNS PTR names and observed redirects are pivotable attributes. A 404 returns a no-information annotation and does not imply that the indicator is benign. All enrichment has to_ids disabled.

  • config:

    api_key

  • input:

    ip-src, ip-dst, domain, hostname, url MISP attribute.

  • output:

    A referenced annotation, domain-ip objects and related hostname/URL attributes.

  • references:

  • requirements:

    • requests
    • Optional Pulsedive API key

Qintel QSentry Lookup

A hover and expansion module which queries Qintel QSentry for ip reputation data [source code]

  • 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

  • config:

    • token
    • remote

  • input:

    ip address attribute

  • ouput:

    Objects containing the enriched IP, threat tags, last seen attributes and associated Autonomous System information

  • references:

    https://www.qintel.com/products/qsentry/

  • requirements:

    A Qintel API token

QR Code Decode

Decode QR codes from attachments OR remote URLs (Anti-Quishing). [source code]

  • 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

Qualys CVE Enrichment

Retrieve Qualys KnowledgeBase vulnerability details for a CVE identifier. [source code]

  • 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.

  • config:

    • url
    • username
    • password
    • max_results

  • input:

    vulnerability MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.qualys.com/en/vm/api/

  • requirements:

    requests

RandomcoinDB Lookup

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

  • 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.

  • config:

    api-key

  • descrption:

    Module to access the ransomcoinDB with a hash or btc address attribute and get the associated btc address of hashes.

  • input:

    A hash (md5, sha1 or sha256) or btc attribute.

  • output:

    Hashes associated to a btc address or btc addresses associated to a hash.

  • references:

    https://ransomcoindb.concinnity-risks.com

  • requirements:

    A ransomcoinDB API key.

RansomLook Lookup

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

Rapid7 AttackerKB lookup

Module to lookup CVE attributes in Rapid7 AttackerKB. [source code]

  • 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.

  • config:

    api_key

  • 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

  • references:

    https://attackerkb.com/

  • requirements:

    A valid public Rapid7 AttackerKB API key https://api.attackerkb.com/v1/api-docs/docs

Real-time Blackhost Lists Lookup

Module to check an IPv4 address against known RBLs. [source code]

  • 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.

  • config:

    timeout

  • input:

    IP address attribute.

  • output:

    One reputation object per Real-time Blackhost List the IP address is listed on.

  • references:

    RBLs list

  • requirements:

    dnspython3: DNS python3 library

RDAP Lookup

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. [source code]

  • 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.

  • input:

    A domain, hostname, IP address or URL attribute.

  • output:

    A whois object holding the registration data returned by RDAP.

  • references:

Recorded Future Enrich

Module to enrich attributes with threat intelligence from Recorded Future. [source code]

  • 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.

  • config:

    • token
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password

  • 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.

  • references:

    https://www.recordedfuture.com/

  • requirements:

    A Recorded Future API token.

Reverse DNS

Simple Reverse DNS expansion service to resolve reverse DNS from MISP attributes. [source code]

  • 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.

  • config:

    nameserver

  • input:

    An IP address attribute.

  • output:

    A dns-record object holding the PTR records the input resolves to.

  • requirements:

    DNS python library

ReversingLabs Malware Presence

Retrieve ReversingLabs file reputation and malware presence. [source code]

  • 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.

  • config:

    • username
    • password
    • url

  • input:

    md5, sha1, sha256 MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.reversinglabs.com/SpectraIntelligence/API/

  • requirements:

    requests

ReversingLabs Spectra Analyze

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

  • 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.

  • config:

    • api_url
    • api_token
    • verify_ssl

  • 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.

  • references:

    https://github.com/reversinglabs/reversinglabs-misp

  • requirements:

    A ReversingLabs Spectra Analyze API token.

  • support:

    support@reversinglabs.com

ReversingLabs Spectra Intelligence Submission

Submit a file hash, URL or attachment to ReversingLabs Spectra Intelligence dynamic analysis. [source code]

  • 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.

  • config:

    • username
    • password
    • url
    • platform
    • mode
    • max_size_mb

  • input:

    md5, sha1, sha256, url, attachment MISP attribute.

  • output:

    Referenced enrichment objects and pivotable attributes.

  • references:

    https://docs.reversinglabs.com/SpectraIntelligence/API/

  • requirements:

    requests

RIPEstat

Query RIPEstat for the announcing ASNs, prefixes and ASN holders of IP, prefix and AS attributes. [source code]

  • features:

    Uses the public network-info, prefix-overview and as-overview endpoints without an API key. Supports IPv4, IPv6 and multiple origin ASNs. Returns linked asn objects with contextual attributes (to_ids=false). The optional sourceapp identifies regular API usage; defaults to misp-modules. See the usage guide in documentation/expansion/ripestat.md.

  • config:

    sourceapp

  • input:

    An ip-src or ip-dst address/CIDR prefix, or an AS attribute (AS3333 or 3333).

  • output:

    ASN objects with holder descriptions and the observed announcing prefix, linked to the source attribute.

  • references:

    https://stat.ripe.net/docs/data-api/ripestat-data-api

  • requirements:

    requests

RST Cloud Cobalt Strike Beacon

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

  • 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.

  • config:

    • api_key
    • base_url
    • port
    • timeout

  • input:

    IP, URL, domain, or hostname attribute (optional port via config).

  • output:

    file MISP object(s) with beacon hashes and Cobalt Strike galaxy tag.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud Favicon

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

  • 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.

  • config:

    • api_key
    • base_url
    • timeout

  • input:

    URL, domain, hostname, or IP attribute.

  • output:

    file MISP object, favicon-hash attribute, and resolved favicon URL.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud HTML Fetcher

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

  • 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.

  • config:

    • api_key
    • base_url
    • mode
    • port
    • timeout

  • 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.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud IoC Lookup

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. [source code]

  • 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.

  • config:

    • api_key
    • base_url
    • misp_url
    • misp_key
    • misp_verifycert

  • input:

    IP, domain, hostname, URL, or hash attribute (incl. host|port composites).

  • output:

    rst-ioc MISP object, galaxy/score tags, and optional related attributes.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud 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. [source code]

  • 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).

  • config:

    • api_key
    • base_url
    • misp_url
    • misp_key
    • misp_verifycert

  • input:

    IP, domain, hostname, URL, or hash attribute (incl. host|port composites).

  • output:

    rst-noise MISP object with verdict, category, and risk/noise tags.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud Screenshot

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

  • 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.

  • config:

    • api_key
    • base_url
    • frame
    • port
    • timeout

  • input:

    URL, domain, hostname, or IP attribute (optional port via config).

  • output:

    image MISP object with PNG attachment linked to the enriched attribute.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud SSL Certificate

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

  • 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.

  • config:

    • api_key
    • base_url
    • port
    • timeout

  • input:

    IP, hostname, or domain attribute (optional port via config or composite).

  • output:

    x509 MISP object referencing the enriched attribute.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

RST Cloud Whois

Retrieve parsed WHOIS information for a domain via RST Cloud. [source code]

  • 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.

  • config:

    • api_key
    • base_url

  • input:

    Domain or hostname attribute.

  • output:

    whois MISP object with registration and nameserver fields.

  • references:

  • requirements:

    • An RST Cloud API key.
    • rstapi>=1.2.0 (PyPI).

Rulezet Rule 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. [source code]

  • 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.

  • config:

    url

  • 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.

  • references:

  • requirements:

    Access to a Rulezet instance (https://rulezet.org by default)

ScanMalware Lookup

Query ScanMalware for subdomains, browser-observed hosts and sandbox scan results. [source code]

  • 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.

  • config:

    • api_url
    • max_results

  • input:

    A domain, hostname, URL or IP address.

  • output:

    Domain attributes for the hosts found, plus text and link attributes describing the scan.

  • references:

SecurityTrails Lookup

An expansion modules for SecurityTrails. [source code]

  • 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.

  • config:

    apikey

  • input:

    A domain, hostname or IP address attribute.

  • output:

    passive-dns, whois and domain-ip objects describing what SecurityTrails knows about the input.

  • references:

    https://securitytrails.com/

  • requirements:

    • dnstrails python library
    • An access to the SecurityTrails API (apikey)

ShadowTrackr

Enrich IP addresses with ShadowTrackr false-positive and infrastructure context. [source code]

  • 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.

  • config:

    apikey

  • input:

    ip-src, ip-dst MISP attribute.

  • output:

    A referenced annotation containing IP intelligence.

  • references:

    https://shadowtrackr.com/docs_v3/5-API

  • requirements:

    requests

Sherlock Lookup

Find social media accounts by username with Sherlock. [source code]

  • 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. Start misp-modules with --debug to log the command, live CLI output, elapsed time and report summary; this also enables Sherlock's --verbose output. --debug-extended HTTP tracing runs in the server process and cannot trace Sherlock's separate process. For troubleshooting, first limit sites to GitHub. Results can contain false positives and should be reviewed.

  • config:

    • sherlock_path
    • sites
    • timeout
    • scan_timeout

  • 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.

  • references:

  • requirements:

    Install the sherlock-project CLI separately (for example: pipx install sherlock-project). No API key required.

Shodan Lookup

Module to query on Shodan. [source code]

  • features:

    The module takes an IP address as input and queries the Shodan API to get some additional data about it.

  • config:

    apikey

  • input:

    An IP address MISP attribute.

  • output:

    Text with additional data about the input, resulting from the query on Shodan.

  • references:

    https://www.shodan.io/

  • requirements:

    • shodan python library
    • An access to the Shodan API (apikey)

Shodan InternetDB

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

  • 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.

  • input:

    ip-src, ip-dst MISP attribute.

  • output:

    An ip-port object and hostname, CPE and vulnerability attributes.

  • references:

    https://internetdb.shodan.io/

  • requirements:

    requests

Sigma Rule Converter

An expansion hover module to display the result of sigma queries. [source code]

  • 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.

  • input:

    A Sigma attribute.

  • output:

    Text displaying results of queries on the Sigma attribute.

  • references:

    https://github.com/Neo23x0/sigma/wiki

  • requirements:

    Sigma python library

Sigma Syntax Validator

An expansion hover module to perform a syntax check on sigma rules. [source code]

  • 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.

  • data-source:

    internal

  • input:

    A Sigma attribute.

  • output:

    Text describing the validity of the Sigma rule.

  • references:

    https://github.com/Neo23x0/sigma/wiki

  • requirements:

    • Sigma python library
    • Yaml python library

SigMF Expansion

Expands a SigMF Recording object into a SigMF Expanded Recording object, extracts a SigMF archive into a SigMF Recording object. [source code]

  • features:

Silent Push Enrichment

Retrieve domain and IP risk and infrastructure context from Silent Push. [source code]

  • 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.

  • config:

    apikey

  • input:

    domain, hostname, ip-src, ip-dst, url MISP attribute.

  • output:

    A context annotation and related ASN and hostname attributes.

  • references:

    https://help.silentpush.com/docs/get-enrichment-data

  • requirements:

    requests

SoChain

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

  • 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.

  • config:

    apikey

  • 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.

  • references:

  • requirements:

    • requests
    • PyMISP

Socialscan Lookup

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

  • 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.

  • input:

    An email address or usename attribute.

  • output:

    One user-account object per online platform the email address or username has an account on.

  • references:

    https://github.com/iojw/socialscan

  • requirements:

    The socialscan python library

SOCRadar Threat Intelligence

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. [source code]

  • 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.

  • config:

    • socradar_api_key
    • socradar_api_url
    • socradar_mode
    • socradar_ai_insight

  • 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.

  • references:

  • requirements:

    requests

SophosLabs Intelix Lookup

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

  • 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.

  • config:

    • client_id
    • client_secret
    • region

  • input:

    An ip address, url, domain or sha256 attribute.

  • output:

    SophosLabs Intelix report and lookup objects

  • references:

    https://aws.amazon.com/marketplace/pp/B07SLZPMCS

  • requirements:

    A client_id and client_secret pair to authenticate to the SophosLabs Intelix API

URL Archiver

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

  • 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.

  • config:

    archivepath

  • input:

    A link or url attribute.

  • output:

    A page-capture object holding the cached page.

  • references:

    https://github.com/adulau/url_archiver

  • requirements:

    urlarchiver: python library to fetch and archive URL on the file-system

SpamCop Lookup

Check an IPv4 address against the SpamCop Blocking List (SCBL). [source code]

  • 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.

  • config:

    timeout

  • 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.

  • references:

  • requirements:

    dnspython

SSH Fingerprint

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

  • 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.

  • input:

    An IP address attribute (ip-src or ip-dst).

  • output:

    passive-ssh MISP object with banner and fingerprint.

  • references:

    https://tools.ietf.org/html/rfc4253

Qualys SSL Labs

Retrieve SSL Labs API v4 TLS assessments, endpoint grades and certificate details for a hostname. [source code]

  • features:

    Requires an organization email already registered with SSL Labs API v4. No registration is performed by this module. Set allow_scan to true before any API request is made. The analyze endpoint can start an assessment even when cached results are requested. Cached reports up to max_age hours old (default 24) are preferred; a cache miss can start a scan. Such assessments run on Qualys servers and can take minutes. Each invocation makes one API call and returns progress; run the module again later to retrieve the result. It never forces a restart with startNew and does not publish a report on the public results board. Complete results include endpoint grades, protocols, cipher suites and weakness-test results as contextual annotations, endpoint ip-port objects and x509 certificate objects. Partial or failed endpoints are labelled and are not assigned a successful grade. Numeric test statuses are retained without interpreting unknown/error values as vulnerabilities. All enrichment has to_ids disabled.

  • config:

    • email
    • allow_scan
    • max_age

  • input:

    domain, hostname MISP attribute.

  • output:

    Referenced progress/assessment annotations, endpoint ip-port objects and x509 objects.

  • references:

  • requirements:

    • requests
    • An email registered with SSL Labs API v4

Stairwell Lookup

Module to query the Stairwell API to get additional information about the input hash attribute [source code]

  • 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.

  • config:

    apikey

  • input:

    A hash attribute (md5, sha1, sha256).

  • output:

    File object related to the input attribute found on Stairwell platform.

  • references:

  • requirements:

    Access to Stairwell platform (apikey)

STIX2 Pattern Syntax Validator

An expansion hover module to perform a syntax check on stix2 patterns. [source code]

  • 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.

  • input:

    A STIX2 pattern attribute.

  • output:

    Text describing the validity of the STIX2 pattern.

  • references:

    STIX2.0 patterning specifications

  • requirements:

    stix2patterns python library

Team Cymru Scout

Retrieve Scout foundation intelligence for an IP address or search for a domain. [source code]

  • 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.

  • config:

    apikey

  • input:

    domain, hostname, ip-src, ip-dst MISP attribute.

  • output:

    MISP attributes, objects and tags converted from Scout STIX intelligence.

  • references:

    https://scout.cymru.com/

  • requirements:

    • requests
    • misp-stix (included in the all extra)

Run an explicit Scout search query and import the returned intelligence. [source code]

  • 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.

  • config:

    • apikey
    • days

  • input:

    text MISP attribute.

  • output:

    MISP attributes, objects and tags converted from Scout search results.

  • references:

    https://scout.cymru.com/

  • requirements:

    • requests
    • misp-stix (included in the all extra)

ThreatCrowd Lookup

Module to get information from ThreatCrowd. [source code]

  • 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.

  • 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

  • references:

    https://www.threatcrowd.org/

ThreadFox Lookup

Module to search for an IOC on ThreatFox by abuse.ch. [source code]

  • features:

  • config:

    auth_key

ThreatMiner Lookup

Module to get information from ThreatMiner. [source code]

  • 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.

  • 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

  • references:

    https://www.threatminer.org/

TLS Certificate Check

Extract TLS certificate details from a domain and return as x509 MISP object. [source code]

  • 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.

  • input:

    A domain or hostname attribute.

  • output:

    x509 MISP object with certificate details.

  • references:

    https://tools.ietf.org/html/rfc5246

Triage Report Enrichment

Retrieve Triage overview reports by trusted report link or search existing analyses by file hash. api_url defaults to https://tria.ge/api; configure https://private.tria.ge/api for private accounts. Overview reports preserve verdicts, signatures, extracted configuration and available analysis metadata. This module performs lookups only. It does not submit samples or poll unfinished tasks. [source code]

  • features:

    Retrieve Triage overview reports by trusted report link or search existing analyses by file hash. api_url defaults to https://tria.ge/api; configure https://private.tria.ge/api for private accounts. Overview reports preserve verdicts, signatures, extracted configuration and available analysis metadata. This module performs lookups only. It does not submit samples or poll unfinished tasks.

  • config:

    • api_key
    • api_url
    • max_results

  • data-source:

    external

  • input:

    link, md5, sha1, sha256

  • output:

    MISP objects linked to the original attribute.

  • references:

    https://tria.ge/docs/

  • requirements:

    • requests
    • pymisp

Triage Submit

Module to submit samples to tria.ge [source code]

  • config:
    • apikey
    • url_mode

TruSTAR Enrich

Module to get enrich indicators with TruSTAR. [source code]

  • 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.

  • config:

    • user_api_key
    • user_api_secret
    • enclave_ids

  • 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.

  • references:

    https://docs.trustar.co/api/v13/indicators/get_indicator_summaries.html

TweetFeed Lookup

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. [source code]

  • 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.

  • 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.

  • references:

  • requirements:

    No API key required.

UnpacMe Lookup

Find existing UnpacMe unpacking results for a SHA-256 hash. [source code]

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    sha256 MISP attribute.

  • output:

    Submission annotations and unpacked-child file objects.

  • references:

    https://api.unpac.me/

  • requirements:

    requests

URL DNS and ASN Expansion

Resolve URL hosts into IPv4/IPv6 IP-port objects and IPv4 ASN objects. [source code]

  • 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.

  • config:

    nameserver

  • input:

    A URL attribute with type, value and UUID.

  • output:

    Linked ip-port objects for IPv4/IPv6 and asn objects for public IPv4 addresses.

  • references:

    https://www.team-cymru.com/ip-asn-mapping

  • requirements:

    • dnspython
    • PyMISP

URL Shortener Resolver

Resolve known HTTP(S) URL shorteners into a shortened-link object. [source code]

  • features:

    Resolve known shorteners and optional additional_shorteners (comma-separated exact hostnames). Follow at most max_redirects HTTP redirects (default 10, maximum 20), using HEAD with streamed GET fallback on HTTP 405/501. timeout is per request (default 10 seconds, maximum 30); DNS uses the system resolver. Every hop must resolve exclusively to public addresses on ports 80/443. Connections are pinned to a validated address with TLS hostname verification. Return the original attribute and a shortened-link object with the final destination and ordered redirect history. No API key, proxy, browser, JavaScript or HTML redirect processing is used. Generated attributes have to_ids=false.

  • config:

    • additional_shorteners
    • max_redirects
    • timeout

  • input:

    A URL attribute containing type, value and UUID.

  • output:

    A shortened-link object referencing the original URL attribute.

  • references:

  • requirements:

    • urllib3
    • certifi
    • idna
    • PyMISP
    • Direct outbound HTTP(S) and DNS access

URLhaus Lookup

Query of the URLhaus API to get additional information about the input attribute. [source code]

  • 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.

  • config:

    auth_key

  • input:

    A domain, hostname, url, ip, md5 or sha256 attribute.

  • output:

    MISP attributes & objects fetched from the result of the URLhaus API query.

  • references:

    https://urlhaus.abuse.ch/

URLScan Lookup

An expansion module to query urlscan.io. [source code]

  • 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.

  • config:

    apikey

  • input:

    A domain, hostname or url attribute.

  • output:

    url, domain-ip, geolocation, asn, x509, image and reputation objects describing the scan.

  • references:

    https://urlscan.io/

  • requirements:

    An access to the urlscan.io API

Validin DNS History

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

  • 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.

  • config:

    • endpoint
    • api_key
    • result_limit

  • input:

    domain, hostname, or IP address.

  • output:

    MISP dns-record objects plus optional subdomain attributes.

  • requirements:

    • requests
    • pymisp

VARIoT db Lookup

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

  • 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.

  • config:

    API_key

  • 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.

  • references:

    https://www.variotdbs.pl/

  • requirements:

    A VARIoT db API key (if you do not want to be limited to 100 queries / day)

VirusTotal v3 Lookup

Enrich observables with the VirusTotal v3 API [source code]

  • 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, 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.

  • config:

    • apikey
    • event_limit
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password

  • 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.

  • references:

  • requirements:

    An access to the VirusTotal API (apikey), with a high request rate limit.

VirusTotal Sample Downloader

Download an existing file from VirusTotal by hash. [source code]

  • 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.

  • config:

    • apikey
    • max_size_mb

  • input:

    md5, sha1, sha256 MISP attribute.

  • output:

    A file object with a binary attachment and verified hashes.

  • references:

    https://docs.virustotal.com/reference/files-download

  • requirements:

    requests

VirusTotal Public API Lookup

Enrich observables with the VirusTotal v3 public API [source code]

  • 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, 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.

  • config:

    • apikey
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password

  • 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.

  • references:

  • requirements:

    An access to the VirusTotal API (apikey)

VirusTotal Upload

Module to push malware samples to VirusTotal [source code]

  • config:

    virustotal_apikey

  • requirements:

    requests library

VMRay Analyzer Lookup

Retrieve existing VMRay sample and analysis context by file hash. [source code]

  • 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.

  • config:

    • apikey
    • url
    • max_results

  • input:

    md5, sha1, sha256 MISP attribute.

  • output:

    File objects, report links and referenced analysis annotations.

  • references:

    https://www.vmray.com/

  • requirements:

    requests

VMRay Submit

Module to submit a sample to VMRay. [source code]

  • 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.

  • config:

    • apikey
    • url
    • shareable
    • do_not_reanalyze
    • do_not_include_vmrayjobids

  • 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

  • references:

    https://www.vmray.com/

  • requirements:

    An access to the VMRay API (apikey & url)

VMware NSX Defender Enrich

Module to enrich a file or URL with VMware NSX Defender. [source code]

  • 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.

  • config:

    • analysis_url
    • analysis_verify_ssl
    • analysis_key
    • analysis_api_token
    • vt_key
    • misp_url
    • misp_verify_ssl
    • misp_key

  • input:

    File hash, attachment or URL to be enriched with VMware NSX Defender.

  • output:

    Objects and tags generated by VMware NSX Defender.

  • references:

    https://www.vmware.com

  • requirements:

    The module requires a VMware NSX Defender Analysis api_token and key.

VulDB

Expand CVEs, VulDB identifiers and CPEs using the VulDB API. [source code]

  • features:

    Look up CVEs with an exact advanced search, VulDB IDs with an ID request, or CPEs with a product search. Returns one vulnerability object per entry, linked to the original attribute. apikey is required. details defaults to false; enabling it consumes one API credit per returned entry and requires the appropriate subscription. limit defaults to 10 (1-100); timeout defaults to 30 seconds (maximum 120). Null or blank optional settings use these defaults. One request is made per enrichment, without automatic retries or pagination. CPE search is experimental in VulDB; check version applicability before using the results. See the usage guide: https://github.com/MISP/misp-modules/blob/main/documentation/expansion/vuldb.md

  • config:

    • apikey
    • details
    • limit
    • timeout

  • data-source:

    external

  • input:

    A vulnerability attribute containing a CVE, VULDB-67685 or numeric VulDB ID; or a CPE attribute.

  • output:

    Vulnerability objects with identifiers, titles, dates and references; optional descriptions, CPEs and CVSS.

  • references:

  • requirements:

    • requests
    • pymisp
    • A VulDB API key

VulnDB Lookup

Module to query VulnDB (Flashpoint). [source code]

  • 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.

    Register an OAuth client application in VulnDB under API > Overview. Set apikey to its client ID and apisecret to its client secret. Legacy OAuth 1 consumer credentials must be replaced with OAuth 2.0 client credentials. Authentication uses requests; the legacy oauth2 package is no longer required.

  • config:

    • apikey
    • apisecret
    • discard_dates
    • discard_external_references
    • discard_cvss
    • discard_productinformation
    • discard_classification
    • discard_cpe

  • input:

    A vulnerability attribute.

  • output:

    Additional data enriching the CVE input, fetched from VulnDB.

  • references:

    https://vulndb.flashpoint.io/

  • requirements:

    VulnDB OAuth 2.0 client credentials (apikey: client ID, apisecret: client secret)

Vulnerability Lookup

Expand vulnerabilities and CPEs with Vulnerability Lookup advisories and enrichment [source code]

  • 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.

  • config:

    • api_url
    • timeout
    • max_related
    • with_linked
    • with_comments
    • with_bundles
    • with_sightings
    • with_meta
    • with_epss
    • with_kev
    • with_timeline
    • cpe_source
    • cpe_page

  • 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.

  • references:

  • requirements:

    • requests
    • pymisp

Vulners Lookup

An expansion hover module to expand information about CVE id using Vulners API. [source code]

  • 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.

  • config:

    apikey

  • input:

    A vulnerability attribute.

  • output:

    A vulnerability object, one exploit object per public exploit, and the Vulners AI score.

  • references:

    https://vulners.com/

  • requirements:

    • Vulners python library
    • An access to the Vulners API

Vysion Enrich

Module to enrich the information by making use of the Vysion API. [source code]

  • 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.

  • config:

    • apikey
    • event_limit
    • proxy_host
    • proxy_port
    • proxy_username
    • proxy_password

  • 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.

  • references:

  • requirements:

    • Vysion python library
    • Vysion API Key

Webarchive (Wayback Machine)

Query the Internet Archive Wayback Machine for an existing web page snapshot. [source code]

  • 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:///. 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.

  • config:

    timestamp

  • 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.

  • references:

    https://archive.org/help/wayback_api.php

  • requirements:

    • requests
    • PyMISP

Whisper

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

  • 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.

  • config:

    • api_url
    • api_key
    • max_tlp
    • timeout

  • 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.

  • references:

    https://whisper.security

  • requirements:

    An access to the Whisper graph API (api_url + api_key)

Whois Lookup

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. [source code]

  • 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).

  • config:

    • server
    • port

  • 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.

  • references:

  • requirements:

    uwhois: A whois python library

WhoisFreaks Lookup

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. [source code]

  • 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.

  • config:

    apikey

  • 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.

  • references:

    https://whoisfreaks.com/

  • requirements:

    An access to the Whoisfreaks API_KEY

Wikidata Lookup

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

  • 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.

  • input:

    Text attribute.

  • output:

    Text attribute.

  • references:

    https://www.wikidata.org

  • requirements:

    SPARQLWrapper python library

IBM X-Force Exchange Lookup

An expansion module for IBM X-Force Exchange. [source code]

  • 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.

  • config:

    • apikey
    • apipassword

  • 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.

  • references:

    https://exchange.xforce.ibmcloud.com/

  • requirements:

    An access to the X-Force API (apikey)

XLXS Enrich

Module to extract freetext from a .xlsx document. [source code]

  • 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.

  • 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.

XposedOrNot Lookup

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

  • 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.

  • config:

    api_key

  • input:

    An email address.

  • output:

    One breach object per data breach the email address appears in.

  • references:

  • requirements:

    No API key required.

YARA Rule Generator

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

  • 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.

  • 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.

  • references:

  • require_standard_format:

    True

  • requirements:

    yara-python python library

YARA Syntax Validator

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

  • 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

  • input:

    YARA rule attribute.

  • output:

    Text to inform users if their rule is valid.

  • references:

    http://virustotal.github.io/yara/

  • requirements:

    yara_python python library

Yeti Lookup

Module to process a query on Yeti. [source code]

Zetalytics Passive DNS

Look up passive DNS records in Zetalytics. [source code]

  • 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.

  • config:

    • apikey
    • max_results

  • input:

    domain, hostname, ip-src, ip-dst MISP attribute.

  • output:

    Referenced DNS record objects with observation times.

  • references:

  • requirements:

    requests

ZoomEye

Search ZoomEye API v2 for IP addresses, domains, hostnames and SHA-1 certificate fingerprints. [source code]

  • features:

    Requires api_key. Builds an escaped, Base64-encoded search query for API v2 and requests one page of up to max_results assets (default 20, maximum 100). Uses the v4/v6 dataset for IPs, web for domains, and all datasets for hostnames and certificate fingerprints. Leading/trailing API key whitespace is removed. A result-limit notice is included when total exceeds the returned records; additional pages are not fetched automatically. Returns referenced ip-port objects with service/banner context, and an annotation retaining result counts and observed metadata. Certificate searches identify assets using an observed certificate, not a malicious verdict. All enrichment has to_ids disabled.

  • config:

    • api_key
    • max_results

  • input:

    ip-src, ip-dst, domain, hostname, x509-fingerprint-sha1 MISP attribute.

  • output:

    Referenced ip-port objects and an annotation with result count and search coverage.

  • references:

    https://github.com/zoomeye-ai/ZoomEye-python/blob/master/api.md

  • requirements:

    • requests
    • ZoomEye API key