Secrets Manager SDKs

Secrets Manager offers software development kits (SDKs) that you can use to connect with the service in various programming languages. For more information about getting started with Secrets Manager SDKs, check out the following repositories on GitHub:

• Go SDK
• Node.js SDK
• Java SDK
• Python SDK

Secrets Manager CLI plug-in

If you're already using the IBM Cloud Command Line Interface (CLI), you can install the Secrets Manager plug-in so that you can manage secrets in your instance from the command line. For example, after you add secrets to your service instance, you can run the following CLI command to obtain a list of secrets:

ibmcloud secrets-manager secrets

To install the Secrets Manager CLI plug-in, run ibmcloud plugin install secrets-manager. For more information, check out the Secrets Manager CLI reference.

Secrets Manager API

If you're trying out Secrets Manager for the first time, you might want to use the Secrets Manager API to evaluate the service and test out workflows for your applications. Start by copying the service endpoint URL from the Endpoints page in your Secrets Manager service dashboard. Then, generate an IBM Cloud Identity and Access Management (IAM) token to include in your request. For example, after you store secrets in your service instance, the following API request can be used to obtain your list of secrets:

curl -X GET  \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/json" 
  "{base_url}/api/v2/secrets"

Replace {base_url} with your service endpoint URL, and {access_token} with your IAM token. To run the API request, you can paste it into your command line or preferred API testing tool.

For more information about using Secrets Manager APIs, check out the Secrets Manager API reference.

Vault

Already using HashiCorp Vault? You can interact with your Secrets Manager service instance by using the Vault HTTP API or CLI format.

Secrets Manager doesn't support all components that are available for Vault. Instead, the service builds on a custom version of open source Vault to support operations in Secrets Manager for various secret types.

For more information, check out the following resources:

• Vault API reference
• Vault CLI reference