Cortex XDR - IOC

Use the Cortex XDR - IOCs feed integration to sync indicators from Cortex XSOAR to Cortex XDR and back to Cortex XSOAR. Cortex XDR is the world's first detection and response app that natively integrates network, endpoint and cloud data to stop sophisticated attacks.

Data Enrichment & Threat Intelligence · Cortex XDR by Palo Alto Networks · Feed

Details

IDCortex XDR - IOC
ProviderPalo Alto Networks
CategoryData Enrichment & Threat Intelligence
From Version5.5.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix

README

Cortex XDR is the world’s first detection and response app that natively integrates network, endpoint and cloud data to stop sophisticated attacks.

Use the Cortex XDR - IOCs feed integration to sync indicators between Cortex XSOAR and Cortex XDR. The integration will sync indicators according to the defined fetch interval. At each interval, the integration will push new and modified indicators defined in the Sync Query from Cortex XSOAR to Cortex XDR. Additionally, the integration will check if there are manual modifications of indicators on Cortex XDR and sync back to Cortex XSOAR. Once per day, the integration will perform a complete sync which will also remove indicators that have been deleted/expired in Cortex XSOAR, from Cortex XDR.

This integration was integrated and tested with Branch: stable-50 of XDR.

Prerequisites

An API key of type Advanced with an Administrator role.

Configure Cortex XDR - IOC in Cortex

