El refspec de GitPython Remote.pull() elude la protección de opciones inseguras de --upload-pack, permitiendo la ejecución arbitraria de comandos
Resumen
Remote.pull() en GitPython reenvía su argumento posicional refspec directamente al proceso secundario git pull, mientras que su protección frente a opciones inseguras solo inspecciona los argumentos por palabra clave. Una aplicación que pase datos influenciados por un atacante como refspec (por ejemplo, un parámetro de rama o refspec proporcionado por el usuario en un servicio web o de CI) puede suministrar un valor con formato de opción como --upload-pack=<command>. El valor elude la comprobación unsafe_git_pull_options, se sitúa tras el separador -- en la línea de comandos de git pull y se ejecuta como el programa upload-pack para transportes de ruta local o SSH. Esto da lugar a la ejecución arbitraria de comandos con los privilegios del proceso invocador utilizando los argumentos predeterminados documentados (allow_unsafe_options=False).
Causa raíz
Está documentado que Remote.pull() rechaza opciones peligrosas a menos que se indique allow_unsafe_options=True, y --upload-pack aparece explícitamente listada como una opción de este tipo. Sin embargo, la protección solo examina los argumentos por palabra clave y nunca el posicional refspec. La comprobación construye su lista de candidatos mediante Git._option_candidates([], kwargs), pasando una lista vacía en lugar de los posicionales, por lo que el valor refspec nunca se compara con unsafe_git_pull_options = ["--upload-pack"]. A continuación, el refspec normalizado se reenvía literalmente a la invocación de git pull. El separador inicial -- que neutraliza un refspec con formato de opción para git fetch y git push no protege a git pull, debido a que git pull vuelve a reenviar sus posicionales finales a un git fetch interno sin reinsertar un separador --, por lo que el posicional se convierte en una opción para dicho fetch interno.
Affected function: git.remote.Remote.pull
Source: git/remote.py (guard at the check_unsafe_options call using _option_candidates([], kwargs); sink at the self.repo.git.pull("--", self, refspec, ...) invocation)
Impacto
Un atacante que controle el valor refspec pasado a Remote.pull() logra la ejecución arbitraria de comandos en el sistema operativo con los privilegios del proceso que invoca GitPython, sin privilegios adicionales y sin interacción del usuario, en la ruta de código predeterminada. La explotación requiere que el repositorio remoto utilizado emplee un transporte que ejecute upload-pack en el lado local, concretamente una ruta del sistema de archivos local o SSH; a través de HTTPS el valor --upload-pack es inerte porque el servidor ignora cualquier programa upload-pack suministrado por el cliente. Este requisito de transporte restringe el conjunto de despliegues vulnerables, pero no añade dificultad para el atacante una vez alcanzado un objetivo vulnerable. Dado que los entornos de trabajo suelen utilizar orígenes de ruta local o SSH, la base expuesta es considerable.
Prueba de concepto
Environment: GitPython from the affected source tree; system git 2.43.0.
The pulled origin uses a local filesystem transport (protocol.file.allow=always for git >= 2.38).
Pasos de reproducción:
- Crear un repositorio de origen accesible a través de un transporte de ruta local.
- En un repositorio consumidor, registrar dicho origen y llamar a
Remote.pull()con un refspec controlado por el atacante. - Observar que el comando inyectado se ejecuta.
import git
repo = git.Repo("consumer") # has an origin using a local-path or ssh transport
origin = repo.remote("origin")
# Attacker-controlled refspec value; default arguments (allow_unsafe_options=False):
origin.pull(refspec="--upload-pack=touch /tmp/pwned; git-upload-pack")
cmdline: git pull -v -- origin --upload-pack=touch /tmp/pwned; git-upload-pack
[attack] marker created (RCE) : True
[isolate] upload_pack passed as KWARG blocked : True (only the positional refspec escapes)
[sibling] same value via git fetch : safe (pull-specific behavior)
[control] benign refspec : safe
Cadena de ataque
- Exposición: Una aplicación llama a
Remote.pull(refspec=<value>)en la ruta predeterminada, donde<value>se deriva de una entrada influenciada por el atacante, como un parámetro de solicitud de rama o refspec. - Control: El atacante suministra la cadena
--upload-pack=<command>; git-upload-pack. El valor pasa porGit._unpack_args, que únicamente lo aplana y convierte a cadena, conservando su formato de opción. - Ruta: El bucle del protocolo invoca
Git.check_unsafe_protocolssobre el valor, lo cual solo coincide con URLs de transporte de ayudantes remotos (una forma<transport>::) y no marca un token--upload-pack=. - Protección: La protección contra opciones inseguras llama a
check_unsafe_options(options=Git._option_candidates([], kwargs), ...). Dado que los argumentos posicionales se pasan como una lista vacía, el posicionalrefspecnunca se inspecciona frente aunsafe_git_pull_options. - Primitiva: El valor se reenvía a
git pull -v -- <remote> --upload-pack=<command>; git-upload-pack;git pullvuelve a reenviar el posicional a ungit fetchinterno sin un separador--, por lo que se toma como el programa upload-pack. - Resultado: En transportes por ruta local o SSH, git ejecuta
<command>como el programa upload-pack, otorgando ejecución arbitraria de comandos con el usuario del proceso que realiza la llamada.
Evidencia de elusión
La protección relevante es la propia llamada a check_unsafe_options de Remote.pull(), presente en el artefacto publicado actual. Es incompleta: inspecciona Git._option_candidates([], kwargs), que únicamente considera argumentos por palabra clave, de modo que el posicional refspec nunca se comprueba. Esto se confirmó empíricamente: pasar el mismo valor como argumento por palabra clave upload_pack= genera UnsafeOptionError, mientras que pasarlo como posicional refspec no lo hace, demostrando que solo el posicional elude la protección.
El separador -- en la línea de comandos de git pull se probó como posible mitigación y fue refutado: con git del sistema 2.43.0, git pull -- <remote> '--upload-pack=<cmd>' ejecutó el comando inyectado, mientras que el mismo valor suministrado a git fetch -- ... y git push -- ... no se ejecutó, ya que dichos subcomandos respetan el terminador --, mientras que git pull reenvía los posicionales a un fetch interno sin él. La comprobación de transporte check_unsafe_protocols también fue examinada y no marca el token --upload-pack= debido a que no tiene formato <transport>::. Ningún aviso previo publicado para este paquete aborda Remote.pull, el argumento posicional de refspec en fetch o pull, ni la inyección de --upload-pack a través de un refspec; el problema aceptado más cercano cubre la misma clase (un argumento posicional que evade una comprobación exclusiva para palabras clave) en una función y destino diferentes.
Versiones afectadas
Ecosystem: pip (PyPI)Package: GitPythonConfirmed affected range: >= 3.1.30Latest release checked: 3.1.62 (PyPI); source verified against the 3.1.62 release tagFix status: not fixed in any released version or on the development branch
La protección de pull basada exclusivamente en argumentos por palabra clave, junto con el receptor posicional refspec, está presente en todas las etiquetas publicadas desde 3.1.30 hasta la versión más reciente 3.1.62, según se ha verificado inspeccionando el archivo git/remote.py distribuido en cada versión etiquetada. La versión 3.1.30 introdujo la protección unsafe_git_pull_options; el rango afectado se establece desde ese límite bajo el criterio de protección incompleta. Las versiones anteriores a 3.1.30 reenvían refspec de forma posicional sin ninguna protección contra opciones inseguras y sin separador --, siendo también explotables, pero el rango se declara de forma conservadora a partir de la introducción de dicha protección. No existe una versión corregida.
Corrección sugerida
Haga cumplir la comprobación de opciones inseguras en el posicional refspec, y no únicamente en los argumentos por palabra clave. La protección debería construir su lista de candidatos a partir de los posicionales efectivamente reenviados (por ejemplo, pasando la lista normalizada de refspecs a Git._option_candidates junto con kwargs) para que un refspec con formato de opción como --upload-pack=... sea rechazado con UnsafeOptionError a menos que se especifique allow_unsafe_options=True. La misma corrección debe verificarse para cualquier otra ruta de reenvío de referencias o refspecs que dependa de comprobaciones exclusivas de argumentos por palabra clave. Como mitigación provisional sin cambios de código, quienes utilicen la librería deben validar o rechazar los valores de refspec que comiencen con -, evitar pasar datos no confiables como refspec y priorizar el uso de repositorios remotos mediante HTTPS, donde cualquier programa upload-pack suministrado por el cliente resulta inerte.
Reportado por zx (GitHub: @manus-pi).
Qué hacer
Actualice gitpython a la versión 3.2.0 o posterior. Como mitigación provisional sin cambios de código, valide o rechace los valores de refspec que comiencen con un guion, evite pasar datos no confiables como refspecs y prefiera repositorios remotos HTTPS, donde el programa upload-pack suministrado por el cliente queda inerte.
Software afectado
Haz clic en una tecnología para ver todas sus vulnerabilidades.
| Plataforma | Paquete | Versiones vulnerables | Corregida en |
|---|---|---|---|
| Python (PyPI) | gitpython | >= 3.1.30, < 3.2.0 | 3.2.0 |
Referencias
- https://github.com/gitpython-developers/GitPython/security/advisories/GHSA-f9j4-qggq-h239
- https://github.com/gitpython-developers/GitPython/pull/2247
- https://github.com/gitpython-developers/GitPython/commit/790bb3164948625ffb043d2a162425d55923fe9a
- https://github.com/gitpython-developers/GitPython
- https://github.com/gitpython-developers/GitPython/releases/tag/3.2.0
- Vector CVSS
CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:H- Debilidad (CWE)
CWE-78, CWE-88- Plataforma
- Python (PyPI)
- Paquete
gitpython- Publicada
- 27.10.2026
- Actualizado
- 31.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-f9j4-qggq-h239 - 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
-
El refspec de GitPython Remote.pull() elude la protección de opciones inseguras de --upload-pack, permitiendo la ejecución arbitraria de comandos 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.