Alta

GitPython valida la ruta ".git" de un submódulo solo después de clonar en ella (RCE)

  • Publicada: 22.10.2026
  • Actualizado: 26.10.2026 10:00

Resumen

create_submodule(name, path, url) clona un submódulo en el propio directorio .git del repositorio antes de rechazar la ruta. La comprobación previa a la clonación acepta un path con valor ".git/hooks", por lo que el submódulo se clona directamente en el directorio activo de hooks, y un archivo llamado post-checkout dentro del submódulo se convierte en un .git/hooks/post-checkout ejecutable. En 3.2.0+, la comprobación posterior del índice genera ValueError, pero solo después de que la clonación ya haya escrito en el disco, y no elimina el hook insertado; en 3.1.x no existe dicha comprobación y la llamada tiene éxito silenciosamente. En cualquiera de los casos, el hook se ejecuta en la siguiente operación de git (por ejemplo, checkout), permitiendo la ejecución de código.

Detalles

La ruta de checkout se valida demasiado tarde, después de que la clonación ya ha modificado el disco. Esto rompe la invariante de "validar antes de la mutación" que el commit 43a43cd8 ("Validate submodule checkout and metadata paths before mutation") pretendía aplicar.

Submodule.add() invoca la comprobación permisiva de la ruta antes de clonar, y la comprobación estricta solo alcanza el alias ".git" en el momento del índice, después de que _clone_repo haya escrito en el disco:

git/objects/submodule/base.py (Submodule.add) 599: path = cls._to_relative_path(repo, path) # accepts ".git/hooks" 673: mrepo = cls._clone_repo(repo, url, path, name, ...) # clones into <worktree>/.git/hooks 714: index.add([sm], write=True) # strict check only triggers here

git/index/base.py (IndexFile._preprocess_add_items) 732: _validate_repo_path(entry.path) # rejects ".git", too late

_to_relative_path solo bloquea rutas ../absolutas/fuera del árbol; los alias .git son rechazados únicamente por _validate_repo_path, que se añadió en 3.2.0 (commit a75aedf3) y se ejecuta en el límite del índice. El ValueError que genera en la línea 732 no revierte lo que _clone_repo ya escribió.

Comportamiento según la versión:

  • 3.2.0 .. tip bda18e08: _validate_repo_path lanza ValueError en index.add, pero el hook ya se encuentra en el disco y no se elimina (orden incorrecto de validación frente a clonación).
  • 3.1.x (p. ej. 3.1.59): _validate_repo_path no existe y _to_relative_path no rechaza .git; create_submodule(path=".git/hooks", ...) regresa sin ningún error y el hook se implanta de manera silenciosa.

Prueba de concepto

Configuración: evilsub/ : un repositorio git cuya RAÍZ contiene un archivo ejecutable llamado post-checkout (la carga útil) victim/ : un repositorio git con al menos 1 commit y una segunda rama, cuyo .git/hooks NO tiene sample hooks (the state of a minimal/CI checkout, or git init with an empty template dir, or GIT_TEMPLATE_DIR/init.templateDir empty)

import git, os.path as osp try: git.Repo("victim").create_submodule(name="x", path=".git/hooks", url=osp.abspath("evilsub")) except ValueError: pass # 3.2.0+: ".git" is rejected, but only AFTER the clone, so the plant already happened. # 3.1.x: no exception is raised at all; the call succeeds and still plants the hook.

victim/.git/hooks/post-checkout ahora existe, modo 0755, controlado por el atacante, en todas

las versiones afectadas. Cualquier checkout posterior lo ejecuta:

git -C victim checkout <other-branch> -> el hook se ejecuta -> ejecución de código

Verificado en vivo:

  • tip bda18e08 (3.2.0 + 3 commits): create_submodule generó ValueError desde git/index/base.py:732, pero .git/hooks/post-checkout estaba presente y era ejecutable, y git checkout lo ejecutó.
  • 3.1.59: create_submodule regresó sin errores; .git/hooks/post-checkout fue implantado y ejecutado por git checkout.

Impacto

