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
| ID | Cortex XDR - IOC |
|---|---|
| Provider | Palo Alto Networks |
| Category | Data Enrichment & Threat Intelligence |
| From Version | 5.5.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix |
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 IDapikey— API Keyfeed— Fetch indicatorsautoSync— Auto Syncseverity— Overriding severity value (required)feedTags— Tagsquery— Sync Query (required)insecure— Trust any certificate (not secure)proxy— Use system proxy settingsfeedReputation— Indicator ReputationfeedReliability— Source Reliability (required)tlp_color— Traffic Light Protocol ColorfeedExpirationPolicy—feedExpirationInterval—feedIncremental— Incremental FeedfeedFetchInterval— Feed Fetch Intervalxsoar_severity_field— XSOAR Severity Fieldxsoar_comments_field— XSOAR Comment Field Exporting To XDRcomments_as_tags— Comments as tags (CSV)override_severity— Override severityfeedBypassExclusionList— Bypass exclusion listextensive_logs— Extensive logging (for debugging purposes)
Commands (7)
-
xdr-iocs-create-sync-fileCreates the sync file for the manual process. Run this command when instructed by the XDR support team.
-
xdr-iocs-disableDisables IOCs in the XDR server.
-
xdr-iocs-enableEnables IOCs in the XDR server.
-
xdr-iocs-pushPush modified IOCs to Cortex XDR.
-
xdr-iocs-set-sync-timeDeprecatedSet sync time manually. (Do not use this command unless you understand the consequences.)
-
xdr-iocs-syncSync your IOC with Cortex XDR.
-
xdr-iocs-to-keep-fileCreate 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