FeedUstaThreatStream

Details

ID	`FeedUstaThreatStream`
Provider	Anomali
Category	Data Enrichment & Threat Intelligence
From Version	6.10.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

This integration fetches indicators from the USTAv4 Threat Stream feed. The indicators can be of type malicious URLs or malware hashes.
This integration was integrated and tested with version 4.1.0 of FeedUstaThreatStream.

Configure USTAv4 Threat Stream IOC Feed in Cortex

Navigate to Settings > Integrations > Servers & Services.
Search for USTAv4 Threat Stream IOC Feed.

Click Add instance to create and configure a new integration instance.

Parameter	Description	Required
Fetch indicators		False
Server’s URL		True
API Key	The API Key to use for connection	True
IOC Feed Type		True
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
Traffic Light Protocol Color	The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed	False
Feed Fetch Interval		False
Bypass exclusion list	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.	False
Trust any certificate (not secure)		False
Use system proxy settings		False
		False
		False
Tags	Supports CSV values.	False

Click Test to validate the URLs, token, and connection.

Commands

You can execute these commands from the Cortex XSOAR 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.

usta-tsa-search-malware-hash

Search malware hash indicators from the feed.

Base Command

usta-tsa-search-malware-hash

Input

Argument Name	Description	Required
limit	The maximum number of results to return. Default is 10.	Optional
hash	The hash to search for. It can be a SHA-1, SHA-256, or MD5 hash.	Required

Context Output

Path	Type	Description
USTA.ThreatStreamMalwareHashes.id	String	The ID of the alert
USTA.ThreatStreamMalwareHashes.hashes[0].sha256	String	The SHA-256 hash of the malware
USTA.ThreatStreamMalwareHashes.hashes[0].md5	String	The MD5 hash of the malware
USTA.ThreatStreamMalwareHashes.hashes[0].sha1	String	The SHA-1 hash of the malware
USTA.ThreatStreamMalwareHashes.tags	Array	The tags of the malware
USTA.ThreatStreamMalwareHashes.created	Date	The creation date of the malware
USTA.ThreatStreamMalwareHashes.valid_from	Date	The valid from date of the malware
USTA.ThreatStreamMalwareHashes.valid_until	Date	The valid until date of the malware

Command Example

!usta-tsa-search-malware-hash hash=d5d8c33957e90d1caca4b5207d8da5ab1bc4caa9f702abc0ec006d0518ea9aec

Context Example

{
    "USTA" :{
        "ThreatStreamMalwareHashes":[
             {
                "id": "bf89614f-0ec8-4a88-a4e7-085b113a871b",
                "hashes": {
                    "sha256": "d5d8c33957e90d1caca4b5207d8da5ab1bc4caa9f702abc0ec006d0518ea9aec",
                    "sha1": "659661291eb5fd6452d6cabdc24cd9fbc1fb17f7",
                    "md5": "4a15ed0feb9e90b56e82c2e45a3b3f5e"
                },
                "tags": [
                    "SnakeKeylogger"
                ],
                "valid_from": "2024-11-22T07:30:07.000Z",
                "valid_until": "2025-11-22T07:30:07.000Z",
                "created": "2024-11-22T07:37:40.729Z"
            }
        ]
    }
}

usta-tsa-search-malicious-url

Search malicious URL indicators from the feed.

Base Command

usta-tsa-search-malicious-url

Input

Argument Name	Description	Required
limit	The maximum number of results to return. Default is 10.	Optional
url	The URL to search for.	Required

Context Output

Path	Type	Description
USTA.ThreatStreamMaliciousUrls.id	String	The ID of the alert
USTA.ThreatStreamMaliciousUrls.url	String	The URL of the malicious site
USTA.ThreatStreamMaliciousUrls.is_domain	Boolean	Whether the malicious site is a domain
USTA.ThreatStreamMaliciousUrls.ip_addresses	Array	The IP addresses of the malicious site
USTA.ThreatStreamMaliciousUrls.tags	Array	The tags of the malicious site
USTA.ThreatStreamMaliciousUrls.created	Date	The creation date of the malicious site
USTA.ThreatStreamMaliciousUrls.valid_from	Date	The valid from date of the malicious site
USTA.ThreatStreamMaliciousUrls.valid_until	Date	The valid until date of the malicious site

Command Example

!usta-tsa-search-malicious-url url=http://192.168.100.1:38082/i

Context Example

