Nivel inicial13 min de lectura · Revisado el

Secretos en Git: cómo no filtrar claves, también con IA

Secretos en Git: una llave tachada en el último commit, pero la misma llave sigue visible en el commit anterior de la historia. Secretos en Gitrubentejera.com 05e6a64HEAD Sigue en la historiaBorrada del código
Quitar la clave del último commit no la quita del anterior: la historia la sigue guardando.

El 5 de noviembre de 2026, Microsoft Threat Intelligence publicó que unos atacantes usan marcos de pruebas de penetración con agentes de IA, entre ellos uno llamado ARTEX, para buscar claves en repositorios públicos de GitHub y usarlas. En un caso observado, según el informe, un agente de IA pasó de buscar secretos en GitHub a sacar datos de Azure Key Vault en cinco minutos.

Un secreto en Git es una clave de API, una contraseña o un certificado que acaba guardado en un commit. El problema no es solo que esté en el código hoy: Git guarda todas las versiones, así que una clave que se sube una vez queda en la historia aunque la borres en el commit siguiente. Este artículo explica, con pruebas ejecutadas, por qué borrar una clave no basta, qué barreras la paran antes de que salga, qué hacer si ya la subiste y qué cambia cuando quien hace los commits es un agente de IA. Es la idea de la IA Limpia: la IA acelera lo que ya hay, también los descuidos.

Un símil: la llave fotocopiada

Imagina que dejas la llave de casa un rato en el mostrador de una copistería y alguien la fotocopia. Después te la guardas en el bolsillo. Ya no está en el mostrador, pero la copia existe, y no sabes quién la tiene. Lo único que te protege de verdad es cambiar la cerradura.

Un secreto en un commit funciona igual: quitarlo del código es guardarse la llave; la historia de Git es la fotocopia; rotar la clave es cambiar la cerradura. El símil se queda corto en una cosa: una fotocopia de una llave hay que llevarla a la puerta. Una clave filtrada se prueba desde cualquier sitio, y los atacantes lo automatizan.

Por qué borrar la clave no basta

Una prueba: un proyecto con una clave de pago escrita en el código. Es falsa y usa un prefijo inventado, tienda_test_, para no parecerse a la de ningún proveedor real.

// pago.mjs, primer commit
const CLAVE = 'tienda_test_51Falsa0000';

En el commit siguiente, alguien se da cuenta y la cambia por una variable de entorno:

// pago.mjs, segundo commit
const CLAVE = process.env.CLAVE_PAGOS;

En el código ya no está, pero la historia la recuerda. git log -S busca los commits en los que aparece o desaparece un texto (salida resumida):

git log -p -S tienda_test --format='%h %s'
c6def95 Lee la clave del entorno
-const CLAVE = 'tienda_test_51Falsa0000';
05e6a64 Cobro con la pasarela
+const CLAVE = 'tienda_test_51Falsa0000';

Ese es el trabajo que automatizan los atacantes, con grandes volúmenes de búsquedas en GitHub según el informe de Microsoft. Por eso el propio informe pide tratar como comprometida cualquier credencial expuesta y rotarla, aunque el contenido original se haya borrado.

Las barreras, de la más temprana a la última

1. El secreto, fuera del código

La clave va en una variable de entorno o en un gestor de secretos, nunca en el código. Si usas un fichero .env en local, tiene que estar en .gitignore desde el primer commit (mejor .env* con una excepción !.env.example, para cubrir también .env.local o .env.production), y git check-ignore -v .env confirma que Git no lo va a subir. Conviene dejar además un .env.example con los nombres de las variables y sin valores, para que quien clone el proyecto sepa qué necesita.

Mejor aún que guardar bien una clave es no necesitarla: Microsoft recomienda las identidades gestionadas de la nube, y en la integración continua hay credenciales temporales que no dejan nada que filtrar.

2. Un hook que bloquea el commit

Un hook pre-commit es un programa que Git ejecuta antes de cada commit y que puede pararlo. Este, en Node.js y sin dependencias, busca en lo que vas a guardar líneas que parecen claves:

#!/usr/bin/env node
// .githooks/pre-commit
// Para el commit si lo preparado
// parece llevar un secreto.
const { execFileSync } =
  process.getBuiltinModule('node:child_process');

const PATRONES = [
  /tienda_(test|live)_[0-9a-zA-Z]{10,}/,
  /AKIA[0-9A-Z]{16}/,
  /-----BEGIN [A-Z ]*PRIVATE KEY/,
];
const AVISO =
  'Commit bloqueado: parece un secreto.';

