VMware Carbon Black Cloud (Carbon Black CB Defense)
  • 01 Jun 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

VMware Carbon Black Cloud (Carbon Black CB Defense)

  • Dark
    Light
  • PDF

VMware Carbon Black Cloud (formerly Carbon Black CB Defense) is a cloud native platform delivering next-generation antivirus and endpoint detection and response. This adapter is also compatible with Carbon Black Cloud Enterprise EDR (formerly CB ThreatHunter) and Carbon Black Cloud Audit and Remediation (formerly CB LiveOps).

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices

Parameters

  1. VMware Carbon Black Cloud Domain (required) - Use your VMware Carbon Black Cloud domain, in the following format:

    • To use the CB Defense REST API - appservices (v6): https://defense-<environment>.conferdeploy.net/
    • To use the CB Defense REST API - intergrationServices (v3): https://api-<environment>.conferdeploy.net/
  2. API ID and API Secret Key (required) - Use the API ID and the API Secret Key you generated from the Connectors page of the VMware Carbon Black Cloud console.
    For details on generating the API token and the Connector ID, see the CB Defense API authentication reference.

  3. Verify SSL (required, default: False) - Select to verify the SSL certificate offered by the value supplied in VMware Carbon Black Cloud Domain. For more details, see SSL Trust & CA Settings.

  4. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in VMware Carbon Black Cloud Domain.

    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in VMware Carbon Black Cloud Domain.
    • If not supplied, Axonius will connect directly to the value supplied in VMware Carbon Black Cloud Domain.
  5. Organization Key (optional, default: empty) - Your organization key.

    • If supplied, Axonius will use CB Defense REST API v6 to fetch data from VMware Carbon Black Cloud adapter connection.
    • If not supplied, Axonius will use CB Defense REST API v3 to fetch data from VMware Carbon Black Cloud adapter connection.


      You can find your organization key in the VMware Carbon Black Cloud Console under Settings > API Keys.
  6. To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

Advanced Settings

Note:

From Version 4.6, Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters

  1. Fetch deregistred devices (required, default: true) - Select to fetch deregistered devices.
  2. Fetch Vulnerabilities (required, default: false) - Select to fetch vulnerabilities on devices.
Note:

In addition to selecting this option, you must enter a value in the Organization Key parameter. Vulnerabilities are only available via CB Defense REST API v6.

  1. Fetch only active devices (optional, default: false) - Select to exclude inactive devices from the fetch.
  2. Page Size (required, default: 100) - Specify number of entries returned per page request.
Note:

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.


APIs

Axonius uses the following CB Defense REST APIs:
1. CB Defense REST API - intergrationServices (v3), if you have not specified an organization key.
2. CB Defense REST API - appservices (v6), if you have specified an organization key.

It is highly recommended to use the CB Defense REST API - appservices (v6).

Required Permissions

If CB Defense REST API - appservices (v6) is utilized, the value supplied in API Key must be associated with credentials that have 'Device - General Information - Read' custom permissions.
In addition, to create:

you also need 'Device - Quarantine - Execute' permissions.

Refer to Carbon Black Cloud API Access for full details of the custom access level steps.




First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.