Hoch

Refspec in GitPython Remote.pull() umgeht die Schutzfunktion für unsichere Optionen von --upload-pack und ermöglicht die Ausführung beliebiger Befehle

  • Veröffentlicht: 27.10.2026
  • Aktualisiert: 31.10.2026 10:00

Zusammenfassung

Remote.pull() in GitPython leitet sein positionsbezogenes Argument refspec direkt an den Kindprozess git pull weiter, während die Schutzfunktion für unsichere Optionen ausschließlich Schlüsselwortargumente überprüft. Eine Anwendung, die vom Angreifer beeinflusste Daten als refspec übergibt (beispielsweise einen von Benutzern bereitgestellten Branch- oder Refspec-Parameter in einem Web- oder CI-Dienst), kann einen optionsartigen Wert wie --upload-pack=<command> einspeisen. Der Wert umgeht die Überprüfung unsafe_git_pull_options, wird hinter dem Trennzeichen -- in der Befehlszeile von git pull platziert und für lokale Pfad- oder SSH-Transporte als upload-pack-Programm ausgeführt. Dies führt zur Ausführung beliebiger Befehle mit den Berechtigungen des aufrufenden Prozesses unter Verwendung der dokumentierten Standardargumente (allow_unsafe_options=False).

Ursache

Remote.pull() ist so dokumentiert, dass gefährliche Optionen abgewiesen werden, sofern nicht allow_unsafe_options=True gesetzt ist, und --upload-pack ist ausdrücklich als solche Option aufgeführt. Die Prüfung überprüft jedoch nur Schlüsselwortargumente und niemals das positionsbezogene refspec. Die Prüfung erstellt ihre Kandidatenliste mit Git._option_candidates([], kwargs) und übergibt anstelle der Positionsparameter eine leere Liste, sodass der Wert refspec niemals mit unsafe_git_pull_options = ["--upload-pack"] verglichen wird. Das normalisierte refspec wird anschließend unverändert an den Aufruf von git pull weitergeleitet. Das vorangestellte Trennzeichen --, das einen optionsförmigen Refspec für git fetch und git push entschärft, schützt git pull nicht, da git pull seine nachfolgenden Positionsargumente ohne erneutes Einfügen eines ---Trennzeichens an ein internes git fetch weiterleitet, sodass das Positionsargument zu einer Option für dieses interne Fetch wird.

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)

Auswirkungen

Ein Angreifer, der den an Remote.pull() übergebenen Wert refspec kontrolliert, erlangt die beliebige Ausführung von Betriebssystembefehlen mit den Rechten des GitPython aufrufenden Prozesses – ohne zusätzliche Privilegien und ohne Benutzerinteraktion auf dem Standard-Codepfad. Eine Ausnutzung setzt voraus, dass das Remote-Repository einen Transport verwendet, der upload-pack lokal ausführt, namentlich einen lokalen Dateisystempfad oder SSH; über HTTPS bleibt der Wert --upload-pack wirkungslos, da der Server ein vom Client bereitgestelltes upload-pack-Programm ignoriert. Diese Transportvoraussetzung schränkt die Zahl verwundbarer Bereitstellungen ein, erfordert für den Angreifer jedoch keinen zusätzlichen Aufwand, sobald ein verwundbares Ziel erreicht ist. Da Arbeits-Checkouts häufig lokale Pfade oder SSH-Origins nutzen, ist die betroffene Basis beträchtlich.

Proof of Concept

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).

Schritte zur Reproduktion:

  1. Ein Origin-Repository erstellen, das über einen lokalen Pfadtransport erreichbar ist.
  2. In einem verbrauchenden Repository diesen Origin registrieren und Remote.pull() mit einem vom Angreifer kontrollierten Refspec aufrufen.
  3. Beobachten, dass der injizierte Befehl ausgeführt wird.
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

