Gestión de secretos para desarrolladores: Herramientas y prácticas recomendadas para proteger credenciales

Projects

Agrega servicios, genera credenciales y gestiona la facturación desde la CLI, o deja que tu agente lo haga.

Más información 
  1. Introducción
  2. Conclusiones principales
  3. ¿Por qué son importantes las prácticas recomendadas para la gestión de secretos?
  4. ¿Qué tipos de secretos deben proteger los desarrolladores?
  5. ¿Cómo funciona la gestión de secretos?
  6. ¿Cuáles son algunas prácticas recomendadas para la gestión de secretos?
  7. ¿Cuáles son los riesgos de una mala gestión de secretos?
  8. ¿Cómo se aplica la gestión de secretos a los agentes de IA y los flujos de trabajo de desarrollo?
  9. ¿Cómo elegir las herramientas de gestión de secretos adecuadas?
  10. Cómo puede ayudar Stripe Projects

La gestión de secretos es un conjunto de prácticas y sistemas que los desarrolladores utilizan para generar, almacenar, distribuir y retirar credenciales. Algunos ejemplos incluyen una clave de interfaz de programación de aplicaciones (API) dentro de 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 valor determinado, por cuánto tiempo y bajo qué condiciones. La exposición de secretos es un problema cada vez mayor, con casi 24 millones de nuevos secretos codificados de forma rígida añadidos a confirmaciones públicas de GitHub en 2024.

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 aprovisionar claves de API independientes para cada proyecto que cree un desarrollador o equipo.

Conclusiones principales

  • Las claves de la interfaz 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 el registro de auditorías limitan el daño que puede causar un solo secreto expuesto.

  • Las herramientas autónomas que llaman a interfaces de programación de aplicaciones (API) y a la infraestructura necesitan un acceso distinto, con alcance limitado 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 generas, almacenas, distribuyes y retiras las credenciales de las que dependen tus aplicaciones (apps). Una buena gestión de secretos limita el daño de una credencial vulnerada al hacer que su acceso sea claro y fácil de revocar. Una mala gestión de secretos puede permitir que cualquier persona que encuentre un solo valor filtrado acceda a los sistemas de producción.

¿Qué tipos de secretos deben proteger los desarrolladores?

Existen algunas categorías comunes de secretos y cada una funciona de manera ligeramente diferente.

