ioa_exclusion

An IOA exclusion prevents a specific IOA detection pattern from triggering for matching child, parent, and grandparent command-line and image-filename regex values.

API Scopes

The following API scopes are required:

• IOA Exclusions: READ
• IOA Exclusions: WRITE

Example Usage

terraform {
  required_providers {
    crowdstrike = {
      source = "registry.terraform.io/crowdstrike/crowdstrike"
    }
  }
}

provider "crowdstrike" {
  cloud = "us-2"
}

resource "crowdstrike_ioa_exclusion" "example" {
  name        = "example-ioa-exclusion"
  description = "Exclude an approved administrative workflow"
  pattern_id  = "12345"

  cl_regex  = ".*--approved-operation.*"
  ifn_regex = ".*approved-tool\\.exe"

  parent_cl_regex       = ".*--run-approved-tool.*"
  parent_ifn_regex      = ".*workflow-runner\\.exe"
  grandparent_cl_regex  = ".*--start-approved-workflow.*"
  grandparent_ifn_regex = ".*workflow-service\\.exe"

  host_groups = ["all"]
}

Schema

Required

• cl_regex (String) Command-line regex pattern for exclusion matching. Maximum length is 256 characters.
• host_groups (Set of String) Host group IDs that receive this exclusion. Use ["all"] to apply globally.
• ifn_regex (String) Image filename regex pattern for exclusion matching. Maximum length is 256 characters.
• name (String) Display name of the IOA exclusion.
• pattern_id (String) Identifier of the IOA pattern to exclude.

Optional

• comment (String) Additional context stored when creating or updating the exclusion.
• description (String) Description of the IOA exclusion.
• grandparent_cl_regex (String) Grandparent process command-line regex pattern for exclusion matching. Maximum length is 256 characters.
• grandparent_ifn_regex (String) Grandparent process image filename regex pattern for exclusion matching. Maximum length is 256 characters.
• parent_cl_regex (String) Parent process command-line regex pattern for exclusion matching. Maximum length is 256 characters.
• parent_ifn_regex (String) Parent process image filename regex pattern for exclusion matching. Maximum length is 256 characters.

Read-Only

• applied_globally (Boolean) Whether the exclusion is applied globally to all hosts.
• created_by (String) User who created the exclusion.
• created_on (String) Timestamp when the exclusion was created.
• id (String) Unique identifier of the IOA exclusion.
• last_modified (String) Timestamp when the exclusion was last modified.
• last_updated (String) RFC850 timestamp of the last Terraform update to this resource.
• modified_by (String) User who last modified the exclusion.
• pattern_name (String) Name of the IOA pattern.

Import

Import is supported using the following syntax:

# IOA exclusions can be imported using their ID
terraform import crowdstrike_ioa_exclusion.example 12345678-1234-1234-1234-123456789012