La gestión de secretos es un conjunto de prácticas y sistemas que utilizan los desarrolladores para generar, almacenar, distribuir y retirar credenciales. Algunos ejemplos son una API key en una función sin servidor o una contraseña de base de datos en un grupo de conexiones. La gestión de secretos limita quién y qué puede leer un determinado valor, durante cuánto tiempo y en qué condiciones. La exposición de secretos es un problema cada vez mayor, ya que en 2024 se añadieron casi 24 millones de nuevos secretos codificados a los commits públicos de GitHub.
A continuación, analizaremos los tipos de secretos que gestionan los desarrolladores, cómo funcionan el almacenamiento y el acceso, y cómo Stripe Projects puede ayudar a proporcionar API keys independientes para cada proyecto que cree un desarrollador o un equipo.
De un vistazo:
Las API keys de las interfaces de programación de aplicaciones (API), los tokens de acceso, las credenciales de bases de datos, los certificados y las claves de cifrado conllevan sus propios riesgos y ciclos de vida.
Las credenciales con alcance limitado, la rotación programada y los registros de auditoría limitan el daño que puede causar la exposición de un solo secreto.
Las herramientas autónomas que llaman a las interfaces de programación de aplicaciones (API) y a la infraestructura necesitan un acceso distinto, delimitado y revocable en lugar de permisos de cuenta amplios.
¿Por qué son importantes las prácticas recomendadas para la gestión de secretos?
La gestión de secretos abarca cómo se generan, almacenan, distribuyen y retiran las credenciales de las que dependen tus aplicaciones (apps). Una buena gestión de secretos limita los daños causados por una credencial vulnerada, ya que hace que su acceso sea claro y fácil de revocar. Una mala gestión de secretos puede permitir que cualquiera que encuentre un solo valor filtrado acceda a los sistemas de producción.
¿Qué tipos de secretos deben proteger los desarrolladores?
Hay varias categorías comunes de secretos y cada una de ellas funciona de forma ligeramente distinta.
Por lo general, la gestión de secretos abarca los siguientes aspectos:
API keys de la interfaz de programación de aplicaciones (API): Autentican tu aplicación en un servicio de terceros, como un proveedor de servicios de pago o una API de mapas. Por lo general, no caducan por sí solas, por lo que una clave filtrada suele otorgar acceso completo a la cuenta hasta que alguien la revoca manualmente.
Tokens de acceso: Los tokens de acceso de autorización abierta (OAuth) y los JSON Web Tokens (JWT) transmiten los permisos de un usuario o servicio, normalmente con una vida útil más corta que las API keys. Aparecen en aplicaciones móviles, flujos de inicio de sesión único y llamadas entre servicios.
Credenciales de bases de datos: Los nombres de usuario, las contraseñas y las cadenas de conexión para sistemas como PostgreSQL, MySQL o MongoDB se encuentran en archivos de configuración y grupos de conexiones. A menudo, se duplican en varios entornos a la vez.
Certificados y claves privadas: Los certificados de seguridad de la capa de transporte (TLS) y las claves de Secure Shell (SSH) verifican la identidad y protegen las conexiones entre servidores. Los certificados caducados o almacenados incorrectamente provocan interrupciones con la misma frecuencia que las brechas de seguridad.
Claves de cifrado: Las claves que cifran los datos en reposo o en tránsito las gestionan servicios como Amazon Web Services Key Management Service (AWS KMS) o el motor de tránsito de HashiCorp Vault. Perder una puede significar perder el acceso a los datos que protege.
Variables de entorno: No son secretos por sí solas. Son el mecanismo de entrega que utilizan muchas aplicaciones para incorporar secretos a un proceso en ejecución y son una forma fácil de filtrar un valor en un archivo de logs o en un informe de fallos.
Estos secretos aparecen en diferentes entornos: máquinas de desarrollo local, procesos de integración continua y entrega continua (CI/CD), infraestructura en la nube y sistemas de producción. Un valor estrictamente bloqueado en un entorno puede quedar totalmente expuesto en otro.
¿Cómo funciona la gestión de secretos?
La gestión de secretos sustituye los valores codificados por una búsqueda. En lugar de escribir una contraseña de base de datos directamente en el código, tu aplicación la solicita a un almacén centralizado en tiempo de ejecución y este almacén decide si la proporciona.
Las variables de entorno son más sencillas. Los sistemas de orquestación de contenedores te permiten inyectar secretos como variables de entorno o archivos montados en el momento de la implementación, lo que los mantiene fuera de tu código base, pero no los cifra una vez que se encuentran dentro de un contenedor en ejecución. Los sistemas de gestión de la configuración se sitúan en un punto intermedio: protegen un secreto en tránsito y dentro de tu repositorio de configuración, pero sigues siendo responsable de cómo lo gestiona el sistema receptor a partir de ese momento.
Las plataformas centralizadas de gestión de credenciales incorporan la rotación, el control de versiones y los registros de auditoría además del almacenamiento. Cuando tu código necesita un secreto, se autentica en la plataforma a través de una cuenta de servicio, una función de gestión de acceso e identidad (IAM) o un token de corta duración, y recibe una credencial delimitada y con límite de tiempo en lugar de una estática. Esto permite a un equipo cortar el acceso a un solo servicio sin modificar las demás credenciales del sistema.
¿Cuáles son algunas prácticas recomendadas para la gestión de secretos?
Una buena gestión de secretos depende de los hábitos que mantenga un equipo a lo largo del tiempo.
Estas prácticas están presentes en casi todos los marcos de referencia rigurosos:
Otorga acceso con privilegios mínimos: Proporciona a cada servicio o persona solo los secretos específicos que necesitan, limitados a entornos y acciones concretos. Un proceso de integración continua (CI) que se implementa en el entorno de pruebas nunca debe tener las mismas credenciales que uno que se implementa en producción.
Programa la rotación de los secretos: Las API keys y las contraseñas de las bases de datos de larga duración deben rotarse periódicamente y de forma inmediata tras la salida de cualquier empleado o ante una posible exposición. La rotación automatizada elimina la excusa para no hacerlo.
Establece la caducidad de los tokens: Los tokens de corta duración que caducan en minutos u horas limitan el margen de daños en caso de que se filtre uno. Los tokens de acceso OAuth se suelen emparejar con tokens de actualización de mayor duración en lugar de con un único valor estático.
Registra todas las peticiones de acceso: Los logs de auditoría deben documentar qué identidad accedió a qué secreto, cuándo y desde dónde. De ese modo, puedes saber si una credencial se ha visto comprometida durante un incidente en lugar de tener que adivinarlo.
Separa los secretos por entorno: Los entornos de desarrollo, de pruebas y de producción deben tener sus propias credenciales almacenadas en sus almacenes o espacios de nombres individuales. Una contraseña de base de datos de prueba nunca debería funcionar en la base de datos de producción.
Comparte los secretos a través del almacén, no por chat ni por correo electrónico: Si pegas una credencial en Slack o en un ticket de soporte, la estarías introduciendo en un sistema que no se ha diseñado para protegerla. En su lugar, muchas plataformas de gestión de secretos aceptan enlaces para compartir de forma temporal y revocable.
Busca credenciales expuestas en cada commit: Los escáneres como GitHub secret scanning, TruffleHog y Gitleaks comprueban los commits y las peticiones pull en busca de exposiciones accidentales de credenciales antes o justo después de una fusión.
Elimina los secretos filtrados del historial de versiones: Primero, revoca la credencial expuesta, ya que eliminarla del historial de git no sirve de nada si el valor antiguo sigue funcionando. Herramientas como git filter-repo o BFG Repo-Cleaner pueden entonces eliminarla de commits anteriores, aunque cualquiera que haya clonado el repositorio antes seguirá teniendo una copia.
¿Cuáles son los riesgos de una mala gestión de secretos?
La investigación anual de GitGuardian sobre commits públicos de GitHub ha revelado que el 15 % de los autores de commits filtraron un secreto en 2024. El riesgo inmediato es el acceso no autorizado. Las credenciales de bases de datos filtradas se pueden encontrar, y los escáneres automatizados pueden buscar en repositorios públicos en cuestión de minutos tras un push.
Más allá de la exposición inicial, una clave robada que pase desapercibida puede permanecer activa durante meses, ya que muchas empresas tienen un proceso para detectar los fallos de inicio de sesión, pero no para detectar el uso no autorizado de una credencial que, desde el punto de vista técnico, es válida. Un atacante que entra de esta forma no necesita omitir la autenticación en absoluto, porque ya la tiene.
Una mala gestión de secretos también genera riesgos que no tienen nada que ver con los delincuentes. Los certificados caducados provocan interrupciones. Las credenciales rotadas que no se han actualizado en todas partes rompen las integraciones en momentos aleatorios. Además, los equipos que comparten secretos de forma informal, por correo electrónico o en un documento compartido, pueden perder la noción de quién tiene acceso realmente.
¿Cómo se aplica la gestión de secretos a los agentes de IA y a los flujos de trabajo de desarrollo?
Los agentes de programación de IA cambian los cálculos porque a menudo necesitan credenciales reales para hacer un trabajo real, como llamar a una API, consultar una base de datos o implementar código. Un agente ejecuta instrucciones a la velocidad de la máquina, por lo que una credencial mal delimitada puede causar daños en varios sistemas antes de que nadie se dé cuenta.
Ese riesgo aumenta con el número de herramientas a las que puede llamar un agente. Un agente conectado a una API de pagos, un proveedor de la nube y un sistema interno de tickets necesita credenciales distintas y delimitadas para cada uno de ellos, y no un único conjunto de permisos amplios que lo abarque todo. Sin esa separación, una sola sesión comprometida de un agente puede tener un impacto mucho mayor de lo previsto.
Stripe Projects soluciona parte de este problema para los desarrolladores que trabajan en Stripe. Puede proporcionar API keys independientes para cada proyecto que cree un desarrollador o equipo, delimitadas a los datos y el entorno de ese proyecto. Una clave que utiliza un agente o una aplicación no da acceso a otros. Stripe Projects se encarga del aprovisionamiento, el almacenamiento de credenciales y la facturación de los servicios de infraestructura de terceros.
¿Cómo elegir las herramientas de gestión de secretos adecuadas?
La elección adecuada depende de tu infraestructura.
Las siguientes preguntas permiten acotar la lista rápidamente:
¿Se integra con tu proveedor de identidades? Un sistema que no se puede autenticar con tu configuración actual de gestión de acceso e identidad (IAM) o de inicio de sesión único (SSO) añade un segundo sistema de identidad que gestionar. Por lo general, esto implica un control de acceso más deficiente.
¿Acepta la rotación automatizada para los servicios que utilizas? La rotación nativa para bases de datos comunes y servicios en la nube ahorra el trabajo manual de crear y mantener tus propios scripts de rotación.
¿Puede aplicar credenciales de corta duración y delimitadas? Los secretos estáticos y de larga duración son el modelo que intentas evitar. Un sistema que solo almacena valores sin emitir otros dinámicos resuelve la mitad del problema.
¿Produce logs de auditoría que puedas usar de verdad? Los logs que documentan el acceso sin el detalle suficiente para reconstruir un incidente no sirven de mucho cuando los necesitas.
¿Cómo gestiona los secretos que necesitan tus herramientas de IA? Si los agentes o los flujos de trabajo automatizados hacen peticiones de credenciales, comprueba si el sistema puede delimitarlas y hacer que caduquen de forma separada del acceso humano.
Cómo puede ayudar Stripe Projects
Stripe Projects permite a los desarrolladores y a sus agentes de IA añadir servicios, generar credenciales y gestionar la facturación desde la interfaz de línea de comandos (CLI).
Esto es lo que puedes conseguir con Stripe Projects:
Aprovisiona servicios de terceros desde la línea de comandos: Usa un único flujo de trabajo para añadir servicios, gestionar credenciales y actualizar planes, en lugar de usar herramientas y flujos de trabajo diferentes para cada proveedor. Gestiona el alojamiento, las bases de datos, la autorización, la IA y mucho más sin necesidad de usar dashboards, archivos de configuración o código de infraestructura.
Sincroniza las credenciales automáticamente: Mantén la portabilidad de las variables de entorno entre configuraciones locales, equipos, compañeros y agentes, sin necesidad de copiar y pegar claves de API.
Gestiona la facturación desde la CLI o tu agente de programación: Configura los datos de facturación una sola vez y compártelos de forma segura con servicios de terceros. Sube y baja de categoría, monitoriza el consumo y gestiona las suscripciones desde la CLI.
Obtén más información sobre cómo Stripe Projects ayuda a simplificar el aprovisionamiento de aplicaciones o copia y pega este comando en tu terminal para empezar hoy mismo:
brew install stripe/stripe-cli/stripe && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
El contenido de este artículo tiene solo fines informativos y educativos generales y no debe interpretarse como asesoramiento legal o fiscal. Stripe no garantiza la exactitud, la integridad, la adecuación o la vigencia de la información incluida en el artículo. Busca un abogado o un asesor fiscal profesional y con licencia para ejercer en tu jurisdicción si necesitas asesoramiento para tu situación particular.