Credentials

FlexDeploy integrates with external credential stores like HashiCorp Vault and CyberArk AAM and also has API to integrate with other credential stores. This integration is focused on retrieval of secure credential text during workflow executions. Credentials (Password, Passphrase etc.) for Endpoints, Project, Environment Instance, Integration Instances can be configured for retrieval from external credential store. Note that such credentials retrieved from external credential stores are not stored, cached or printed in FlexDeploy, which allows you to update credentials as per your requirements without changing anything in FlexDeploy. At the same time, FlexDeploy also supports Local credential store where credentials are stored in encrypted format in FlexDeploy database. FlexDeploy Local credential store uses AES 128 or AES 256 bit encryption. See Java Cryptography Extension (JCE) unlimited strength policy files to use AES 256 bit encryption.

Migration from 5.1 or earlier versions

FlexDeploy will automatically migrate encrypted property values and endpoint password/passphrase to Local credential store at startup. Each migrated credential will be uniquely named also. Local credential store is introduced with FlexDeploy 5.2. You can continue to use Local credential store or choose to migrate to external credential store as necessary. See example below for credentials that were migrated to Local credential store.

Note that FlexDeploy only allows retrieval of credentials from external credential store, i.e. you will need to manage credentials using tools provided by credential store. You can always manage Local credentials using UI or REST API.

Here are features provided by FlexDeploy in this category

  • Out of box integration with HashiCorp Vault and CyberArk AAM (certificate authentication and agent based)
  • Local credential store (useful for customers that do not have external credential store)
  • Ability to integrate with other credential stores
  • Credentials can be managed from central location or from individual place where credential is utilized.

Terminology

FlexDeploy TermDescription
Credential Store Provider

Provider encapsulates logic required to retrieve credential from specific type of store. There are few providers available out of box, but you can define custom implementations using either Java class or Groovy script. Provider will define properties necessary to connect to credential store as well inputs necessary for each credential.

Credential Store

Credential store represents instance of specific type of credential store provider. You can have many such credential stores in FlexDeploy. For example, you can have store for Production credentials and another for Non Production credentials.

Local credential store is available out of box.

CredentialRepresent each individual credential with inputs necessary to retrieve it from credential store. For local credential store, you will just provide secret text, but for HashiCorp Vault you will provide path and key name to retrieve that credential from external credential store.
Credential NameName to uniquely identify each credential. This must be unique across all credential stores. For example, if you are using same password for OS user oracle in Development environment then you can use DEV OS Oracle as name for credential.
Credential ScopeScope for credential. This serves as filtering mechanism. Various scopes are Endpoint, Project, Instance, Environment Instance. This means that endpoint password credential can not be used for Git instance password.

Getting Started

If you want to integrate with HashiCorp Vault or CyberArk AAM, you must first create Credential Store definition in FlexDeploy, then you can create individual credentials as necessary.

If you want to integrate with other credential stores, then you need to first create new Credential Store Provider, then create Credential Store definition, then you can create individual credentials as necessary.

If you want to just use Local credential store, then you can just create credentials as necessary for Local credential store.

Let's review each topic in detail now.

Credential Store Provider

Credential Store

Credential

The following macros are not currently supported in the footer:
  • style