Skip to main content

Carbon Black Endpoint Standard v2

This Integration is part of the Carbon Black Endpoint Standard Pack.#

Supported versions

Supported Cortex XSOAR versions: 5.5.0 and later.

VMware Carbon Black Endpoint Standard (formerly known as Carbon Black Defense) is a next-generation antivirus + EDR in one cloud-delivered platform that stops commodity malware, advanced malware, non-malware attacks, and ransomware. This integration was integrated and tested with version 1.1.2 of Carbon Black Endpoint Standard

New Features in Carbon Black Endpoint Standard v2#

The Carbon Black Endpoint Standard v1 integration is deprecated because Carbon Black released a new version of their API. Use the Carbon Black Endpoint Standard v2 integration instead. The following are the new features in V2.

New Commands#

The Carbon Black Endpoint Standard v2 integration supports the following new commands:

Deprecated Commands in Carbon Black Endpoint Standard v1#

The following commands from the Carbon Black Endpoint Standard v1 integration have been deprecated and replaced with the v2 commands as shown.

Deprecated CommandReplaced with v2 Commands
cbd-get-device-statuscbd-device-search
cbd-get-devices-statuscbd-device-search
cbd-change-device-status- cbd-device-quarantine
- cbd-device-unquarantine
- cbd-device-background-scan
- cbd-device-background-scan-stop
- cbd-device-bypass
- cbd-device-unbypass
- cbd-device-policy-update
- cbd-device-update-sensor-version
cbd-find-eventscbd-find-events returns a job_id to use in the cbd-find-events-results command as an argument.
cbd-find-processescbd-find-processes returns a job_id to use in the cbd-find-processes-results command as an argument.

Playbooks#

There are 3 new playbooks:

  • Carbon Black Endpoint Standard Find Events - Finds events using a search query (or device_id, etc.).
  • Carbon Black Endpoint Standard Find Event Details - Receives event IDs and returns details about the event.
  • Carbon Black Endpoint Standard Find Processes - Finds processes using a search query (or device_id, etc.).

Mapper#

Carbon Black Endpoint Standard Mapper.

Layout#

Carbon Black Endpoint Standard Incoming Layout.

Classifier#

Carbon Black Endpoint Standard

Configure Carbon Black Endpoint Standard on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Carbon Black Endpoint Standard.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    URLTrue
    Custom API KeyThis Custom API key is required for all use cases except the policy use cases.False
    Custom API Secret KeyThis Custom API secret key is required for all use cases except the policy use cases.False
    Live Response API KeyThis Live Response API key is required only for the policy use cases.False
    Live Response API Secret KeyThis Live Response API secret key is required only for the policy use cases.False
    Organization KeyThe organization unique key. This is required for all use cases (and for fetching incidents) except the policy use cases.False
    Incident typeFalse
    Fetch incidentsFalse
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
    The type of the alertType of alert to be fetched.False
    The category of the alert.Category of alert to be fetched (THREAT, MONITORED). If nothing is selected he is fetching from all categories.False
    Device idThe alerts related to a specific device, represented by its ID.False
    Policy idThe alerts related to a specific policy, represented by its ID.False
    Device usernameThe alerts related to a specific device, represented by its username.False
    QueryQuery in Lucene syntax and/or value searches.False
    First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days).False
    Maximum number of incidents per fetchFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

cbd-get-alert-details#


Get details about the events that led to an alert by its ID. This includes retrieving metadata around the alert as well as a list of all the events associated with the alert. Only API keys of type “API” can call the alerts API.

Required Permissions#

RBAC Permissions Required - org.alerts: READ

Base Command#

cbd-get-alert-details

Input#

Argument NameDescriptionRequired
alertIdThe ID of the alert.Required

Context Output#

PathTypeDescription
CarbonBlackDefense.Alert.idStringThe identifier for the alert.
CarbonBlackDefense.Alert.legacy_alert_idStringThe unique short ID for the alerts to support easier consumption in the UI console. Use the ID for API requests.
CarbonBlackDefense.Alert.org_keyStringThe unique identifier for the organization associated with the alert.
CarbonBlackDefense.Alert.create_timeDateThe time the alert was created.
CarbonBlackDefense.Alert.last_update_timeDateThe last time the alert was updated.
CarbonBlackDefense.Alert.first_event_timeDateThe time of the first event associated with the alert.
CarbonBlackDefense.Alert.last_event_timeDateThe time of the latest event associated with the alert.
CarbonBlackDefense.Alert.threat_idStringThe identifier of the threat that this alert belongs to. Threats are comprised of a combination of factors that can be repeated across devices.
CarbonBlackDefense.Alert.severityNumberThe threat ranking of the alert.
CarbonBlackDefense.Alert.categoryStringThe category of the alert (THREAT, MONITORED).
CarbonBlackDefense.Alert.device_idNumberThe identifier assigned by Carbon Black Cloud to the device associated with the alert.
CarbonBlackDefense.Alert.device_osStringThe operating system of the device associated with the alert.
CarbonBlackDefense.Alert.device_os_versionStringThe operating system and version on the device.
CarbonBlackDefense.Alert.device_nameStringThe hostname of the device associated with the alert.
CarbonBlackDefense.Alert.device_usernameStringThe username of the user logged on during the alert. If the user is not available then this may be populated with the device owner.
CarbonBlackDefense.Alert.policy_idNumberThe identifier for the policy associated with the device at the time of the alert.
CarbonBlackDefense.Alert.policy_nameStringThe name of the policy associated with the device at the time of the alert.
CarbonBlackDefense.Alert.target_valueStringThe priority of the device assigned by the policy.
CarbonBlackDefense.Alert.workflow.stateStringThe state of the tracking system for alerts as they are triaged and resolved. The state can be OPEN or DISMISSED.
CarbonBlackDefense.Alert.workflow.remediationStringThe state of the workflow of the tracking system for alerts as they are triaged and resolved. The state can be OPEN or DISMISSED.
CarbonBlackDefense.Alert.workflow.last_update_timeDateThe last time the alert was updated.
CarbonBlackDefense.Alert.workflow.commentStringThe comment about the workflow of the tracking system for alerts as they are triaged and resolved.
CarbonBlackDefense.Alert.workflow.changed_byStringThe name of the person who changed the alert.
CarbonBlackDefense.Alert.notes_presentBooleanIndicates if notes are associated with the threat ID.
CarbonBlackDefense.Alert.tagsUnknownTags associated with the alert ([ "tag1", "tag2" ]).
CarbonBlackDefense.Alert.reasonStringThe description of the alert.
CarbonBlackDefense.Alert.countNumberThe count of the alert.
CarbonBlackDefense.Alert.report_idStringThe identifier of the report that contains the IOC.
CarbonBlackDefense.Alert.report_nameStringThe name of the report that contains the IOC.
CarbonBlackDefense.Alert.ioc_idStringThe identifier of the IOC that caused the hit.
CarbonBlackDefense.Alert.ioc_fieldStringThe indicator of comprise (IOC) field that the hit contains.
CarbonBlackDefense.Alert.ioc_hitStringIOC field value or IOC that matches the query.
CarbonBlackDefense.Alert.watchlists.idStringThe ID of the watchlists associated with an alert.
CarbonBlackDefense.Alert.watchlists.nameStringThe name of the watchlists associated with an alert.
CarbonBlackDefense.Alert.process_guidStringThe global unique identifier of the process that triggered the hit.
CarbonBlackDefense.Alert.process_nameStringThe name of the process that triggered the hit.
CarbonBlackDefense.Alert.run_stateStringThe run state for the watchlist alerts. This value is always "RAN".
CarbonBlackDefense.Alert.threat_indicators.process_nameStringThe name of the threat indicators that make up the threat.
CarbonBlackDefense.Alert.threat_indicators.sha256StringThe SHA-256 hash of the threat indicators that make up the threat.
CarbonBlackDefense.Alert.threat_indicators.ttpsStringThe tactics, techniques, and procedures (TTPs) of the threat indicators that make up the threat.
CarbonBlackDefense.Alert.threat_cause_actor_sha256StringThe SHA-256 hash of the threat cause actor.
CarbonBlackDefense.Alert.threat_cause_actor_md5StringThe MD5 hash of the threat cause actor.
CarbonBlackDefense.Alert.threat_cause_actor_nameStringProcess name or IP address of the threat actor.
CarbonBlackDefense.Alert.threat_cause_reputationStringThe reputation of the threat cause. (KNOWN_MALWARE, SUSPECT_MALWARE, PUP, NOT_LISTED, ADAPTIVE_WHITE_LIST, COMMON_WHITE_LIST, TRUSTED_WHITE_LIST, COMPANY_BLACK_LIST).
CarbonBlackDefense.Alert.threat_cause_threat_categoryStringThe category of the threat cause. (UNKNOWN, NON_MALWARE, NEW_MALWARE, KNOWN_MALWARE, RISKY_PROGRAM).
CarbonBlackDefense.Alert.threat_cause_vectorStringThe source of the threat cause. (EMAIL, WEB, GENERIC_SERVER, GENERIC_CLIENT, REMOTE_DRIVE, REMOVABLE_MEDIA, UNKNOWN, APP_STORE, THIRD_PARTY).
CarbonBlackDefense.Alert.document_guidStringThe document GUID.
CarbonBlackDefense.Alert.typeStringThe type of alert. (CB_ANALYTICS, DEVICE_CONTROL).
CarbonBlackDefense.Alert.reason_codeStringThe shorthand enum for the full-text reason.
CarbonBlackDefense.Alert.device_locationStringWhether the device was on-premise or off-premise when the alert started. (ONSITE, OFFSITE, UNKNOWN).
CarbonBlackDefense.Alert.created_by_event_idStringEvent identifier that initiated the alert.
CarbonBlackDefense.Alert.threat_activity_dlpStringWhether the alert involved data loss prevention (DLP). (NOT_ATTEMPTED, ATTEMPTED, SUCCEEDED).
CarbonBlackDefense.Alert.threat_activity_phishStringWhether the alert involved phishing. (NOT_ATTEMPTED, ATTEMPTED, SUCCEEDED).
CarbonBlackDefense.Alert.threat_activity_c2StringWhether the alert involved a command and control (c2) server. (NOT_ATTEMPTED, ATTEMPTED, SUCCEEDED).
CarbonBlackDefense.Alert.threat_cause_actor_process_pidStringThe process identifier (PID) of the actor process.
CarbonBlackDefense.Alert.threat_cause_process_guidStringThe GUID of the process.
CarbonBlackDefense.Alert.threat_cause_parent_guidStringThe parent GUID of the process.
CarbonBlackDefense.Alert.threat_cause_cause_event_idStringThe threat cause cause event ID.
CarbonBlackDefense.Alert.blocked_threat_categoryStringThe category of the threat on which we were able to take action. (UNKNOWN, NON_MALWARE, NEW_MALWARE, KNOWN_MALWARE, RISKY_PROGRAM).
CarbonBlackDefense.Alert.not_blocked_threat_categoryStringOther potentially malicious activity involved in the threat on which we weren’t able to take action (either due to policy config, or not having a relevant rule). (UNKNOWN, NON_MALWARE, NEW_MALWARE, KNOWN_MALWARE, RISKY_PROGRAM).
CarbonBlackDefense.Alert.kill_chain_statusStringThe stage within the Cyber Kill Chain sequence most closely associated with the attributes of the alert. (RECONNAISSANCE, WEAPONIZE, DELIVER_EXPLOIT, INSTALL_RUN, COMMAND_AND_CONTROL, EXECUTE_GOAL, BREACH). For example [ "EXECUTE_GOAL", "BREACH" ].
CarbonBlackDefense.Alert.sensor_actionStringThe action taken by the sensor, according to the rule of the policy. (POLICY_NOT_APPLIED, ALLOW, ALLOW_AND_LOG, TERMINATE, DENY).
CarbonBlackDefense.Alert.policy_appliedStringWhether a policy was applied. (APPLIED, NOT_APPLIED).

