Understanding Secrets in Kubernetes

  • Post category:Containers / Harbor
  • Post last modified:June 29, 2023


In the world of container orchestration, Kubernetes reigns supreme, offering a powerful and flexible platform for managing and deploying applications. Among its many features, Kubernetes provides a robust mechanism for securely managing sensitive information, known as secrets. Secrets play a pivotal role in ensuring the security, efficiency, and scalability of your Kubernetes deployments. In this article, we will explore the secrets in Kubernetes, uncovering their importance, functionalities, and providing practical examples to illustrate their usage.

Understanding Secrets in Kubernetes

In Kubernetes, secrets are a way to securely store sensitive information such as passwords, API keys, and certificates. Unlike ConfigMaps, which handle non-sensitive configuration data, secrets are specifically designed to safeguard confidential information from being exposed or easily accessed by unauthorized entities.

Secrets in Kubernetes are base64-encoded representations of sensitive data, stored within the cluster and accessible to pods and other Kubernetes resources as needed. By leveraging secrets, developers can ensure that sensitive information is kept separate from container images and configurations, reducing the risk of inadvertent exposure.

Types of Secrets

Kubernetes provides two main types of secrets:

i. Opaque Secrets: Opaque secrets are the most common type and are used for arbitrary data, such as passwords, tokens, or other unstructured information. The data within an opaque secret is stored as key-value pairs, where the values are base64-encoded strings.

ii. TLS Secrets: TLS (Transport Layer Security) secrets are specifically designed for handling TLS certificates and private keys. These secrets are used to secure communication between services within a cluster or with external entities.

Creating and Managing Secrets

Creating and managing secrets in Kubernetes can be done through various methods, including imperative commands or declarative YAML manifests. Let’s take a look at an example of creating a secret imperatively using the kubectl command:

kubectl create secret generic my-secret --from-literal=api-key=abc123 --from-file=ssl-cert=cert.pem

In this example, we create a generic secret named “my-secret” with two key-value pairs: “api-key” with the value “abc123” and “ssl-cert” with the value loaded from the file “cert.pem“.

Alternatively, secrets can also be defined declaratively in YAML manifests. Here’s an example of a secret manifest:

apiVersion: v1
kind: Secret
name: my-secret
type: Opaque
api-key: YWJjMTIz # base64-encoded value

In this declarative approach, the secret is defined with a name, type (Opaque in this case), and the base64-encoded data. You can create the secret by applying this manifest using the kubectl apply -f secret.yaml command.

Using Secrets in Kubernetes Deployments

Once secrets are created, they can be easily utilized within Kubernetes deployments, pods, or other resources. Let’s consider an example where a deployment needs to access a secret:

apiVersion: apps/v1
kind: Deployment
name: my-app
replicas: 1
- name: my-container
image: my-app-image
- name: API_KEY
name: my-secret
key: api-key

In this deployment manifest, the environment variable API_KEY is set to the value of the api-key key from the my-secret secret. The application running in the container can then access this value like any other environment variable, ensuring the secure retrieval of sensitive information.

Best Practices for Secrets Management

To ensure the effective management of secrets in Kubernetes, consider the following best practices:

  • Regularly rotate secrets: Rotate secrets at regular intervals or in response to security incidents to mitigate the risk of compromise.
  • Restrict secret access: Implement proper RBAC (Role-Based Access Control) policies to limit access to secrets only to authorized entities.
  • Encrypt secrets at rest: Enable encryption at rest for your Kubernetes cluster to ensure the secrets are stored securely.
  • Leverage external secret management solutions: Consider integrating external secret management solutions like HashiCorp Vault or Azure Key Vault to enhance security and centralized management.


Secrets in Kubernetes offer a vital mechanism for securely managing sensitive information within containerized applications. By leveraging secrets, developers can ensure the confidentiality of critical data, enhance security, and adhere to best practices for secrets management. In this article, we explored the fundamentals of secrets in Kubernetes, discussed different types of secrets, examined how to create and manage secrets, and provided practical examples of their usage. By following the best practices outlined here, you can unlock the hidden powers of secrets and fortify your Kubernetes deployments for enhanced security and efficiency.

Ashutosh Dixit

I am currently working as a Senior Technical Support Engineer with VMware Premier Services for Telco. Before this, I worked as a Technical Lead with Microsoft Enterprise Platform Support for Production and Premier Support. I am an expert in High-Availability, Deployments, and VMware Core technology along with Tanzu and Horizon.

Leave a Reply