Cyjax Feed

The feed allows customers to pull indicators of compromise from cyber incidents (IP addresses, URLs, domains, CVE and file hashes).

Data Enrichment & Threat Intelligence · Cyjax Feed · Feed

Details

IDCyjax Feed
ProviderCYJAX
CategoryData Enrichment & Threat Intelligence
From Version5.5.0
Docker Imagedemisto/cyjax:1.0.0.10133006
Supported ModulesAgentix XSIAM

README

The feed allows customers to pull indicators of compromise from cyber incidents (IP addresses, URLs, domains, CVEs, and file hashes).

CYJAX API token

  1. Log in to CYJAX threat intelligence portal.
  2. On the top navigation bar, hover the cursor over your user icon and go to Profile Settings.
  3. Open the API tokens tab.
  4. Generate a new token and enable the Indicators API scope.
  5. Record the API token, as it will not be accessible after the window is closed.

Feed installation

  1. Navigate to Settings > Integrations > Servers & Services.
  2. Search for Cyjax Feed.
  3. Click Add instance to create and configure a new integration instance.

Configuration

  1. Enter feed name, e.g., CYJAX Feed.
  2. API URL: https://api.cymon.co/v2.
  3. Enter CYJAX API token.
  4. Set proxy if required by your installation.
  5. Indicator reputation (the reputation assigned to the indicators fetched from this feed; the default is Suspicious).
  6. Source reliability: A - Completely reliable.
  7. Traffic Light Protocol Color - The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.
  8. Use CYJAX feed TLP (selected by default) - Whether to use the TLP set by CYJAX. This will override the TLP set above.
  9. Set feed tags (optional, comma-delimited, e.g., MyTag, YourTag).
  10. Set Indicator Expiration Method (default is never).
  11. Set fetch interval (default is to fetch every 1 hour).
  12. First fetch time. The time interval for the first fetch (retroactive). The default is 3 days.
  13. Test connection.
  14. Click done to save.

Commands

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

!cyjax-get-indicators


Get indicators from the CYJAX API.

Argument Description Required
since The start date time in ISO 8601 format Optional
until The end date time in ISO 8601 format Optional
type The indicator type. If not specified all indicators are returned. Allowed values are IPv4, IPv6, Domain, Hostname, Email, FileHash-SHA1, FileHash-SHA256, FileHash-MD5, FileHash-SSDEEP Optional
source_type The indicator source type. Allowed values are incident-report, my-report Optional
source_id The indicator source ID Optional
limit The maximum number of indicators to get. The default value is 50. Optional

Example: !cyjax-get-indicators since=2020-10-23T00:00:00 type=IPv4

!cyjax-indicator-sighting


Get the CYJAX sighting of an indicator.

Argument Description Required
value The indicator value Required

Example: !cyjax-indicator-sighting value=176.117.5.126

!cyjax-unset-indicators-last-fetch-date


Unset the indicators feed last fetch date. Should only be used if a user needs to use the re-fetch button
and wants to fetch old indicators from CYJAX. The next feed will use the date set in first_fetch (default is the last 3 days).

