Alta

El refspec de GitPython Remote.pull() elude la protección de opciones inseguras de --upload-pack, permitiendo la ejecución arbitraria de comandos

  • Publicada: 27.10.2026
  • Actualizado: 31.10.2026 10:00

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:

  1. Crear un repositorio de origen accesible a través de un transporte de ruta local.
  2. En un repositorio consumidor, registrar dicho origen y llamar a Remote.pull() con un refspec controlado por el atacante.
  3. Observar que el comando inyectado se ejecuta.
python
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

  1. 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.
  2. Control: El atacante suministra la cadena --upload-pack=<command>; git-upload-pack. El valor pasa por Git._unpack_args, que únicamente lo aplana y convierte a cadena, conservando su formato de opción.
  3. Ruta: El bucle del protocolo invoca Git.check_unsafe_protocols sobre el valor, lo cual solo coincide con URLs de transporte de ayudantes remotos (una forma <transport>::) y no marca un token --upload-pack=.
  4. 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 posicional refspec nunca se inspecciona frente a unsafe_git_pull_options.
  5. Primitiva: El valor se reenvía a git pull -v -- <remote> --upload-pack=<command>; git-upload-pack; git pull vuelve a reenviar el posicional a un git fetch interno sin un separador --, por lo que se toma como el programa upload-pack.
  6. 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: GitPython
  • Confirmed affected range: >= 3.1.30
  • Latest release checked: 3.1.62 (PyPI); source verified against the 3.1.62 release tag
  • Fix 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.

PlataformaPaqueteVersiones vulnerablesCorregida en
Python (PyPI) gitpython >= 3.1.30, < 3.2.0 3.2.0

Referencias

Puntuación CVSS 8.1/10
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.

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. 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
    Alta · 8.1 CVE-2026-110858 >= 3.1.30, < 3.2.0 3.2.0
  2. Alta · 8.8 CVE-2026-42215 >= 3.1.30, < 3.1.47 3.1.47

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.