Esto es lo que suele abarcar la gestión de secretos:

  • Claves de interfaz de programación de aplicaciones (API): Autentican tu aplicación ante un servicio de terceros, como un proveedor de servicios de pago o una API de mapas. Por lo general, no vencen 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 tokens web de notación de objetos JavaScript (JSON) contienen los permisos de un usuario o servicio, por lo general con un ciclo de vida más corto que las claves de API. Aparecen en aplicaciones móviles, flujos de inicio de sesión único y llamadas de servicio a servicio.

  • 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, estos 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 shell seguro (SSH) verifican la identidad y protegen las conexiones entre servidores. Los certificados vencidos o almacenados de forma incorrecta causan interrupciones con la misma frecuencia que causan vulnerabilidades.

  • Claves de cifrado: Las claves que cifran datos en reposo o en tránsito son gestionadas por servicios como el servicio de gestión de claves de Amazon Web Services (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: Estas no son secretos por sí solas. Son el mecanismo de entrega que muchas aplicaciones utilizan para extraer secretos en un proceso en ejecución y son una manera fácil de filtrar un valor en un archivo de registros o informe de fallos.

Estos secretos aparecen en diferentes entornos: máquinas de desarrollo local, canalizaciones de integración continua y distribución continua (CI/CD), infraestructura de la nube y sistemas de producción. Un valor bloqueado de forma estricta en un entorno puede quedar totalmente expuesto en otro.

¿Cómo funciona la gestión de secretos?

La gestión de secretos reemplaza los valores codificados de forma rígida con una búsqueda. En lugar de escribir una contraseña de base de datos directamente en tu código, tu aplicación se la solicita a un almacén centralizado en tiempo de ejecución, y dicho almacén decide si la libera.

Las variables de entorno son más simples. 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 base de código, pero no los cifra una vez que ingresan en un contenedor en ejecución. Los sistemas de gestión de la configuración se encuentran 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 el sistema receptor lo maneja después de eso.

Las plataformas centralizadas de gestión de credenciales incorporan rotación, control de versiones y seguimientos de auditoría sobre el 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 identidades y accesos (IAM) o un token de corta duración, y se le otorga una credencial de alcance y tiempo limitados en lugar de una estática. Esto permite que un equipo corte el acceso a un solo servicio sin tener que tocar todas 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 un equipo mantenga a lo largo del tiempo.

Estas prácticas aparecen en casi todos los marcos rigurosos:

  • Otorga acceso con el menor privilegio: Dale a cada servicio o persona solo los secretos específicos que necesiten, limitados a entornos y acciones determinados. Una canalización de integración continua (CI) que se implementa en un entorno de pruebas nunca debe tener las mismas credenciales que una que se implementa en producción.

  • Rota los secretos de forma programada: Las claves de API y las contraseñas de bases de datos de larga duración deben rotar con regularidad e inmediatamente después de la salida de cualquier empleado o sospecha de exposición. La rotación automatizada elimina la excusa de omitirla.

  • Establece el vencimiento en los tokens: Los tokens de corta duración que vencen en minutos u horas limitan el margen de daño si uno se filtra. Los tokens de acceso de OAuth se suelen emparejar con tokens de actualización de mayor duración en lugar de un único valor estático.

  • Registra todas las solicitudes de acceso: Los registros de auditoría deben documentar qué identidad accedió a qué secreto, cuándo y desde dónde. De esta manera, puedes responder si una credencial se vio comprometida durante un incidente en lugar de adivinar.

  • Separa los secretos por entorno: El desarrollo, las pruebas y la producción deben tener sus propias credenciales almacenadas en sus bóvedas o espacios de nombres individuales. Una contraseña de base de datos de prueba nunca debe funcionar en la base de datos de producción.

  • Comparte secretos a través de la bóveda, no mediante chat ni correo electrónico: Pegar una credencial en Slack o en un ticket de soporte la pone en un sistema que no fue diseñado para protegerla. En cambio, muchas plataformas de gestión de secretos admiten enlaces para compartir temporales y revocables.

  • Busca credenciales expuestas en cada confirmación: Los escáneres como el escaneo de secretos de GitHub, TruffleHog y Gitleaks revisan las confirmaciones y las solicitudes de extracción en busca de exposiciones accidentales de credenciales antes o justo después de una fusión.

  • Elimina los secretos filtrados del historial de versiones: Revoca la credencial expuesta primero, ya que eliminarla del historial de git no ayuda si el valor anterior aún funciona. Herramientas como git filter-repo o BFG Repo-Cleaner pueden luego quitarla de las confirmaciones pasadas, aunque cualquiera que haya clonado el repositorio antes todavía tiene una copia.

¿Cuáles son los riesgos de una mala gestión de secretos?

La investigación anual de GitGuardian sobre confirmaciones públicas de GitHub reveló que el 15 % de los autores de confirmaciones filtraron un secreto en 2024. El riesgo inmediato es el acceso no autorizado. Se puede encontrar una credencial de base de datos filtrada y los escáneres automatizados pueden buscar en repositorios públicos a los pocos minutos de un envío.

Más allá de la exposición inicial, una clave robada que pasa desapercibida puede permanecer activa durante meses, ya que muchas empresas tienen un proceso para detectar fallos de inicio de sesión, pero no uno para detectar el uso no autorizado de una credencial que es técnicamente válida. Un atacante que ingresa de esta manera no necesita eludir la autenticación en absoluto; ya la tiene.

Una mala gestión de secretos también crea un riesgo que no tiene nada que ver con un criminal. Los certificados vencidos causan interrupciones. Las credenciales rotadas que no se actualizaron en todas partes interrumpen las integraciones en momentos aleatorios. Además, los equipos que comparten secretos de manera informal, a través de correo electrónico o un documento compartido, pueden perder el control de quién tiene acceso realmente.

¿Cómo se aplica la gestión de secretos a los agentes de IA y los flujos de trabajo de desarrollo?

Los agentes de codificación de IA cambian el cálculo porque a menudo necesitan credenciales reales para realizar el 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 definida puede causar daño en varios sistemas antes de que alguien se dé cuenta.

Ese riesgo crece con la cantidad de herramientas a las que un agente puede llamar. Un agente conectado a una API de pagos, a un proveedor de la nube y a un sistema interno de tickets necesita credenciales distintas y con alcance limitado para cada uno, no un solo conjunto de permisos amplios que lo cubra todo. Sin esa separación, una sola sesión de agente vulnerada puede tener un impacto mucho mayor de lo previsto.

Stripe Projects soluciona parte de esto para los desarrolladores que crean soluciones en Stripe. Puede aprovisionar claves de API independientes para cada proyecto que cree un desarrollador o equipo, limitadas a los datos y al entorno de ese proyecto. Una clave que utiliza un agente o aplicación no conlleva el acceso a otro. Stripe Projects se encarga del aprovisionamiento, el almacenamiento de credenciales y la facturación para servicios de infraestructura de terceros.

¿Cómo elegir las herramientas de gestión de secretos adecuadas?

La elección correcta depende de tu infraestructura.

Algunas preguntas reducen la lista rápidamente:

  • ¿Se integra con tu proveedor de identidades? Un sistema que no se puede autenticar con tu configuración existente de gestión de identidades y accesos (IAM) o de inicio de sesión único (SSO) añade un segundo sistema de identidades que gestionar. Por lo general, esto significa un control de acceso más débil.

  • ¿Admite la rotación automatizada para los servicios que usas? La rotación nativa para bases de datos comunes y servicios en la nube ahorra el trabajo manual de crear y mantener scripts de rotación por tu cuenta.

  • ¿Puede aplicar credenciales de corta duración y con alcance limitado? Los secretos estáticos de larga duración son el patrón del que intentas alejarte. Un sistema que solo almacena valores sin emitir otros dinámicos resuelve la mitad del problema.

  • ¿Produce registros de auditoría que realmente puedas usar? Los registros que documentan el acceso sin el detalle suficiente para reconstruir un incidente no ayudan mucho cuando los necesitas.

  • ¿Cómo maneja los secretos que necesitan tus herramientas de IA? Si los agentes o los flujos de trabajo automatizados solicitan credenciales, verifica si el sistema puede limitar su alcance y hacer que venzan de forma independiente 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).

