CrowdStrike UpdateIOC

CrowdStrike UpdateIOC

Certified
Enterprise Edition

Update a CrowdStrike Falcon custom indicator of compromise

Patches the action, severity, and/or expiration of an existing custom IOC. At least one of action, severity, or expirationDays must be set.

yaml
type: io.kestra.plugin.ee.crowdstrike.ioc.UpdateIOC

Escalate an indicator to prevent and extend its expiration

yaml
id: update_ioc
namespace: company.team

tasks:
  - id: update_ioc
    type: io.kestra.plugin.ee.crowdstrike.ioc.UpdateIOC
    clientId: "{{ secret('CROWDSTRIKE_CLIENT_ID') }}"
    clientSecret: "{{ secret('CROWDSTRIKE_CLIENT_SECRET') }}"
    iocId: "4f8b9c1a2d3e4f5061728394a5b6c7d"
    action: PREVENT
    severity: CRITICAL
    expirationDays: 90
Properties

API client ID

Client ID of a CrowdStrike API client with the scopes required by the tasks and triggers being used.

API client secret

Client secret of the CrowdStrike API client. Exchanged for a short-lived OAuth2 Bearer token on every task run and trigger poll; never logged.

Possible Values
NO_ACTIONALLOWPREVENTDETECT

Action

New action CrowdStrike takes when this indicator is observed.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaulthttps://api.crowdstrike.com

CrowdStrike API base URL

Base URL of the CrowdStrike Falcon API for your cloud region (for example: https://api.crowdstrike.com for US-1, https://api.us-2.crowdstrike.com for US-2, https://api.eu-1.crowdstrike.com for EU-1, or https://api.laggar.gcw.crowdstrike.com for US-GOV-1). Defaults to the US-1 endpoint. Using the wrong region for your tenant results in 403 Forbidden responses.

Expiration, in days from now

New expiration, from 1 to 365 days from now. Converted to an RFC-3339 expiration timestamp before being sent to the CrowdStrike API.

IOC ID

ID of the custom IOC to update.

Possible Values
INFORMATIONALLOWMEDIUMHIGHCRITICAL

Severity

New severity for this indicator.

ID of the updated IOC