VMware Carbon Black Cloud (Carbon Black CB Defense)
  • 27 Mar 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

VMware Carbon Black Cloud (Carbon Black CB Defense)

  • Dark
    Light
  • PDF

Article Summary

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 latest Carbon Black Devices API: https://defense-<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 - 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) - A proxy to use when connecting to the value supplied in VMware Carbon Black Cloud Domain.

  5. Organization Key (required) - Your organization key, used to fetch data from the 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:

FAdvanced 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 deregistered devices (required, default: true) - Select to fetch deregistered devices.
  2. Fetch Vulnerabilities - 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 Carbon Black Devices API.

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

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


APIs

Axonius uses the Carbon Black Devices API.

Required Permissions

The value supplied in API Key must be associated with credentials that have 'Device - General Information - Read' custom permissions.
'vulnerabilityAssessment.data READ' - permissions are required to fetch vulnerabilities.
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.


Version Matrix

This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.

VersionSupportedNotes
Latest version of Carbon Black Device APIYes


Supported From Version

Supported from Axonius version 4.5



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
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.