Command Example#

!cbd-get-alert-details alertId=3d541e1d-8930-4651-85c3-8cd9728d9776

Context Example#

{
"CarbonBlackDefense": {
"Alert": {
"category": "THREAT",
"count": 0,
"create_time": "2021-04-04T10:42:54.143Z",
"device_id": 5678,
"device_name": "AB\\winABCL-1234",
"device_os": "WINDOWS",
"device_os_version": null,
"device_username": "jon@example.com",
"document_guid": "1a2b3c4d",
"first_event_time": "2021-04-04T10:39:55.946Z",
"id": "1234",
"ioc_field": null,
"ioc_hit": "((netconn_port:5355 device_os:WINDOWS)) -enriched:true",
"ioc_id": "565633-0",
"last_event_time": "2021-04-04T10:39:55.946Z",
"last_update_time": "2021-04-04T10:42:54.143Z",
"legacy_alert_id": "ABCD-1234",
"notes_present": false,
"org_key": "7DESJ9GN",
"policy_id": 6525,
"policy_name": "default",
"process_guid": "7DESJ9GN-003e6d59-00000498-00000000-1d70b726e2c3359",
"process_name": "svchost.exe",
"reason": "Process svchost.exe was detected by the report \"Credential Access - LLMNR/NBT-NS Poisoning - LLMNR Traffic Detected\" in watchlist \"ATT&CK Framework\"",
"report_id": "ABCD-1234",
"report_name": "Credential Access - LLMNR/NBT-NS Poisoning - LLMNR Traffic Detected",
"run_state": "RAN",
"severity": 1,
"tags": null,
"target_value": "LOW",
"threat_cause_actor_md5": "36f670d89040709013f6a460176767ec",
"threat_cause_actor_name": "c:\\windows\\system32\\svchost.exe",
"threat_cause_actor_sha256": "438b6ccd84f4dd32d9684ed7d58fd7d1e5a75fe3f3d12ab6c788e6bb0ffad5e7",
"threat_cause_reputation": "TRUSTED_WHITE_LIST",
"threat_cause_threat_category": "UNKNOWN",
"threat_cause_vector": "UNKNOWN",
"threat_id": "8E4CE676E9C9EEF4F94065D009B66094",
"threat_indicators": [
{
"process_name": "svchost.exe",
"sha256": "1a2b3c4d",
"ttps": [
"565633-0"
]
}
],
"type": "WATCHLIST",
"watchlists": [
{
"id": "1234",
"name": "ATT&CK Framework"
}
],
"workflow": {
"changed_by": "Carbon Black",
"comment": null,
"last_update_time": "2021-04-04T10:42:05.900Z",
"remediation": null,
"state": "OPEN"
}
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Get Alert Details#

IdCategoryDevice IdDevice NameDevice UsernameCreate TimeIoc HitPolicy NameProcess NameTypeSeverity
1234THREAT5678AB\winABC-123jon@example.com2021-04-04T10:42:54.143Z((netconn_port:5355 device_os:WINDOWS)) -enriched:truedefaultsvchost.exeWATCHLIST1

cbd-device-search#


Searches devices in your organization.

Required Permissions#

RBAC Permissions Required - device: READ

Base Command#

cbd-device-search

Input#

Argument NameDescriptionRequired
device_idThe identifier for the device.Optional
osThe operating system. Possible values: "WINDOWS", "MAC", "LINUX", and "OTHER". Possible values are: WINDOWS, MAC, LINUX, OTHER.Optional
statusThe status of the device. Possible values: "PENDING", "REGISTERED", "DEREGISTERED", "BYPASS", "ACTIVE", "INACTIVE", "ERROR", "ALL", "BYPASS_ON", "LIVE", "SENSOR_PENDING_UPDATE". Possible values are: PENDING, REGISTERED, DEREGISTERED, BYPASS, ACTIVE, INACTIVE, ERROR, ALL, BYPASS_ON, LIVE, SENSOR_PENDING_UPDATE.Optional
start_timeThe time to start getting results. specified as ISO-8601 strings for example: "2021-01-27T12:43:26.243Z".Optional
target_priorityThe “Target value” configured in the policy assigned to the sensor. Possible values: "LOW", "MEDIUM", "HIGH", "MISSION_CRITICAL". Possible values are: LOW, MEDIUM, HIGH, MISSION_CRITICAL.Optional
queryThe query in Lucene syntax and/or value searches.Optional
end_timeThe time to stop getting results. specified as ISO-8601 strings for example: "2021-02-27T12:43:26.243Z".Optional
rowsThe maximum number of rows to return. Default is 20. Default is 20.Optional

Context Output#

PathTypeDescription
CarbonBlackDefense.Device.activation_codeStringThe device activation code to register the sensor with a specific organization.
CarbonBlackDefense.Device.activation_code_expiry_timeDateThe time when the activation code expires and cannot be used to register a device. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.ad_group_idNumberThe Active Directory group ID to match.
CarbonBlackDefense.Device.appliance_nameStringThe name of the appliance the Virtual Machine (VM) is associated with.
CarbonBlackDefense.Device.appliance_uuidStringThe UUID of the appliance the VM is associated with.
CarbonBlackDefense.Device.av_ave_versionStringThe AVE version (part of AV Version).
CarbonBlackDefense.Device.av_engineStringThe current antivirus (AV) version.
CarbonBlackDefense.Device.av_last_scan_timeDateThe last time a local scan completed. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.av_masterBooleanWhether the device is an AV Master.
CarbonBlackDefense.Device.av_pack_versionStringThe pack version (part of AV version).
CarbonBlackDefense.Device.av_product_versionStringThe product version (part of AV version).
CarbonBlackDefense.Device.av_statusStringThe status of the local scan. For example [ "AV_ACTIVE", "AV_REGISTERED" ]. (AV_NOT_REGISTERED, AV_REGISTERED, AV_DEREGISTERED, AV_ACTIVE, AV_BYPASS, SIGNATURE_UPDATE_DISABLED, ONACCESS_SCAN_DISABLED, ONDEMAND_SCAN_DISABLED, PRODUCT_UPDATE_DISABLED).
CarbonBlackDefense.Device.av_update_serversUnknownA list of the device’s AV servers. For example [ "string", "string" ].
CarbonBlackDefense.Device.av_vdf_versionStringVDF version (part of AV version).
CarbonBlackDefense.Device.cluster_nameStringName of the cluster. A cluster is a group of hosts.
CarbonBlackDefense.Device.current_sensor_policy_nameStringThe name of the policy currently configured on the sensor.
CarbonBlackDefense.Device.datacenter_nameStringThe name of the underlying data center. The data center managed object provides the interface to the common container object for hosts, virtual machines, networks, and datastores.
CarbonBlackDefense.Device.deployment_typeStringThe device’s deployment type. This is a classification that is determined by its lifecycle management policy. (ENDPOINT, WORKLOAD).
CarbonBlackDefense.Device.deregistered_timeDateThe time when the deregister request was received. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.device_meta_data_item_list.key_nameStringThe key name that describes the device.
CarbonBlackDefense.Device.device_meta_data_item_list.key_valueStringThe key value that describes the device.
CarbonBlackDefense.Device.device_meta_data_item_list.positionNumberThe position that describes the device.
CarbonBlackDefense.Device.device_owner_idNumberThe identifier for the device owner associated with the device.
CarbonBlackDefense.Device.emailStringThe email address for the device owner.
CarbonBlackDefense.Device.encoded_activation_codeStringThe encoded activation code.
CarbonBlackDefense.Device.esx_host_nameStringThe name of the ESX host on which the VM is deployed.
CarbonBlackDefense.Device.esx_host_uuidStringThe UUID of the ESX host on which the VM is deployed.
CarbonBlackDefense.Device.first_nameStringThe first name of the device owner.
CarbonBlackDefense.Device.idNumberThe ID of the device.
CarbonBlackDefense.Device.last_contact_timeDateThe last time the sensor contacted Carbon Black Cloud. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_device_policy_changed_timeDateThe last time the sensor changed from one policy to another. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_device_policy_requested_timeDateThe last time the sensor checked for changes to the policy. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_external_ip_addressStringThe last IP address of the device according to Carbon Black Cloud. This can differ from the last_internal_ip_address due to the network proxy or NAT. Can be either IPv4 or IPv6 format.
CarbonBlackDefense.Device.last_internal_ip_addressStringThe last IP address of the device reported by the sensor. Can be either IPv4 or IPv6 format.
CarbonBlackDefense.Device.last_locationStringThe device’s current location relative to the organization’s network, based on the current IP address and the device’s registered DNS domain suffix. (UNKNOWN, ONSITE, OFFSITE).
CarbonBlackDefense.Device.last_nameStringThe last name of the device owner.
CarbonBlackDefense.Device.last_policy_updated_timeDateThe last time the current policy received an update. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_reported_timeDateThe last time Carbon Black Cloud received one or more events reported by the sensor. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_reset_timeDateThe last time the device was reset. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.last_shutdown_timeDateThe last time the device was shutdown. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.linux_kernel_versionStringNot implemented.
CarbonBlackDefense.Device.login_user_nameStringThe last user who logged in to the device. (Requires Windows Carbon Black Cloud sensor).
CarbonBlackDefense.Device.mac_addressStringThe media access control (MAC) address for the device’s primary interface. (Requires Windows CBC sensor version 3.6.0.1941 or later, or macOS CBC sensor).
CarbonBlackDefense.Device.middle_nameStringThe middle name of the device owner.
CarbonBlackDefense.Device.nameStringThe hostname of the endpoint recorded by the sensor when last initialized.
CarbonBlackDefense.Device.organization_idNumberThe organization identifier.
CarbonBlackDefense.Device.organization_nameStringThe organization name.
CarbonBlackDefense.Device.osStringThe operating system. (WINDOWS, MAC, LINUX, OTHER).
CarbonBlackDefense.Device.os_versionStringThe operating system and version of the endpoint.
CarbonBlackDefense.Device.passive_modeBooleanWhether the device is in bypass mode.
CarbonBlackDefense.Device.policy_idNumberThe policy identifier assigned to the device.
CarbonBlackDefense.Device.policy_nameStringThe policy name assigned to the device. This name may not match the current_sensor_policy_name until the sensor checks back in.
CarbonBlackDefense.Device.policy_overrideBooleanWhether the policy was manually assigned to override mass sensor management.
CarbonBlackDefense.Device.quarantinedBooleanThe indicator that the device is in quarantine mode.
CarbonBlackDefense.Device.registered_timeDateThe time when the device was registered with Carbon Black Cloud. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.scan_last_action_timeDateThe last time the background scan was started or stopped. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.scan_last_complete_timeDateThe time the last background scan completed. (ISO 8601 timestamp in UTC).
CarbonBlackDefense.Device.scan_statusStringThe status of the background scan. (NEVER_RUN, STOPPED, IN_PROGRESS, COMPLETED).
CarbonBlackDefense.Device.sensor_kit_typeStringThe type of sensor installed on the device. (XP, WINDOWS, MAC, AV_SIG, OTHER, RHEL, UBUNTU, SUSE, AMAZON_LINUX, MAC_OSX).
CarbonBlackDefense.Device.sensor_out_of_dateBooleanWhether there is a new version available to be installed.
CarbonBlackDefense.Device.sensor_pending_updateBooleanWhether the sensor is marked by the sensor updater service for a sensor upgrade.
CarbonBlackDefense.Device.sensor_statesStringThe states the sensor is in. For example [ "ACTIVE", "LIVE_RESPONSE_ENABLED" ]. (ACTIVE, PANICS_DETECTED, LOOP_DETECTED, DB_CORRUPTION_DETECTED, CSR_ACTION, REPUX_ACTION, DRIVER_INIT_ERROR, REMGR_INIT_ERROR, UNSUPPORTED_OS, SENSOR_UPGRADE_IN_PROGRESS, SENSOR_UNREGISTERED, WATCHDOG, SENSOR_RESET_IN_PROGRESS, DRIVER_INIT_REBOOT_REQUIRED, DRIVER_LOAD_NOT_GRANTED, SENSOR_SHUTDOWN, SENSOR_MAINTENANCE, FULL_DISK_ACCESS_NOT_GRANTED, DEBUG_MODE_ENABLED, AUTO_UPDATE_DISABLED, SELF_PROTECT_DISABLED, VDI_MODE_ENABLED, POC_MODE_ENABLED, SECURITY_CENTER_OPTLN_DISABLED, LIVE_RESPONSE_RUNNING, LIVE_RESPONSE_NOT_RUNNING, LIVE_RESPONSE_KILLED, LIVE_RESPONSE_NOT_KILLED, LIVE_RESPONSE_ENABLED, LIVE_RESPONSE_DISABLED, DRIVER_KERNEL, DRIVER_USERSPACE).
CarbonBlackDefense.Device.sensor_versionStringThe version of the installed sensor in the format: #.#.#.#.
CarbonBlackDefense.Device.statusStringThe status of the device. (PENDING, REGISTERED, DEREGISTERED, BYPASS Additional searchable statuses that are not returnable ACTIVE, INACTIVE, ERROR, ALL, BYPASS_ON, LIVE, SENSOR_PENDING_UPDATE).
CarbonBlackDefense.Device.target_priorityStringDevice target priorities to match. (LOW, MEDIUM, HIGH, MISSION_CRITICAL).
CarbonBlackDefense.Device.uninstall_codeStringThe code to enter when uninstalling the sensor.
CarbonBlackDefense.Device.vcenter_host_urlStringThe vCenter host URL.
CarbonBlackDefense.Device.vcenter_nameStringThe name of the vCenter the VM is associated with.
CarbonBlackDefense.Device.vcenter_uuidStringThe 128-bit SMBIOS UUID of a vCenter represented as a hexadecimal string.
CarbonBlackDefense.Device.vdi_base_deviceNumberThe identifier of the device from which this device was cloned/re-registered.
CarbonBlackDefense.Device.virtual_machineBooleanWhether this device is a virtual machine (VMware AppDefense integration). Deprecated for deployment_type.
CarbonBlackDefense.Device.virtualization_providerStringThe name of the VM virtualization provider.
CarbonBlackDefense.Device.vm_ipStringThe IP address of the VM.
CarbonBlackDefense.Device.vm_nameStringThe name of the VM that the sensor is deployed on.
CarbonBlackDefense.Device.vm_uuidStringThe 128-bit SMBIOS UUID of a virtual machine represented as a hexadecimal string. (Format: 12345678-abcd-1234-cdef-123456789abc).
CarbonBlackDefense.Device.vulnerability_scoreNumberThe vulnerability score from 0 to 100 indicating the workload’s level of vulnerability with 100 being highly vulnerable.
CarbonBlackDefense.Device.vulnerability_severityStringThe severity level indicating the workload’s vulnerability. (CRITICAL, MODERATE, IMPORTANT, LOW).
CarbonBlackDefense.Device.windows_platformStringDeprecated for os_version. (CLIENT_X86, CLIENT_X64, SERVER_X86, SERVER_X64, CLIENT_ARM64, SERVER_ARM64).

Command Example#

!cbd-device-search

Context Example#

{
"CarbonBlackDefense": {
"Device": [
{
"activation_code": null,
"activation_code_expiry_time": "2020-10-27T13:49:46.641Z",
"ad_group_id": 0,
"appliance_name": null,
"appliance_uuid": null,
"av_ave_version": null,
"av_engine": "",
"av_last_scan_time": null,
"av_master": false,
"av_pack_version": null,
"av_product_version": null,
"av_status": null,
"av_update_servers": null,
"av_vdf_version": null,
"cluster_name": null,
"current_sensor_policy_name": "test",
"datacenter_name": null,
"deployment_type": "WORKLOAD",
"deregistered_time": null,
"device_meta_data_item_list": [
{
"key_name": "OS_MAJOR_VERSION",
"key_value": "CentOS 7",
"position": 0
},
{
"key_name": "SUBNET",
"key_value": "11.1.1",
"position": 0
}
],
"device_owner_id": 556712,
"email": "squee",
"esx_host_name": null,
"esx_host_uuid": null,
"first_name": null,
"id": 1234,
"last_contact_time": "2021-04-04T13:29:14.616Z",
"last_device_policy_changed_time": "2021-03-22T18:02:05.742Z",
"last_device_policy_requested_time": "2021-03-22T18:02:57.571Z",
"last_external_ip_address": "1.1.1.1",
"last_internal_ip_address": "8.8.8.8",
"last_location": "UNKNOWN",
"last_name": null,
"last_policy_updated_time": "2021-03-08T21:03:41.776Z",
"last_reported_time": "2021-04-04T13:29:14.440Z",
"last_reset_time": null,
"last_shutdown_time": null,
"linux_kernel_version": null,
"login_user_name": null,
"mac_address": null,
"middle_name": null,
"name": "bo1tapsandbox-01",
"organization_id": 1105,
"organization_name": "cb-internal-alliances.com",
"os": "LINUX",
"os_version": "CentOS 7.9-2009",
"passive_mode": false,
"policy_id": 63139,
"policy_name": "LRDemo-JH",
"policy_override": true,
"quarantined": false,
"registered_time": "2020-10-20T13:49:46.675Z",
"scan_last_action_time": null,
"scan_last_complete_time": null,
"scan_status": null,
"sensor_kit_type": "RHEL",
"sensor_out_of_date": true,
"sensor_pending_update": false,
"sensor_states": [
"LIVE_RESPONSE_NOT_RUNNING",
"LIVE_RESPONSE_ENABLED",
"LIVE_RESPONSE_NOT_KILLED",
"ACTIVE"
],
"sensor_version": "2.9.0.312585",
"status": "REGISTERED",
"target_priority": "MEDIUM",
"uninstall_code": "TS3HIY27",
"vcenter_host_url": null,
"vcenter_name": null,
"vcenter_uuid": null,
"vdi_base_device": null,
"virtual_machine": true,
"virtualization_provider": "VMW_ESX",
"vm_ip": null,
"vm_name": null,
"vm_uuid": null,
"vulnerability_score": 0,
"vulnerability_severity": null,
"windows_platform": null
},
{
"activation_code": "VQ6IT3",
"activation_code_expiry_time": "2020-12-25T00:24:45.326Z",
"ad_group_id": 0,
"appliance_name": null,
"appliance_uuid": null,
"av_ave_version": "1.2.3.4",
"av_engine": "4.14.3.454-ave.1.1.1.1:avpack.2.2.2.2:vdf.3.3.3.3:apc.4.4.4.4",
"av_last_scan_time": null,
"av_master": false,
"av_pack_version": "1.2.3.4",
"av_product_version": "4.14.3.454",
"av_status": [
"AV_ACTIVE",
"ONDEMAND_SCAN_DISABLED"
],
"av_update_servers": null,
"av_vdf_version": "1.2.3.4",
"cluster_name": null,
"current_sensor_policy_name": "default",
"datacenter_name": null,
"deployment_type": "WORKLOAD",
"deregistered_time": null,
"device_meta_data_item_list": [
{
"key_name": "OS_MAJOR_VERSION",
"key_value": "Windows 10",
"position": 0
},
{
"key_name": "SUBNET",
"key_value": "10.33.4",
"position": 0
},
{
"key_name": "AD_LDAP",
"key_value": "OU=Domain Controllers,DC=redteam,DC=aelladata,DC=com",
"position": 0
}
],
"device_owner_id": 605596,
"email": "jon@example.ai",
"encoded_activation_code": "L8ANCTWT9P7",
"esx_host_name": null,
"esx_host_uuid": null,
"first_name": "Yubao",
"id": 5678,
"last_contact_time": "2021-04-04T13:29:14.056Z",
"last_device_policy_changed_time": "2021-03-16T11:44:32.072Z",
"last_device_policy_requested_time": "2021-04-04T13:27:44.316Z",
"last_external_ip_address": "1.1.1.1",
"last_internal_ip_address": "8.8.8.8",
"last_location": "OFFSITE",
"last_name": "Zhang",
"last_policy_updated_time": "2021-04-02T06:05:12.968Z",
"last_reported_time": "2021-04-04T13:19:54.003Z",
"last_reset_time": null,
"last_shutdown_time": null,
"linux_kernel_version": null,
"login_user_name": "",
"mac_address": "000c290c520c",
"middle_name": null,
"name": "REDTEAM\\malware-gen2",
"organization_id": 1105,
"organization_name": "cb-internal-alliances.com",
"os": "WINDOWS",
"os_version": "Windows Server 2016 x64",
"passive_mode": true,
"policy_id": 6525,
"policy_name": "default",
"policy_override": true,
"quarantined": false,
"registered_time": "2020-12-18T03:58:59.811Z",
"scan_last_action_time": null,
"scan_last_complete_time": null,
"scan_status": null,
"sensor_kit_type": "WINDOWS",
"sensor_out_of_date": true,
"sensor_pending_update": false,
"sensor_states": [
"DRIVER_INIT_ERROR",
"LIVE_RESPONSE_NOT_RUNNING",
"LIVE_RESPONSE_NOT_KILLED",
"LIVE_RESPONSE_ENABLED",
"SECURITY_CENTER_OPTLN_DISABLED"
],
"sensor_version": "3.6.0.1941",
"status": "BYPASS",
"target_priority": "LOW",
"uninstall_code": "PDLHMMYF",
"vcenter_host_url": null,
"vcenter_name": null,
"vcenter_uuid": null,
"vdi_base_device": null,
"virtual_machine": true,
"virtualization_provider": "VMW_ESX",
"vm_ip": null,
"vm_name": null,
"vm_uuid": null,
"vulnerability_score": 0,
"vulnerability_severity": null,
"windows_platform": null
},
{
"activation_code": "EYIAHV",
"activation_code_expiry_time": "2021-02-25T20:58:03.232Z",
"ad_group_id": 0,
"appliance_name": null,
"appliance_uuid": null,
"av_ave_version": "5.5.5.5",
"av_engine": "1.1.1.1-ave.2.2.2.2:avpack.3.3.3.3:vdf.4.4.4.4",
"av_last_scan_time": null,
"av_master": false,
"av_pack_version": "5.5.5.5",
"av_product_version": "4.14.3.454",
"av_status": [
"AV_ACTIVE",
"ONDEMAND_SCAN_DISABLED"
],
"av_update_servers": null,
"av_vdf_version": "5.5.5.5",
"cluster_name": null,
"current_sensor_policy_name": "default",
"datacenter_name": null,
"deployment_type": "WORKLOAD",
"deregistered_time": null,
"device_meta_data_item_list": [
{
"key_name": "OS_MAJOR_VERSION",
"key_value": "Windows 10",
"position": 0
},
{
"key_name": "AD_LDAP",
"key_value": "DC=rtest,DC=com",
"position": 0
},
{
"key_name": "SUBNET",
"key_value": "172.16.15",
"position": 0
}
],
"device_owner_id": 605966,
"email": "jon@example.com",
"encoded_activation_code": "2VNKDLWE3UT",
"esx_host_name": null,
"esx_host_uuid": null,
"first_name": "Brandon",
"id": 9101,
"last_contact_time": "2021-04-04T13:29:13.643Z",
"last_device_policy_changed_time": "2021-03-31T20:11:50.835Z",
"last_device_policy_requested_time": "2021-04-02T06:05:52.963Z",
"last_external_ip_address": "1.1.1.1",
"last_internal_ip_address": "8.8.8.8",
"last_location": "OFFSITE",
"last_name": "Van Pelt",
"last_policy_updated_time": "2021-04-02T06:05:12.968Z",
"last_reported_time": "2021-04-04T05:28:57.161Z",
"last_reset_time": null,
"last_shutdown_time": null,
"linux_kernel_version": null,
"login_user_name": "RTEST\\opryadko",
"mac_address": "0050569fdd57",
"middle_name": null,
"name": "AB\\ABC-123-Win10E",
"organization_id": 1105,
"organization_name": "cb-internal-alliances.com",
"os": "WINDOWS",
"os_version": "Windows 10 x64",
"passive_mode": false,
"policy_id": 6525,
"policy_name": "default",
"policy_override": true,
"quarantined": false,
"registered_time": "2021-02-18T18:22:10.545Z",
"scan_last_action_time": null,
"scan_last_complete_time": null,
"scan_status": null,
"sensor_kit_type": "WINDOWS",
"sensor_out_of_date": true,
"sensor_pending_update": false,
"sensor_states": [
"ACTIVE",
"LIVE_RESPONSE_NOT_RUNNING",
"LIVE_RESPONSE_NOT_KILLED",
"LIVE_RESPONSE_ENABLED",
"SECURITY_CENTER_OPTLN_DISABLED"
],
"sensor_version": "3.6.0.1979",
"status": "REGISTERED",
"target_priority": "LOW",
"uninstall_code": "KMVSAQLT",
"vcenter_host_url": null,
"vcenter_name": null,
"vcenter_uuid": null,
"vdi_base_device": null,
"virtual_machine": true,
"virtualization_provider": "VMW_ESX",
"vm_ip": null,
"vm_name": null,
"vm_uuid": null,
"vulnerability_score": 0,
"vulnerability_severity": null,
"windows_platform": null
}
]
}
}

Human Readable Output#

Carbon Black Endpoint Standard Devices List Results#

IdNameOsPolicy NameQuarantinedStatusTarget PriorityLast Internal Ip AddressLast External Ip AddressLast Contact TimeLast Location
1234bo1tapsandbox-01LINUXLRDemo-JHfalseREGISTEREDMEDIUM8.8.8.81.1.1.12021-04-04T13:29:14.616ZUNKNOWN
5678REDTEAM\malware-gen2WINDOWSdefaultfalseBYPASSLOW8.8.8.81.1.1.12021-04-04T13:29:14.056ZOFFSITE
9101RTEST\Oleg-TB2-Win10EWINDOWSdefaultfalseREGISTEREDLOW8.8.8.81.1.1.12021-04-04T13:29:13.643ZOFFSITE

cbd-find-processes#


Creates a process search job. The results for the search job may be requested using the returned job ID. At least one of the arguments (not including: rows, start, and time_range) is required.

Required Permissions#

RBAC Permissions Required - org.search.events: CREATE

Base Command#

cbd-find-processes

Input#

Argument NameDescriptionRequired
alert_categoryThe Carbon Black Cloud classification for events tagged to an alert. Possible values: "THREAT" and "OBSERVED". Possible values are: THREAT, OBSERVED.Optional
hashAggregate set of MD5 and SHA-256 hashes associated with the process (including childproc_hash, crossproc_hash, filemod_hash, modload_hash, process_hash).Optional
device_external_ipThe IP address of the endpoint according to Carbon Black Cloud. This IP address can differ from the device_internal_ip due to network proxy or NAT. Can be either IPv4 or IPv6 format.Optional
device_idThe ID assigned to the endpoint by Carbon Black Cloud. This ID is unique across all Carbon Black Cloud environments.Optional
device_internal_ipThe IP address of the endpoint reported by the sensor. Can be either IPv4 or IPv6 format.Optional
device_nameThe hostname of the endpoint recorded by the sensor when last initialized.Optional
device_osThe operating system of the endpoint. Possible values: "WINDOWS", "MAC", "LINUX". Possible values are: WINDOWS, MAC, LINUX.Optional
device_timestampThe sensor-reported timestamp of the batch of events in which this record was submitted to Carbon Black Cloud. specified as ISO 8601 timestamp in UTC for example: 2020-01-19T04:28:40.190Z.Optional
event_typeThe type of enriched event observed. Possible value: "filemod", "netconn", "regmod", "modload", "crossproc", "childproc", "scriptload", and "fileless_scriptload". Possible values are: filemod, netconn, regmod, modload, crossproc, childproc, scriptload, fileless_scriptload.Optional
parent_nameThe file system path of the parent process binary.Optional
parent_reputationThe reputation of the parent process applied by Carbon Black Cloud when the event is initially processed. Possible values: "ADAPTIVE_WHITE_LIST", "ADWARE", "COMMON_WHITE_LIST", "COMPANY_BLACK_LIST", "COMPANY_WHITE_LIST", "HEURISTIC", "IGNORE", "KNOWN_MALWARE", "LOCAL_WHITE", "NOT_LISTED", "PUP", "RESOLVING", "SUSPECT_MALWARE", and "TRUSTED_WHITE_LIST". Possible values are: ADAPTIVE_WHITE_LIST, ADWARE, COMMON_WHITE_LIST, COMPANY_BLACK_LIST, COMPANY_WHITE_LIST, HEURISTIC, IGNORE, KNOWN_MALWARE, LOCAL_WHITE, NOT_LISTED, PUP, RESOLVING, SUSPECT_MALWARE, TRUSTED_WHITE_LIST.Optional
process_cmdlineThe command line executed by the actor process.Optional
process_guidThe unique process identifier for the actor process.Optional
process_nameThe file system path of the actor process binary.Optional
process_pidThe process identifier assigned by the operating system. This can be multi-valued in case of fork() or exec() process operations on Linux and macOS.Optional
process_reputationThe reputation of the actor process applied when the event is processed by Carbon Black Cloud. Possible values: "ADAPTIVE_WHITE_LIST", "ADWARE", "COMMON_WHITE_LIST", "COMPANY_BLACK_LIST", "COMPANY_WHITE_LIST", "HEURISTIC", "IGNORE", "KNOWN_MALWARE", "LOCAL_WHITE", "NOT_LISTED", "PUP", "RESOLVING", "SUSPECT_MALWARE", and "TRUSTED_WHITE_LIST". Possible values are: ADAPTIVE_WHITE_LIST, ADWARE, COMMON_WHITE_LIST, COMPANY_BLACK_LIST, COMPANY_WHITE_LIST, HEURISTIC, IGNORE, KNOWN_MALWARE, LOCAL_WHITE, NOT_LISTED, PUP, RESOLVING, SUSPECT_MALWARE, TRUSTED_WHITE_LIST.Optional
process_start_timeThe sensor reported timestamp of when the process started. specified as ISO 8601 timestamp in UTC for example: 2020-05-04T21:34:03.968Z. This is not available for processes running before the sensor starts.Optional
process_terminatedWhether the process has terminated. Possible values: "true" and "false". Always "false" for enriched events (process termination not recorded). Possible values are: true, false.Optional
process_usernameThe user context in which the actor process was executed.
MacOS - all users for the PID for fork() and exec() transitions.
Linux - process user for exec() events, but in a future sensor release can be multi-valued due to setuid().
Optional
sensor_actionThe action performed by the sensor on the process. Possible values: "TERMINATE", "DENY", and "SUSPEND". Possible values are: TERMINATE, DENY, SUSPEND.Optional
queryThe query in Lucene syntax and/or value searches.Optional
rowsThe number of rows to request. Can be paginated.Optional
startThe first row to use for pagination.Optional
time_rangeThe time window in which to restrict the search to match using device_timestamp as the reference. The window value will take priority over the start and end times if provided. For example {"end": "2020-01-21T18:34:04Z", "start": "2020-01-18T18:34:04Z", "window": "-2w"}, window: “-2w” (where y=year, w=week, d=day, h=hour, m=minute, s=second) start: ISO 8601 timestamp, end: ISO 8601 timestamp.Optional

Context Output#

PathTypeDescription
CarbonBlackDefense.Process.Search.job_idStringThe job ID of the process search.

Command Example#

!cbd-find-processes query=chrome

Context Example#

{
"CarbonBlackDefense": {
"Process": {
"Search": {
"job_id": "f5a2ae0e-c3f7-4443-882d-009097eaabd3"
}
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Processes Search#

Job Id
f5a2ae0e-c3f7-4443-882d-009097eaabd3

cbd-find-events#


Creates an enriched events search job. The results for the search job may be requested using the returned job ID. At least one of the arguments (not including: rows, start, time_range) is required).

Required Permissions#

RBAC Permissions Required - org.search.events: CREATE

Base Command#

cbd-find-events

Input#

Argument NameDescriptionRequired
alert_categoryThe Carbon Black Cloud classification for events tagged to an alert. Possible values: "THREAT" and "OBSERVED". Possible values are: THREAT, OBSERVED.Optional
hashAggregate set of MD5 and SHA-256 hashes associated with the process (including childproc_hash, crossproc_hash, filemod_hash, modload_hash, process_hash).Optional
device_external_ipThe IP address of the endpoint according to Carbon Black Cloud. This IP address can differ from the device_internal_ip due to network proxy or NAT. Can be either IPv4 or IPv6 format.Optional
device_idThe ID assigned to the endpoint by Carbon Black Cloud. This ID is unique across all Carbon Black Cloud environments.Optional
device_internal_ipThe IP address of the endpoint reported by the sensor. Can be either IPv4 or IPv6 format.Optional
device_nameThe hostname of the endpoint recorded by the sensor when last initialized.Optional
device_osThe operating system of the endpoint. Possible values: "WINDOWS", "MAC", "LINUX". Possible values are: WINDOWS, MAC, LINUX.Optional
event_typeThe type of enriched event observed. Possible value: "filemod", "netconn", "regmod", "modload", "crossproc", "childproc", "scriptload", and "fileless_scriptload". Possible values are: filemod, netconn, regmod, modload, crossproc, childproc, scriptload, fileless_scriptload.Optional
parent_nameThe file system path of the parent process binary.Optional
parent_reputationThe reputation of the parent process applied by Carbon Black Cloud when the event is initially processed. Possible values: "ADAPTIVE_WHITE_LIST", "ADWARE", "COMMON_WHITE_LIST", "COMPANY_BLACK_LIST", "COMPANY_WHITE_LIST", "HEURISTIC", "IGNORE", "KNOWN_MALWARE", "LOCAL_WHITE", "NOT_LISTED", "PUP", "RESOLVING", "SUSPECT_MALWARE", and "TRUSTED_WHITE_LIST". Possible values are: ADAPTIVE_WHITE_LIST, ADWARE, COMMON_WHITE_LIST, COMPANY_BLACK_LIST, COMPANY_WHITE_LIST, HEURISTIC, IGNORE, KNOWN_MALWARE, LOCAL_WHITE, NOT_LISTED, PUP, RESOLVING, SUSPECT_MALWARE, TRUSTED_WHITE_LIST.Optional
process_cmdlineThe command line executed by the actor process.Optional
process_guidThe unique process identifier for the actor process.Optional
process_nameThe file system path of the actor process binary.Optional
process_pidThe process identifier assigned by the operating system. This can be multi-valued in case of fork() or exec() process operations on Linux and macOS.Optional
process_reputationThe reputation of the actor process applied when the event is processed by Carbon Black Cloud. Possible values: "ADAPTIVE_WHITE_LIST", "ADWARE", "COMMON_WHITE_LIST", "COMPANY_BLACK_LIST", "COMPANY_WHITE_LIST", "HEURISTIC", "IGNORE", "KNOWN_MALWARE", "LOCAL_WHITE", "NOT_LISTED", "PUP", "RESOLVING", "SUSPECT_MALWARE", and "TRUSTED_WHITE_LIST". Possible values are: ADAPTIVE_WHITE_LIST, ADWARE, COMMON_WHITE_LIST, COMPANY_BLACK_LIST, COMPANY_WHITE_LIST, HEURISTIC, IGNORE, KNOWN_MALWARE, LOCAL_WHITE, NOT_LISTED, PUP, RESOLVING, SUSPECT_MALWARE, TRUSTED_WHITE_LIST.Optional
process_start_timeThe sensor reported timestamp of when the process started. specified as ISO 8601 timestamp in UTC for example: 2020-05-04T21:34:03.968Z. This is not available for processes running before the sensor starts.Optional
process_terminatedWhether the process has terminated. Possible values: "true" and "false". Always "false" for enriched events (process termination not recorded). Possible values are: true, false.Optional
process_usernameThe user context in which the actor process was executed.
MacOS - all users for the PID for fork() and exec() transitions.
Linux - process user for exec() events, but in a future sensor release can be multi-valued due to setuid().
Optional
sensor_actionThe action performed by the sensor on the process. Possible values: "TERMINATE", "DENY", and "SUSPEND". Possible values are: TERMINATE, DENY, SUSPEND.Optional
queryThe query in Lucene syntax and/or value searches.Optional
rowsThe number of rows to request. Can be paginated.Optional
startThe first row to use for pagination.Optional
time_rangeThe time window in which to restrict the search to match using device_timestamp as the reference. The window value will take priority over the start and end times if provided. For example {"end": "2020-01-21T18:34:04Z", "start": "2020-01-18T18:34:04Z", "window": "-2w"}, window: “-2w” (where y=year, w=week, d=day, h=hour, m=minute, s=second) start: ISO 8601 timestamp, end: ISO 8601 timestamp.Optional

Context Output#

PathTypeDescription
CarbonBlackDefense.Events.Search.job_idStringThe job ID of the event search.

Command Example#

!cbd-find-events query=chrome

Context Example#

{
"CarbonBlackDefense": {
"Events": {
"Search": {
"job_id": "b853bf18-d1f3-4dcc-b590-6626ee547bec"
}
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Events Search#

Job Id
b853bf18-d1f3-4dcc-b590-6626ee547bec

cbd-find-processes-results#


Retrieves the results of a process search identified by the job ID.

Required Permissions#

RBAC Permissions Required - org.search.events: READ

Base Command#

cbd-find-processes-results

Input#

Argument NameDescriptionRequired
job_idThe job ID.Required
rowsThe number of rows to request. Can be paginated. Default is 10. Default is 10.Optional

Context Output#

PathTypeDescription
CarbonBlackDefense.Process.Results.job_idStringThe results of the process search.
CarbonBlackDefense.Process.Results.approximate_unaggregatedNumberThe approximate number of unaggregated results.
CarbonBlackDefense.Process.Results.completedNumberThe number of completed results.
CarbonBlackDefense.Process.Results.contactedNumberThe number of contacted results.
CarbonBlackDefense.Process.Results.num_aggregatedNumberThe number of aggregated results.
CarbonBlackDefense.Process.Results.num_availableNumberThe number of processes available in this search.
CarbonBlackDefense.Process.Results.num_foundNumberThe number of processes found in this search.
CarbonBlackDefense.Process.Results.resultsUnknownThe lists that contains the data of the results for this search.

Command Example#

!cbd-find-processes-results job_id=a79f5a25-5ab4-4df7-b806-62e0aedd7034

Context Example#

{
"CarbonBlackDefense": {
"Process": {
"Results": {
"job_id": "a79f5a25-5ab4-4df7-b806-62e0aedd7034",
"approximate_unaggregated": 35890,
"completed": 47,
"contacted": 47,
"num_aggregated": 3230,
"num_available": 500,
"num_found": 35890,
"results": [
{
"backend_timestamp": "2021-04-04T11:14:46.886Z",
"device_group_id": 0,
"device_id": 1234,
"device_name": "vm-2k12-vg63",
"device_policy_id": 1234,
"device_timestamp": "2021-04-04T11:13:52.850Z",
"enriched": true,
"enriched_event_type": [
"NETWORK"
],
"event_type": [
"netconn"
],
"ingress_time": 1617534862426,
"legacy": true,
"org_id": "7DESJ9GN",
"process_guid": "7DESJ9GN-003ecd38-002005cc-00000000-1d719ba5c26912d",
"process_hash": [
"402a3d06bc6c0051e65c91e1bddac9d7",
"cbc104fcc03cb2acbdafc2fe2669e8da54993f8d21d8851d4d80ecec26a3a9f0"
],
"process_name": "c:\\program files (x86)\\google\\chrome\\application\\chrome.exe",
"process_pid": [
2098636
],
"process_username": [
"VM-2K12-VG63\\Administrator"
]
},
{
"backend_timestamp": "2021-04-04T11:15:17.238Z",
"childproc_count": 0,
"crossproc_count": 389,
"device_group_id": 0,
"device_id": 5678,
"device_name": "development\\vm-beats-dev",
"device_policy_id": 1234,
"device_timestamp": "2021-04-04T11:13:38.546Z",
"enriched": true,
"enriched_event_type": [
"NETWORK"
],
"event_type": [
"netconn"
],
"filemod_count": 21432,
"ingress_time": 1617534886234,
"legacy": true,
"modload_count": 252,
"netconn_count": 3388,
"org_id": "7DESJ9GN",
"parent_guid": "7DESJ9GN-003b7b6c-00001e8c-00000000-1d716fd3d5cd170",
"parent_pid": 7820,
"process_guid": "7DESJ9GN-003b7b6c-00000bb4-00000000-1d716fd3ea4f2fa",
"process_hash": [
"6bfe4850808952622e41f88db244393b",
"8ceee04d6316e2ba04fdf2222506fc8be7b3cd158d843c4edc23d8de5e2f77d9"
],
"process_name": "c:\\program files (x86)\\google\\chrome\\application\\chrome.exe",
"process_pid": [
2996
],
"process_username": [
"AB\\example.process"
],
"regmod_count": 0,
"scriptload_count": 0
},
{
"alert_category": [
"THREAT"
],
"alert_id": [
"null/115E98DB"
],
"backend_timestamp": "2021-04-04T11:15:17.238Z",
"childproc_count": 862,
"crossproc_count": 530,
"device_group_id": 0,
"device_id": 9101,
"device_name": "development\\vm-beats-dev",
"device_policy_id": 1234,
"device_timestamp": "2021-04-04T11:12:41.447Z",
"enriched": true,
"enriched_event_type": [
"CREATE_PROCESS"
],
"event_type": [
"childproc"
],
"filemod_count": 43922,
"ingress_time": 1617534886234,
"legacy": true,
"modload_count": 1239,
"netconn_count": 807,
"org_id": "7DESJ9GN",
"parent_guid": "7DESJ9GN-003b7b6c-000006a0-00000000-1d7166c204a7a5a",
"parent_pid": 1696,
"process_guid": "7DESJ9GN-003b7b6c-00001e8c-00000000-1d716fd3d5cd170",
"process_hash": [
"6bfe4850808952622e41f88db244393b",
"8ceee04d6316e2ba04fdf2222506fc8be7b3cd158d843c4edc23d8de5e2f77d9"
],
"process_name": "c:\\program files (x86)\\google\\chrome\\application\\chrome.exe",
"process_pid": [
7820
],
"process_username": [
"AB\\example.process"
],
"regmod_count": 117,
"scriptload_count": 0
}
]
}
}
}
}

Human Readable Output#

The Results For The Process Search#

Device IdDevice NameProcess NameDevice Policy IdEnriched Event Type
1234vm-2k12-vg63c:\program files (x86)\google\chrome\application\chrome.exe1234NETWORK
5678development\vm-beats-devc:\program files (x86)\google\chrome\application\chrome.exe1234NETWORK
9101development\vm-beats-devc:\program files (x86)\google\chrome\application\chrome.exe1234CREATE_PROCESS

cbd-get-policies#


Gets the list of policies available in your organization.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-get-policies

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
CarbonBlackDefense.Policy.idNumberThe policy ID.
CarbonBlackDefense.Policy.priorityLevelStringThe policy priority level.
CarbonBlackDefense.Policy.systemPolicyBooleanWhether the policy is a system policy.
CarbonBlackDefense.Policy.latestRevisionNumberThe latest revision of the policy.
CarbonBlackDefense.Policy.policyUnknownThe policy object.
CarbonBlackDefense.Policy.nameStringThe unique name of the policy.
CarbonBlackDefense.Policy.descriptionStringThe description of the policy.
CarbonBlackDefense.Policy.versionNumberThe version of the policy.

Command Example#

!cbd-get-policies

Context Example#

{
"CarbonBlackDefense": {
"Policy": [
{
"description": "Default Policy. Please do not edit or rename this Policy. Create your own Policy and test with that.",
"id": 6525,
"latestRevision": 1617343512968,
"name": "default",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "KNOWN_MALWARE"
},
"id": 111,
"operation": "RUN",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 112,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 113,
"operation": "NETWORK",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 114,
"operation": "MEMORY_SCRAPE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 115,
"operation": "RUN_INMEMORY_CODE",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 117,
"operation": "POL_INVOKE_NOT_TRUSTED",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 118,
"operation": "INVOKE_CMD_INTERPRETER",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 119,
"operation": "RANSOM",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 120,
"operation": "INVOKE_SCRIPT",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 121,
"operation": "CODE_INJECTION",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "PUP"
},
"id": 122,
"operation": "RUN",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "SUSPECT_MALWARE"
},
"id": 123,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 124,
"operation": "NETWORK",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 125,
"operation": "MEMORY_SCRAPE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 126,
"operation": "RUN_INMEMORY_CODE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 128,
"operation": "POL_INVOKE_NOT_TRUSTED",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 129,
"operation": "INVOKE_CMD_INTERPRETER",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 130,
"operation": "RANSOM",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 131,
"operation": "INVOKE_SCRIPT",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 132,
"operation": "CODE_INJECTION",
"required": false
}
],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "false"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "false"
},
{
"name": "DELAY_EXECUTE",
"value": "false"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SHOW_FULL_UI",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "true"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
},
{
"name": "ALLOW_EXPEDITED_SCAN",
"value": "false"
},
{
"name": "RATE_LIMIT",
"value": "0"
},
{
"name": "CONNECTION_LIMIT",
"value": "0"
},
{
"name": "QUEUE_SIZE",
"value": "100"
},
{
"name": "LEARNING_MODE",
"value": "0"
}
]
},
"priorityLevel": "LOW",
"systemPolicy": true,
"version": 2
},
{
"description": null,
"id": 6527,
"latestRevision": 1613421692562,
"name": "Detection_Servers",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 8,
"recoveryScanIfMissed": true,
"startHour": 20
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 2,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 0,
"regId": null,
"server": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
],
"serversForOffSiteDevices": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 2,
"operation": "RANSOM",
"required": true
}
],
"sensorSettings": [
{
"name": "ALLOW_UPLOADS",
"value": "true"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Device has been quarantined by your computer administrator."
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "false"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
}
]
},
"priorityLevel": "HIGH",
"systemPolicy": true,
"version": 2
},
{
"description": null,
"id": 6528,
"latestRevision": 1613421692592,
"name": "Restrictive_Mac_Workstation",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 8,
"recoveryScanIfMissed": true,
"startHour": 20
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 2,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 0,
"regId": null,
"server": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
],
"serversForOffSiteDevices": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "KNOWN_MALWARE"
},
"id": 9,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 10,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "SUSPECT_MALWARE"
},
"id": 11,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "PUP"
},
"id": 12,
"operation": "RUN",
"required": false
}
],
"sensorSettings": [
{
"name": "ALLOW_UPLOADS",
"value": "true"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Device has been quarantined by your computer administrator."
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "false"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
}
]
},
"priorityLevel": "MEDIUM",
"systemPolicy": true,
"version": 2
}
]
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policies#