const diff = execFileSync('git', [
  'diff', '--cached', '-U0',
  '--no-color', '--no-ext-diff',
], { encoding: 'utf8', maxBuffer: 1024 ** 3 });

const sospechosas = diff.split('\n')
  .filter((l) => l.startsWith('+'))
  .filter((l) => !l.startsWith('+++ '))
  .filter((l) =>
    PATRONES.some((p) => p.test(l)));

if (sospechosas.length > 0) {
  console.error(AVISO);
  for (const l of sospechosas) {
    console.error('  ' + l);
  }
  process.exit(1);
}

Usa process.getBuiltinModule en lugar de import para que funcione aunque el package.json del proyecto diga "type": "commonjs", y pide el diff sin color para que nada lo esconda. Se activa en cada clon apuntando Git a la carpeta de hooks; es configuración local, así que quien clone el proyecto tiene que ejecutarlo también:

chmod +x .githooks/pre-commit
git config core.hooksPath .githooks

Y al intentar guardar una clave:

git commit -m "Clave de respaldo"
Commit bloqueado: parece un secreto.
  +const RESPALDO = 'tienda_live_51Otra00000';

Es un ejemplo: tres patrones no cubren todos los tipos de claves. Para un proyecto real hay herramientas con cientos de patrones (las tienes más abajo). Un hook local, además, se puede saltar con git commit --no-verify, y core.hooksPath hay que activarlo en cada clon, así que hace falta una barrera más allá de tu máquina.

No confundas este hook de Git, que para cualquier commit, tuyo o del agente, con los hooks de Claude Code, que se ejecutan antes de cada acción del agente. Hay un ejemplo de estos que bloquea un commit con un .env en el artículo sobre AGENTS.md y CLAUDE.md.

3. Escaneo en la integración continua

La barrera que no depende de que nadie active nada en su máquina es la integración continua: una herramienta que revisa cada push y cada pull request, y que puede revisar también la historia entera. Funciona igual en repositorios públicos y privados.

4. Secret scanning y push protection en GitHub

GitHub detecta secretos conocidos (secret scanning) y puede bloquear el git push que los lleva (push protection). Según su documentación:

  • La push protection de usuario viene activada por defecto en GitHub.com y te impide subir secretos a repositorios públicos.
  • La de cada repositorio viene desactivada; la activa quien administra el repositorio o la organización, y requiere GitHub Secret Protection, que en repositorios privados es de pago.
  • Se puede saltar dando un motivo; en un repositorio con la protección activa, eso deja una alerta y un registro.

Detecta los formatos de clave que GitHub conoce: una contraseña sin formato propio puede pasar.

Herramientas para detectar secretos

Herramienta Dónde se usa
TruffleHog En local, en la CI y sobre la historia; según su README, clasifica más de 800 tipos de secretos
gitleaks Como hook, en la CI y sobre la historia; su README dice que ya solo recibe parches de seguridad
Secret scanning de GitHub En el servidor, sobre los repositorios de GitHub

No se han ejecutado aquí: instalarlas requiere descargarlas.

Qué hacer si ya subiste una clave

  1. Rótala primero. Revoca la clave en el servicio y crea otra. Es lo que piden Microsoft y GitHub: mientras no la rotes, sigue funcionando.

  2. Sácala del código y pásala a una variable de entorno o a un gestor de secretos.

  3. Si era un fichero, como .env, sácalo de Git sin borrarlo de tu disco y añádelo a .gitignore [SIN EJECUTAR]:

    git rm --cached .env
    echo ".env" >> .gitignore
  4. Si hace falta, reescribe la historia. La guía de GitHub usa git filter-repo, que se instala aparte de Git, y avisa de sus límites: no llega a los clones de otras personas ni a los forks, las vistas en caché de GitHub solo las quita su soporte, y alguien con un clon antiguo puede volver a subir la clave. Por eso el paso 1 va primero.

Qué cambia cuando programa un agente de IA

Esta sección es interpretación nuestra, salvo donde se cita una fuente.

Hay un dato, con matices. GitGuardian, que vende detección de secretos, analizó los commits públicos de GitHub de 2025 en «The State of Secrets Sprawl 2026» (17 de marzo de 2026): los hechos con ayuda de Claude Code filtraron secretos en el 3,2 % de los casos, frente al 1,5 % del total. La propia empresa avisa de que no debe leerse como un fallo de la herramienta, porque quien acepta, edita y sube el cambio sigue siendo una persona. Es una correlación, no una causa, y su informe no explica cómo identificó esos commits.

