To configure the AlienApp for VMware Carbon Black Cloud in USM Anywhere, you first need to configure API key credentials. You also need to provide the hostname and Org Key for your Carbon Black Cloud instance.
Set up Carbon Black Cloud API
Follow the instructions listed in the VMware Carbon Black Cloud documentation to configure your API key credentials. Here are some guidelines on how to configure the API key credentials required for USM Appliance.
Note: Because VMware has announced that they are phasing out all preconfigured key types, creating your API keys with the Custom type may mean your AlienApp for VMware Carbon Black Cloud is more future-proof.
AT&T Cybersecurity does not recommend configuring Super User API keys for use with this app, as that API key type is far more permissive than this app requires.
At minimum, your API key must be configured with the Manage Roles and Manage Users permissions from the Organization Settings category, as well as all permissions granted to users.
If you are not planning to use a preconfigured API key type, you must configure and save your Custom API key type before creating your new API key.
Once you have created your API key, you can view your credentials at any time by opening the Actions dropdown within Carbon Black Cloud settings and selecting API Credentials.
To view your Org Key, navigate to Settings > API Access > API Keys within the VMware Carbon Black Cloud console.
Configure the AlienApp for VMware Carbon Black Cloud in USM Anywhere
To enable the AlienApp for VMware Carbon Black Cloud
- In USM Anywhere, go to Data Sources > AlienApps.
- Click the Available Apps tab.
- Search for the AlienApp, and then click the tile.
- Click Configure API.
If you have more than one deployed USM Anywhere Sensor, select the sensor that you want to use for the enabled AlienApp.
AlienApps operate through a deployed sensor and use APIs to integrate with the connected third-party technology. Select the sensor that can access the integration endpoint. The HTTPS connections to the API will originate from this sensor, so it is important to make sure the sensor has network access to the AlienApp API endpoints.
Enter the hostname, Org Key, and API key credentials.
- Click Save.
- Go to Settings > Scheduler.
- In the Job Scheduler, search for the AlienApp on the sensor to which it was deployed.
In the enabled column, click the icon for the inactive collection job.
The icon turns green, and collection is enabled.
- (Optional.) Click the icon to customize the frequency of the event collection.
AlienApp Log Collection
Once the AlienApp has been configured, you can choose to have USM Anywhere collect logs from the app on a regular basis.
To configure log collection for the AlienApp