IdPriority LevelSystem PolicyLatest RevisionVersion
6525LOWtrue2021-04-02T06:05:12.000Z2
6527HIGHtrue2021-02-15T20:41:32.000Z2
6528MEDIUMtrue2021-02-15T20:41:32.000Z2

cbd-get-policy#


Retrieves a policy object by ID.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-get-policy

Input#

Argument NameDescriptionRequired
policyIdThe policy ID.Required

Context Output#

PathTypeDescription
CarbonBlackDefense.Policy.idNumberThe policy ID.
CarbonBlackDefense.Policy.priorityLevelStringThe policy priority level.
CarbonBlackDefense.Policy.systemPolicyBooleanWhether the policy is a system policy.
CarbonBlackDefense.Policy.latestRevisionNumberThe latest revision of the policy.
CarbonBlackDefense.Policy.policyUnknownThe policy object.
CarbonBlackDefense.Policy.nameStringThe unique name of the policy.
CarbonBlackDefense.Policy.descriptionStringThe description of the policy.
CarbonBlackDefense.Policy.versionNumberThe version of the policy.

Command Example#

!cbd-get-policy policyId=6527

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": null,
"id": 6527,
"latestRevision": 1613421692562,
"name": "Detection_Servers",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 8,
"recoveryScanIfMissed": true,
"startHour": 20
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 2,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 0,
"regId": null,
"server": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
],
"serversForOffSiteDevices": [
"http://updates2.cdc.carbonblack.io/update2"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 2,
"operation": "RANSOM",
"required": true
}
],
"sensorSettings": [
{
"name": "ALLOW_UPLOADS",
"value": "true"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Device has been quarantined by your computer administrator."
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "false"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
}
]
},
"priorityLevel": "HIGH",
"systemPolicy": true,
"version": 2
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policy#

