Skip to main content

DCM External Vaults

The External Vault feature allows you to connect DCM with your Vault of choice (see supported vaults). Thus, you can use External Vaults in DCM to fetch credentials from your Vault and securely use them in your workflow.

We support External Vaults for Designer 22.3 and later.

External Vault Configuration

In order to configure External Vaults, DCM must be enabled. Learn how to enable DCM in the DCM - Designer article. To connect DCM to your Vault:

  1. In Designer, select File > Manage Connections to open DCM.

  2. Go to the External Vaults tab.

  3. Select +New.

  4. Enter a Vault name.

  5. Choose Technology.

  6. Enter the address of your Vault into the URL input, for example, https://myvault.hashicorp.cloud:8200/.

  7. Select Save.

Next, select credentials to authenticate to your Vault:

  1. Choose an Authentication Method.

  2. Fill in the credential information.

  3. Select Link.

You are now able to select this External Vault as a source of credentials.

Create an External Vault Credential

In order to create a new credential that contains authentication data from an External Vault, you must:

  1. Open DCM.

  2. Open the Credentials tab.

  3. Select + Add Credential.

  4. Enter the credential name.

  5. Select Vault from the Vault dropdown.

  6. Enter a path to the secret in the selected Vault into the Vault Path. Use slash formatting, for example, path/to/secret.

  7. Select Authentication method.

  8. If you want to fetch the credential from Vault, check the Use Values from Vault check box.

    Then enter the key - the username (when accessing a key-value type of secret) or the JSON path (if the retrieved secret is a more complex JSON object) using the Javascript object notation, for example, secrets.username.

    Other types of secrets are not supported.

  9. If you want to enter any part of the credential value manually (and keep it saved in DCM), uncheck the Use Values from Vault checkbox.

    Then enter the actual credential value (for example, your username).

  10. Select Save.

Now, the newly saved credential can be used in your Workflow, the same as any other DCM credential.

Edit External Vault Credential

  1. Open DCM.

  2. Open the Credentials tab.

  3. Select which credential to edit.

  4. Select Edit.

  5. Update credential details.

  6. Select Save.

Delete External Vault Credential

  1. Open DCM.

  2. Open the Credentials tab.

  3. Select which credential to delete.

  4. Select the trashcan icon.

  5. Select Delete to confirm.

Supported Vaults

  • Hashicorp Vault (KV secrets engine) - supported for Designer 22.3 and later.

  • CyberArk Conjur - supported for Designer 22.3 and later.

  • AWS Secrets Manager