AlienVault OTX TAXII Feed

Details

ID	`AlienVault OTX TAXII Feed`
Provider	AT&T Cybersecurity
Category	Data Enrichment & Threat Intelligence
From Version	5.5.0
Docker Image	`demisto/taxii:1.0.0.10133006`
Supported Modules	Agentix XSIAM

README

Use the AlienVault OTX integration to fetch indicators using a TAXII client.

This integration can only fetch indicators from active collections. Active collections are those which contain at least one indicator.

Configure AlienVault OTX TAXII Feed in Cortex

Parameter	Description	Required
feed	The fetch indicators.	False
feedReputation	The indicator reputation.	False
feedReliability	The source’s reliability.	True
tlp_color	The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. More information about the protocol can be found at https://us-cert.cisa.gov/tlp	False
feedExpirationPolicy	The feed’s expiration policy.	False
feedExpirationInterval	The interval after which the feed expires.	False
feedFetchInterval	The feed fetch interval.	False
feedBypassExclusionList	Whether to bypass exclusion list.	False
api_key	The AlienVault OTX API key.	True
all_collections	Whether to get all active collections - if selected the integration will run on all active collections regardless of the collections supplied in the collections parameter. Inactive collections will not return indicators.	False
collections	The collections to fetch from.	False
insecure	Whether to trust any certificate (not secure).	False
proxy	Whether to use the system proxy settings.	False

If you do not know which collections are available - do not set the Collections and All Collections parameters. The resulting error message will list all the accessible collections.

Note: not all listed collections are active.

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

Get indicators

Gets the indicators from AlienVault OTX.

Base Command

alienvaultotx-get-indicators

Input

Argument Name	Description	Required
limit	The maximum number of indicators to return. The default value is 10.	Required

Context Output

There is no context output for this command.

Command Example

!alienvaultotx-get-indicators limit=3

Human Readable Output

Indicators from AlienVault OTX TAXII

value	type
1.2.3.4	IP
https:/<span>/demisto.com	URL
demisto<span>.com	Domain

Video Demo

Sorry, your browser doesn't support embedded videos. You can download the video at: https://github.com/demisto/content-assets/blob/7982404664dc68c2035b7c701d093ec026628802/Assets/FeedAlienVault/AlienVault_OTX_Feed_Demo.mp4

Configuration parameters

feed — Fetch indicators
feedReputation — Indicator Reputation
feedReliability — Source Reliability (required)
tlp_color — Traffic Light Protocol Color
feedExpirationPolicy —
feedExpirationInterval —
feedFetchInterval — Feed Fetch Interval
feedTags — Tags
feedBypassExclusionList — Bypass exclusion list
credentials —
api_key — API Key
all_collections — Get All Active Collections
collections — Collections to Fetch From
initial_interval — First Fetch Time
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (1)

alienvaultotx-get-indicators
Gets the indicators from AlienVault OTX.

Source

FeedAlienVaultOTXTaxii.py FeedAlienVaultOTXTaxii_test.py FeedAlienVaultOTXTaxii.yml FeedAlienVaultOTXTaxii_description.md command_examples.txt

Download History Raw

category: Data Enrichment & Threat Intelligence
provider: AT&T Cybersecurity
commonfields:
  id: AlienVault OTX TAXII Feed
  version: -1
configuration:
- defaultvalue: 'true'
  display: Fetch indicators
  name: feed
  type: 8
  required: false
- additionalinfo: Indicators from this integration instance will be marked with this reputation
  defaultvalue: Bad
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  type: 18
  required: false
- additionalinfo: Reliability of the source providing the intelligence data
  defaultvalue: C - Fairly 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
- 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
  required: false
- defaultvalue: indicatorType
  name: feedExpirationPolicy
  display: ''
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  type: 17
  required: false
- defaultvalue: '20160'
  name: feedExpirationInterval
  display: ''
  type: 1
  required: false
- defaultvalue: '240'
  display: Feed Fetch Interval
  name: feedFetchInterval
  type: 19
  required: false
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  type: 0
  required: false
- 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.
  display: Bypass exclusion list
  name: feedBypassExclusionList
  type: 8
  required: false
- name: credentials
  type: 9
  displaypassword: API Key
  hiddenusername: true
  required: false
- display: API Key
  hidden: true
  name: api_key
  type: 4
  required: false
- additionalinfo: When selected, will run on all active collections regardless of the supplied collections. Inactive or empty collections will be ignored.
  display: Get All Active Collections
  name: all_collections
  type: 8
  required: false
- additionalinfo: Supports a CSV of collections to fetch from. If an inactive or empty collection is supplied, a Timeout error will be raised. If not set, it will raise an error listing all the available collections.
  display: Collections to Fetch From
  name: collections
  type: 0
  required: false
- display: First Fetch Time
  name: initial_interval
  type: 0
  additionalinfo: The time interval for the first fetch (retroactive). <number> <time unit> of type minute/hour/day/year. For example, 1 minute, 12 hour
  defaultvalue: 1 hour
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
description: This integration fetches indicators from AlienVault OTX using a TAXII client.
display: AlienVault OTX TAXII Feed
name: AlienVault OTX TAXII Feed
script:
  commands:
  - arguments:
    - defaultValue: '10'
      description: The maximum number of indicators to return. The default value is 10.
      name: limit
      required: true
    - description: how far back should we fetch indicators  - e.g. 1 day, 2 hours. If not set, will use the first fetch integration parameter.
      name: begin_date
    description: Gets the indicators from AlienVault OTX.
    name: alienvaultotx-get-indicators
  dockerimage: demisto/taxii:1.0.0.10133006
  feed: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
fromversion: 5.5.0
tests:
- No tests (auto formatted)