After generating the API keys from the Carbon Black Cloud console, configure the Carbon Black Cloud Workload appliance to establish connection withCarbon Black Cloud.

Prerequisites

  • Verify the Carbon Black Cloud Workload appliance VM is powered-on.
  • API keys are generated and copied from the Carbon Black Cloud console. For more information, refer to Step 1D: Generate API ID and API Secret Key.
  • Appliance must have HTTPS (443) connectivity to communicate with the vCenter Server and the Carbon Black Cloud.

Procedure

  1. Log in to the vSphere Client.
  2. Verify the Carbon Black Cloud Workload appliance VM is powered-on. Open the VM console and note down the IP address of the appliance.
  3. From your browser, log in to the Carbon Black Cloud Workload appliance at https://<appliance IP address> using the admin credentials.
  4. Go to the Appliance > Registration page.
  5. In the Carbon Black Cloud section, click Edit.
  6. Click the CB Cloud Environment drop-down menu and select a Carbon Black Cloud environment.
  7. Optional. If the Carbon Black Cloud environment is not present, select Other from the CB Cloud Environment drop-down menu, and populate the CBC URL.
  8. Configure the following values.
    1. CBC URL: Enter the Carbon Black Cloud console URL as per your hosted Carbon Black Cloud location. For example, https://dashboard.confer.net/.
    2. Appliance name: Enter a unique name for the appliance in your Carbon Black Cloud organization.
      Important: The appliance name must be UNIQUE for your Carbon Black Cloud organization. One Appliance name is associated with one Carbon Black Cloud organization. You cannot use the same appliance name with a different set of API keys or use a different appliance name for the same set of API keys.
    3. Org key: Enter the organization key for your Carbon Black Cloud organization.
      CBC appliance name and Org key values
      To find the org key, log in to the Carbon Black Cloud console and navigate to the Settings > API Access > API Keys page. You can find your Org Key value in the upper left.
    4. API ID: Paste the 10 digit API ID copied from the Carbon Black Cloud console.
    5. API secret key: Paste the API secret key copied from the Carbon Black Cloud console.

      For more information, refer to Step 1D: Generate API ID and API Secret Key.

  9. Click Save.

Results

When you see a green check mark, the connection between the vCenter Server, Carbon Black Cloud Workload appliance, and Carbon Black Cloud is established.
After successful registration:
  • If the registered Carbon Black Cloud Workload appliance is with version 1.1, you see the Org Name.
  • If the registered Carbon Black Cloud Workload appliance is with version earlier then 1.1, you see the Org Key.

What to do next

After the connection is successfully established, you can view data in the Carbon Black Cloud Workload Plug-in from the vCenter Server. When you click the Carbon Black icon in the left navigation pane, the Summary tab displays appliance health and inventory status.