Qué hacer cuando se hace commit de un secreto en Git
Última actualización
Una respuesta paso a paso a una credencial que acaba en un commit de un repositorio Git: revocarla y rotarla primero, comprobar si se usó, limpiar el historial y evitar que se repita.
En esta página
- Por qué no basta con borrar la línea
- Paso 1: revocar y rotar
- Paso 2: entender el alcance
- Paso 3: comprobar si se usó indebidamente
- Paso 4: limpiar el código y el historial
- Paso 5: corregir la causa
- Paso 6: registrar lo que pasó
- Los secretos y los agentes de programación con IA
- Cómo gestiona AI CodeOps los secretos
Cuando un secreto, como una clave de API, un token, una contraseña o una clave privada, acaba en un commit de un repositorio Git, primero revócalo y rótalo, después averigua a qué podía acceder y si se usó, y luego quítalo del código y, si tu política lo exige, del historial. Borrar la línea en un commit nuevo no sirve por sí solo: Git conserva todas las versiones anteriores, y cada clon, fork y caché de la CI tiene una copia. Trata la credencial como comprometida desde el momento en que se hizo push.
Esta página amplía la sección sobre el escaneo de secretos de ¿Cómo se protege el código generado por IA?.
Por qué no basta con borrar la línea
Un repositorio Git es un historial, no una carpeta. Quitar un secreto en un commit nuevo lo deja en el commit anterior, donde cualquiera con acceso puede leerlo con un solo comando. También hay copias fuera del repositorio:
- el clon de cada desarrollador y cada fork;
- los sistemas de CI que clonaron el repositorio, y sus cachés y sus logs;
- las vistas del propio proveedor de Git del commit y de cualquier pull request que lo contuviera;
- las imágenes de contenedor o los artefactos de build creados a partir de ese commit;
- las copias de seguridad y los mirrors.
Los repositorios públicos los analizan continuamente herramientas automáticas que buscan credenciales, así que, en un repositorio público, da por hecho que el secreto se vio en cuanto se hizo push. En los repositorios privados el público es menor, pero no nulo.
Paso 1: revocar y rotar
La rotación es el único paso que hace inútil el valor filtrado. Hazla primero, antes de cualquier limpieza.
- Emite una credencial de sustitución en el proveedor.
- Despliega la sustitución en todo lo que la usa de forma legítima.
- Revoca la credencial filtrada para que deje de funcionar.
Si el secreto es de alto impacto y la exposición es pública, revócalo de inmediato y acepta una interrupción breve en lugar de dejar expuesta una credencial que funciona mientras despliegas la sustitución. Algunos proveedores detectan sus propias claves en los repositorios públicos y las revocan automáticamente; no te fíes de ello.
Paso 2: entender el alcance
Apunta qué podía hacer la credencial:
- Qué concede. ¿Acceso de solo lectura a un servicio, o acceso de administración a una cuenta en la nube?
- Dónde más se usa. Las credenciales compartidas significan más sistemas que rotar.
- Cuándo quedó expuesta. La hora del commit marca el inicio de la ventana que hay que investigar.
- Quién pudo verla. ¿Público, toda la organización o un equipo? ¿Hubo forks?
Esto determina cuánta investigación necesita el incidente y a quién hay que informar.
Paso 3: comprobar si se usó indebidamente
Mira en los logs de auditoría o de acceso del proveedor la actividad con la credencial durante la ventana de exposición: direcciones IP desconocidas, regiones inesperadas, recursos nuevos, accesos a datos inusuales o picos de uso y de facturación. Si encuentras un uso indebido, esto se ha convertido en un incidente de seguridad con su propia respuesta: contener, investigar a qué se accedió y avisar a quien exijan tus políticas y tus obligaciones.
Paso 4: limpiar el código y el historial
Quita el secreto del código actual y sustitúyelo por una referencia al lugar donde vive ahora el valor: una variable de entorno, un gestor de secretos o un archivo de configuración que no va a ningún commit.
Si además hay que reescribir el historial depende de tu política. Si lo haces:
- Usa una herramienta pensada para ello, como
git filter-repoo BFG Repo-Cleaner. El proyecto Git recomiendagit filter-repoen lugar del antiguogit filter-branch. - Coordínate con todos los que trabajan en el repositorio. Una reescritura cambia los hashes de los commits, así que los clones existentes deben volver a clonarse o restablecerse con cuidado.
- Comprueba qué conserva tu proveedor de Git. Las referencias de los pull requests y las vistas en caché pueden seguir mostrando los commits antiguos; la documentación del proveedor explica cómo pedir que se eliminen.
- Recuerda que los forks y los clones quedan fuera de tu alcance. Por eso la rotación iba primero.
Limpia los logs de la CI y vuelve a construir cualquier artefacto o imagen que contuviera el secreto.
Paso 5: corregir la causa
Averigua cómo llegó el secreto al repositorio, y cierra ese camino.
- Mantén los secretos fuera de los archivos versionados. Los archivos de configuración locales como
.envvan en.gitignore, con un archivo de ejemplo versionado que tenga valores de marcador. - Analiza antes del commit. Los hooks de pre-commit que ejecutan un escáner de secretos, como gitleaks, TruffleHog o detect-secrets, detectan la mayoría de los errores en la máquina del desarrollador.
- Analiza al hacer push. Algunos proveedores de Git ofrecen una protección de push que rechaza los push que contienen una credencial reconocida.
- Analiza el historial una vez. Un análisis puntual de todo el historial encuentra filtraciones antiguas que nadie notó.
- Inyecta las credenciales en el momento del build y de la ejecución. Los jobs de build y de despliegue reciben los secretos de un gestor de secretos o del almacén de secretos del sistema de CI, limitados a los jobs que los necesitan y enmascarados en los logs.
- Prefiere credenciales de corta duración. Cuando los proveedores lo admiten, la identidad de carga de trabajo o los tokens que caducan en minutos limitan el daño de cualquier filtración.
Paso 6: registrar lo que pasó
Escribe un registro breve: qué se filtró, cuándo, cuánto tiempo estuvo expuesto, a qué podía acceder, si se usó, qué se rotó y qué cambió para evitar que se repita. Es útil para las auditorías, y es la mejor forma de notar cuándo el mismo tipo de error se sigue repitiendo.
Los secretos y los agentes de programación con IA
Los agentes de IA añaden nuevas formas de filtrar secretos. Un agente que lee un archivo .env puede copiar una clave real en el código, en datos de prueba o en un ejemplo de configuración. Un agente que recibe una credencial en su prompt o en su contexto puede escribirla en su salida, en los logs o en una petición a un proveedor de modelos. Y los logs de prompts del lado del proveedor pueden contener ahora también el secreto, lo que significa que, otra vez, la respuesta es la rotación y no el borrado.
El control más eficaz es sencillo: los agentes que escriben código nunca deberían tener credenciales de producción en su contexto. Da los secretos al job de build o de despliegue que los necesita, no al agente.
Cómo gestiona AI CodeOps los secretos
AI CodeOps no analiza tus repositorios en busca de secretos; sigue usando un escáner de secretos en tu propio pipeline. Lo que hace es mantener los secretos del espacio de trabajo lejos de los agentes de IA y registrar cómo se gestionan.
- Cifrados y enmascarados. Los secretos del espacio de trabajo se cifran en reposo con AES-256-GCM. Después de guardarlos, la consola solo muestra una máscara.
- Con alcance limitado y rotables. Un secreto se puede limitar a ciertos flujos de trabajo, tener fecha de caducidad, desactivarse o rotarse sin cambiar de sitio, quedando registradas la hora de la rotación y la versión.
- Lejos de los agentes. Los secretos llegan a los jobs de build como variables de entorno, y sus valores se eliminan del log del build. Los agentes de IA nunca los reciben.
- Auditados. Crear, actualizar, activar o desactivar y eliminar un secreto queda registrado en el registro de auditoría. El rol Secret Manager puede gestionar secretos sin ningún otro acceso.
- Cambios revisados. La revisión de hallazgos de cada cambio de la IA cubre la seguridad, y el Security Auditor busca secretos expuestos en los flujos de trabajo que lo incluyen. Una regla de política puede denegar los cambios en rutas como
config/secrets/**.
Consulta Seguridad y SBOM, la entrada del glosario escaneo de secretos y Revisión de seguridad y seguimiento de SBOM para la visión general.
Preguntas frecuentes
¿Basta con borrar el secreto en un commit nuevo?
No. El secreto sigue en el historial del repositorio, en cada clon y en cada fork, y posiblemente en los logs y las cachés de la CI. Revócalo y rótalo; borrarlo del código es un paso de limpieza posterior.
¿Debería reescribir el historial de Git después de filtrar un secreto?
Solo después de revocar el secreto, y solo si tu política lo exige. Una reescritura no llega a los clones ni a los forks que ya existen, y altera el trabajo de todos los que trabajan en el repositorio, así que nunca sustituye a la rotación.
¿Y si el repositorio es privado?
Rótalo igualmente. Todos los que tienen acceso, cada sistema de CI que lo clona, cada fork y cada copia de seguridad tienen ahora el secreto. Que sea privado reduce la exposición; no la elimina.
¿Cómo evito que se hagan commits de secretos?
Mantén los secretos fuera de los archivos que van a commits, analiza antes del commit con un hook de pre-commit, activa la protección de push si tu proveedor de Git la ofrece, e inyecta las credenciales en los jobs de build desde un gestor de secretos en lugar de guardarlas en el repositorio.