La contraseña de la base de datos de pedidos empezó en un archivo .env. Luego se copió a una variable de CI para las migraciones, a un Kubernetes Secret para el servicio y a dos portátiles durante un incidente. Dos años después nadie conoce todas las copias, así que nadie se atreve a rotarla.
GitGuardian contó 28,65 millones de nuevos secretos incrustados en el código en los commits públicos de GitHub en 2025, un 34 % más en un año, y más del 64 % de los secretos que confirmó como válidos en 2022 seguían funcionando en enero de 2026 (State of Secrets Sprawl 2026).
Este artículo construye una arquitectura de gestión de secretos sin contraseñas de base de datos de larga duración: workload identity, credenciales dinámicas de corta duración, cifrado de sobre con KMS, rotación y auditoría, con un diagrama del flujo.
Dónde fallan los secretos estáticos
Cada copia de un secreto estático es un lugar por donde puede filtrarse:
- El historial de Git conserva el valor después de que borres la línea.
- Las variables de CI las puede leer cualquiera que pueda modificar un job que las recibe.
- Las variables de entorno son visibles para todos los procesos del contenedor y acaban en logs y volcados de fallos. La hoja de referencia de OWASP sobre secretos desaconseja usarlas salvo que no haya otra opción.
- Los Kubernetes Secrets se almacenan sin cifrar en etcd por defecto, y cualquiera que pueda crear un Pod en un namespace puede leer todos los Secrets de ahí, como advierte la documentación de Kubernetes.
Un gestor de secretos resuelve el almacenamiento, no el arranque: la app sigue necesitando una credencial para obtener su credencial. La solución es una identidad emitida por la plataforma, que se cambia por credenciales que caducan solas.
Los bloques de construcción
| Componente | Función | Ejemplos |
|---|---|---|
| Gestor de secretos | Almacena y emite secretos, aplica políticas, sigue los leases | HashiCorp Vault, OpenBao, AWS Secrets Manager, Google Secret Manager, Azure Key Vault |
| KMS o HSM | Guarda claves de cifrado de claves que nunca salen de él | AWS KMS, Google Cloud KMS, Azure Key Vault Managed HSM |
| Workload identity | Demuestra qué carga de trabajo llama, con tokens de plataforma de corta duración | Tokens de cuenta de servicio de Kubernetes, EKS Pod Identity, Workload Identity Federation for GKE, Microsoft Entra Workload ID |
| Entrega | Lleva el secreto al proceso | Vault Agent, Secrets Store CSI Driver, External Secrets Operator, llamadas de SDK |
| Auditoría | Registra quién leyó qué y cuándo | Audit devices de Vault, AWS CloudTrail, un SIEM |
Cifrado de sobre con KMS
Un KMS no está pensado para datos voluminosos; AWS KMS Encrypt acepta como máximo 4 096 bytes. El cifrado de sobre reparte el trabajo:
GenerateDataKeydevuelve una clave de datos única por duplicado: en texto plano y cifrada con tu clave de KMS, la clave de cifrado de claves (KEK).- Cifra los datos localmente con la clave en texto plano y bórrala de la memoria.
- Guarda la clave de datos cifrada junto al texto cifrado. Para leer, envíala a
Decrypty descifra localmente.
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256
La KEK nunca sale del KMS sin cifrar, así que cada uso es una llamada a la API que puedes autorizar y registrar (AWS KMS cryptography details). La rotación automática, una vez activada, se ejecuta cada año por defecto y solo cambia el material de la clave para los cifrados nuevos; el texto cifrado antiguo se sigue descifrando.
El patrón aparece dos veces aquí. El proveedor KMS de Kubernetes envuelve las claves de datos que cifran los Secrets en etcd; usa KMS v2, porque la v1 está desactivada por defecto desde Kubernetes 1.29. El keyring de Vault está cifrado por una clave raíz y, con auto-unseal, un KMS en la nube descifra esa clave raíz cuando Vault arranca.
Cómo demuestra un Pod quién es
Todo Pod ya tiene una identidad, su cuenta de servicio, en la que también se basa la identidad de carga de trabajo en un service mesh. Con el método de autenticación Kubernetes de Vault:
- El kubelet solicita, mediante la API TokenRequest, un token de cuenta de servicio proyectado con la audiencia
vault. Dura una hora por defecto (10 minutos como mínimo) y se renueva al 80 % de su TTL. - Vault Agent inicia sesión con el token y un rol de Vault.
- Vault valida el token con la API Kubernetes TokenReview. Un token vinculado deja de ser válido cuando caduca o se elimina su Pod.
- Vault comprueba la cuenta de servicio, el namespace y la audiencia con el rol, y devuelve un token con sus políticas.
vault write auth/kubernetes/role/payments \
bound_service_account_names=payments-api \
bound_service_account_namespaces=payments \
audience=vault policies=payments-db token_ttl=1h
El token es una credencial al portador, y la documentación de autenticación Kubernetes de Vault advierte contra compartirlo con otros servicios. Una audiencia dedicada hace que los servicios que comprueban aud lo rechacen.
Los servicios de workload identity de la tabla cambian un token de cuenta de servicio proyectado por credenciales de nube de corta duración, así que no se almacena ninguna clave de nube. GitHub Actions OIDC hace lo mismo para los jobs de despliegue en un pipeline de CI/CD. El JWT authentication flow explica cómo se verifican esos tokens.
Credenciales dinámicas de base de datos
Un secreto dinámico se crea bajo demanda y se destruye cuando termina su lease. Con el motor de secretos de bases de datos de Vault, cada lectura de database/creds/payments crea un nuevo usuario de PostgreSQL:
vault write database/roles/payments db_name=orders \
creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO \"{{name}}\";" \
default_ttl=1h max_ttl=24h
Los leases se pueden renovar hasta max_ttl. Vault Agent renueva los secretos renovables tras dos tercios del lease y vuelve a obtener los secretos con lease no renovables al 90 % de su TTL. Cuando un lease caduca o se revoca, Vault ejecuta las sentencias de revocación, por defecto una sentencia genérica de eliminación de usuario. Sin TTL, se aplica el valor por defecto del sistema de Vault, 768 horas (32 días).
Lo que ganas:
- Un usuario por Pod, de modo que una consulta sospechosa apunta a un lease y no a todos los servicios que comparten una contraseña.
- Las filtraciones caducan, como máximo una hora después de emitirse, salvo que se renueve el lease.
- Respuesta con un comando:
vault lease revoke -prefix database/creds/paymentsrevoca todas las credenciales activas del rol.
Un detalle: VALID UNTIL hace caducar la contraseña, lo que importa al iniciar sesión. Da a las conexiones del pool una vida máxima más corta que el lease (el valor por defecto de HikariCP es de 30 minutos) y recarga las credenciales cuando Vault Agent reescriba el archivo.
Opciones de entrega y sus contrapartidas
| Entrega | Cómo funciona | Valores nuevos | Ojo con |
|---|---|---|---|
| Variables de entorno | Se definen al arrancar el contenedor | Tras un reinicio | Visibles para todos los procesos; se filtran a logs y volcados |
| Kubernetes Secret sincronizado | External Secrets Operator (refresco cada hora por defecto) o Vault Secrets Operator copia los valores en un Secret | Los volúmenes montados se actualizan; las variables de entorno no | Una copia en etcd: activa el cifrado en reposo y un RBAC estricto |
| Sidecar agente | Vault Agent Injector renderiza los secretos en un volumen en memoria en /vault/secrets |
Sí, si la app vuelve a leer el archivo | Un sidecar y un init container en cada Pod |
| Volumen CSI | Secrets Store CSI Driver monta los secretos cuando arranca el Pod | Solo con auto-rotación alpha, desactivada por defecto | La sincronización opcional a un Secret recupera la copia en etcd |
| Llamada de SDK | La app llama a la API del gestor de secretos | Sí, en el código | Autenticación, caché y reintentos en cada servicio |
Para credenciales dinámicas, los archivos renderizados por el agente encajan mejor: el agente gestiona el inicio de sesión, la renovación y el nuevo renderizado. Usa Secrets sincronizados cuando los Helm charts esperen uno o cuando guardes los secretos de un repositorio GitOps como referencias, y el SDK fuera de Kubernetes.
Rotación sin tiempo de inactividad
La rotación tiene una regla: la credencial nueva debe funcionar antes de que la antigua deje de hacerlo.
- Las credenciales dinámicas rotan por diseño, siempre que los consumidores recarguen a tiempo.
- Las contraseñas estáticas de base de datos necesitan un job de rotación. En AWS Secrets Manager, la estrategia de usuario único mantiene las conexiones abiertas pero puede denegar llamadas brevemente, así que los clientes necesitan reintentos; la estrategia de usuarios alternos cambia entre dos usuarios, de modo que un cliente que obtuvo el secreto a mitad de rotación sigue teniendo credenciales válidas. La rotación puede ejecutarse hasta cada cuatro horas.
- Claves de API: despliega la clave nueva, confirma que el tráfico se ha movido y revoca la antigua.
Registros de auditoría y acceso break-glass
Vault envía una entrada por cada solicitud y respuesta a todos los audit devices activados y rechaza las solicitudes que ningún device pueda registrar, por lo que HashiCorp recomienda activar al menos dos. La mayoría de las cadenas se registran como hashes HMAC-SHA256, y /sys/audit-hash calcula el hash de un valor conocido para que puedas buscarlo. Envíalo a tu SIEM y alerta sobre el uso del token raíz y los cambios de política.
El acceso break-glass debe ser aburrido y estar probado:
- Sin token raíz permanente. HashiCorp recomienda los tokens raíz solo para la configuración inicial o emergencias, revocados justo después.
vault operator generate-rootnecesita un quórum de poseedores de claves de unseal o de recuperación. - Conoce tus dependencias duras. Con auto-unseal, las claves de recuperación no pueden descifrar la clave raíz, así que Vault no puede hacer unseal sin su clave de KMS. AWS KMS espera de 7 a 30 días antes de eliminar una clave; alerta en cada eliminación programada.
El diagrama del flujo de secretos
Contenido del diagrama
- Kubernetes API server
- Pod: payments-api
- Projected SA token
- Vault Agent (sidecar)
- App container
- Cloud KMS key
- Vault: auth, policies, leases
- Vault audit log to SIEM
- orders DB (PostgreSQL)
- 1 TokenRequest via kubelet
- read JWT
- 2 login: JWT + role payments
- 3 TokenReview
- 4 read database/creds/payments
- 5 CREATE ROLE ... VALID UNTIL
- 6 render /vault/secrets/db
- 7 connect as the short-lived user (TLS)
- 8 lease ends: DROP ROLE
- at startup: decrypt root key
- every request and response
Cómo leerlo:
- Izquierda: el marco Pod con el token proyectado, el sidecar Vault Agent y la app, bajo el Kubernetes API server.
- Aristas moradas 1 a 3, identidad: TokenRequest (1), login con el rol payments (2), TokenReview (3).
- Aristas turquesa 4 a 7, la credencial: lectura de
database/creds/payments(4),CREATE ROLE ... VALID UNTIL(5), renderizado de/vault/secrets/db(6), conexión por TLS (7). - Arista roja discontinua 8: el lease termina y Vault elimina el usuario.
- Derecha: KMS descifra la clave raíz de Vault al arrancar; el registro de auditoría recibe cada solicitud y respuesta.
- El bloque Markdown lista todas las duraciones.
Cómo dibujar con claridad diagramas de gestión de secretos
- Numera los pasos y coloréalos por fase: identidad, entrega, revocación.
- Escribe duraciones y audiencias en el diagrama. «aud vault, 1h» invita a la revisión; «de corta duración» invita a la discusión.
- Muestra dónde existe el texto plano: memoria, volúmenes en memoria, variables de entorno, etcd.
- Dibuja las rutas de revocación y auditoría, no solo el camino feliz.
- Nunca pongas claves, tokens ni nombres de host internos reales en un diagrama.
- Deja el almacenamiento y los detalles internos del clúster de Vault para un diagrama de operaciones.
El diagrama de flujo de datos de threat modeling añade los límites de confianza, el modelo zero trust muestra el marco de acceso más amplio y el diagrama de arquitectura de Kubernetes cubre el API server y el kubelet.
Constrúyelo en Archboard
- Inicia sesión con Google o GitHub y crea un diagrama.
- Añade un Marco del paquete Básico llamado Pod: payments-api. Dentro, apila un Token del paquete Seguridad y dos nodos Contenedor del paquete Docker: Vault Agent (sidecar) y App container.
- Encima del marco, añade un Clúster de Kubernetes del paquete Nube con la etiqueta Kubernetes API server.
- Añade una Bóveda del paquete Seguridad en el medio. A la derecha, añade un Recurso en la nube del paquete Nube para la clave de KMS, Registros del paquete DevOps para el registro de auditoría y Postgres del paquete Datos.
- Dibuja las aristas 1 a 8 con flechas de bloque (morado para la identidad, turquesa para la credencial, rojo discontinuo para DROP ROLE), además de la arista de arranque hacia la clave de KMS y una arista discontinua hacia el registro de auditoría.
- Añade un bloque Markdown del paquete Básico con las duraciones y dos anotaciones de Texto del paquete Básico para el rol de Vault y el usuario de la base de datos.
La herramienta Kubernetes YAML to diagram convierte manifiestos existentes en un primer borrador. El ejemplo usa 10 nodos de diagrama, dentro del plan Free.
Preguntas frecuentes
¿Cuál es la diferencia entre un gestor de secretos y un KMS? Un KMS guarda claves que nunca salen de él y cifra elementos pequeños como las claves de datos. Un gestor de secretos almacena y emite los propios secretos, como contraseñas y claves de API, a menudo protegidos por un KMS.
¿Están cifrados los Kubernetes Secrets? No por defecto. Activa el cifrado en reposo para etcd, idealmente con el proveedor KMS v2, y restringe el RBAC: cualquiera que pueda crear Pods en un namespace puede leer sus Secrets.
¿Qué son los secretos dinámicos? Credenciales creadas bajo demanda y eliminadas cuando termina su lease, como los usuarios de base de datos de una hora que el motor de secretos de bases de datos de Vault crea por solicitud.
¿Debo pasar los secretos como variables de entorno? Evítalo cuando puedas: todos los procesos del contenedor pueden leerlas, se filtran a logs y volcados de fallos y solo cambian al reiniciar. Los archivos renderizados por el agente son más fáciles de proteger y rotar.
¿Con qué frecuencia deben rotarse los secretos? Las credenciales dinámicas caducan en horas y no necesitan calendario. Rota los secretos estáticos según un calendario y tras cualquier sospecha de exposición o cambio de personal, y prueba la rotación primero en staging.