---
title: "Carbon Black"
slug: "carbon-black"
updated: 2025-06-24T17:24:23Z
published: 2025-06-24T17:24:23Z
canonical: "help.nucleussec.com/carbon-black"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.nucleussec.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Carbon Black

Nucleus enables you to ingest your Carbon Black vulnerability data into Nucleus using the Carbon Black connector.

The connector uses the APIs provided by Carbon Black to seamlessly ingest vulnerability data into various Nucleus projects for use in analysis, triage, automation, and reporting.

## Create the Carbon Black API key

Before setting up the Carbon Black connector, you will first need to create an API key in Carbon Black for the connector to use.

1. Log in to Carbon Black.
1. [Create an API access level](https://docs.vmware.com/en/VMware-Carbon-Black-Cloud/services/carbon-black-cloud-user-guide/GUID-BABDFEF4-A483-4824-8A6D-6F0BA0FF94FE.html) with the following permission (.notation name) functions:
    - For `device`, select **Read** permission.
    - For `vulnerabilityAssessment.data`, select **Read** permission.
1. [Create an API key](https://docs.vmware.com/en/VMware-Carbon-Black-Cloud/services/carbon-black-cloud-user-guide/GUID-F3816FB5-969F-4113-80FC-03981C65F969.html) with the access level you created in the previous step.
1. After creating the API key, you will be given an API ID and API secret key which you will use when [configuring the Carbon Black connector](/v1/docs/carbon-black#configure-the-carbon-black-connector).

## Configure the Carbon Black connector

1. Log in to your Nucleus project.
1. From the navigation bar on the left, under **Integration Hub**, select **Connector Setup**.
1. Select **Carbon Black**.<br>
1. In the **Name** field, enter a name for the connector.
1. In the **Description** field, enter a description for this connector.
1. In the **Instance URL** field, enter the URL to your organization's instance of Carbon Black.
1. In the **Org Key** field, enter your [Carbon Black Org Key](https://community.carbonblack.com/t5/Knowledge-Base/Carbon-Black-Cloud-Where-is-the-Org-Key-Found/ta-p/80970).
1. In the **API ID** field, enter [the API ID you created](/v1/docs/carbon-black#create-carbon-black-api-key).
1. In the **API Secret** field, enter [the API secret key you created](/v1/docs/carbon-black#create-carbon-black-api-key).
1. Click **Verify Credentials**. If the credentials were entered correctly, a message confirming a successful connection will appear.
1. Click **Save & Finish**.

## Vulnerability scan data ingestion

To ingest Carbon Black scan results into a Nucleus project:

1. Log in to your Nucleus project.
1. From the navigation bar on the left, under **Integration Hub**, select **Import via Connector**.
1. Select your Carbon Black connector.
1. Select whether you want to import by **Workload**, **Endpoint**, **AWS**, or all three.
1. Click **Next**.
1. Select a schedule to import scans into the project.
1. Click **Save & Finish**.