FeedMandiantThreatIntelligence

Fetch indicators from Mandiant Advantage.

Data Enrichment & Threat Intelligence · Mandiant Advantage Threat Intelligence · Feed

Details

IDFeedMandiantThreatIntelligence
ProviderGoogle
CategoryData Enrichment & Threat Intelligence
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Mandiant Threat Intelligence Feed

Prerequisites

  • A Mandiant Advantage Threat Intelligence account

Get Credentials

  • Log into advantage.mandiant.com
  • Navigate to Settings, then scroll down to APIv4 Access and Key.
  • Click Get Key ID and Secret.

Upgrading from previous versions

Version 1.1 supercedes all previous versions of the Mandiant Advantage Threat Intelligence Integration and splits feed and enrichment capabilities into 2 separate integrations. Customers upgrading from earlier versions should follow these steps:

  1. Note the instance name of your existing Mandiant Advantage Threat Intelligence integration instance, this is needed in a later step.
  2. Remove all instances of existing Mandiant Advantage Threat Intelligence integrations.
  3. Optionally, remove the integration from your Cortex XSOAR server.
  4. Remove all indicators created by the previous version. To do this:
    a. Open the Threat Intel page and perform an All Time search using this query sourceInstances:"<INSTANCE NAME>", where <INSTANCE_NAME> is the name of your old integration instance collected in step 1.
    b. Select all indicators.
    c. Click Delete and Exclude.
    d. In the Delete and Exclude dialog box, check the Do not add to exclusion list checkbox and click the Delete and Exclude button.
  5. Once the indicator deletion process completes, install the new version of the integration and add an instance of the FeedMandiant integration to re-establish the feed.

NOTE: To enable enrichment commands, also add an instance of the Mandiant integration.

Integration Settings

Parameter Description Required
Fetch indicators Whether the integration should check Mandiant for new indicators. False
API Key Your API Key from Mandiant Advantage Threat Intelligence. True
Secret Key Your Secret Key from Mandiant Advantage Threat Intelligence. True
Page Size The number of indicators to request in each page. True
Timeout API calls timeout. False
Indicator Reputation Indicators from this integration instance will be marked with this reputation. False
Source Reliability Reliability of the source providing the intelligence data. True
Feed Minimum Threat Score The minimum Threat Score value to import as part of the feed. True
First fetch time The maximum value allowed is 90 days. False
Feed Exclude Open Source Intelligence Whether to exclude Open Source Intelligence as part of the feed. False
Traffic Light Protocol Color The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. False
Tags Supports CSV values. False
Feed Expiration Policy Defines how expiration of an indicator created by the feed will be managed. False
Feed Expiration Interval Defines the expiration date based on the number of days after an indicator is created / updated when the Feed Expiration Policy is set to interval. False
Feed Fetch Interval How frequently the feed should check Mandiant for new indicators. True

Commands

mandiant-get-indicators

Returns a list of indicators in JSON format.

Base Command

mandiant-get-indicators

Input

Argument Description Required
limit The maximum number of indicators to fetch. True

Context Output

This command has no context output.

Configuration parameters

  • feed — Fetch indicators
  • api_key — API Key (required)
  • secret_key — Secret Key (required)
  • page_size — Page Size (required)
  • timeout — Timeout
  • feedReputation — Indicator Reputation
  • feedReliability — Source Reliability (required)
  • feedMinimumThreatScore — Feed Minimum Threat Score (required)
  • first_fetch — First fetch time
  • feedExcludeOSIntel — Feed Exclude Open Source Intelligence
  • tlp_color — Traffic Light Protocol Color
  • feedTags — Tags
  • feedExpirationPolicy
  • feedExpirationInterval
  • feedFetchInterval — Feed Fetch Interval (required)
  • feedIncremental — Incremental feed
  • feedBypassExclusionList — Bypass exclusion list

Commands (1)

  • mandiant-get-indicators

    Fetch indicators.

name: FeedMandiantThreatIntelligence
display: Mandiant Feed
description: Fetch indicators from Mandiant Advantage.
category: Data Enrichment & Threat Intelligence
provider: Google
commonfields:
  id: FeedMandiantThreatIntelligence
  version: -1
sectionorder:
- Connect
- Collect
configuration:
- defaultvalue: 'true'
  display: Fetch indicators
  additionalinfo: 'Whether the integration should check Mandiant for new indicators.'
  name: feed
  type: 8
  required: false
  section: Collect
- additionalinfo: Your API Key from Mandiant Advantage Threat Intelligence.
  display: API Key
  name: api_key
  required: true
  type: 0
  section: Connect
- additionalinfo: Your Secret Key from Mandiant Advantage Threat Intelligence.
  display: Secret Key
  name: secret_key
  required: true
  type: 4
  section: Connect
- name: page_size
  type: 0
  display: Page Size
  required: true
  defaultvalue: 1000
  additionalinfo: 'The number of indicators to request in each page.'
  section: Collect
  advanced: true
- additionalinfo: API calls timeout.
  defaultvalue: '60'
  display: Timeout
  name: timeout
  type: 0
  required: false
  section: Connect
  advanced: true
- additionalinfo: Indicators from this integration instance will be marked with this reputation.
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  type: 18
  required: false
  section: Collect
- additionalinfo: Reliability of the source providing the intelligence data.
  defaultvalue: A - Completely reliable
  display: Source Reliability
  name: feedReliability
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  required: true
  type: 15
  section: Collect
- name: feedMinimumThreatScore
  type: 0
  display: Feed Minimum Threat Score
  required: true
  defaultvalue: 80
  additionalinfo: 'The minimum Threat Score value to import as part of the feed.'
  section: Collect
- additionalinfo: The maximum value allowed is 90 days.
  defaultvalue: 30
  display: First fetch time
  name: first_fetch
  type: 0
  required: false
  section: Collect
- name: feedExcludeOSIntel
  display: Feed Exclude Open Source Intelligence
  type: 8
  defaultvalue: 'true'
  additionalinfo: 'Whether to exclude Open Source Intelligence as part of the feed'
  required: false
  section: Collect
- additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.
  display: Traffic Light Protocol Color
  name: tlp_color
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  type: 15
  defaultvalue: RED
  required: false
  section: Collect
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  type: 0
  required: false
  section: Collect
- name: feedExpirationPolicy
  display: ''
  additionalinfo: Defines how expiration of an indicator created by the feed will be managed.
  options:
  - never
  - interval
  - indicatorType
  type: 17
  required: false
  section: Collect
- name: feedExpirationInterval
  display: ''
  type: 1
  required: false
  section: Collect
- defaultvalue: '240'
  display: Feed Fetch Interval
  name: feedFetchInterval
  additionalinfo: 'How frequently the feed should check Mandiant for new indicators.'
  type: 19
  required: true
  section: Collect
- additionalinfo: Incremental feeds pull only new or modified indicators that have been sent from the integration. The determination if the indicator is new or modified happens on the 3rd-party vendor's side, so only indicators that are new or modified are sent to Cortex XSOAR. Therefore, all indicators coming from these feeds are labeled new or modified.
  defaultvalue: 'true'
  display: Incremental feed
  hidden: true
  name: feedIncremental
  required: false
  type: 8
  section: Collect
- name: feedBypassExclusionList
  display: Bypass exclusion list
  type: 8
  additionalinfo: When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.
  section: Collect
script:
  commands:
  - name: mandiant-get-indicators
    arguments:
    - description: The maximum number of indicators to fetch.
      name: limit
    description: Fetch indicators.
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
fromversion: 6.10.0
tests:
- No tests (auto formatted)