Create a new Custom Detection Rule - Create Custom Detection Rules to check your organization’s assets. - Administrator Guide - Cortex XDR - Cortex - Security Operations

Cortex XDR 5.x Documentation

Product
Cortex XDR
License
XDR + Cloud
Creation date
2025-07-13
Last date published
2026-06-11
Category
Administrator Guide
Abstract

Create Custom Detection Rules to check your organization’s assets.

Creating Custom Detection Rules give you the flexibility to define and enforce security best practices tailored to your organization's objectives, as well as regulatory requirements not already covered by the compliance standards in our catalog.

Before you begin

Ensure you have a custom compliance control defined to associate the Custom Detection Rule to. For more information, see Use a built-in or custom standard.

How to create a Custom Detection Rule
  1. Go to Posture ManagementRules & PoliciesRulesCloud Workload.

  2. In the Cloud Workload Rules page, click Create Custom Rule.

  3. Enter the following settings:

    • Rule name: A descriptive name for the custom rule.

    • Description: An optional field for adding additional details or context about the rule, such as its purpose or intended behavior.

  4. Select a Scanner to execute the Custom Detection Rule and its associated script. The options are:

    • Agentless Disk Scan

    • Kubernetes Connector

    • XDR Agent

  5. Configure settings specific to the scanner you select.

  6. For Compliance Violation Severity, define the severity level of the compliance violation to ensure proper categorization and prioritization. Possible values are:

    • Critical

    • High

    • Medium

    • Low

    • Informational

  7. For Compliance Controls, assign the rule to one or more existing compliance controls.

    Note

    Only Custom Detection Rules (not built-in rules) can be assigned to custom controls.

    1. Click Add.

    2. Select a custom compliance control from the list.

    3. Click Assign.

  8. For Remediation, you can optionally define the remediation steps to address any detected misconfiguration.

  9. Click Create.

    The new rule appears in the Rules List.

    You can now use the rule as a check to either create an issue or monitor adherence to a specific requirement.

    Create an issue

    Under Posture ManagementPoliciesCloud Workload, add the Custom Detection Rule to a Policy. This policy automatically runs the rule and creates an issue if the check fails.

    Monitor compliance adherence

    Under Posture ManagementComplianceCatalogsStandards, create a custom standard that includes the custom control associated with the Custom Detection Rule, and then create an assessment profile that runs the custom standard. You can then monitor the compliance results in a report. For more information, see Monitor and track compliance adherence.