IdNameLatest RevisionVersionPriority LevelSystem Policy
6527Detection_Servers2021-02-15T20:41:32.000Z2HIGHtrue

cbd-set-policy#


Resets policy fields.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-set-policy

Input#

Argument NameDescriptionRequired
policyThe policy ID to be set.Required
keyValueA JSON object that holds key/value pairs. The key is the field path in the policy object you want to update with a value.Required

Context Output#

PathTypeDescription
CarbonBlackDefense.Policy.idNumberThe policy ID.
CarbonBlackDefense.Policy.priorityLevelStringThe policy priority level.
CarbonBlackDefense.Policy.systemPolicyBooleanWhether the policy is a system policy.
CarbonBlackDefense.Policy.latestRevisionNumberThe latest revision of the policy.
CarbonBlackDefense.Policy.policyUnknownThe policy object.
CarbonBlackDefense.Policy.nameStringThe unique name of the policy.
CarbonBlackDefense.Policy.descriptionStringThe description of the policy.
CarbonBlackDefense.Policy.versionNumberThe version of the policy.

Command Example#

``!cbd-set-policy policy=123456 keyValue={"policyInfo": {"description": "update example", "name": "xsoar test1", "id": 123456, "policy": {"sensorSettings": [{"name": "SHOW_UI", "value": "true"}]}, "priorityLevel": "HIGH"}}````

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": "update example",
"id": 123456,
"latestRevision": 1617542937951,
"name": "xsoar test1",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "true"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "true"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SHOW_FULL_UI",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
},
{
"name": "ALLOW_EXPEDITED_SCAN",
"value": "false"
},
{
"name": "RATE_LIMIT",
"value": "0"
},
{
"name": "CONNECTION_LIMIT",
"value": "0"
},
{
"name": "QUEUE_SIZE",
"value": "100"
},
{
"name": "LEARNING_MODE",
"value": "0"
}
]
},
"priorityLevel": "HIGH",
"systemPolicy": false,
"version": 2
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policy#