Angriffskette

  1. Exposition: Eine Anwendung ruft Remote.pull(refspec=<value>) auf dem Standardpfad auf, wobei <value> aus einer vom Angreifer beeinflussten Eingabe wie einem Branch- oder Refspec-Anforderungsparameter stammt.
  2. Kontrolle: Der Angreifer übergibt die Zeichenkette --upload-pack=<command>; git-upload-pack. Der Wert durchläuft Git._unpack_args, wodurch er lediglich verflacht und in Text konvertiert wird, wobei die Optionsform erhalten bleibt.
  3. Pfad: Die Protokollschleife ruft Git.check_unsafe_protocols auf dem Wert auf, was nur auf Remote-Helper-Transport-URLs (eine <transport>::-Form) zutrifft und ein --upload-pack=-Token nicht markiert.
  4. Schutzfunktion: Der Schutz für unsichere Optionen ruft check_unsafe_options(options=Git._option_candidates([], kwargs), ...) auf. Da Positionsargumente als leere Liste übergeben werden, wird das positionsbezogene refspec niemals gegen unsafe_git_pull_options geprüft.
  5. Primitiv: Der Wert wird an git pull -v -- <remote> --upload-pack=<command>; git-upload-pack weitergeleitet; git pull leitet das Positionsargument ohne ---Trennzeichen an ein internes git fetch weiter, sodass es als upload-pack-Programm akzeptiert wird.
  6. Ergebnis: Bei einem lokalen Pfad- oder SSH-Transport führt Git <command> als upload-pack-Programm aus, was zur beliebigen Befehlsausführung als Benutzer des aufrufenden Prozesses führt.

Nachweis der Umgehung

Die relevante Schutzfunktion ist der eigene Aufruf von check_unsafe_options in Remote.pull(), der im aktuellen Release-Artefakt enthalten ist. Er ist unvollständig: Er prüft Git._option_candidates([], kwargs), was nur Schlüsselwortargumente berücksichtigt, sodass das positionsbezogene refspec nie überprüft wird. Dies wurde empirisch bestätigt: Die Übergabe desselben Werts als Schlüsselwortargument upload_pack= löst UnsafeOptionError aus, während die Übergabe als positionsbezogenes refspec dies nicht tut, was belegt, dass nur das Positionsargument der Schutzfunktion entgeht.

Das ---Trennzeichen auf der git pull-Befehlszeile wurde als mögliche Gegenmaßnahme getestet und widerlegt: Mit System-Git 2.43.0 führte git pull -- <remote> '--upload-pack=<cmd>' den injizierten Befehl aus, während derselbe Wert, der an git fetch -- ... und git push -- ... übergeben wurde, nicht ausgeführt wurde, da diese Unterbefehle das ---Endezeichen beachten, wohingegen git pull Positionsargumente ohne ein solches Zeichen an ein internes Fetch weiterleitet. Die Transportüberprüfung check_unsafe_protocols wurde ebenfalls untersucht und beanstandet das Token --upload-pack= nicht, da es keine <transport>::-Form aufweist. Kein zuvor veröffentlichtes Advisory für dieses Paket behandelt Remote.pull, das positionsbezogene Fetch- oder Pull-Refspec-Argument oder die Injection von --upload-pack über einen Refspec; das am nächsten liegende akzeptierte Problem betrifft dieselbe Schwachstellenklasse (ein positionsbezogenes Argument, das einer reinen Schlüsselwortprüfung entgeht) in einer anderen Funktion und Senke.

Betroffene Versionen

  • 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

Die reine Schlüsselwort-Pull-Schutzfunktion zusammen mit der positionsbezogenen refspec-Senke ist in jedem veröffentlichten Tag von 3.1.30 bis zum neuesten Release 3.1.62 vorhanden, verifiziert durch Prüfung des ausgelieferten git/remote.py in jedem getaggten Artefakt. Version 3.1.30 führte die Schutzfunktion unsafe_git_pull_options ein; der betroffene Bereich wird unter dem Rahmen der unvollständigen Prüfung ab dieser Grenze angegeben. Versionen vor 3.1.30 leiten refspec positionsbezogen ohne Schutz vor unsicheren Optionen und ohne ---Trennzeichen weiter und sind ebenfalls angreifbar; der Bereich wird jedoch konservativ ab der Einführung der Schutzfunktion angegeben. Es existiert kein behobenes Release.

Vorgeschlagene Behebung

