CyrenThreatInDepth

Threat InDepth's actionable and contextualized intelligence helps enterprises improve their threat detection and response by providing unprecedented visibility into new email-borne security threats faster than other security vendors.

Data Enrichment & Threat Intelligence · Cyren Threat InDepth Threat Intelligence · Feed

Details

ID	`CyrenThreatInDepth`
Provider	Communitake
Category	Data Enrichment & Threat Intelligence
From Version	6.0.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

Threat InDepth’s correlated and contextualized intelligence helps enterprises improve their threat detection and response by providing unprecedented visibility into new email-borne security threats and actionable insights to make meaningful response decisions. By correlating insights gathered across email content, web traffic, and suspicious files; Cyren provides security teams with a multi-dimensional presentation of critical threat characteristics.

Benefits include

Access to Cyren’s GlobalView™ Threat Intelligence Cloud that provides the earliest visibility into new and evolving attacks on a global basis
Comprehensive, multi-dimensional presentation of critical threat characteristics to help analysts understand the evolving threat landscape
Timely, Correlated, & Contextualized intelligence that helps reduce mean-time-to-detect (MTTD) and mean-time-to-respond (MTTR) for security analysts
Improved threat detection for existing security products such as SIEM and SOAR solutions

Feeds included in Cyren Threat InDepth content pack

The Cyren Threat InDepth content pack includes access to these streams of indicators:

IP Reputation Intelligence
Phishing & Fraud URL Intelligence
Malware URL Intelligence
Malware File Intelligence

Configure Cyren Threat InDepth Threat Intelligence Feed In Cortex

Parameter	Description	Required
apikey	API JWT token that has been issued to you	True
feed_name	Name of the particular feed that matches your API JWT token	True
max_indicators	The maximum number of indicators to fetch	False
feed	Fetch indicators.	False
feedIncremental	Is incremental or not	False
feedReputation	The reputation to apply to the fetched indicators.	False
feedReliability	The reliability of the this feed.	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		False
feedExpirationInterval		False
feedFetchInterval	Feed Fetch Interval	False
feedBypassExclusionList	Bypass exclusion list	False

The underlying Cyren Threat InDepth API provides you with an incremental feed, meaning it provides new
or modified indicators. It also works with an offset value that keeps track of your currently processed
indicators. Your current offset defaults at the globally known maximum offset on your first setup and
is being stored and updated for you in the integration instance context. The integration then uses the
“Maximum number of indicators” parameter as the count in each request. It is recommended to set it to
a high enough value so that you get all the feed indicators for maximum product value, to handle bursts
etc. (the value cannot be higher than 100.000 and it will be capped at that value if you set a higher one).

In case you want to want to reset the offset value, use the cyren-threat-indepth-reset-client-offset command.

You can retrieve the current offset value using the cyren-threat-indepth-get-client-offset command.

Commands

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

Fetch indicators

Fetching Cyren Threat InDepth indicators

Required Permissions

A valid API JWT token and a matching feed name

Base Command

cyren-threat-indepth-get-indicators

Input

Argument Name	Description	Required
max_indicators	The maximum number of results to return.	True

Context Output

There is no context output for this command.

Command Example

!cyren-threat-indepth-get-indicators max_indicators=2

Human Readable Output

Indicators from Cyren Threat InDepth:

value	type	rawJSON	score
http://nu4vs0m.u5jkzm4r.i2wd30t.bpbp9c7d.b7ni2cio.auz8x15h.freshoff.eu	URL	payload: {"action": "+", "type": "url", "identifier": "f59ef036-a790-5193-b942-24a8618c936a", "first_seen": "2020-10-25T13:41:36.000Z", "last_seen": "2021-01-05T13:54:41.000Z", "detection": {"category": ["phishing"], "detection_ts": "2020-10-25T13:41:36.000Z"}, "meta": {"port": 80, "protocol": "http"}, "relationships": [{"relationship_type": "resolves to", "relationship_ts": "2020-10-25T13:41:36.000Z", "ip": "217.70.142.108", "related_entity_category": "phishing", "relationship_description": "resolves to phishing ip"}], "detection_methods": ["URL Categorization"], "url": "http://nu4vs0m.u5jkzm4r.i2wd30t.bpbp9c7d.b7ni2cio.auz8x15h.freshoff.eu"} offset: 57006380 timestamp: 2021-01-05T14:00:48.919Z	3

Reset Client Offset

This command allows you to update the stored client offset for the feed API.

Required Permissions

A valid API JWT token and a matching feed name

Base Command

cyren-threat-indepth-reset-client-offset

Input

Argument Name	Description	Required
offset	Optional The offset you want to use as your baseline for future fetches (if not provided, the global max offset from the API is used)	False

Context Output

There is no context output for this command.

Command Example

!cyren-threat-indepth-reset-client-offset
!cyren-threat-indepth-reset-client-offset offset = 34234234

