Toda aplicación tiene secretos: la contraseña de la base de datos, la clave de la API de pagos, el token de WhatsApp, la credencial del SMTP, el certificado del inicio de sesión con el proveedor de identidad. Y casi toda aplicación empieza guardando esos secretos de la forma más fácil: en el appsettings.json, en un .env commiteado “solo por ahora” o en una variable copiada a mano al servidor. En este artículo explicamos qué es un Secrets Manager (gestor de secretos), cómo funciona, cuáles son las opciones más usadas, como AWS Secrets Manager, Azure Key Vault, Google Secret Manager y HashiCorp Vault, y cuándo vale la pena usar uno.

Qué es un Secrets Manager

Un Secrets Manager es una bóveda centralizada de credenciales. En lugar de que cada servidor, pipeline o desarrollador guarde su propia copia de la contraseña de la base de datos, todos le piden el valor a la bóveda en el momento en que lo necesitan. La bóveda guarda el secreto cifrado, decide quién puede leer cada uno, registra cada acceso y permite cambiar el valor (rotarlo) sin tocar el código.

En la práctica, cambia la pregunta de “¿dónde está la contraseña?” a “¿quién tiene permiso para pedir la contraseña?”. Y la respuesta a esa segunda pregunta es una política que controlas, auditas y revocas en un solo lugar.

El problema que resuelve

Los secretos dispersos son uno de los vectores de ataque más comunes y más baratos de explotar, y el problema está creciendo. El informe State of Secrets Sprawl 2026, de GitGuardian, publicado en marzo, muestra:

  • 28,6 millones de secretos nuevos expuestos en repositorios públicos de GitHub en 2025, un 34% más que el año anterior, el mayor salto registrado;
  • el 64% de los secretos válidos encontrados en 2022 seguía funcionando cuatro años después: quien los filtró, en general, nunca los cambió;
  • los repositorios internos tienen 6 veces más secretos fijos en el código que los públicos, y el 28% de los incidentes ni siquiera pasó por el código: ocurrió en Slack, Jira y Confluence;
  • las claves filtradas de servicios de IA subieron un 81%, a 1,27 millones, y solo los archivos de configuración de servidores MCP publicados en GitHub expusieron más de 24 mil secretos.

Los caminos más comunes:

  • Secreto en el código o en el repositorio. Un .env o appsettings.Production.json commiteado queda en el historial de Git para siempre, aunque el archivo se borre después.
  • Secreto copiado en varios lugares. La misma contraseña en el servidor, en el pipeline de CI, en la laptop de tres desarrolladores y en un mensaje de chat. Nadie sabe cuántas copias existen, así que nadie la cambia.
  • Secreto que nunca cambia. La contraseña de la base creada en el primer deploy sigue igual años después, conocida incluso por quien ya dejó la empresa.
  • Secreto en logs e imágenes Docker. Las variables de entorno aparecen en volcados de error, en docker inspect y en capas de imágenes publicadas por error.
  • Secreto en la configuración de agentes de IA. Archivos como mcp.json y prompts con la clave pegada “para probar” se volvieron una nueva fuente de filtraciones, porque se crean rápido y se commitean sin revisión.

Un Secrets Manager no elimina el secreto, pero lo saca de esos lugares y lo pone en un único punto protegido, con dueño, regla de acceso e historial.

Cómo funciona

Los productos varían, pero todos funcionan de forma parecida:

  1. Almacenamiento cifrado. El secreto se guarda cifrado con una clave maestra mantenida en un servicio de claves (KMS) o en hardware dedicado (HSM). Ni quien administra el almacenamiento lee el valor en texto plano.
  2. Identidad en lugar de contraseña para obtener la contraseña. La aplicación se autentica en la bóveda con la identidad de la propia infraestructura: un IAM Role en AWS, una Managed Identity en Azure, una Service Account en Google Cloud o en Kubernetes. Así no existe “la contraseña de la bóveda” que esconder.
  3. Política de acceso. Cada secreto tiene reglas: la API de producción lee la contraseña de la base de producción, el entorno de pruebas no. El desarrollador puede tener acceso a pruebas y ningún acceso a producción.
  4. Lectura en tiempo de ejecución. La aplicación obtiene el valor al iniciar (o periódicamente) y lo mantiene en memoria. El secreto no queda en disco, en el repositorio ni en la imagen.
  5. Versionado y rotación. Cada cambio genera una nueva versión. Algunos servicios cambian la contraseña en la base y en la bóveda al mismo tiempo, según un calendario que tú defines.
  6. Auditoría. Cada lectura queda registrada (en CloudTrail, Azure Monitor, Cloud Audit Logs): quién la leyó, qué secreto, cuándo y desde dónde.

Secrets Manager vs variable de entorno vs archivo .env

Las variables de entorno son un buen medio de entrega, pero no son un lugar de almacenamiento. La pregunta siempre es: ¿de dónde vino el valor que está en la variable?