Ejecución arbitraria de código. Una biblioteca o aplicación que crea un submódulo a partir de un path influenciado por un atacante termina con un ejecutable controlado por el atacante en .git/hooks, el cual git ejecuta en operaciones posteriores habituales. Esto afecta a cualquier servicio que derive la ruta de checkout de un submódulo a partir de datos no confiables, como uno que ingiera una especificación de submódulo (nombre/ruta/URL) desde un manifiesto provisto por el usuario o una solicitud de API y pase path a create_submodule. En 3.2.0+, la validación de la propia biblioteca es lo que falla: rechaza correctamente la ruta .git, pero solo después de que el submódulo ya ha sido clonado en su lugar, por lo que una aplicación que capture el ValueError cree razonablemente que la ruta insegura fue bloqueada.

Precondiciones (de ahí AC:H):

  • (1) la aplicación pasa un path de submódulo influenciado por el atacante;
  • (2) el nombre del hook objetivo está libre en .git/hooks, lo cual se cumple en checkouts mínimos/CI/contenedores y siempre que init.templateDir/GIT_TEMPLATE_DIR esté vacío. Con los hooks de ejemplo predeterminados presentes, git clone rechaza el destino no vacío y no se produce la implantación.

Afectadas: todas las versiones probadas desde 3.1.x (3.1.59) hasta el tip actual bda18e08 (3.2.0 + 3 commits). 3.1.x implanta de forma silenciosa; 3.2.0+ implanta a pesar de generar ValueError.

Qué hacer

Actualice gitpython a la versión 3.2.1 o posterior.

Software afectado

Haz clic en una tecnología para ver todas sus vulnerabilidades.

PlataformaPaqueteVersiones vulnerablesCorregida en
Python (PyPI) gitpython < 3.2.1 3.2.1

Referencias

Puntuación CVSS 7.5/10
Vector CVSS
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:H/I:H/A:H
Debilidad (CWE)
CWE-696
Plataforma
Python (PyPI)
Paquete
gitpython
Publicada
22.10.2026
Actualizado
26.10.2026 10:00

Fuentes y licencias · Editado o traducido por DockRay; se mantienen los derechos y las licencias de las fuentes.

OSV / GitHub Advisory Database - GHSA-83vg-56qc-22m7 - CC BY 4.0

Historial de vulnerabilidades: gitpython

Todas las vulnerabilidades publicadas de este paquete (Python (PyPI)), de la más reciente a la más antigua. Muestra si es un fallo aislado o un paquete que hay que vigilar.

Todas (43) en el archivo
Entradas en total
43
Primera → última
12.2022 10.2026
Sin corrección
0
Explotada en ataques
0

Distribución por gravedad

  • Crítica 3
  • Alta 30
  • Media 10

Divulgaciones por año

  1. 2022: 1
  2. 2023: 3
  3. 2024: 1
  4. 2025: 0
  5. 2026: 38
Gravedad:
  1. GitPython valida la ruta ".git" de un submódulo solo después de clonar en ella (RCE) esta entrada
    Alta · 7.5 CVE-2026-114145 < 3.2.1 3.2.1
Mostrar más (13) Mostrando 20 de 33

Identifica las vulnerabilidades de tu aplicación

Con la integración de DockRay y el inventario de software activado, DockRay compara las versiones notificadas de los componentes con las vulnerabilidades conocidas y avisa de las coincidencias confirmadas. La cobertura depende de la tecnología compatible y de los avisos disponibles.

Conectar tu aplicación
Newsletter DockRay

La seguridad de tus aplicaciones en tu correo

Vulnerabilidades importantes, recomendaciones concretas y consejos prácticos para tus aplicaciones. Elige tus tecnologías y sigue lo que importa para tu proyecto.

  • Un resumen diario de nuevas vulnerabilidades, también las críticas.
  • Avisos sobre actualizaciones importantes.
  • Consejos prácticos sobre seguridad y monitorización de aplicaciones.

Déjalo vacío para recibir avisos de todas las tecnologías.

Suscripción gratuita. Date de baja con un clic en cualquier correo.