f3nris
f6b8c84285
Every EDR (category: endpoint) integration is now audited for an OCSF mapper. Six had a fetch command but no mapper — add a bundled OCSF mapper for each, wire the fetch command as an ingestion source (ingest: results_path/dedup_key [/incremental_field]) and add the top-level ingestion block. Field mappings were derived from each vendor's fetch output and cross-referenced against the demisto/content reference for that vendor. - carbon-black-cloud: search_alerts (results_path results, dedup id) — 35 fields - cisco-secure-endpoint: list_events (data, id) — 21 fields - cybereason: query_malops (malops, guid, incr start_time) — 6 fields - sophos-central: list_alerts (items, id) — 14 fields - trend-vision-one: list_alerts (items, id, incr start_datetime) — 19 fields - withsecure: list_incidents (items, incidentId) — 7 fields Validated: every manifest passes ParseManifest+ValidateManifest and every mapper passes ParseMapperFile with all JSONata source_path/field expressions compiling. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
130 lines
4.6 KiB
YAML
130 lines
4.6 KiB
YAML
id: carbon_black_cloud
|
|
name: VMware Carbon Black Cloud
|
|
version: 1.0.0
|
|
description: "VMware Carbon Black Cloud (Platform API) — endpoint containment: search and read devices, quarantine/unquarantine an endpoint, trigger a background scan, update a device's policy, search alerts, and ban/unban a file hash (reputation override). API-token authentication; stdlib-only, no extra Python dependencies."
|
|
changelog: "1.0.0 — Initial release: device search/get, quarantine/unquarantine, background scan, update policy, alert search, ban hash, delete reputation override."
|
|
category: endpoint
|
|
|
|
# Per-instance configuration. The API token is sent as
|
|
# 'X-Auth-Token: <api_secret_key>/<api_id>'. org_key identifies the org.
|
|
config_schema:
|
|
properties:
|
|
base_url:
|
|
type: string
|
|
description: "Carbon Black Cloud URL (e.g. https://defense.conferdeploy.net)"
|
|
api_id:
|
|
type: string
|
|
description: "API key ID"
|
|
api_secret_key:
|
|
type: string
|
|
description: "API secret key"
|
|
x-soar-sensitive: true
|
|
org_key:
|
|
type: string
|
|
description: "Organization key"
|
|
required:
|
|
- base_url
|
|
- api_id
|
|
- api_secret_key
|
|
- org_key
|
|
|
|
commands:
|
|
- id: list_devices
|
|
name: cbc-list-devices
|
|
description: "Search devices (optionally by hostname or IP)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
query: { type: string, description: "Free-text query (hostname, user, IP)" }
|
|
rows: { type: number, description: "Max devices (default 50)" }
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
- id: get_device
|
|
name: cbc-get-device
|
|
description: "Get a single device by ID."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
device_id: { type: string, description: "Device ID" }
|
|
required: [device_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: quarantine_device
|
|
name: cbc-quarantine-device
|
|
description: "Quarantine (network-isolate) a device."
|
|
inputs_schema:
|
|
properties:
|
|
device_id: { type: string, description: "Device ID" }
|
|
required: [device_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: unquarantine_device
|
|
name: cbc-unquarantine-device
|
|
description: "Remove a device from quarantine."
|
|
inputs_schema:
|
|
properties:
|
|
device_id: { type: string, description: "Device ID" }
|
|
required: [device_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: background_scan
|
|
name: cbc-background-scan
|
|
description: "Start or stop a background scan on a device."
|
|
inputs_schema:
|
|
properties:
|
|
device_id: { type: string, description: "Device ID" }
|
|
toggle: { type: string, description: "ON or OFF (default ON)" }
|
|
required: [device_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: update_device_policy
|
|
name: cbc-update-device-policy
|
|
description: "Assign a device to a different policy."
|
|
inputs_schema:
|
|
properties:
|
|
device_id: { type: string, description: "Device ID" }
|
|
policy_id: { type: string, description: "Target policy ID" }
|
|
required: [device_id, policy_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: search_alerts
|
|
name: cbc-search-alerts
|
|
description: "Search alerts. Used for ingestion: results path = results."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
query: { type: string, description: "Free-text alert query" }
|
|
rows: { type: number, description: "Max alerts (default 50)" }
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
ingest:
|
|
results_path: results
|
|
dedup_key: id
|
|
- id: ban_hash
|
|
name: cbc-ban-hash
|
|
description: "Ban a file by SHA-256 hash (reputation deny-list override)."
|
|
inputs_schema:
|
|
properties:
|
|
sha256: { type: string, description: "SHA-256 hash to ban" }
|
|
filename: { type: string, description: "Optional associated file name" }
|
|
description: { type: string, description: "Optional reason/description" }
|
|
required: [sha256]
|
|
outputs_schema: { properties: {} }
|
|
- id: delete_reputation_override
|
|
name: cbc-delete-reputation-override
|
|
description: "Delete a reputation override (unban) by its ID."
|
|
inputs_schema:
|
|
properties:
|
|
override_id: { type: string, description: "Reputation override ID" }
|
|
required: [override_id]
|
|
outputs_schema: { properties: {} }
|
|
|
|
- id: test_connection
|
|
name: cbc-test-connection
|
|
description: "Verify connectivity and the API token (used by the Test button)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
|
|
ingestion:
|
|
command: search_alerts
|
|
mapper: search_alerts
|
|
default_incident_type: "Carbon Black Cloud Alert"
|