.env en el repositorioVariable de entorno manualSecrets Manager
Cifrado en reposoNoDepende del servidorSí
Control de quién leeQuien accede al repositorioQuien accede al servidorPolítica por secreto y por identidad
Registro de accesoNoNoSí, cada lectura
RotaciónManual, en todas partesManual, servidor por servidorCentralizada, a veces automática
Riesgo de filtrarse por GitAltoBajoBajo
CostoCeroCeroCentavos por secreto al mes

El .env sigue siendo excelente para el desarrollo local, con valores falsos o de un entorno desechable, y siempre listado en el .gitignore.

Las opciones más usadas

  • AWS Secrets Manager: la bóveda de AWS, con rotación automática nativa para RDS, Aurora, Redshift y DocumentDB y rotación personalizada vía Lambda. En 2026 sumó los managed external secrets, que rotan sin Lambda las credenciales de 14 servicios de terceros, como Salesforce, Snowflake, Datadog, GitLab, MongoDB Atlas, Databricks y Twilio; eventos en EventBridge en cada cambio de valor; y, desde noviembre, replicación entre cuentas, para mantener una copia sincronizada en una cuenta de recuperación. Cuesta US$ 0,40 por secreto al mes más US$ 0,05 cada 10 mil llamadas. Para configuraciones simples y no sensibles, el SSM Parameter Store es una alternativa más barata.
  • Azure Key Vault: guarda secretos, claves de cifrado y certificados en el mismo servicio, con opción de HSM administrado. Se integra directamente con Managed Identity, App Service, Azure Functions y con el IConfiguration de .NET. Desde la API 2026-02-01, las bóvedas nuevas se crean con Azure RBAC como control de acceso predeterminado en lugar de las antiguas access policies, y las versiones anteriores de la API de administración se retirarán el 27 de febrero de 2027: scripts, plantillas Bicep/Terraform y versiones antiguas de la Azure CLI deben actualizarse antes.
  • Google Secret Manager: secretos versionados, con replicación por región (y, desde junio de 2026, multirregión), integración con IAM y notificación de rotación vía Pub/Sub. La sincronización con Secrets de Kubernetes en GKE pasó a disponibilidad general en abril de 2026, y la rotación automática de contraseñas de Cloud SQL sin código propio está en versión preliminar desde julio.
  • HashiCorp Vault (y su fork abierto OpenBao): corre en cualquier lugar, incluso en tu propia infraestructura. Además de guardar secretos, genera credenciales dinámicas: un usuario de base de datos creado al momento, válido por una hora, que se borra solo. Vault 2.0, lanzado en abril de 2026 ya bajo el ciclo de soporte de IBM, se autentica en AWS, Azure y Google Cloud mediante federación de identidad (OIDC), sin claves fijas. OpenBao, mantenido por la comunidad en la Linux Foundation, sigue siendo la alternativa de código abierto. Más potentes, pero exigen operar y proteger tu propio clúster.
  • Infisical, Doppler y 1Password Secrets Automation: plataformas enfocadas en la experiencia del desarrollador, que sincronizan secretos con Vercel, GitHub Actions, Kubernetes y varias nubes a la vez.

Si ya estás en una nube, su bóveda suele ser la opción más simple: la autenticación por identidad viene lista y el costo es bajo. Vault y las plataformas independientes tienen más sentido con varias nubes, servidores propios o la necesidad de credenciales dinámicas.

En la práctica: .NET con Azure Key Vault

En ASP.NET Core, Key Vault entra como una fuente más del IConfiguration. El código sigue leyendo builder.Configuration["ConnectionStrings:Default"] como siempre, y el valor pasa a venir de la bóveda:

// dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets
// dotnet add package Azure.Identity
using Azure.Identity;

var builder = WebApplication.CreateBuilder(args);

// Managed Identity en Azure; az login / Visual Studio en la maquina del dev
builder.Configuration.AddAzureKeyVault(
    new Uri("https://cpw-produccion.vault.azure.net/"),
    new DefaultAzureCredential());

// el secreto "ConnectionStrings--Default" en la boveda se vuelve "ConnectionStrings:Default" aqui
var conn = builder.Configuration.GetConnectionString("Default");

No hay contraseña de la bóveda en el appsettings.json: DefaultAzureCredential usa la Managed Identity del App Service en producción y el inicio de sesión del desarrollador en la máquina local. Basta con dar a la identidad de la aplicación el rol Key Vault Secrets User en la bóveda correcta. Como RBAC ahora es el predeterminado en bóvedas nuevas, es el camino recomendado; en bóvedas antiguas que aún usan access policies, conviene planificar la migración.

En la práctica: Node.js con AWS Secrets Manager

// npm i @aws-sdk/client-secrets-manager
import { SecretsManagerClient, GetSecretValueCommand } from '@aws-sdk/client-secrets-manager'

const client = new SecretsManagerClient({ region: 'sa-east-1' })

