GitPython weryfikuje ścieżkę podmodułu ".git" dopiero po sklonowaniu do niej (RCE)
Podsumowanie
create_submodule(name, path, url) klonuje podmoduł do własnego katalogu .git repozytorium przed odrzuceniem ścieżki. Wartość path o postaci ".git/hooks" jest akceptowana przez sprawdzenie przed klonowaniem, więc podmoduł jest klonowany bezpośrednio do aktywnego katalogu hooks, a plik o nazwie post-checkout w podmodule staje się wykonywalnym .git/hooks/post-checkout. W wersji 3.2.0+ późniejsze sprawdzenie indeksu zgłasza ValueError, ale dopiero po tym, jak operacja klonowania zapisała już dane na dysku, i nie usuwa umieszczonego hooka; w 3.1.x takiego sprawdzenia nie ma i wywołanie kończy się bez błędu. W obu przypadkach hook jest uruchamiany przy następnej operacji gita (np. checkout), powodując wykonanie kodu.
Szczegóły
Ścieżka checkoutu jest sprawdzana zbyt późno, już po tym, jak klonowanie zmodyfikowało dysk. Narusza to niezmiennik „sprawdź przed modyfikacją”, który miał wymusić commit 43a43cd8 („Validate submodule checkout and metadata paths before mutation”).
Submodule.add() wywołuje liberalne sprawdzenie ścieżki przed klonowaniem, a rygorystyczna kontrola dociera do aliasu ".git" dopiero na etapie indeksu, po tym jak _clone_repo zapisało już dane na dysku:
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 blokuje jedynie ścieżki ../bezwzględne/poza drzewem; aliasy .git są odrzucane dopiero przez _validate_repo_path, które dodano w 3.2.0 (commit a75aedf3) i które działa na granicy indeksu. ValueError zgłoszony w linii 732 nie cofa zmian wprowadzonych na dysku przez _clone_repo.
Zachowanie zależne od wersji:
- 3.2.0 .. tip bda18e08: _validate_repo_path zgłasza ValueError przy index.add, ale hook znajduje się już na dysku i nie zostaje usunięty (nieprawidłowa kolejność walidacji względem klonowania).
- 3.1.x (np. 3.1.59): _validate_repo_path nie istnieje, a _to_relative_path nie odrzuca
.git; create_submodule(path=".git/hooks", ...) powraca bez żadnego błędu, a hook zostaje umieszczony po cichu.
Proof of concept
Przygotowanie:
evilsub/ : repozytorium git, którego ROOT zawiera plik wykonywalny o nazwie post-checkout (ładunek)
victim/ : repozytorium git z co najmniej 1 commitem i drugą gałęzią, którego .git/hooks NIE zawiera
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 teraz istnieje, z uprawnieniami 0755, kontrolowany przez atakującego, w każdej
podatnej wersji. Dowolny późniejszy checkout go uruchamia:
git -C victim checkout <other-branch> -> hook się uruchamia -> wykonanie kodu
Zweryfikowane na żywo:
- tip bda18e08 (3.2.0 + 3 commitów): create_submodule zgłosiło ValueError z git/index/base.py:732, a mimo to .git/hooks/post-checkout był obecny i wykonywalny, po czym
git checkoutgo wykonało. - 3.1.59: create_submodule zakończyło się bez błędu; .git/hooks/post-checkout został umieszczony i wykonany przez
git checkout.
Wpływ
Dowolne wykonanie kodu. Biblioteka lub aplikacja tworząca podmoduł z parametru path zależnego od atakującego kończy z kontrolowanym przez atakującego plikiem wykonywalnym w .git/hooks, który git uruchamia przy zwykłych późniejszych operacjach. Dotyczy to każdej usługi wyprowadzającej ścieżkę checkoutu podmodułu z niezaufanych danych, np. pobierającej specyfikację podmodułu (nazwa/ścieżka/URL) z manifestu dostarczonego przez użytkownika lub żądania API i przekazującej path do create_submodule. W wersji 3.2.0+ zawodzi sama walidacja biblioteki: poprawnie odrzuca ścieżkę .git, ale dopiero po tym, jak podmoduł został już sklonowany na miejsce, więc aplikacja przechwytująca ValueError może błędnie zakładać, że niebezpieczna ścieżka została zablokowana.
Warunki wstępne (stąd AC:H):
- (1) aplikacja przekazuje
pathpodmodułu kontrolowany przez atakującego; - (2) docelowa nazwa hooka jest wolna w
.git/hooks, co ma miejsce w minimalnych checkoutach/CI/kontenerach oraz gdy init.templateDir/GIT_TEMPLATE_DIR jest pusty. Jeśli obecne są domyślne przykładowe hooki,git cloneodrzuca niepusty cel i do umieszczenia nie dochodzi.
Podatne: wszystkie testowane wersje od 3.1.x (3.1.59) do obecnego tipa bda18e08 (3.2.0 + 3 commitów). Wersje 3.1.x umieszczają plik po cichu; wersje 3.2.0+ umieszczają plik pomimo zgłoszenia ValueError.
Co trzeba zrobić
Zaktualizuj pakiet gitpython do wersji 3.2.1 lub nowszej.
Czego dotyczy
Kliknij technologię, aby zobaczyć wszystkie dotyczące jej podatności.
| Platforma | Paczka | Podatne wersje | Poprawka w wersji |
|---|---|---|---|
| Python (PyPI) | gitpython | < 3.2.1 | 3.2.1 |
Odnośniki
- 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
- Wektor CVSS
CVSS:3.1/AV:N/AC:H/PR:N/UI:R/S:U/C:H/I:H/A:H- Słabość (CWE)
CWE-696- Platforma
- Python (PyPI)
- Paczka
gitpython- Ujawniono
- 22.10.2026
- Aktualizacja
- 26.10.2026 10:00
Źródła i licencje · Redakcja lub tłumaczenie: DockRay. Zachowano prawa źródeł i obowiązujące licencje.
OSV / GitHub Advisory Database - GHSA-83vg-56qc-22m7 - CC BY 4.0
Historia podatności: gitpython
Wszystkie opisane podatności tej paczki (Python (PyPI)), od najnowszej. Widać, czy to jednorazowa wpadka, czy paczka, której trzeba pilnować.
- Wszystkich wpisów
- 43
- Pierwsza → ostatnia
- 12.2022 10.2026
- Bez poprawki
- 0
- Wykorzystywana w atakach
- 0
Rozkład istotności
- Krytyczna 3
- Wysoka 30
- Średnia 10
Ujawnienia w latach
- 2022: 1
- 2023: 3
- 2024: 1
- 2025: 0
- 2026: 38
-
GitPython weryfikuje ścieżkę podmodułu ".git" dopiero po sklonowaniu do niej (RCE) ten wpis
Dowiedz się, które podatności dotyczą Twojej aplikacji
Po podłączeniu integracji DockRay i włączeniu raportowania oprogramowania DockRay porównuje zgłoszone wersje komponentów ze znanymi podatnościami i powiadamia o potwierdzonych dopasowaniach. Zakres zależy od obsługiwanej technologii i dostępnych biuletynów.