Human Readable Output

Reset Cyren Threat InDepth ip_reputation feed client offset to 1000 (API provided max offset of 1000, was 500).

Get Client Offset

This command allows you to retrieve the stored client offset for the feed API.

Required Permissions

A valid API JWT token and a matching feed name

Base Command

cyren-threat-indepth-get-client-offset

Input

There is not input for this command.

Context Output

There is no context output for this command.

Command Example

!cyren-threat-indepth-get-client-offset

Human Readable Output

Cyren Threat InDepth ip_reputation feed client offset is 500 (API provided max offset of 1000).

Additional Information

Configuration parameters

feedReputation — Indicator Reputation
feedReliability — Source Reliability (required)
feedExpirationPolicy —
feedExpirationInterval —
feedIncremental — Incremental Feed
feedFetchInterval — Feed Fetch Interval
feedBypassExclusionList — Bypass exclusion list
tlp_color — Traffic Light Protocol Color
feedTags — Tags
feed — Fetch indicators
apikey — API Token (required)
feed_name — Feed Name (required)
max_indicators — Maximum number of indicators
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (3)

cyren-threat-indepth-get-client-offset
Prints the max client offset stored in the integration context.
cyren-threat-indepth-get-indicators
Fetching Cyren Threat InDepth indicators
cyren-threat-indepth-reset-client-offset
Resets the max client offset stored in the integration context.

Source

CyrenThreatInDepth.py CyrenThreatInDepth_test.py CyrenThreatInDepth.yml CyrenThreatInDepth_description.md

Download History Raw

commonfields:
  id: CyrenThreatInDepth
  version: -1
name: CyrenThreatInDepth
display: Cyren Threat InDepth Threat Intelligence Feed
category: Data Enrichment & Threat Intelligence
provider: Communitake
description: Threat InDepth's actionable and contextualized intelligence helps enterprises improve their threat detection and response by providing unprecedented visibility into new email-borne security threats faster than other security vendors.
fromversion: 6.0.0
defaultmapperin: Cyren Threat InDepth Indicator Mapper
configuration:
- display: Indicator Reputation
  name: feedReputation
  type: 18
  options:
  - None
  - Good
  - Suspicious
  - Bad
  additionalinfo: Indicators from this integration instance will be marked with this reputation
  required: false
- display: Source Reliability
  name: feedReliability
  defaultvalue: F - Reliability cannot be judged
  type: 15
  required: true
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  additionalinfo: Reliability of the source providing the intelligence data
- display: ""
  name: feedExpirationPolicy
  defaultvalue: indicatorType
  type: 17
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  required: false
- display: ""
  name: feedExpirationInterval
  defaultvalue: "20160"
  type: 1
  required: false
- additionalinfo: Incremental feeds pull only new or modified indicators that have been sent from the integration. As the determination if the indicator is new or modified happens on the 3rd-party vendor's side, and only indicators that are new or modified are sent to Cortex XSOAR, all indicators coming from these feeds are labeled new or modified.
  defaultvalue: "true"
  display: Incremental Feed
  name: feedIncremental
  type: 8
  required: false
- display: Feed Fetch Interval
  name: feedFetchInterval
  defaultvalue: "240"
  type: 19
  required: false
- display: Bypass exclusion list
  name: feedBypassExclusionList
  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.
  required: false
- 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
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  type: 0
  required: false
- defaultvalue: "true"
  display: Fetch indicators
  name: feed
  type: 8
  required: false
- display: API Token
  name: apikey
  type: 4
  required: true
- display: Feed Name
  name: feed_name
  defaultvalue: IP Reputation
  type: 15
  required: true
  options:
  - IP Reputation
  - Phishing URLs
  - Malware URLs
  - Malware Hashes
  additionalinfo: Choose from the available options to ingest the type of data you are interested in. Keep in mind that the API token issued to you only corresponds to one of the data types each.
- display: Maximum number of indicators
  name: max_indicators
  defaultvalue: "100000"
  type: 0
  additionalinfo: Maximum number of indicators to be fetched each time. The value cannot be higher than 100.000. If you provide a value higher than that it will be capped at 100.000.
  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
script:
  script: "-"
  type: python
  commands:
  - arguments:
    - default: true
      defaultValue: "50"
      description: The maximum number of results to return.
      name: max_indicators
    description: Fetching Cyren Threat InDepth indicators
    execution: true
    name: cyren-threat-indepth-get-indicators
  - arguments:
    - description: The new offset from the feed (if not provided, the latest offset is taken).
      name: offset
    description: Resets the max client offset stored in the integration context.
    execution: true
    name: cyren-threat-indepth-reset-client-offset
  - description: Prints the max client offset stored in the integration context.
    execution: true
    name: cyren-threat-indepth-get-client-offset
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  subtype: python3
tests:
- No tests