// la credencial viene del IAM Role de Lambda, ECS o EC2, no del codigo
const { SecretString } = await client.send(
  new GetSecretValueCommand({ SecretId: 'produccion/api/base-de-datos' })
)
const { username, password, host } = JSON.parse(SecretString)

Obtén el secreto una vez al iniciar y guárdalo en memoria, o usa una caché con expiración corta. Llamar a la bóveda en cada petición hace la aplicación más lenta y la factura más alta.

Rotación: la función que más se olvida

Guardar bien un secreto que nunca cambia resuelve solo la mitad del problema. La rotación limita el daño de una filtración que todavía no descubriste: si la contraseña filtrada ya se cambió, ya no abre nada.

  • Automática: para bases administradas en AWS, Secrets Manager cambia la contraseña en la base y en la bóveda según un calendario (cada 30 días, por ejemplo), y ahora hace lo mismo con claves de varios SaaS mediante los managed external secrets. En Google Cloud, la rotación administrada de Cloud SQL está en versión preliminar. En Azure, Key Vault avisa cuando un secreto está por vencer y dispara una Function que hace el cambio.
  • Con dos credenciales: para APIs de terceros, mantén dos claves válidas, cambia una a la vez y solo revoca la antigua cuando todas las instancias hayan tomado la nueva.
  • Credenciales dinámicas: con Vault u OpenBao, cada instancia recibe su propia credencial temporal. No existe contraseña compartida que rotar.

Para que la aplicación soporte la rotación, debe volver a leer el secreto cuando una conexión falla por credencial inválida, o recargar la configuración periódicamente. AddAzureKeyVault acepta un ReloadInterval para eso.

Errores comunes

  • Cambiar el secreto por la credencial de la bóveda. Guardar la contraseña en la bóveda y la clave de acceso a la bóveda en el appsettings.json no resuelve nada. Usa identidad administrada (IAM Role, Managed Identity, Workload Identity).
  • Una bóveda para todo. Producción y pruebas en la misma bóveda, con el mismo permiso, rompen la separación de entornos. Usa bóvedas o prefijos separados, con políticas separadas.
  • Permisos amplios. “Leer todos los secretos” para toda la aplicación. Da a cada servicio acceso solo a los secretos que usa.
  • Registrar el valor en el log. Un console.log(config) al iniciar vuelca todo en el log. Nunca imprimas objetos de configuración completos.
  • Olvidar el historial de Git. Mover el secreto a la bóveda no borra la versión antigua commiteada. Un secreto que estuvo alguna vez en el repositorio debe considerarse filtrado y cambiarse, no solo eliminarse. El 64% de claves de 2022 aún válidas muestra cuánto se posterga este paso.
  • Pegar la clave en el chat o en el agente. Una contraseña enviada por Slack, adjunta en Jira o escrita en el mcp.json del asistente de código también es un secreto filtrado. Configura agentes y servidores MCP para leer de la bóveda o de variables de entorno.
  • Bóveda como base de datos. Un Secrets Manager es para credenciales, no para configuración común (URLs, feature flags, límites). Eso va en el appsettings, en Parameter Store o en App Configuration.

Cuándo vale la pena

Vale la pena cuando la aplicación tiene más de un entorno, más de una persona con acceso al deploy o cualquier dato sensible de clientes. Es decir: casi siempre que el sistema está en producción. El costo es bajo (unos pocos dólares al mes para la mayoría de los proyectos) y la implementación, en una aplicación que ya lee la configuración de un solo lugar, suele llevar horas, no semanas.

Para un sitio estático o un prototipo sin datos reales, un .env fuera del repositorio y las variables secretas de la plataforma de hosting (Vercel, GitHub Actions, App Service) ya son un buen comienzo.

Checklist

  • Ningún secreto en el repositorio, ni siquiera en archivos de ejemplo; escaneo de secretos (GitHub Secret Scanning, Gitleaks) activo en el CI
  • Secretos de producción en un Secrets Manager, separados de los de pruebas
  • La aplicación accede a la bóveda con identidad administrada, sin clave fija
  • Cada servicio lee solo los secretos que usa
  • Rotación definida para contraseñas de base de datos y claves de API, con fecha y responsable
  • Logs de acceso a la bóveda activos y alertas para lecturas fuera de lo normal
  • Los secretos que se filtraron o estuvieron en Git fueron cambiados
  • El pipeline de deploy lee de la bóveda o de las variables secretas de la plataforma, nunca de texto en el YAML
  • Configuraciones de agentes de IA y servidores MCP sin claves en texto plano
  • En Azure: scripts y plantillas con la API 2026-02-01 o posterior antes del 27/02/2027, con bóvedas en RBAC

Fuentes

¿Necesitas ayuda?

¿Quieres sacar las contraseñas del código, organizar los secretos de producción en una bóveda o configurar la rotación automática sin detener el sistema? Habla con nosotros: hacemos la migración a AWS Secrets Manager, Azure Key Vault o la herramienta adecuada para tu caso, entorno por entorno.