Integration runtime configuration typeIntegration server configuration type

Vault archive key type

Use the Vault archive key type to create configurations that supply a vault archive key, which decrypts an IBM® App Connect Enterprise vault archive that stores credentials for connecting to secured resources.

Tip: The Vault archive key type works with the Vault archive type, so you need both of these configurations if your IBM App Connect Enterprise Toolkit integration is configured to connect to secured resources.
Note: If you want to deploy an integration that connects to secured resources by using encrypted credentials from an IBM App Connect Enterprise vault, only one of these configuration pairs is permissible:
  • Vault archive and Vault archive key: Use this combination for integration servers or integration runtimes at version 13.0.3.0-r1 or later.
  • Vault and Vault key: This combination is supported for integration servers or integration runtimes at version 13.0.2.2-r2 or earlier, and is deprecated in 13.0.3.0-r1 or later.

Summary of key details for the configuration type

File name or type Contains secrets Path extracted/imported to Maximum allowed per integration server or integration runtime
String value Yes Not applicable (Passed to the integration server or integration runtime command line on startup) 1

Creating the vault archive key value for a configuration object of type Vault archive key

The Vault archive key type requires a string value that is used to decrypt a vault archive, which is stored in a configuration object of type Vault archive. This string value must match the archive key that you supplied in the command to export the credentials from an integration server vault or external directory vault to a .zip vault archive. An archive key symmetrically encrypts and decrypts the credentials in a vault archive. For information about exporting a vault, see mqsivault command and ibmint export credentials command in the IBM App Connect Enterprise documentation.

Only one vault archive key can be specified per integration server or integration runtime. When you export the credentials from an integration server vault or external directory vault in IBM App Connect Enterprise, the supplied archive key encrypts the .zip vault archive that is created. When you subsequently deploy an integration server or integration runtime that uses this vault archive, you need to supply the same archive key to decrypt the vault archive. This vault archive is then imported into a new vault that is created for use by the deployed integration.

You can use the vault archive key string value to create a configuration object as described in Configuration reference: Creating an instance from the Red Hat OpenShift web console and Creating an instance from the Red Hat OpenShift or Kubernetes CLI.