Stripe Projects te ayuda a:

  • Aprovisionar servicios de terceros desde la línea de comandos: Usa un solo flujo de trabajo para agregar servicios, administrar credenciales y actualizar planes, en lugar de usar herramientas y flujos de trabajo diferentes para cada proveedor. Administra el alojamiento, las bases de datos, la autorización, la IA y mucho más sin necesitar dashboards, archivos de configuración ni código de infraestructura.

  • Sincronizar credenciales automáticamente: Mantén las variables de entorno portables entre configuraciones locales, máquinas, compañeros de equipo y agentes — sin copiar y pegar claves de la interfaz de programación de aplicaciones (API).

  • Administrar la facturación desde la CLI o tu agente de programación: Configura los datos de facturación una vez y compártelos de forma segura con servicios de terceros. Sube y baja de nivel, monitorea el consumo y administra 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, adecuación o vigencia de la información incluida en el artículo. Si necesitas asistencia para tu situación particular, te recomendamos consultar a un abogado o un contador competente con licencia para ejercer en tu jurisdicción.

Más artículos

  • Hubo un problema. Vuelve a intentarlo o comunícate con soporte.

¿Todo listo para empezar?

Crea una cuenta y empieza a aceptar pagos sin necesidad de firmar contratos ni proporcionar datos bancarios. Si lo prefieres, puedes ponerte en contacto con nosotros para que diseñemos un paquete personalizado para tu empresa.
Payments

Payments

Acepta pagos en línea y en persona desde cualquier parte del mundo con una solución de pagos diseñada para todo tipo de negocios.

Documentación de Payments

Encuentra una guía para integrar las API de pagos de Stripe.