> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/integrations/builtin/credentials/carbonblack.md).

# Set up Carbon Black credentials in Duaer

Store Carbon Black connection details in Duaer for digital-organization nodes to use at runtime. Secrets are protected by the instance encryption key and are not written into node parameters.
## Create a Carbon Black Cloud API key <a href="#create-an-api-key" id="create-an-api-key"></a>

The Duaer Carbon Black API credential:

1. In the Carbon Black Cloud console, open Settings > API Access and create an API key with the access level the endpoints need.
2. Put API Secret Key/API ID, joined by a slash, in Access Token, as Carbon Black expects. Duaer sends it in the X-Auth-Token header.
3. Put your console’s regional address, such as https://defense.conferdeploy.net/, in URL.

Duaer has no dedicated node for this service. In the HTTP Request node, set Authentication to Predefined Credential Type and pick the Carbon Black API credential. Refer to [custom operations](/integrations/custom-operations.md).

## Carbon Black API fields in Duaer <a href="#carbon-black-api" id="carbon-black-api"></a>

In Duaer, choose Carbon Black API when you create a credential, then fill in these fields:

- URL
- Access Token (required, secret)

## Save the connection in Duaer

Open Credentials and create Carbon Black. Fill in the key, OAuth, or server fields. After you save, digital-organization nodes reference this credential instead of putting the secret in a parameter.

Credential values are protected by the instance encryption key. If you change or lose that key, stored credentials cannot be decrypted. See the hosting notes on encryption keys. 

## Who can use this credential

Who can see or edit it follows projects and roles. Do not paste secrets into chat or variables. External vaults are covered under external secrets.
## Questions

### Do Carbon Black secret values appear in Duaer node parameters?

No. In Duaer, Carbon Black secrets stay in the credential. Nodes only reference the credential. Execution records should not show the plaintext secret either.

### What usually stops a Carbon Black credential from saving in Duaer?

Wrong fields, an OAuth callback that does not match the instance URL, or a role that cannot create credentials. Check the fields Carbon Black expects, then confirm you can create credentials in that project.