IdDescriptionNameLatest RevisionVersionPriority LevelSystem Policy
123456update examplexsoar test12021-04-04T13:28:57.000Z2HIGHfalse

cbd-create-policy#


Creates a new policy on the CB Defense backend.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-create-policy

Input#

Argument NameDescriptionRequired
descriptionA description of the policy. Can be multiple lines.Required
nameA unique one-line name for the policy.Required
priorityLevelThe priority score associated with sensors assigned to this policy. Possible values: "MISSION_CRITICAL", "HIGH", "MEDIUM", and "LOW". Possible values are: MISSION_CRITICAL, HIGH, MEDIUM, LOW.Required
policyThe JSON object containing the policy details. Make sure a valid policy object is passed. You can use the get-policy command to retrieve a similar policy object. Then you can reset some of the policy's fields with the set-policy command, and pass the edited object.Required

Context Output#

PathTypeDescription
CarbonBlackDefense.Policy.idNumberThe policy ID.
CarbonBlackDefense.Policy.priorityLevelStringThe policy priority level.
CarbonBlackDefense.Policy.systemPolicyBooleanWhether the policy is a system policy.
CarbonBlackDefense.Policy.latestRevisionNumberThe latest revision of the policy.
CarbonBlackDefense.Policy.policyUnknownThe policy object.
CarbonBlackDefense.Policy.nameStringThe unique name of the policy.
CarbonBlackDefense.Policy.descriptionStringThe description of the policy.
CarbonBlackDefense.Policy.versionNumberThe version of the policy.