Setzen Sie die Invariante für unsichere Optionen auch für das positionsbezogene refspec durch, nicht nur für Schlüsselwortargumente. Die Prüfung sollte ihre Kandidatenliste aus den tatsächlich weitergeleiteten Positionsargumenten bilden (beispielsweise indem die normalisierte Refspec-Liste neben kwargs an Git._option_candidates übergeben wird), sodass ein optionsförmiges refspec wie --upload-pack=... mit UnsafeOptionError abgewiesen wird, es sei denn, allow_unsafe_options=True ist gesetzt. Dieselbe Korrektur sollte für alle anderen Weiterleitungspfade von Referenzen oder Refspecs überprüft werden, die auf der reinen Schlüsselwortprüfung basieren. Als vorübergehende Behelfslösung ohne Codeänderung sollten Aufrufer Refspec-Werte validieren oder ablehnen, die mit - beginnen, es vermeiden, nicht vertrauenswürdige Daten als refspec zu übergeben, und HTTPS-Remotes bevorzugen, bei denen ein vom Client übergebenes upload-pack-Programm wirkungslos ist.

Gemeldet von zx (GitHub: @manus-pi).

Was zu tun ist

Aktualisieren Sie gitpython auf Version 3.2.0 oder höher. Als Übergangsmaßnahme ohne Codeänderung sollten Aufrufer Refspec-Werte validieren oder abweisen, die mit einem Bindestrich beginnen, die Übergabe nicht vertrauenswürdiger Daten als Refspecs vermeiden und HTTPS-Remotes bevorzugen, bei denen ein clientseitig übergebenes upload-pack-Programm wirkungslos bleibt.

Betroffene Software

Klicken Sie auf eine Technologie, um alle zugehörigen Schwachstellen anzuzeigen.

PlattformPaketAnfällige VersionenBehoben in
Python (PyPI) gitpython >= 3.1.30, < 3.2.0 3.2.0

Verweise

CVSS-Wert 8.1/10
CVSS-Vektor
CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:H
Schwäche (CWE)
CWE-78, CWE-88
Plattform
Python (PyPI)
Paket
gitpython
Veröffentlicht
27.10.2026
Aktualisiert
31.10.2026 10:00

Quellen und Lizenzen · Von DockRay bearbeitet oder übersetzt; Rechte und Lizenzen der Quellen bleiben erhalten.

OSV / GitHub Advisory Database - GHSA-f9j4-qggq-h239 - CC BY 4.0

Schwachstellenhistorie: gitpython

Alle veröffentlichten Schwachstellen dieses Pakets (Python (PyPI)), neueste zuerst. Zeigt, ob es ein einmaliger Ausrutscher ist oder ein Paket, das man im Auge behalten muss.

Alle (43) im Archiv
Einträge insgesamt
43
Erste → letzte
12.2022 10.2026
Ohne Fix
0
In Angriffen ausgenutzt
0

Verteilung nach Schweregrad

  • Kritisch 3
  • Hoch 30
  • Mittel 10

Veröffentlichungen pro Jahr

  1. 2022: 1
  2. 2023: 3
  3. 2024: 1
  4. 2025: 0
  5. 2026: 38
Schweregrad:
  1. Refspec in GitPython Remote.pull() umgeht die Schutzfunktion für unsichere Optionen von --upload-pack und ermöglicht die Ausführung beliebiger Befehle dieser Eintrag
    Hoch · 8.1 CVE-2026-110858 >= 3.1.30, < 3.2.0 3.2.0
  2. Hoch · 8.8 CVE-2026-42215 >= 3.1.30, < 3.1.47 3.1.47

Erkennen Sie Schwachstellen in Ihrer Anwendung

Mit der DockRay-Integration und aktivierter Softwareinventarisierung prüft DockRay gemeldete Komponentenversionen auf bekannte Schwachstellen und benachrichtigt Sie über bestätigte Treffer. Die Abdeckung hängt von der unterstützten Technologie und den verfügbaren Meldungen ab.

Anwendung verbinden
DockRay Newsletter

Anwendungssicherheit in Ihrem Postfach

Wichtige Schwachstellen, konkrete Empfehlungen und praktische Tipps für Ihre Anwendungen. Wählen Sie Ihre Technologien und verfolgen Sie, was für Ihr Projekt relevant ist.

  • Eine tägliche Zusammenfassung neuer Schwachstellen, auch kritischer.
  • Benachrichtigungen über wichtige Updates.
  • Praktische Tipps zur Sicherheit und Überwachung von Anwendungen.

Leer lassen, um Meldungen zu allen Technologien zu erhalten.

Kostenlos anmelden. In jeder E-Mail mit einem Klick abmelden.