VMWare Carbon Black Cloud

introduction this guide explains how to authenticate the vmware carbon black cloud connector in swimlane using api credentials you will create an api key in the carbon black cloud console, collect the required identifiers, and configure the connector asset in swimlane turbine prerequisites carbon black cloud access requirements you must have access to the vmware carbon black cloud console with permissions to create api keys access the carbon black cloud platform apis manage alerts, devices, and security actions through the api required credentials during setup you will collect carbon black cloud api url api id api secret key authentication method overview the vmware carbon black cloud apis authenticate using the x auth token header the value of this header is constructed using the api secret key and api id carbon black cloud api setup take the following steps to create an api key in carbon black cloud log in to the vmware carbon black cloud console from the left navigation menu, open settings navigate to api access open the api keys tab click add api key enter a unique name for the api key select the appropriate access level or create a custom role with required permissions click save to create the api key copy the generated api id and api secret key store these credentials securely for use in swimlane connector configuration in swimlane take the following steps to configure the vmware carbon black cloud connector asset in swimlane log in to turbine from the left hand navigation pane click orchestration and then assets the asset homepage opens click the plus icon (+) to open the configure your connector asset window select vmware carbon black cloud from the asset type list fill in the asset settings and asset input fields as shown below configuration parameters field description required url base url for the carbon black cloud api endpoint required username api id generated in carbon black cloud required password api secret key generated in carbon black cloud required verify ssl enable or disable ssl certificate verification optional http proxy proxy configuration if requests must pass through a proxy optional troubleshooting if authentication fails ensure the api id and api secret key are copied correctly verify the carbon black cloud api url matches your tenant environment confirm the api key has the required access permissions ensure the api key has not been regenerated or revoked check ssl verification settings if ssl inspection is enabled validate proxy configuration if outbound api traffic must pass through a proxy sources vmware carbon black cloud platform api documentation https //developer carbonblack com/reference/carbon black cloud/platform apis https //developer carbonblack com/reference/carbon black cloud/platform apis vmware carbon black cloud authentication documentation https //developer carbonblack com/reference/carbon black cloud/authentication https //developer carbonblack com/reference/carbon black cloud/authentication result you have successfully authenticated the vmware carbon black cloud connector in swimlane