- 10 Aug 2022
- 2 Minutes to read
VMware Carbon Black Cloud (Carbon Black CB Defense)
- Updated on 10 Aug 2022
- 2 Minutes to read
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:
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/
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.
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.
HTTPS Proxy (optional) - A proxy to use when connecting to the value supplied in VMware Carbon Black Cloud Domain.
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.
To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
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.
- Fetch deregistered devices (required, default: true) - Select to fetch deregistered devices.
- Fetch Vulnerabilities - Select to fetch vulnerabilities on devices.
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.
- Fetch only active devices (optional) - Select to exclude inactive devices from the fetch.
- Page Size (required, default: 100) - Specify the number of entities returned per page request.
For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.
Axonius uses the Carbon Black Devices API.
The value supplied in API Key must be associated with credentials that have 'Device - General Information - Read' custom permissions.
In addition, to create:
- Change VMware Carbon Black Cloud Policy Enforcement Actions
- Isolate and Unisolate in VMware Carbon Black Cloud Enforcement Actions
you also need 'Device - Quarantine - Execute' permissions.
Refer to Carbon Black Cloud API Access for full details of the custom access level steps.
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.
|Latest version of Carbon Black Device API||Yes|
Supported From Version
Supported from Axonius version 4.5