{
    "USTA" :{
        "ThreatStreamMaliciousUrls":[
             {
                "id": "28cffb9a-add5-480c-8968-539863695770",
                "url": "http://192.168.100.1:38082/i",
                "host": "192.168.100.1",
                "is_domain": false,
                "ip_addresses": [
                    "192.168.100.1"
                ],
                "tags": [
                    "elf.mozi"
                ],
                "valid_from": "2024-11-22T07:24:06.000Z",
                "valid_until": "2025-11-22T07:24:06.000Z",
                "created": "2024-11-22T08:30:03.055Z"
            }
        ]
    }
}

usta-tsa-search-phishing-site

Search malicious URL indicators from the feed.

Base Command

usta-tsa-search-phishing-site

Input

Argument Name	Description	Required
limit	The maximum number of results to return. Default is 10.	Optional
url	The URL to search for.	Required

Context Output

Path	Type	Description
USTA.ThreatStreamPhishingSites.id	String	The ID of the alert
USTA.ThreatStreamPhishingSites.url	String	The URL of the phishing site
USTA.ThreatStreamPhishingSites.is_domain	Boolean	Whether the phishing site is a domain
USTA.ThreatStreamPhishingSites.ip_addresses	Array	The IP addresses of the phishing site
USTA.ThreatStreamPhishingSites.created	Date	The creation date of the phishing site

Command Example

!usta-tsa-search-phishing-site url=example.com

Context Example

{
    "USTA" :{
        "ThreatStreamMaliciousUrls":[
            {
                "id": 219286,
                "url": "https://example.com",
                "host": "example.com",
                "is_domain": true,
                "ip_addresses": [
                    "192.168.100.1"
                ],
                "country": null,
                "created": "2024-02-05T15:23:11.646011Z"
            }
        ]
    }
}

Configuration parameters

feed — Fetch indicators
url — Server's URL (required)
api_key — API Key (required)
ioc_feed_type — IOC Feed Type (required)
feedReputation — Indicator Reputation
feedReliability — Source Reliability (required)
tlp_color — Traffic Light Protocol Color
feedFetchInterval — Feed Fetch Interval
feedBypassExclusionList — Bypass exclusion list
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings
feedExpirationPolicy —
feedExpirationInterval —
feedTags — Tags

Commands (3)

usta-tsa-search-malicious-url
Search malicious URL indicators from the feed.
usta-tsa-search-malware-hash
Search malware hash indicators from the feed.
usta-tsa-search-phishing-site
Search malicious URL indicators from the feed.

Source

FeedUstaThreatStream.py FeedUstaThreatStream_test.py FeedUstaThreatStream.yml FeedUstaThreatStream_description.md command_examples.txt

Download History Raw

category: Data Enrichment & Threat Intelligence
provider: Anomali
sectionorder:
- Connect
- Collect
commonfields:
  id: FeedUstaThreatStream
  version: -1
configuration:
- defaultvalue: 'true'
  display: Fetch indicators
  name: feed
  required: false
  type: 8
  section: Collect
- defaultvalue: https://usta.prodaft.com/
  display: Server's URL
  name: url
  required: true
  type: 0
  section: Connect
- display: API Key
  additionalinfo: The API Key to use for connection
  name: api_key
  required: true
  type: 4
  section: Connect
- display: IOC Feed Type
  name: ioc_feed_type
  options:
  - ALL
  - malicious-urls
  - malware-hashes
  - phishing-sites
  required: true
  type: 16
  section: Collect
- additionalinfo: Indicators from this integration instance will be marked with this reputation
  defaultvalue: Bad
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  required: false
  type: 18
  section: Collect
- additionalinfo: Reliability of the source providing the intelligence data
  defaultvalue: F - Reliability cannot be judged
  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
- 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
  required: false
  type: 15
  section: Collect
- defaultvalue: '30'
  display: Feed Fetch Interval
  name: feedFetchInterval
  required: false
  type: 19
  section: Collect
- 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.
  defaultvalue: 'true'
  display: Bypass exclusion list
  name: feedBypassExclusionList
  required: false
  type: 8
  section: Collect
- display: Trust any certificate (not secure)
  name: insecure
  required: false
  type: 8
  section: Connect
- display: Use system proxy settings
  name: proxy
  required: false
  type: 8
  section: Connect
- display: ''
  name: feedExpirationPolicy
  type: 17
  required: false
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  defaultvalue: interval
  section: Collect
