Skip to main content

Cyware Orchestrate

Vmware CarbonBlack Cloud Enterprise EDR 1.0.0

App Vendor: VMware

App Category: Endpoint Detection and Response

App Version in Orchestrate: V1.0.1

API version: V1, V2, V3

Default Port: 443

About App

The Vmware CarbonBlack Cloud Enterprise EDR app in the Orchestrate application allows security teams to integrate with Carbon Black ThreatHunter as Carbon Black Cloud Enterprise EDR, to gain unfiltered visibility for top Security Operations Centers (SOCs) and Incident Response (IR) teams. Carbon Black ThreatHunter is delivered through the Carbon Black Cloud, a next-generation endpoint protection platform that consolidates security in the cloud using a single agent, console and dataset.

The VMware CarbonBlack Cloud Enterprise EDR app in the Orchestrate application can perform the below listed actions:

Action Name

Description

Get details of a Watchlist

This action can be used to get details of a Watchlist.

Get details of a Feed

This action can be used to get details of a Feed.

Get details of a Feed Report

This action can be used to get details of a report from a Feed.

Get information about a Feed

This action can be used to get information about a Feed.

Get a list of Feed Reports

This action can be used to get a list of Feed Reports.

Get a list of Feeds

This action can be used to get a list of all Feeds.

Get a list of all Watchlists

This action can be used to get the list of all Watchlists.

Search Feeds

This action can be used to search Feeds.

Prerequisites

All the actions configured in the VMware CarbonBlack Cloud Enterprise EDR app relate to private APIs. VMware CarbonBlack Cloud Enterprise EDR Enterprise subscription is required to access the private APIs.

Configuration Parameters

The following configuration parameters are required for the VMware CarbonBlack Cloud Enterprise EDR app to communicate with VMware CarbonBlack Cloud Enterprise EDR enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required / Optional

Comments

Cloud Domain

Enter the cloud domain. For example, "defense.tld"

Text

Required

API ID

Enter API ID.

Password

Required

Required Access Level type: RBAC permission required

API Secret Key

Enter API Secret Key.

Password

Required

Required Access Level type: RBAC permission required

Org Key

Enter the Org Key. For example, “7DESJ9GN“

Text

Required

Action: Get details of a Watchlist

This action can be used to get details of a watchlist.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Watchlist ID

Enter the Watchlist ID. For example, “jEi9DvRgRRC2D3CPXtuOlg”

Text

Required

Example Request
[
    {
        "watchlist_id": "jEi9DvRgRRC2D3CPXtuOlg"
    }
]
Action: Get details of a Feed

This action can be used to get details of a feed.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Feed ID

Enter the feed ID. For example, “TtEd0qO0R2uEipWr8gYNTw”

Text

Required

Example Request
[
    {
        "feed_id": "TtEd0qO0R2uEipWr8gYNTw"
    }
]
Action: Get details of a Feed Report

This action can be used to get details of a report from a feed.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Feed ID

Enter the feed ID. For example, “TtEd0qO0R2uEipWr8gYNTw”

Text

Required

Report ID

Enter the report ID. For example, “tc-104232995”

Text

Required

Example Request
[
    {
        "feed_id": "TtEd0qO0R2uEipWr8gYNTw",
        "report_id": "tc-104232995"
    }
]
Action: Get information about a Feed

This action can be used to get information about a feed.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Feed ID

Enter the feed ID. For example, “TtEd0qO0R2uEipWr8gYNTw”

Text

Required

Example Request
[
    {
        "feed_id": "TtEd0qO0R2uEipWr8gYNTw"
    }
]
Action: Get a list of Feed Reports

This action can be used to get a list of feed reports.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Feed ID

Enter the feed ID. For example, “TtEd0qO0R2uEipWr8gYNTw”

Text

Required

Example Request
[
    {
        "feed_id": "TtEd0qO0R2uEipWr8gYNTw"
    }
]
Action: Get a list of Feeds

This action can be used to get a list of all feeds.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Public Feeds

Select if you want to include public Feeds.

Boolean

Optional

Allowed values:

  • True

  • False

By default, the value is set as “False”

Example Request
[
   {
     “public_feeds”: “False“
   }
]
Action: Get a list of all Watchlists

This action can be used to get a list of all Watchlists.

Input Parameters

No input parameters are required for this action.

Action: Search Feeds

This action can be used to search feeds.

Input Parameters

Parameter

Description

Field Type

Required / Optional

Comments

Search Query

Enter a search query. For example, “url”

Any

Required

Additional Parameters

Enter additional parameters in the form of key value pairs to filter Feeds.

Key Value

Optional

Allowed key value pairs are:

  • start = Offset of first record

  • rows = Number of records to retrieve

  • sort = Comma separated list of sort fields. Allowed values: ASC and DESC

  • facet.field = Comma separated list of fields to compute facets.

Example Request
[
    {
        "extra_params": {},
        "search_query": "url"
    }
]