Parameter Description Required
url Server URL (e.g. https://example.net) True
apikey_id API Key ID True
apikey API Key True
feed Fetch indicators False
severity The severity in Cortex XDR True
Tags Appears in Cortex XSOAR if a modification was made on the Cortex XDR side and is being “mirrored” to Cortex XSOAR False
query Sync Query True
insecure Trust any certificate (not secure) False
xsoar_severity_field The Cortex XSOAR indicator field used as severity. True
xsoar_comments_field The Cortex XSOAR field where comments are stored. Default is comments. Expecting an XSOAR IOC format of a comment (nested dictionary). See Comments As Tags for more. True
comments_as_tags Whether to consider the value at xsoar_comments_field as CSV. Requires specifying a xsoar_comments_field value different than the default comments. True
proxy Use system proxy settings False
feedReputation Indicator Reputation False
feedReliability Source 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   False
feedExpirationInterval   False
feedFetchInterval Feed Fetch Interval (make sure to set it to at least 15 minutes) False
feedBypassExclusionList Bypass exclusion list False

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.

xdr-iocs-sync


Sync IOCs with Cortex XDR.
Run this command manually only when configuring the instance integration with fetch indicators disabled (run this only once).
It is not recommended to run this manually when there are more then 40,000 indicators.

When fetch indicators is enabled, the sync mechanism is used by default. This sets the current time as the last sync time and fetches IOCs from Cortex XSOAR to Cortex XDR, sorted by modification time, in batches of 40,000, up to that time. Upon reaching the last sync point, the synchronization becomes bi-directional, first from Cortex XSOAR to Cortex XDR, then from Cortex XDR to Cortex XSOAR.

As a result, the duration of the first sync depends on the number of IOCs in the Cortex XSOAR tenant and the Feed Fetch Interval. For example, if there are 800,000 indicators in Cortex XSOAR and the Feed Fetch Interval is set to 20 minutes as recommended, the initial sync process will take approximately 7 hours.

Base Command

xdr-iocs-sync

Input

There are no input arguments for this command.

Context Output

There is no context output for this command.

Command Example

!xdr-iocs-sync

Human Readable Output

sync with XDR completed.

xdr-iocs-push


Push new or modified IOCs to Cortex XDR.

Base Command

xdr-iocs-push

Input

Argument Name Description Required
indicator the indicators Optional

Context Output

There is no context output for this command.

Command Example

xdr-iocs-push

Human Readable Output

push success.

xdr-iocs-enable


Enable iocs in XDR server

Base Command

xdr-iocs-enable

Input

Argument Name Description Required
indicator The indicator to enable Required

Context Output

There is no context output for this command.

Command Example

!xdr-iocs-enable indicator=11.11.11.11

Human Readable Output

indicators 11.11.11.11 enabled.

xdr-iocs-disable


Disable iocs in XDR server

Base Command

xdr-iocs-disable

Input

Argument Name Description Required
indicator The indicator to enable Required

Context Output

There is no context output for this command.

Command Example

!xdr-iocs-disable indicator=22.22.22.22

Human Readable Output

indicators 22.22.22.22 disabled.

xdr-iocs-set-sync-time


Set sync time manually (Do not use this command unless you unredstandard the consequences).

Base Command

xdr-iocs-set-sync-time

Input

Argument Name Description Required
time The time of the file creation (use UTC time zone). Required

Context Output

There is no context output for this command.

xdr-iocs-create-sync-file


Creates the sync file for the manual process. Run this command when instructed by the XDR support team.

Base Command

xdr-iocs-create-sync-file

Input

Argument Name Description Required
zip Whether to zip the output file. Required
set_time Whether to modify the sync time locally. Required

Context Output

There is no context output for this command.

Base Command

xdr-iocs-to-keep-file

Input

There are no input arguments for this command.

Context Output

There is no context output for this command.

Configuration parameters

  • url — Server URL (e.g. https://example.net) (required)
  • apikey_id_creds
  • apikey_creds
  • apikey_id — API Key ID
  • apikey — API Key
  • feed — Fetch indicators
  • autoSync — Auto Sync
  • severity — Overriding severity value (required)
  • feedTags — Tags
  • query — Sync Query (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • feedReputation — Indicator Reputation
  • feedReliability — Source Reliability (required)
  • tlp_color — Traffic Light Protocol Color
  • feedExpirationPolicy
  • feedExpirationInterval
  • feedIncremental — Incremental Feed
  • feedFetchInterval — Feed Fetch Interval
  • xsoar_severity_field — XSOAR Severity Field
  • xsoar_comments_field — XSOAR Comment Field Exporting To XDR
  • comments_as_tags — Comments as tags (CSV)
  • override_severity — Override severity
  • feedBypassExclusionList — Bypass exclusion list
  • extensive_logs — Extensive logging (for debugging purposes)

Commands (7)

  • xdr-iocs-create-sync-file

    Creates the sync file for the manual process. Run this command when instructed by the XDR support team.

  • xdr-iocs-disable

    Disables IOCs in the XDR server.

  • xdr-iocs-enable

    Enables IOCs in the XDR server.

  • xdr-iocs-push

    Push modified IOCs to Cortex XDR.

  • xdr-iocs-set-sync-time Deprecated

    Set sync time manually. (Do not use this command unless you understand the consequences.)

  • xdr-iocs-sync

    Sync your IOC with Cortex XDR.

  • xdr-iocs-to-keep-file

    Create a file with all the IOCs that are going to sync to Cortex XDR.

category: Data Enrichment & Threat Intelligence
provider: Palo Alto Networks
sectionorder:
  - Connect
  - Collect
commonfields:
  id: Cortex XDR - IOC
  version: -1
configuration:
- display: Server URL (e.g. https://example.net)
  name: url
  required: true
  type: 0
  section: Connect
- display: ''
  name: apikey_id_creds
  type: 9
  displaypassword: API Key ID
  hiddenusername: true
  required: false
  section: Connect
- display: ''
  name: apikey_creds
  type: 9
  displaypassword: API Key
  hiddenusername: true
  required: false
  section: Connect
- display: API Key ID
  name: apikey_id
  type: 4
  hidden: true
  required: false
  section: Connect
- display: API Key
  name: apikey
  type: 4
  hidden: true
  required: false
  section: Connect
- display: Fetch indicators
  name: feed
  type: 8
  defaultvalue: 'true'
  required: false
  section: Collect
- additionalinfo: When enabled, indicators will be synced from Cortex XSOAR to Cortex XDR. Disable if you prefer to use a playbook to sync indicators.
  defaultvalue: 'true'
  display: Auto Sync
  name: autoSync
  type: 8
  required: false
  section: Collect
- additionalinfo: When the `override severity` parameter is set to True, the severity level chosen here will be used for all indicators. Otherwise, the severity level of the indicator will be used.
  display: Overriding severity value
  name: severity
  required: true
  type: 15
  options:
  - info
  - low
  - medium
  - high
  - critical
  section: Collect
- display: Tags
  name: feedTags
  type: 0
  additionalinfo: Supports CSV values.
  defaultvalue: Cortex XDR
  required: false
  section: Collect
- display: Sync Query
  name: query
  required: true
  type: 0
  additionalinfo: The query used to collect indicators to sync from Cortex XSOAR to Cortex XDR.
  defaultvalue: reputation:Bad and (type:File or type:Domain or type:IP)
  section: Collect
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
- 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
- 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: Reliability of the source providing the intelligence data
  defaultvalue: A - Completely reliable
  section: Collect
- display: 'Traffic Light Protocol Color'
  name: tlp_color
  type: 15
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed
  required: false
  section: Collect
- display: ''
  name: feedExpirationPolicy
  type: 17
  options:
  - never
  - interval
  - indicatorType
  required: false
  section: Collect
- display: ''
  name: feedExpirationInterval
  type: 1
  required: false
  section: Collect
- display: Incremental Feed
  name: feedIncremental
  type: 8
  defaultvalue: 'true'
  hidden: true
  required: false
  section: Collect
- defaultvalue: '15'
  display: Feed Fetch Interval
  name: feedFetchInterval
  type: 19
  required: false
  section: Collect
- additionalinfo: The XSOAR indicator field used as severity.
  display: XSOAR Severity Field
  name: xsoar_severity_field
  type: 0
  defaultvalue: 'sourceoriginalseverity'
  required: false
  section: Collect
- defaultvalue: 'comments'
  additionalinfo: 'The Cortex XSOAR field where comments are stored and being export to XDR. Default is `comments`. Expecting a Cortex XSOAR IOC format of a comment (nested dictionary).'
  display: XSOAR Comment Field Exporting To XDR
  name: xsoar_comments_field
  options:
  - indicator_link
  - comments
  type: 16
  advanced: true
  required: false
  section: Collect
- defaultvalue: 'false'
  additionalinfo: Whether to consider the value at `xsoar_comments_field` as CSV. Requires specifying a xsoar_comments_field value different than the default `comments`.
  display: Comments as tags (CSV)
  name: comments_as_tags
  type: 8
  required: false
  section: Collect
- additionalinfo: When enabled, the severity value will be taken from the `severity` parameter, regardless of the IOC severity value. Otherwise, the severity value will be taken according to the `xsoar_severity_field` parameter.
  display: Override severity
  name: override_severity
  type: 8
  defaultvalue: 'true'
  required: false
  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.
  display: Bypass exclusion list
  name: feedBypassExclusionList
  type: 8
  required: false
  section: Collect
- display: Extensive logging (for debugging purposes)
  additionalinfo: Do not use this option unless advised otherwise. Using this parameter may result in increased processing time.
  name: extensive_logs
  type: 8
  advanced: true
  required: false
  section: Connect
description: Use the Cortex XDR - IOCs feed integration to sync indicators from Cortex XSOAR to Cortex XDR and back to Cortex XSOAR. Cortex XDR is the world's first detection and response app that natively integrates network, endpoint and cloud data to stop sophisticated attacks.
display: Cortex XDR - IOC
name: Cortex XDR - IOC
script:
  commands:
  - description: Create a file with all the IOCs that are going to sync to Cortex XDR.
    name: xdr-iocs-to-keep-file
  - arguments:
    - description: |-
        For first sync, set to true.
        (do NOT run this twice!).
      name: firstTime
      auto: PREDEFINED
      default: true
      defaultValue: 'false'
      predefined:
      - 'true'
      - 'false'
    description: Sync your IOC with Cortex XDR.
    name: xdr-iocs-sync
  - arguments:
    - description: The indicators to be pushed. Leave empty to push all recently modified IOCs.
      name: indicator
      isArray: true
    description: Push modified IOCs to Cortex XDR.
    name: xdr-iocs-push
  - description: Set sync time manually. (Do not use this command unless you understand the consequences.)
    name: xdr-iocs-set-sync-time
    arguments:
    - description: The time of the file creation (use UTC time zone).
      name: time
      required: true
    deprecated: true
  - description: Creates the sync file for the manual process. Run this command when instructed by the XDR support team.
    name: xdr-iocs-create-sync-file
    arguments:
    - name: zip
      description: Whether to zip the output file.
      defaultValue: false
      required: true
    - name: set_time
      description: Whether to modify the sync time locally.
      defaultValue: false
      required: true
  - arguments:
    - description: The indicator to enable.
      isArray: true
      name: indicator
      required: true
    description: Enables IOCs in the XDR server.
    name: xdr-iocs-enable
  - arguments:
    - description: The indicator to disable.
      isArray: true
      name: indicator
      required: true
    description: Disables IOCs in the XDR server.
    name: xdr-iocs-disable
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- Cortex XDR - IOC - Test
fromversion: 5.5.0