- display: ''
  name: feedExpirationInterval
  type: 1
  required: false
  defaultvalue: '20160'
  section: Collect
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  required: false
  type: 0
  section: Collect
display: USTAv4 Threat Stream IOC Feed
name: FeedUstaThreatStream
script:
  commands:
  - arguments:
    - default: false
      defaultValue: '10'
      description: The maximum number of results to return.
      isArray: false
      name: limit
      required: false
      secret: false
    - name: hash
      required: true
      secret: false
      description: The hash to search for. It can be a SHA-1, SHA-256, or MD5 hash.
    deprecated: false
    description: Search malware hash indicators from the feed.
    execution: false
    name: usta-tsa-search-malware-hash
    outputs:
    - contextPath: USTA.ThreatStreamMalwareHashes.id
      description: The ID of the alert.
      type: String
    - contextPath: USTA.ThreatStreamMalwareHashes.hashes[0].sha256
      description: The SHA-256 hash of the malware.
      type: String
    - contextPath: USTA.ThreatStreamMalwareHashes.hashes[0].md5
      description: The MD5 hash of the malware.
      type: String
    - contextPath: USTA.ThreatStreamMalwareHashes.hashes[0].sha1
      description: The SHA-1 hash of the malware.
      type: String
    - contextPath: USTA.ThreatStreamMalwareHashes.tags
      description: The tags of the malware.
      type: Array
    - contextPath: USTA.ThreatStreamMalwareHashes.created
      description: The creation date of the malware.
      type: Date
    - contextPath: USTA.ThreatStreamMalwareHashes.valid_from
      description: The valid from date of the malware.
      type: Date
    - contextPath: USTA.ThreatStreamMalwareHashes.valid_until
      description: The valid until date of the malware.
      type: Date
  - arguments:
    - default: false
      defaultValue: '10'
      description: The maximum number of results to return.
      isArray: false
      name: limit
      required: false
    - name: url
      required: true
      secret: false
      description: The URL to search for.
    deprecated: false
    description: Search malicious URL indicators from the feed.
    execution: false
    name: usta-tsa-search-malicious-url
    outputs:
    - contextPath: USTA.ThreatStreamMaliciousUrls.id
      description: The ID of the alert.
      type: String
    - contextPath: USTA.ThreatStreamMaliciousUrls.url
      description: The URL of the malicious site.
      type: String
    - contextPath: USTA.ThreatStreamMaliciousUrls.is_domain
      description: Whether the malicious site is a domain.
      type: Boolean
    - contextPath: USTA.ThreatStreamMaliciousUrls.ip_addresses
      description: The IP addresses of the malicious site.
      type: Array
    - contextPath: USTA.ThreatStreamMaliciousUrls.tags
      description: The tags of the malicious site.
      type: Array
    - contextPath: USTA.ThreatStreamMaliciousUrls.created
      description: The creation date of the malicious site.
      type: Date
    - contextPath: USTA.ThreatStreamMaliciousUrls.valid_from
      description: The valid from date of the malicious site.
      type: Date
    - contextPath: USTA.ThreatStreamMaliciousUrls.valid_until
      description: The valid until date of the malicious site.
      type: Date
  - arguments:
    - default: false
      defaultValue: '10'
      description: The maximum number of results to return.
      isArray: false
      name: limit
      required: false
    - name: url
      required: true
      secret: false
      description: The URL to search for.
    deprecated: false
    description: Search malicious URL indicators from the feed.
    execution: false
    name: usta-tsa-search-phishing-site
    outputs:
    - contextPath: USTA.ThreatStreamPhishingSites.id
      description: The ID of the alert.
      type: String
    - contextPath: USTA.ThreatStreamPhishingSites.url
      description: The URL of the phishing site.
      type: String
    - contextPath: USTA.ThreatStreamPhishingSites.is_domain
      description: Whether the phishing site is a domain.
      type: Boolean
    - contextPath: USTA.ThreatStreamPhishingSites.ip_addresses
      description: The IP addresses of the phishing site.
      type: Array
    - contextPath: USTA.ThreatStreamPhishingSites.created
      description: The creation date of the phishing site.
      type: Date
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  isfetch: false
  longRunning: false
  longRunningPort: false
  runonce: false
  script: '-'
  subtype: python3
  type: python
fromversion: 6.10.0
description: Fetches indicators from the USTAv4 Threat Stream feed. The indicators can be of type malicious URLs or malware hashes.
marketplaces:
- xsoar
- marketplacev2
- platform
tests:
- No tests (auto formatted)