Configuration parameters

  • url — Cyjax API URL (required)
  • apikey — API Key (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • feed — Fetch indicators
  • feedReputation — Indicator Reputation
  • feedReliability — Source Reliability (required)
  • tlp_color — Traffic Light Protocol Color
  • use_cyjax_tlp — Use Cyjax feed TLP
  • feedTags — Tags
  • feedExpirationPolicy
  • feedExpirationInterval
  • feedIncremental — Incremental Feed
  • feedBypassExclusionList — Bypass exclusion list
  • feedFetchInterval — Feed Fetch Interval
  • first_fetch — First fetch time (required)

Commands (3)

  • cyjax-get-indicators

    Get indicators.

  • cyjax-indicator-sighting

    Get sighting of a indicator.

  • cyjax-unset-indicators-last-fetch-date

    Unset the indicators feed last fetch date. Should only be used if user needs to use `re-fetch` button and wants to fetch old indicators from CYJAX. Next feed will use date set in first_fetch (default is last 3 days).

category: Data Enrichment & Threat Intelligence
provider: CYJAX
display: Cyjax Feed
name: Cyjax Feed
description: 'The feed allows customers to pull indicators of compromise from cyber incidents (IP addresses, URLs, domains, CVE and file hashes).'
commonfields:
  id: Cyjax Feed
  version: -1
sectionorder:
- Connect
- Collect
configuration:
- defaultvalue: https://api.cymon.co/v2
  additionalinfo: Url to CYJAX API.
  display: Cyjax API URL
  name: url
  required: true
  type: 0
  section: Connect
- display: API Key
  additionalinfo: CYJAX API key obtained from CYJAX portal.
  name: apikey
  required: true
  type: 4
  section: Connect
- display: Trust any certificate (not secure)
  name: insecure
  defaultvalue: 'false'
  type: 8
  required: false
  section: Connect
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
- display: Fetch indicators
  defaultvalue: 'true'
  name: feed
  type: 8
  required: false
  section: Collect
- display: Indicator Reputation
  additionalinfo: Indicators from this integration instance will be marked with this reputation
  defaultvalue: Suspicious
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  type: 18
  required: false
  section: Collect
- display: Source Reliability
  additionalinfo: Reliability of the source providing the intelligence data
  defaultvalue: A - Completely reliable
  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: tlp_color
  additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed
  display: Traffic Light Protocol Color
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  type: 15
  required: false
  section: Collect
- name: use_cyjax_tlp
  display: Use Cyjax feed TLP
  additionalinfo: Whether to use TLP set by CYJAX. Will override TLP set above.
  defaultvalue: 'true'
  type: 8
  required: false
  section: Collect
- name: feedTags
  display: Tags
  additionalinfo: Supports CSV values.
  type: 0
  required: false
  section: Collect
- display: ""
  name: feedExpirationPolicy
  defaultvalue: never
  type: 17
  options:
  - never
  - interval
  - indicatorType
  required: false
  section: Collect
- name: feedExpirationInterval
  defaultvalue: "20160"
  type: 1
  display: ""
  required: false
  section: Collect
- 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.
  display: Incremental Feed
  name: feedIncremental
  defaultvalue: 'true'
  type: 8
  hidden: true
  required: false
  section: Collect
- 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
  section: Collect
- name: feedFetchInterval
  defaultvalue: '60'
  display: Feed Fetch Interval
  type: 19
  required: false
  section: Collect
- defaultvalue: 3 days
  display: First fetch time
  additionalinfo: The time interval for the first fetch (retroactive). For example 3 days, 1 hour
  name: first_fetch
  required: true
  type: 0
  section: Collect
script:
  commands:
  - arguments:
    - name: since
      description: The start date time in ISO 8601 format.
    - name: until
      description: The end date time in ISO 8601 format.
    - name: type
      description: 'The indicator type. If not specified all indicators are returned. Allowed values are IPv4, IPv6, Domain, Hostname, Email, FileHash-SHA1, FileHash-SHA256, FileHash-MD5, FileHash-SSDEEP.'
    - name: source_type
      description: The indicators source type. Allowed values are incident-report, my-report.
    - name: source_id
      description: The indicators source ID.
    - name: limit
      description: The maximum number of indicators to get. The default value is 50.
      defaultValue: '50'
    name: cyjax-get-indicators
    description: Get indicators.
  - arguments:
    - description: Indicator value.
      name: value
      required: true
    name: cyjax-indicator-sighting
    description: Get sighting of a indicator.
  - name: cyjax-unset-indicators-last-fetch-date
    description: 'Unset the indicators feed last fetch date. Should only be used if user needs to use `re-fetch` button and wants to fetch old indicators from CYJAX. Next feed will use date set in first_fetch (default is last 3 days).'
  feed: true
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/cyjax:1.0.0.10133006
fromversion: 5.5.0
tests:
- No tests (auto formatted)