Un agente de IA no filtra secretos a propósito, pero tiene todo lo necesario para hacerlo por descuido:

  • Lee el .env sin preguntarte. En Claude Code, leer ficheros de la carpeta del proyecto no pide permiso por defecto, y cat está entre los comandos que se ejecutan sin confirmación. Si no quieres que lo lea, tienes que prohibirlo tú.
  • Copia valores reales a un test, un ejemplo o un fichero de configuración, porque es lo que «funciona».
  • Configura servidores MCP con la clave dentro. Muchas guías piden pegarla en el fichero de configuración, que acaba en el repositorio; el mismo informe de GitGuardian encontró 24.008 secretos en ficheros de configuración de MCP públicos. En Claude Code, .mcp.json puede leerla del entorno con ${VARIABLE}. Más sobre MCP en qué es MCP.
  • Hace commit en segundos, a menudo de muchos ficheros a la vez, y el cambio se revisa con prisa.
  • Puede saltarse el hook con git commit --no-verify si algo le falla. Por eso hace falta la barrera de la CI y la del servidor.

Por eso las barreras tienen que ser automáticas, no instrucciones. Un «no subas claves» en el fichero de instrucciones del agente ayuda, pero el hook, la CI y la push protection paran el commit aunque el agente no lo lea. En Claude Code, además, se puede impedir que lea los ficheros de secretos con reglas de permisos deny, con la sintaxis de su documentación de permisos:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

Sin ejecutar: es la sintaxis de la documentación. Según esa página, la regla frena a las herramientas de lectura y también a comandos que nombran el fichero, como cat .env. No frena lo que lo lee sin nombrarlo, como un grep -r desde la carpeta o un script que abra el fichero por su cuenta; para eso está la sandbox, que pone el límite en el sistema operativo. Y si el agente procesa contenido no confiable y puede hacer peticiones de red, una inyección de prompt puede pedirle que envíe la clave fuera.

Al revisar lo que entrega el agente, busca valores que parezcan claves en tests, ejemplos y configuración: es uno de los puntos de la checklist para revisar código generado por IA.

Errores frecuentes

  • Borrar la clave en un commit nuevo y darlo por resuelto. Sigue en la historia, y sigue funcionando hasta que se rota.
  • Añadir .env al .gitignore después de subirlo. .gitignore no saca de Git lo que ya está guardado: hay que quitarlo con git rm --cached .env y, como ya está en la historia, rotar lo que contenga.
  • Confiar solo en el hook local. Se salta con --no-verify y no existe en el equipo de otra persona ni en el de un agente que trabaje en otra máquina.
  • Claves de producción en entornos de pruebas. Si el entorno de pruebas se filtra, se filtra producción.
  • Dejar al agente leer los secretos «para depurar». Lo que lee puede acabar en su respuesta, en un test o en un commit.

Límites

  • El hook del ejemplo es mínimo. Busca tres patrones; no sustituye a una herramienta mantenida ni a la detección de GitHub.
  • Los hechos de ARTEX y los datos de GitGuardian son de quien los publica. Microsoft habla de su propia investigación, y GitGuardian vende detección de secretos.
  • No se han ejecutado gitleaks, TruffleHog ni la regla de permisos. Se citan por su documentación.

Tu siguiente paso

Busca hoy en la historia de tu proyecto, no solo en el código. -G acepta una expresión regular, así que puedes buscar varios prefijos a la vez (cámbialos por los de tus claves):

git log -p --all \
  -G 'tienda_(test|live)_|AKIA|ghp_' \
  --format='%h %s'

--all revisa todas las ramas, no solo la actual.

Si aparece alguna, rótala antes de nada. Después, añade un hook o una herramienta como TruffleHog en la CI para que no vuelva a entrar, y activa la push protection en el repositorio.

Si decides cómo trabaja tu equipo con agentes, pon barreras que no dependan de que alguien se acuerde: el hook versionado en el repositorio y activado en cada clon, escaneo de secretos en la integración continua, push protection activada y reglas que impidan al agente leer los ficheros de secretos. El hook local es la primera ayuda, no la garantía.

Fuentes

Consultadas el 21 de noviembre de 2026.

Código: ejecutado el 21 de noviembre de 2026 con Git 2.53.0 (en inglés) y Node.js 24.21.0, en un repositorio de prueba con claves falsas de prefijo inventado. El hook se probó con y sin "type": "commonjs" en el package.json y con el color de Git forzado. Los comandos con .env y la regla de permisos no se han ejecutado.