Hoch

GitPython validiert den ".git"-Pfad eines Submoduls erst nach dem Klonen (RCE)

  • Veröffentlicht: 22.10.2026
  • Aktualisiert: 26.10.2026 10:00

Zusammenfassung

create_submodule(name, path, url) klont ein Submodul in das eigene .git-Verzeichnis des Repositorys, bevor der Pfad zurückgewiesen wird. Ein path von ".git/hooks" wird von der Überprüfung vor dem Klonen akzeptiert, sodass das Submodul direkt in das aktive hooks-Verzeichnis geklont wird und eine Datei namens post-checkout im Submodul zu einem ausführbaren .git/hooks/post-checkout wird. Ab 3.2.0+ löst die spätere Indexprüfung zwar ValueError aus, dies geschieht jedoch erst, nachdem der Klonvorgang bereits auf die Festplatte geschrieben hat, und der platzierte Hook wird nicht entfernt; in 3.1.x gibt es keine solche Prüfung und der Aufruf ist stillschweigend erfolgreich. In beiden Fällen wird der Hook bei der nächsten Git-Operation (z. B. Checkout) ausgeführt, was zur Codeausführung führt.

Details

Der Checkout-Pfad wird zu spät validiert, nachdem der Klonvorgang die Festplatte bereits verändert hat. Dies verletzt die Invariante "vor der Mutation validieren", die Commit 43a43cd8 ("Validate submodule checkout and metadata paths before mutation") durchsetzen sollte.

Submodule.add() ruft vor dem Klonen die unvollständige Pfadprüfung auf, und die strenge Prüfung erreicht den ".git"-Alias erst zum Indexzeitpunkt, nachdem _clone_repo bereits auf die Festplatte geschrieben hat:

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 blockiert nur ../absolute/out-of-tree-Pfade; .git-Aliase werden erst von _validate_repo_path abgefangen, das in 3.2.0 (Commit a75aedf3) hinzugefügt wurde und an der Indexgrenze ausgeführt wird. Der in Zeile 732 ausgelöste ValueError macht die Änderungen, die _clone_repo bereits vorgenommen hat, nicht rückgängig.

Versionsabhängiges Verhalten:

  • 3.2.0 .. tip bda18e08: _validate_repo_path löst bei index.add einen ValueError aus, aber der Hook befindet sich bereits auf der Festplatte und wird nicht entfernt (falsche Reihenfolge von Validierung vs. Klonen).
  • 3.1.x (z. B. 3.1.59): _validate_repo_path existiert nicht und _to_relative_path weist .git nicht ab; create_submodule(path=".git/hooks", ...) kehrt ohne Fehler zurück und der Hook wird unbemerkt platziert.

Proof of Concept

Aufbau: evilsub/ : ein Git-Repository, dessen ROOT eine ausführbare Datei namens post-checkout enthält (die Payload) victim/ : ein Git-Repository mit mindestens 1 Commit und einem zweiten Branch, dessen .git/hooks KEIN 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 existiert nun mit Rechten 0755, angreiferkontrolliert, in jeder

betroffenen Version. Jeder spätere Checkout führt es aus:

git -C victim checkout <other-branch> -> der Hook läuft -> Codeausführung

Live verifiziert:

  • tip bda18e08 (3.2.0 + 3 Commits): create_submodule löste ValueError in git/index/base.py:732 aus, dennoch war .git/hooks/post-checkout vorhanden und ausführbar, und git checkout führte es aus.
  • 3.1.59: create_submodule kehrte ohne Fehler zurück; .git/hooks/post-checkout wurde abgelegt und von git checkout ausgeführt.

Auswirkungen

Beliebige Codeausführung. Eine Bibliothek bzw. Anwendung, die ein Submodul über einen vom Angreifer beeinflussten path erstellt, erhält eine vom Angreifer kontrollierte ausführbare Datei in .git/hooks, die Git bei späteren regulären Vorgängen ausführt. Dies betrifft jeden Dienst, der einen Submodul-Checkout-Pfad aus nicht vertrauenswürdigen Daten ableitet, z. B. bei der Verarbeitung einer Submodul-Spezifikation (Name/Pfad/URL) aus einem vom Benutzer bereitgestellten Manifest oder einer API-Anfrage und Übergabe von path an create_submodule. Unter 3.2.0+ schlägt die Validierung der Bibliothek selbst fehl: Sie weist den .git-Pfad zwar korrekt zurück, aber erst, nachdem das Submodul bereits an Ort und Stelle geklont wurde, sodass eine Anwendung, die den ValueError abfängt, fälschlicherweise annimmt, der unsichere Pfad sei blockiert worden.

Voraussetzungen (daher AC:H):

  • (1) die Anwendung übergibt einen vom Angreifer beeinflussten Submodul-path;
  • (2) der Ziel-Hook-Name ist in .git/hooks frei, was für minimale/CI/Container-Checkouts und bei leerem init.templateDir/GIT_TEMPLATE_DIR zutrifft. Sind die standardmäßigen Sample-Hooks vorhanden, verweigert git clone das nicht leere Ziel und es erfolgt kein Ablegen.

Betroffen: alle getesteten Versionen von 3.1.x (3.1.59) bis zum aktuellen tip bda18e08 (3.2.0 + 3 Commits). 3.1.x platziert stillschweigend; 3.2.0+ platziert trotz Auslösen von ValueError.

Was zu tun ist

Aktualisieren Sie gitpython auf Version 3.2.1 oder höher.

Betroffene Software

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

PlattformPaketAnfällige VersionenBehoben in
Python (PyPI) gitpython < 3.2.1 3.2.1

Verweise

CVSS-Wert 7.5/10
CVSS-Vektor
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:H/I:H/A:H
Schwäche (CWE)
CWE-696
Plattform
Python (PyPI)
Paket
gitpython
Veröffentlicht
22.10.2026
Aktualisiert
26.10.2026 10:00

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

OSV / GitHub Advisory Database - GHSA-83vg-56qc-22m7 - 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. GitPython validiert den ".git"-Pfad eines Submoduls erst nach dem Klonen (RCE) dieser Eintrag
    Hoch · 7.5 CVE-2026-114145 < 3.2.1 3.2.1
Mehr anzeigen (13) 20 von 33 angezeigt

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.