Command Example#

``!cbd-create-policy description=This is xsoar's test policy name=xsoar test3 priorityLevel=HIGH policy={}````

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": "This is xsoar's test policy",
"id": 67586,
"latestRevision": 1617542929543,
"name": "xsoar test3",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "KNOWN_MALWARE"
},
"id": 111,
"operation": "RUN",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 112,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 113,
"operation": "NETWORK",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 114,
"operation": "MEMORY_SCRAPE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 115,
"operation": "RUN_INMEMORY_CODE",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 117,
"operation": "POL_INVOKE_NOT_TRUSTED",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 118,
"operation": "INVOKE_CMD_INTERPRETER",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 119,
"operation": "RANSOM",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 120,
"operation": "INVOKE_SCRIPT",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "RESOLVING"
},
"id": 121,
"operation": "CODE_INJECTION",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "PUP"
},
"id": 122,
"operation": "RUN",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "SUSPECT_MALWARE"
},
"id": 123,
"operation": "RUN",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 124,
"operation": "NETWORK",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 125,
"operation": "MEMORY_SCRAPE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 126,
"operation": "RUN_INMEMORY_CODE",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 128,
"operation": "POL_INVOKE_NOT_TRUSTED",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 129,
"operation": "INVOKE_CMD_INTERPRETER",
"required": false
},
{
"action": "TERMINATE",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 130,
"operation": "RANSOM",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 131,
"operation": "INVOKE_SCRIPT",
"required": false
},
{
"action": "DENY",
"application": {
"type": "REPUTATION",
"value": "ADAPTIVE_WHITE_LIST"
},
"id": 132,
"operation": "CODE_INJECTION",
"required": false
}
],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "false"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "false"
},
{
"name": "DELAY_EXECUTE",
"value": "false"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SHOW_FULL_UI",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "true"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
},
{
"name": "ALLOW_EXPEDITED_SCAN",
"value": "false"
},
{
"name": "RATE_LIMIT",
"value": "0"
},
{
"name": "CONNECTION_LIMIT",
"value": "0"
},
{
"name": "QUEUE_SIZE",
"value": "100"
},
{
"name": "LEARNING_MODE",
"value": "0"
}
]
},
"priorityLevel": "HIGH",
"systemPolicy": false,
"version": 2
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policy#

