Parametr refspec w GitPython Remote.pull() omija zabezpieczenie opcji --upload-pack, umożliwiając wykonanie dowolnych poleceń
Podsumowanie
Remote.pull() w GitPython przekazuje swój pozycyjny argument refspec bezpośrednio do procesu potomnego git pull, podczas gdy mechanizm ochrony przed niebezpiecznymi opcjami weryfikuje wyłącznie argumenty nazwane. Aplikacja przekazująca dane pochodzące od atakującego jako refspec (na przykład podaną przez użytkownika gałąź lub parametr refspec w usłudze internetowej bądź CI) może dostarczyć wartość przypominającą opcję, taką jak --upload-pack=<command>. Wartość ta omija sprawdzenie unsafe_git_pull_options, zostaje umieszczona za separatorem -- w wierszu poleceń git pull i jest wykonywana jako program upload-pack dla transportu po ścieżce lokalnej lub przez SSH. Skutkuje to wykonaniem dowolnych poleceń z uprawnieniami procesu wywołującego przy użyciu udokumentowanych argumentów domyślnych (allow_unsafe_options=False).
Przyczyna błędu
Zgodnie z dokumentacją Remote.pull() odrzuca niebezpieczne opcje, chyba że przekazano allow_unsafe_options=True, a --upload-pack jest wprost wymieniona jako taka opcja. Zabezpieczenie sprawdza jednak wyłącznie argumenty nazwane, pomijając argument pozycyjny refspec. Weryfikacja buduje listę kandydatów za pomocą Git._option_candidates([], kwargs), przekazując pustą listę w miejsce argumentów pozycyjnych, w związku z czym wartość refspec nigdy nie jest porównywana z unsafe_git_pull_options = ["--upload-pack"]. Następnie znormalizowany refspec jest dosłownie przekazywany do wywołania git pull. Początkowy separator --, który neutralizuje refspec w formie opcji dla git fetch oraz git push, nie chroni git pull, ponieważ git pull ponownie przekazuje końcowe argumenty pozycyjne do wewnętrznego wywołania git fetch bez ponownego wstawienia separatora --, przez co argument pozycyjny staje się opcją dla tego wewnętrznego pobrania.
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)
Wpływ
Atakujący kontrolujący wartość refspec przekazywaną do Remote.pull() uzyskuje możliwość wykonania dowolnych poleceń w systemie operacyjnym z uprawnieniami procesu wywołującego GitPython, bez dodatkowych uprawnień i bez interakcji ze strony użytkownika, na domyślnej ścieżce kodu. Wykorzystanie podatności wymaga, aby zdalne repozytorium korzystało z transportu uruchamiającego upload-pack po stronie lokalnej (lokalnej ścieżki w systemie plików lub SSH); w przypadku protokołu HTTPS wartość --upload-pack pozostaje bezużyteczna, ponieważ serwer ignoruje program upload-pack wskazany przez klienta. Ten wymóg transportu zawęża grupę podatnych wdrożeń, lecz nie utrudnia zadania atakującemu po dotarciu do podatnego celu. Repozytoria robocze powszechnie korzystają ze ścieżek lokalnych lub protokołu SSH, dlatego narażona populacja jest znaczna.
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).
Kroki reprodukcji:
- Utwórz repozytorium źródłowe dostępne przez transport ścieżki lokalnej.
- W repozytorium docelowym zarejestruj ten punkt źródłowy i wywołaj
Remote.pull()z parametrem refspec kontrolowanym przez atakującego. - Zaobserwuj, że wstrzyknięte polecenie zostaje wykonane.
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
Łańcuch ataku
- Ekspozycja: Aplikacja wywołuje
Remote.pull(refspec=<value>)na domyślnej ścieżce, gdzie<value>pochodzi z danych kontrolowanych przez atakującego, np. parametru żądania gałęzi lub refspec. - Kontrola: Atakujący podaje ciąg znaków
--upload-pack=<command>; git-upload-pack. Wartość przechodzi przezGit._unpack_args, co jedynie spłaszcza ją i konwertuje na ciąg znaków, zachowując postać opcji. - Ścieżka: Pętla protokołu wywołuje
Git.check_unsafe_protocolsna wartości, co dopasowuje wyłącznie adresy URL transportu remote-helper (postać<transport>::) i nie oznacza tokenu--upload-pack=. - Zabezpieczenie: Mechanizm weryfikacji niebezpiecznych opcji wywołuje
check_unsafe_options(options=Git._option_candidates([], kwargs), ...). Ponieważ argumenty pozycyjne są przekazywane jako pusta lista, pozycyjnyrefspecnigdy nie jest weryfikowany pod kątemunsafe_git_pull_options. - Prymityw: Wartość zostaje przekazana do
git pull -v -- <remote> --upload-pack=<command>; git-upload-pack;git pullponownie przekazuje argument pozycyjny do wewnętrznegogit fetchbez separatora--, przez co jest on traktowany jako program upload-pack. - Rezultat: W przypadku transportu po ścieżce lokalnej lub przez SSH git wykonuje
<command>jako program upload-pack, co pozwala na wykonanie dowolnych poleceń z uprawnieniami użytkownika procesu wywołującego.
Dowód obejścia
Właściwym mechanizmem ochronnym jest wywołanie check_unsafe_options w Remote.pull(), obecne w aktualnie wydanym pakiecie. Jest ono niekompletne: sprawdza Git._option_candidates([], kwargs), co uwzględnia wyłącznie argumenty nazwane, więc pozycyjny refspec nigdy nie jest weryfikowany. Zostało to potwierdzone empirycznie: przekazanie tej samej wartości jako argumentu nazwanego upload_pack= wywołuje UnsafeOptionError, natomiast przekazanie jej jako argumentu pozycyjnego refspec nie powoduje błędu, co dowodzi, że tylko parametr pozycyjny omija zabezpieczenie.
Separator -- w wierszu poleceń git pull został przetestowany jako potencjalne zabezpieczenie i odrzucony: przy użyciu systemowego gita 2.43.0 wywołanie git pull -- <remote> '--upload-pack=<cmd>' wykonało wstrzyknięte polecenie, podczas gdy ta sama wartość podana do git fetch -- ... i git push -- ... nie została wykonana, ponieważ te podpolecenia honorują znak końca opcji --, podczas gdy git pull przekazuje argumenty pozycyjne do wewnętrznego polecenia fetch bez niego. Zbadano także weryfikację transportu check_unsafe_protocols, która nie oznacza tokenu --upload-pack=, ponieważ nie ma on postaci <transport>::. Żadne wcześniej opublikowane ostrzeżenie dla tego pakietu nie dotyczyło Remote.pull, argumentu pozycyjnego refspec w fetch lub pull ani wstrzyknięcia --upload-pack poprzez refspec; najbliższy zaakceptowany błąd dotyczył tej samej klasy podatności (argument pozycyjny omijający sprawdzanie ograniczone do argumentów nazwanych) w innej funkcji i miejscu docelowym.
Wersje dotknięte podatnością
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
Zabezpieczenie operacji pull sprawdzające jedynie argumenty nazwane wraz z ujściem w postaci pozycyjnego argumentu refspec występuje w każdym wydaniu od wersji 3.1.30 do najnowszego wydania 3.1.62, co potwierdzono poprzez inspekcję pliku git/remote.py w każdym oznaczonym tagiem wydaniu. Wersja 3.1.30 wprowadziła zabezpieczenie unsafe_git_pull_options; zakres podatności podano od tej granicy w ramach klasyfikacji niekompletnego zabezpieczenia. Wydania wcześniejsze niż 3.1.30 przekazują refspec pozycyjnie bez ochrony przed niebezpiecznymi opcjami i bez separatora --, więc również podlegają atakowi, jednak zakres określono zachowawczo od momentu wprowadzenia zabezpieczenia. Brak oficjalnego poprawionego wydania.
Sugerowana poprawka
Należy wymusić sprawdzanie niebezpiecznych opcji również dla argumentu pozycyjnego refspec, a nie tylko dla argumentów nazwanych. Zabezpieczenie powinno tworzyć listę kandydatów na podstawie rzeczywiście przekazywanych parametrów pozycyjnych (na przykład poprzez przekazanie znormalizowanej listy refspec do Git._option_candidates obok kwargs), tak aby refspec przypominający opcję, taki jak --upload-pack=..., był odrzucany z błędem UnsafeOptionError, chyba że ustawiono allow_unsafe_options=True. Tę samą korektę należy zweryfikować dla każdej innej ścieżki przekazywania referencji lub refspec, która opiera się na sprawdzaniu wyłącznie argumentów nazwanych. Jako tymczasowe obejście problemu bez modyfikacji kodu, aplikacje wywołujące powinny weryfikować lub odrzucać wartości refspec zaczynające się od -, unikać przekazywania niezaufanych danych jako refspec oraz preferować zdalne repozytoria HTTPS, w przypadku których program upload-pack podany przez klienta pozostaje bez wpływu.
Zgłoszone przez zx (GitHub: @manus-pi).
Co trzeba zrobić
Zaktualizuj pakiet gitpython do wersji 3.2.0 lub nowszej. Jako tymczasowe obejście problemu bez zmian w kodzie należy weryfikować lub odrzucać wartości refspec zaczynające się od myślnika, unikać przekazywania niezaufanych danych jako parametrów refspec oraz preferować repozytoria zdalne HTTPS, gdzie program upload-pack wskazany przez klienta pozostaje zignorowany.
Czego dotyczy
Kliknij technologię, aby zobaczyć wszystkie dotyczące jej podatności.
| Platforma | Paczka | Podatne wersje | Poprawka w wersji |
|---|---|---|---|
| Python (PyPI) | gitpython | >= 3.1.30, < 3.2.0 | 3.2.0 |
Odnośniki
- 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
- Wektor CVSS
CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:H- Słabość (CWE)
CWE-78, CWE-88- Platforma
- Python (PyPI)
- Paczka
gitpython- Ujawniono
- 27.10.2026
- Aktualizacja
- 31.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-f9j4-qggq-h239 - 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
-
Parametr refspec w GitPython Remote.pull() omija zabezpieczenie opcji --upload-pack, umożliwiając wykonanie dowolnych poleceń 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.