Correlation rule details - Administrator Guide - Cortex XSIAM - Cortex

Correlation rule details - Administrator Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM Documentation

Product

Cortex XSIAM

Creation date

2024-03-06

Last date published

2024-10-10

Note

There may be future changes to the Correlation Rules offerings, which can impact your licensing agreements. You will receive a notification ahead of time before any changes are implemented.

If you are assigned a role that enables Investigation → Rules privileges, you can manage all user-defined Correlation Rules from Detection Rules → Correlations.

By default, the Correlation Rules page displays all enabled rules. To search for a specific rule, use the filters above the results table to narrow the results. From the Correlation Rules page, you can manage existing rules using the right-click pivot menu. You can also import and export rules in JSON format, which can help you to transfer your configurations between environments for onboarding, migration, backup, and sharing. You can bulk export and import multiple rules at a time.

In addition, the Correlation Rules page enables you to easily identify and resolve correlation rules errors. The number of errors is indicated at the top of the page in red using the format <number> errors found. You can change the view to only display the correlation rules with errors by selecting Show Errors Only. The LAST EXECUTION column in the table indicates a correlation rule with an error by displaying the last execution time in a red font and providing a description of the correlation rule error when hovering over the field. The following error messages are displayed in the applicable scenarios.

Invalid query
Query timeout
Dependency correlation did not complete
Unknown error
Delayed rule—This rule is running past its scheduled time, which can cause delayed results.
Dataset does not exist: <name of dataset>
Note
Only an administrator can create and view queries built with an unknown dataset that currently does not exist in Cortex XSIAM .

A notification is also displayed in Cortex XSIAM to indicate these correlation rules errors.

Note

Certain fields are exposed and hidden by default. An asterisk (*) is beside every field that is exposed by default.

Field	Description
# OF ALERTS*	The number of alerts triggered by this rule.
ALERT CATEGORY*	Type of alert as configured when creating the rule. Collection Credential Access Dropper Evasion Execution Evasive Exfiltration File Privilege Manipulation File Type Obfuscation Infiltration Lateral Movement Persistence Privilege Escalation Reconnaissance Tampering Other
DATASET*	The text displayed here depends on the resulting action configured for the correlation rule when the rule was created. Alerts—When your resulting action for the rule was configured to Generate alert. Dataset name—When your resulting action for the rule was configured to Save to dataset.
DESCRIPTION*	The description for the Correlation Rule that was configured when the rule was created.
DRILL-DOWN QUERY	Displays the Drill-Down Query that you configured for additional information about the alert for further investigation using Cortex Query Language (XQL) when you created the rule. If you did not configure one, the field is left empty. Once configured any alert generated for the Correlation Rule has a right-click pivot menu Open Drilldown Query option, an Open drilldown query link after you investigate any contributing events, and a quick action Open Drilldown Query icon () that is accessible in the Alerts page, which opens a new browser tab in XQL Search to run this query. If you do not define a Drill-Down Query, no right-click menu option, link, or icon is displayed. The Drill-Down Query Time Frame can be configured as either. Generated Alert—Uses the time frame of the alert that is triggered, which is the first event and last event timestamps for the alert (default option). XQL Search—Uses the time frame from when the Correlation Rule was run in XQL Search.
FAILURE REASON	For a Correlation Rule with an error, displays the error message, which can be one of the following. Invalid query Query timeout Dependency correlation did not complete Unknown error Delayed rule—This rule is running past its scheduled time, which can cause delayed results. Dataset does not exist: <name of dataset> Note Only an administrator can create and view queries built with an unknown dataset that currently does not exist in Cortex XSIAM.
INSERTION DATE	Date and time when the Correlation Rule was created.
LAST EXECUTION*	Date and time when the correlation rule was last executed. Indicates a correlation rule with an error by displaying the last execution time in a red font and providing a description of the correlation rule Error when hovering over the field. Indicates Real-time in the case of Real Time Correlation Rules.
MITRE ATT&CK TACTIC*	Displays the type of MITRE ATT&CK tactic the correlation rule is attempting to trigger.
MITRE ATT&CK TECHNIQUE*	Displays the type of MITRE ATT&CK technique and sub-technique the correlation rule is attempting to trigger.
MODIFICATION DATE*	Date and time when the correlation rule was last modified.
NAME*	Unique name that describes the rule.
RULE ID	Unique identification number for the rule.
SCHEDULE*	Displays the Time Schedule for the frequency of running the XQL Search definition set for the correlation rule when the rule was created. The options displayed are one of the following. Every 10 Minutes Every 20 Minutes Every 30 Minutes Hourly Daily Displays the Time Schedule as Cron Expression fields.
SEVERITY*	Correlation rule severity that was defined when the correlation rule was created. Severity levels can be Informational, Low, Medium, High, Critical, and Customized. Whenever an alert is generated with a severity type of Medium and above based on the Correlation Rule, a new incident is automatically opened.
SOURCE*	User who created this correlation rule.
STATUS	Rule status: Enabled or Disabled.
SUPPRESSION DURATION*	The duration time for how long to ignore other events that match the alert suppression criteria that was configured when the rule was created. This is required to configure.
SUPPRESSION FIELDS*	The fields that the alert suppression is based on, which was configured when the rule was created. The fields listed are based on the XQL query result set for the rule. This is optional to configure.
SUPPRESSION STATUS*	Displays the Suppression Status as either Enabled or Disabled as configured when the rule was created.
TIME FRAME*	Displays the time frame for running a query, which can be up to 7 days as configured when the rule was created.
TIMEZONE	Displays the Timezone when the Time Schedule for the frequency of running the XQL Search definition set for the correlation rule is set to run daily or using a cron expression. Otherwise, this field is left empty.
XQL SEARCH	Displays the XQL definition for the correlation rule that was configured in XQL Search when the rule was created.