GitPython valida la ruta ".git" de un submódulo solo después de clonar en ella (RCE)
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 checkoutlo 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
pathde 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 clonerechaza 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.
| Plataforma | Paquete | Versiones vulnerables | Corregida en |
|---|---|---|---|
| Python (PyPI) | gitpython | < 3.2.1 | 3.2.1 |
Referencias
- https://github.com/gitpython-developers/GitPython/security/advisories/GHSA-83vg-56qc-22m7
- https://nvd.nist.gov/vuln/detail/CVE-2026-114145
- https://github.com/gitpython-developers/GitPython/pull/2264
- https://github.com/gitpython-developers/GitPython/commit/97eadb888d2f99567e3113f4e455be4ca128f697
- https://github.com/gitpython-developers/GitPython
- https://github.com/gitpython-developers/GitPython/releases/tag/3.2.1
- 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.
- 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
- 2022: 1
- 2023: 3
- 2024: 1
- 2025: 0
- 2026: 38
-
GitPython valida la ruta ".git" de un submódulo solo después de clonar en ella (RCE) esta entrada
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.