IdDescriptionNameLatest RevisionVersionPriority LevelSystem Policy
67586This is xsoar's test policyxsoar test32021-04-04T13:28:49.000Z2HIGHfalse

cbd-delete-policy#


Deletes a policy from the CB Defense backend. This may return an error if devices are actively assigned to the policy ID requested for deletion. Note: System policies cannot be deleted.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-delete-policy

Input#

Argument NameDescriptionRequired
policyIdThe policy ID.Required

Context Output#

There is no context output for this command.

Command Example#

!cbd-delete-policy policyId=67585

Human Readable Output#

The policy 67585 was deleted successfully#

MessageSuccess
Successtrue

cbd-update-policy#


Updates an existing policy with a new policy. Note: System policies cannot be modified.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-update-policy

Input#

Argument NameDescriptionRequired
descriptionA description of the policy.Required
nameA one-line name for the policy.Required
priorityLevelThe priority score associated with sensors assigned to this policy. Possible values: "MISSION_CRITICAL", "HIGH", "MEDIUM", and "LOW". Possible values are: MISSION_CRITICAL, HIGH, MEDIUM, LOW.Required
idThe ID of the policy to replace.Required
policyThe JSON object containing the policy details. Make sure a valid policy object is passed. For example {'sensorSettings': [{'name': 'SHOW_UI', 'value': 'false'}]}. You can use the get-policy command to retrieve the policy object you want to update. Then you can reset some of the policy's fields with the set-policy command, and pass the edited object.Required

Context Output#

PathTypeDescription
CarbonBlackDefense.Policy.idNumberThe policy ID.
CarbonBlackDefense.Policy.priorityLevelStringThe policy priority level.
CarbonBlackDefense.Policy.systemPolicyBooleanWhether the policy is a system policy.
CarbonBlackDefense.Policy.latestRevisionNumberThe latest revision of the policy.
CarbonBlackDefense.Policy.policyUnknownThe policy object.
CarbonBlackDefense.Policy.nameStringThe unique name of the policy.
CarbonBlackDefense.Policy.descriptionStringThe description of the policy.
CarbonBlackDefense.Policy.versionNumberThe version of the policy.

