f3nris/riposte-marketplace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(crowdstrike): correct search_detections OCSF mapper against Raptor alert schema

Browse Source 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Guillaume BOURGEOIS
2026-06-26 14:44:25 +02:00
parent 096fa21808
commit 44694f6d9e
2 changed files with 22 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
integrations/crowdstrike/manifest.yaml
+2 -2
View File
@@ -1,8 +1,8 @@
id: crowdstrike id: crowdstrike
name: CrowdStrike Falcon name: CrowdStrike Falcon
version: 1.2.1 version: 1.2.2
description: "CrowdStrike Falcon (OAuth2 API) — full IR coverage: device/IOC/process enrichment, detections & cases, host groups, Real Time Response, ML/IOA exclusions, quarantine, Spotlight/CVE, ODS scans, CSPM, users, IOA rules, CNAPP, and Fusion workflows." description: "CrowdStrike Falcon (OAuth2 API) — full IR coverage: device/IOC/process enrichment, detections & cases, host groups, Real Time Response, ML/IOA exclusions, quarantine, Spotlight/CVE, ODS scans, CSPM, users, IOA rules, CNAPP, and Fusion workflows."
changelog: "1.2.1 — Marked search_detections as an ingestion source (ingest hints: results_path=resources, dedup_key=composite_id) so the alert-rule editor pre-fills it. 1.2.0 — Added a pre-built OCSF mapper for search_detections (Falcon unified alerts → OCSF: device, finding, MITRE, actor/parent process, file and IOC). 1.1.1 — Added test_connection for the instance Test button. 1.1.0 — Expanded to 81 commands (host groups, cases, RTR files/scripts/responders, ML/IOA exclusions, quarantine, Spotlight host-by-vuln/CVE, ODS scans, CSPM, users, IOA rules, CNAPP, identity/mobile detection resolve, and workflows). 1.0.0 — Initial release: device/detection enrichment, Spotlight, IOC management, contain/lift, and core RTR." changelog: "1.2.2 — Corrected the search_detections OCSF mapper against the Falcon Raptor alert schema: domain is device.hostinfo.domain, dropped non-existent fields, added scenario/alleged_filetype/cid. 1.2.1 — Marked search_detections as an ingestion source (ingest hints: results_path=resources, dedup_key=composite_id) so the alert-rule editor pre-fills it. 1.2.0 — Added a pre-built OCSF mapper for search_detections (Falcon unified alerts → OCSF: device, finding, MITRE, actor/parent process, file and IOC). 1.1.1 — Added test_connection for the instance Test button. 1.1.0 — Expanded to 81 commands (host groups, cases, RTR files/scripts/responders, ML/IOA exclusions, quarantine, Spotlight host-by-vuln/CVE, ODS scans, CSPM, users, IOA rules, CNAPP, identity/mobile detection resolve, and workflows). 1.0.0 — Initial release: device/detection enrichment, Spotlight, IOC management, contain/lift, and core RTR."
category: endpoint category: endpoint
# Per-instance configuration. Scripts obtain an OAuth2 bearer token from # Per-instance configuration. Scripts obtain an OAuth2 bearer token from
integrations/crowdstrike/mappers/search_detections.yaml
+20 -24
View File
@@ -1,5 +1,5 @@
name: "CrowdStrike Falcon Alerts → OCSF" name: "CrowdStrike Falcon Alerts → OCSF"
description: "Exhaustive map of a CrowdStrike Falcon unified alert (alerts/entities/alerts/v2, results_path = resources) to OCSF. Triggering process = actor (actor.*); detected file = subject (file.*); MITRE under attacks.*." description: "Exhaustive map of a CrowdStrike Falcon unified alert (alerts/entities/alerts/v2, results_path = resources) to OCSF. Field paths validated against the XSOAR Raptor key maps. Triggering process = actor (actor.*); detected file = subject (file.*); MITRE under attacks.*."
field_mappings: field_mappings:
title: "name" title: "name"
severity: "severity_name = 'Critical' ? 5 : (severity_name = 'High' ? 4 : (severity_name = 'Medium' ? 3 : 2))" severity: "severity_name = 'Critical' ? 5 : (severity_name = 'High' ? 4 : (severity_name = 'Medium' ? 3 : 2))"
@@ -9,7 +9,7 @@ field_mappings:
ocsf: ocsf:
# ── Endpoint / device ───────────────────────────────────────────── # ── Endpoint / device ─────────────────────────────────────────────
- { source_path: "device.hostname", ocsf_field: "src_endpoint.hostname" } - { source_path: "device.hostname", ocsf_field: "src_endpoint.hostname" }
- { source_path: "device.machine_domain", ocsf_field: "src_endpoint.domain" } - { source_path: "device.hostinfo.domain", ocsf_field: "src_endpoint.domain" }
- { source_path: "device.external_ip", ocsf_field: "src_endpoint.ip" } - { source_path: "device.external_ip", ocsf_field: "src_endpoint.ip" }
- { source_path: "device.local_ip", ocsf_field: "device.ip" } - { source_path: "device.local_ip", ocsf_field: "device.ip" }
- { source_path: "device.os_version", ocsf_field: "src_endpoint.os.name" } - { source_path: "device.os_version", ocsf_field: "src_endpoint.os.name" }
@@ -17,17 +17,17 @@ ocsf:
- { source_path: "device.mac_address", ocsf_field: "src_endpoint.mac" } - { source_path: "device.mac_address", ocsf_field: "src_endpoint.mac" }
- { source_path: "device.device_id", ocsf_field: "device.uid" } - { source_path: "device.device_id", ocsf_field: "device.uid" }
- { source_path: "device.agent_version", ocsf_field: "metadata.product.version" } - { source_path: "device.agent_version", ocsf_field: "metadata.product.version" }
- { source_path: "device.cid", ocsf_field: "cloud.account.uid" }
# ── Finding / analytic ──────────────────────────────────────────── # ── Finding / analytic ────────────────────────────────────────────
- { source_path: "composite_id", ocsf_field: "finding_info.uid" } - { source_path: "composite_id", ocsf_field: "finding_info.uid" }
- { source_path: "name", ocsf_field: "finding_info.title" } - { source_path: "name", ocsf_field: "finding_info.title" }
- { source_path: "description", ocsf_field: "finding_info.desc" } - { source_path: "description", ocsf_field: "finding_info.desc" }
- { source_path: "created_timestamp", ocsf_field: "finding_info.created_time" } - { source_path: "created_timestamp", ocsf_field: "finding_info.created_time" }
- { source_path: "updated_timestamp", ocsf_field: "finding_info.modified_time" } - { source_path: "updated_timestamp", ocsf_field: "finding_info.modified_time" }
- { source_path: "type", ocsf_field: "finding_info.analytic.type" } - { source_path: "scenario", ocsf_field: "finding_info.analytic.name" }
- { source_path: "pattern_id", ocsf_field: "finding_info.analytic.uid" } - { source_path: "pattern_id", ocsf_field: "finding_info.analytic.uid" }
- { source_path: "confidence", ocsf_field: "confidence" } - { source_path: "confidence", ocsf_field: "confidence" }
- { source_path: "status", ocsf_field: "status" } - { source_path: "status", ocsf_field: "status" }
- { source_path: "pattern_disposition_description", ocsf_field: "status_detail" }
# ── MITRE ATT&CK ────────────────────────────────────────────────── # ── MITRE ATT&CK ──────────────────────────────────────────────────
- { source_path: "tactic", ocsf_field: "attacks.tactic.name" } - { source_path: "tactic", ocsf_field: "attacks.tactic.name" }
- { source_path: "tactic_id", ocsf_field: "attacks.tactic.uid" } - { source_path: "tactic_id", ocsf_field: "attacks.tactic.uid" }
@@ -36,23 +36,19 @@ ocsf:
# ── Triggering process — the actor ──────────────────────────────── # ── Triggering process — the actor ────────────────────────────────
- { source_path: "filename", ocsf_field: "actor.process.name" } - { source_path: "filename", ocsf_field: "actor.process.name" }
- { source_path: "cmdline", ocsf_field: "actor.process.cmd_line" } - { source_path: "cmdline", ocsf_field: "actor.process.cmd_line" }
- { source_path: "process_id", ocsf_field: "actor.process.pid" }
- { source_path: "filepath", ocsf_field: "actor.process.file.path" } - { source_path: "filepath", ocsf_field: "actor.process.file.path" }
- { source_path: "sha256", ocsf_field: "actor.process.file.hashes.sha256" } - { source_path: "sha256", ocsf_field: "actor.process.file.hashes.sha256" }
- { source_path: "md5", ocsf_field: "actor.process.file.hashes.md5" } - { source_path: "md5", ocsf_field: "actor.process.file.hashes.md5" }
- { source_path: "user_name", ocsf_field: "actor.user.name" } - { source_path: "user_name", ocsf_field: "actor.user.name" }
- { source_path: "user_id", ocsf_field: "actor.user.uid" } - { source_path: "user_id", ocsf_field: "actor.user.uid" }
- { source_path: "logon_domain", ocsf_field: "actor.user.domain" }
# ── Parent process ──────────────────────────────────────────────── # ── Parent process ────────────────────────────────────────────────
- { source_path: "parent_details.filename", ocsf_field: "actor.process.parent_process.name" } - { source_path: "parent_details.cmdline", ocsf_field: "actor.process.parent_process.cmd_line" }
- { source_path: "parent_details.cmdline", ocsf_field: "actor.process.parent_process.cmd_line" }
- { source_path: "parent_details.process_id", ocsf_field: "actor.process.parent_process.pid" }
# ── Detected file — the subject ─────────────────────────────────── # ── Detected file — the subject ───────────────────────────────────
- { source_path: "filename", ocsf_field: "file.name" } - { source_path: "filename", ocsf_field: "file.name" }
- { source_path: "filepath", ocsf_field: "file.path" } - { source_path: "filepath", ocsf_field: "file.path" }
- { source_path: "sha256", ocsf_field: "file.hashes.sha256" } - { source_path: "sha256", ocsf_field: "file.hashes.sha256" }
- { source_path: "md5", ocsf_field: "file.hashes.md5" } - { source_path: "md5", ocsf_field: "file.hashes.md5" }
- { source_path: "alleged_filetype", ocsf_field: "file.type" }
# ── IOC / observable ────────────────────────────────────────────── # ── IOC / observable ──────────────────────────────────────────────
- { source_path: "ioc_value", ocsf_field: "observables.value" } - { source_path: "ioc_value", ocsf_field: "observables.value" }
- { source_path: "ioc_type", ocsf_field: "observables.type" } - { source_path: "ioc_type", ocsf_field: "observables.type" }
- { source_path: "ioc_description", ocsf_field: "observables.name" }