> ## Documentation Index
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Secrets Manager

Explore recommended content and resources to help you get started with IBM Cloud Secrets Manager.

## Get started

- [Getting started with Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-getting-started&format=markdown)
- About
   - [Pricing](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-pricing&format=markdown)
   - [Your responsibilities](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-understanding-your-responsabilities&format=markdown)
- Use cases
   - [Securing Kubernetes secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-use-case-kubernetes-secrets&format=markdown)
   - [Benefit of storing VPN credentials in Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-use-case-vpn-certificates&format=markdown)
- Best practices
   - [Best practices for using Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-best-practices-using&format=markdown)
   - [Best practices for organizing secrets and assigning access](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-best-practices-organize-secrets&format=markdown)
   - [Best practices for rotating and locking secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-best-practices-rotate-secrets&format=markdown)
- [Release notes](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-release-notes&format=markdown)

## Tutorials

- [Access a storage bucket by using a dynamic secret](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-tutorial-access-storage-bucket&format=markdown)
- [Secure secrets for apps that run in your Kubernetes cluster](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secure-secrets-for-apps-that-run-in-your-kubernetes-cluster&format=markdown)

## How to

- Setting up the service
   - [Creating a Secrets Manager service instance](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-create-instance&format=markdown)
   - [Assigning access to Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-assign-access&format=markdown)
   - [Integrating Secrets Manager with your apps](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-integrating-secrets-manager-with-your-apps&format=markdown)
   - [Setting up Terraform](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-terraform-setup&format=markdown)
- Working with secrets
   - [What is a secret?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-what-is-secret&format=markdown)
   - Creating secrets
      - [Arbitrary secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-arbitrary-secrets&format=markdown)
      - [IAM credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-iam-credentials&format=markdown)
      - [Key-value secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-key-value&format=markdown)
      - [Imported certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-certificates&format=markdown)
      - [Public certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-public-certificates&format=markdown)
      - [Private certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-private-certificates&format=markdown)
      - [User credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-user-credentials&format=markdown)
      - [Service credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-service-credentials&format=markdown)
      - [Custom credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-custom-credentials&format=markdown)
   - [Accessing secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-access-secrets&format=markdown)
   - [Locking secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secret-locks&format=markdown)
   - [Secret tasks](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secret-tasks&format=markdown)
   - Rotating secrets
      - [Manually rotating secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-manual-rotation&format=markdown)
      - [Automatically rotating secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-automatic-rotation&format=markdown)
      - [Managing secrets versions](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-version-history&format=markdown)
   - [Deleting secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-delete-secrets&format=markdown)
   - Updating secrets
      - [Updating secret metadata](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-updating-secret-metadata&format=markdown)
      - [Updating secret version metadata](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-updating-secret-version&format=markdown)
- [Organizing your secrets](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secret-groups&format=markdown)
- Configuring secrets engines
   - [What is a secrets engine?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secrets-engines&format=markdown)
   - [IAM credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-configure-iam-engine&format=markdown)
   - Custom credentials
      - [Preparing to create custom credentials](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-custom-credentials-prepare&format=markdown)
      - [Creating a Code Engine job](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-engine-custom-ce-job&format=markdown)
      - [Creating a custom credentials engine configuration](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-custom-credentials-config&format=markdown)
   - Public certificates
      - [Preparing to order public certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-order-certificates&format=markdown)
      - [Connecting third-party certificate authorities](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-add-certificate-authority&format=markdown)
      - [Connecting DNS providers](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-add-dns-provider&format=markdown)
   - Private certificates
      - [Preparing to create private certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-prepare-create-certificates&format=markdown)
      - [Creating root certificate authorities](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-root-certificate-authorities&format=markdown)
      - [Creating intermediate certificate authorities](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-intermediate-certificate-authorities&format=markdown)
      - [Adding certificate templates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-certificate-templates&format=markdown)
      - [Rotating authorities certificates](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-rotating-ca-certificates&format=markdown)
- [Enabling event notifications](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-event-notifications&format=markdown)
- Connecting integrations
   - [Integrating with other IBM Cloud services](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-integrations&format=markdown)
   - [Integrating with Ansible](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-integration-ansible&format=markdown)
   - [Integrating with Vault Jenkins plug-in](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-integration-jenkins&format=markdown)
- Logging and monitoring
   - [Activity tracking events for Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-at_events&format=markdown)
   - [Logging for Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-logging&format=markdown)
   - [Monitoring operational metrics](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-operational-metrics&format=markdown)
- Enhancing security
   - [Managing IAM access for Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-iam&format=markdown)
   - [Learning about Secrets Manager architecture and workload isolation](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-compute-isolation&format=markdown)
   - Privately connecting to Secrets Manager
      - [Using service endpoints](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-service-connection&format=markdown)
      - [Using Client-to-Site VPN](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-vpn-connection&format=markdown)
   - [Securing your data in Secrets Manager](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-mng-data&format=markdown)
   - [Protecting Secrets Manager resources with context-based restrictions](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-access-control-cbr&format=markdown)

## Reference

- Programmatic references
   - [API reference](https://{DomainName}/apidocs/secrets-manager/secrets-manager-v2)
   - [API change log](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-api-change-log&format=markdown)
   - [CLI reference](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-secrets-manager-cli&format=markdown)
   - [CLI change log](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-cli-change-log&format=markdown)
   - [Terraform](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/sm_secrets)
   - Vault
      - [Vault API reference](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-vault-api&format=markdown)
      - [KV secrets engine](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-vault-manage-kv&format=markdown)
      - [KV CLI commands](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-vault-manage-kv-cli&format=markdown)
      - [Setting up the Vault CLI](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-configure-vault-cli&format=markdown)
      - [Vault CLI](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-vault-cli&format=markdown)
- [Service dependency map](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-service-dependencies&format=markdown)
- Service availability
   - [Regions and endpoints](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-endpoints&format=markdown)
   - [Understanding high availability and disaster recovery](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-ha-dr&format=markdown)
- Data portability
   - [Understanding data portability](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-understanding-data-portability&format=markdown)

## Help

- [FAQ](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-faqs&format=markdown)
- [Known issues and limits](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-known-issues-and-limits&format=markdown)
- Troubleshooting
   - [Why is my instance of Secrets Manager stuck on provisioning?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-provision&format=markdown)
   - [Why can't I configure the IAM credentials engine?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-IAM-secrets-engine&format=markdown)
   - [Why am I blocked from ordering a public certificate or generating IAM credentials?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-ip-address-not-allowed&format=markdown)
   - [Why can't I restore the previous version of an IAM credentials secret?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-restore-iam&format=markdown)
   - [Why can't I import my certificate file?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-pem&format=markdown)
   - [Why can't I read a locked IAM credentials secret?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-locked-iam-credentials&format=markdown)
   - [Why did my locked certificate move to the Destroyed state?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-locked-certificates&format=markdown)
   - [Why can't I delete my secret group?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-secret-group&format=markdown)
   - [Why was my instance of Secrets Manager deleted?](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-troubleshoot-instance-delete&format=markdown)
- [Getting help and support](https://cloud.ibm.com/docs/secrets-manager?topic=secrets-manager-getting-help&format=markdown)