Command Example#

``!cbd-update-policy id=123456 description=This is xsoar's test policy after an update name=xsoar test1 priorityLevel=LOW policy={"sensorSettings": [{"name": "SHOW_UI", "value": "false"}]}````

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": "This is xsoar's test policy after an update",
"id": 123456,
"latestRevision": 1617542940381,
"name": "xsoar test1",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "true"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SHOW_FULL_UI",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
},
{
"name": "ALLOW_EXPEDITED_SCAN",
"value": "false"
},
{
"name": "RATE_LIMIT",
"value": "0"
},
{
"name": "CONNECTION_LIMIT",
"value": "0"
},
{
"name": "QUEUE_SIZE",
"value": "100"
},
{
"name": "LEARNING_MODE",
"value": "0"
}
]
},
"priorityLevel": "LOW",
"systemPolicy": false,
"version": 2
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policy#

IdDescriptionNameLatest RevisionVersionPriority LevelSystem Policy
123456This is xsoar's test policy after an updatexsoar test12021-04-04T13:29:00.000Z2LOWfalse

cbd-add-rule-to-policy#


Adds a new rule to an existing policy. Note: System policies cannot be modified.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-add-rule-to-policy

Input#

Argument NameDescriptionRequired
actionRule action. Possible values: "TERMINATE", "IGNORE", "TERMINATE_THREAD", "ALLOW", "DENY", and "TERMINATE_PROCESS". Possible values are: TERMINATE, IGNORE, TERMINATE_THREAD, ALLOW, DENY, TERMINATE_PROCESS.Required
operationRule operation. Possible values are: MODIFY_SYSTEM_EXE, PASSTHRU, CRED, RANSOM, NETWORK_SERVER, POL_INVOKE_NOT_TRUSTED, IMPERSONATE, MICROPHONE_CAMERA, INVOKE_SYSAPP, NETWORK_CLIENT, BYPASS_REG, BUFFER_OVERFLOW, BYPASS_API, USER_DOC, CODE_INJECTION, BYPASS_NET, KEYBOARD, BYPASS_ALL, RUN, INVOKE_CMD_INTERPRETER, MODIFY_SYTEM_CONFIG, ESCALATE, BYPASS_FILE, RUN_AS_ADMIN, BYPASS_PROCESS, NETWORK, KERNEL_ACCESS, NETWORK_PEER, PACKED, INVOKE_SCRIPT, MEMORY_SCRAPE, BYPASS_SELF_PROTECT, TAMPER_API.Required
requiredWhether the rule is required. Possible values: "true" and "false". Possible values are: true, false.Required
typeApplication type. Possible values: "REPUTATION", "SIGNED_BY", and "NAME_PATH". Possible values are: REPUTATION, SIGNED_BY, NAME_PATH.Required
valueApplication value.Required
policyIdThe policy ID.Required

Context Output#

There is no context output for this command.

Command Example#

!cbd-add-rule-to-policy action=ALLOW operation=RANSOM required=true type=REPUTATION value=COMPANY_BLACK_LIST policyId=123456

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": "This is xsoar's test policy after an update",
"id": 123456,
"latestRevision": 1617542944659,
"name": "xsoar test1",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "ALLOW",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 23,
"operation": "RANSOM",
"required": true
}
],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "true"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name": "SCAN_NETWORK_DRIVE",
"value": "false"
},
{
"name": "BYPASS_AFTER_LOGIN_MINS",
"value": "0"
},
{
"name": "BYPASS_AFTER_RESTART_MINS",
"value": "0"
},
{
"name": "SHOW_FULL_UI",
"value": "true"
},
{
"name": "SECURITY_CENTER_OPT",
"value": "false"
},
{
"name": "CB_LIVE_RESPONSE",
"value": "false"
},
{
"name": "UNINSTALL_CODE",
"value": "false"
},
{
"name": "UBS_OPT_IN",
"value": "true"
},
{
"name": "ALLOW_EXPEDITED_SCAN",
"value": "false"
},
{
"name": "RATE_LIMIT",
"value": "0"
},
{
"name": "CONNECTION_LIMIT",
"value": "0"
},
{
"name": "QUEUE_SIZE",
"value": "100"
},
{
"name": "LEARNING_MODE",
"value": "0"
}
]
},
"priorityLevel": "LOW",
"systemPolicy": false,
"version": 2
}
}
}

Human Readable Output#

Carbon Black Endpoint Standard Policy#

IdDescriptionNameLatest RevisionVersionPriority LevelSystem Policy
123456This is xsoar's test policy after an updatexsoar test12021-04-04T13:29:04.000Z2LOWfalse

cbd-update-rule-in-policy#


Updates an existing rule with a new rule. Note: System policies cannot be modified.

Required Permissions#

Live Response Permissions Required

Base Command#

cbd-update-rule-in-policy

Input#

Argument NameDescriptionRequired
actionRule action. Possible values: "TERMINATE", "IGNORE", "TERMINATE_THREAD", "ALLOW", "DENY", and "TERMINATE_PROCESS". Possible values are: TERMINATE, IGNORE, TERMINATE_THREAD, ALLOW, DENY, TERMINATE_PROCESS.Required
operationRule operation. Possible values are: MODIFY_SYSTEM_EXE, PASSTHRU, CRED, RANSOM, NETWORK_SERVER, POL_INVOKE_NOT_TRUSTED, IMPERSONATE, MICROPHONE_CAMERA, INVOKE_SYSAPP, NETWORK_CLIENT, BYPASS_REG, BUFFER_OVERFLOW, BYPASS_API, USER_DOC, CODE_INJECTION, BYPASS_NET, KEYBOARD, BYPASS_ALL, RUN, INVOKE_CMD_INTERPRETER, MODIFY_SYTEM_CONFIG, ESCALATE, BYPASS_FILE, RUN_AS_ADMIN, BYPASS_PROCESS, NETWORK, KERNEL_ACCESS, NETWORK_PEER, PACKED, INVOKE_SCRIPT, MEMORY_SCRAPE, BYPASS_SELF_PROTECT, TAMPER_API.Required
requiredWhether the rule is required. Possible values: "true" and "false". Possible values are: true, false.Required
idRule ID.Required
typeApplication type. Possible values: "REPUTATION", "SIGNED_BY", and "NAME_PATH". Possible values are: REPUTATION, SIGNED_BY, NAME_PATH.Required
valueApplication value.Required
policyIdThe policy ID.Required

Context Output#

There is no context output for this command.

Command Example#

!cbd-update-rule-in-policy action=ALLOW operation=RANSOM required=false id=23 type=REPUTATION value=COMPANY_BLACK_LIST policyId=123456

Context Example#

{
"CarbonBlackDefense": {
"Policy": {
"description": "This is xsoar's test policy after an update",
"id": 123456,
"latestRevision": 1617542947344,
"name": "xsoar test1",
"policy": {
"avSettings": {
"apc": {
"enabled": false,
"maxExeDelay": 45,
"maxFileSize": 4,
"riskLevel": 4
},
"features": [
{
"enabled": true,
"name": "SIGNATURE_UPDATE"
},
{
"enabled": true,
"name": "ONACCESS_SCAN"
},
{
"enabled": true,
"name": "ONDEMAND_SCAN"
}
],
"onAccessScan": {
"profile": "NORMAL"
},
"onDemandScan": {
"profile": "NORMAL",
"scanCdDvd": "AUTOSCAN",
"scanUsb": "AUTOSCAN",
"schedule": {
"days": null,
"rangeHours": 0,
"recoveryScanIfMissed": true,
"startHour": 0
}
},
"signatureUpdate": {
"schedule": {
"fullIntervalHours": 0,
"initialRandomDelayHours": 1,
"intervalHours": 2
}
},
"updateServers": {
"servers": [
{
"flags": 1,
"regId": null,
"server": [
"http://updates.cdc.carbonblack.io/update"
]
}
],
"serversForOffSiteDevices": [
"http://updates.cdc.carbonblack.io/update"
]
}
},
"directoryActionRules": [],
"id": -1,
"knownBadHashAutoDeleteDelayMs": null,
"rules": [
{
"action": "ALLOW",
"application": {
"type": "REPUTATION",
"value": "COMPANY_BLACK_LIST"
},
"id": 23,
"operation": "RANSOM",
"required": false
}
],
"sensorSettings": [
{
"name": "ALLOW_UNINSTALL",
"value": "true"
},
{
"name": "ALLOW_UPLOADS",
"value": "false"
},
{
"name": "SHOW_UI",
"value": "false"
},
{
"name": "ENABLE_THREAT_SHARING",
"value": "true"
},
{
"name": "QUARANTINE_DEVICE",
"value": "false"
},
{
"name": "LOGGING_LEVEL",
"value": "false"
},
{
"name": "QUARANTINE_DEVICE_MESSAGE",
"value": "Your device has been quarantined by your computer administrator."
},
{
"name": "SET_SENSOR_MODE",
"value": "0"
},
{
"name": "SENSOR_RESET",
"value": "0"
},
{
"name": "BACKGROUND_SCAN",
"value": "false"
},
{
"name": "POLICY_ACTION_OVERRIDE",
"value": "true"
},
{
"name": "HELP_MESSAGE",
"value": "CarbonBlack"
},
{
"name": "PRESERVE_SYSTEM_MEMORY_SCAN",
"value": "false"
},
{
"name": "HASH_MD5",
"value": "true"
},
{
"name": "SCAN_LARGE_FILE_READ",
"value": "false"
},
{
"name": "SCAN_EXECUTE_ON_NETWORK_DRIVE",
"value": "true"
},
{
"name": "DELAY_EXECUTE",
"value": "true"
},
{
"name"