Narzędzia strukturalne Code Graph RAG podążają za dowiązaniami symbolicznymi poza katalog główny
Zdalny lub lokalny atakujący, który może umieścić dowiązanie symboliczne w repozytorium kodu źródłowego analizowanym przez code-graph-rag, może spowodować, że narzędzia structural_search oraz structural_replace (oparte na AstGrepService, udostępniane zarówno jako narzędzia MCP, jak i narzędzia agentów AI) odczytają oraz — poprzez structural_replace z parametrem dry_run=False — nadpiszą dowolne pliki poza skonfigurowanym katalogiem głównym projektu. Wynika to z faktu, że weryfikacja przynależności ścieżki do katalogu bazowego (should_skip_path/_classify_file) jest przeprowadzana leksykalnie na nierozwiązanej ścieżce i nigdy nie sprawdza Path.is_symlink() ani nie wywołuje .resolve(), w przeciwieństwie do poprawnego dekoratora validate_project_path używanego w innych częściach projektu.
Podatność przetestowano na commicie 90a3ed3cbdc7d3bb8036985b851cc7c9a3ba9c57 (wersja pyproject 0.0.550), który był aktualnym main w momencie testów. Potwierdzono, że commit ten zawiera już poprawkę poprzedniego zgłoszenia (GHSA-vvr2-h2jp-838m: stronicowane przechodzenie przez ścieżki w read_file) oraz nowszą bramkę uwierzytelniania tokenem bearer w HTTP-MCP (_validate_http_exposure w codebase_rag/mcp/server.py) — jest to odrębny, nadal otwarty problem niezależny od tych poprawek, w innym komponencie, z inną przyczyną źródłową i poważniejszymi skutkami (zapis, a nie tylko odczyt).
Szczegóły
AstGrepService (codebase_rag/tools/ast_grep_service.py) stanowi podstawę zarówno dla narzędzi MCP/agentowych structural_search, jak i structural_replace. Wylicza pasujące pliki za pomocą os.walk() i weryfikuje każdą ścieżkę wyłącznie przez should_skip_path():
codebase_rag/tools/ast_grep_service.py:84-109(_iter_source_files) — przeszukujeself.project_rootza pomocąos.walk(); każdy zwrócony wpis niebędący katalogiem (w tym dowiązanie symboliczne wskazujące dowolne miejsce na dysku) jest traktowany jako plik objęty zakresem.codebase_rag/tools/ast_grep_service.py:61-82(_classify_file) — jedynym sprawdzeniem ograniczenia ścieżki jestshould_skip_path(...), a następnieabs_path.relative_to(self.project_root)(linia 82); ścieżkaabs_pathnigdy nie jest rozwiązywana, więc sprawdzenie to ma charakter czysto leksykalny/napisowy.codebase_rag/utils/path_utils.py:80-109(should_skip_path) orazcodebase_rag/utils/path_utils.py:35-37(cached_relative_path) — obliczarel_path = file_path.relative_to(repo_path)bez wywoływania.resolve()aniPath.is_symlink().- Ujście odczytu (read sink):
codebase_rag/tools/ast_grep_service.py:143-144(search) —source = self._read(abs_path)wywołujepath.read_text(), które w Pythonie podąża za dowiązaniem symbolicznym do jego rzeczywistego celu. - Ujście zapisu (write sink):
codebase_rag/tools/ast_grep_service.py:187-208(replace), linia 208 —abs_path.write_text(new_source, ...), gdydry_run=False, ponownie podążając za dowiązaniem symbolicznym i nadpisując zawartość docelowego pliku.
Jest to niespójne ze sposobem obsługi tej samej klasy ryzyka w pozostałej części bazy kodu. Narzędzia do odczytu/zapisu/edycji plików (file_reader.py, file_writer.py, file_editor.py) są chronione przez validate_project_path (codebase_rag/decorators.py:73-75):
full_path = (self.project_root / file_path_str).resolve()
project_root = self.project_root.resolve()
full_path.relative_to(project_root)
.resolve() podąża za dowiązaniami symbolicznymi przed uruchomieniem weryfikacji ograniczenia katalogu, dzięki czemu narzędzia te prawidłowo odrzucają cele spoza katalogu głównego. Funkcja absolute_path_within_project_root() (codebase_rag/utils/path_utils.py:156-176) z path_utils.py dokumentuje tę samą zasadę wprost w swoim docstringu: "The resolve() calls are load-bearing: containment is checked lexically, so an unresolved .. segment or symlink would escape the root." — jednak should_skip_path()/AstGrepService nie stosuje tego wzorca.
Osiągalność: structural_search (codebase_rag/tools/structural_search.py:24-46) nie posiada żadnej flagi requires_approval — w trybie orkiestratora AI model może wywołać go autonomicznie bez potwierdzenia ze strony człowieka. structural_replace (codebase_rag/tools/structural_editor.py:52-57) jest oznaczony jako requires_approval=True, lecz flaga ta jest egzekwowana wyłącznie przez pętlę agenta pydantic-ai — ścieżka serwera MCP całkowicie ją omija: MCPToolsRegistry.structural_replace (codebase_rag/mcp/tools.py:586-596) wywołuje bezpośrednio self._structural_editor_tool.function(...), zarejestrowane bez żadnej koncepcji zatwierdzania w codebase_rag/mcp/tools.py:369-388. Dowolny klient MCP uprawniony do wywoływania narzędzi może uruchomić structural_replace wraz z dry_run=False w pojedynczym wywołaniu.
Proof of Concept
Potwierdzono dynamicznie na zainstalowanym pakiecie (mgclient/pymgclient zamockowane, podobnie jak w PoC poprzedniego zgłoszenia, ponieważ natywny klient Memgraph nie jest wymagany dla tej ścieżki kodu).
mkdir -p /tmp/poc_symlink/safe-project-root
cat > /tmp/poc_symlink/outside-secret.py << 'EOF'
API_TOKEN = "sk-live-EXAMPLE-NOT-A-REAL-SECRET-1234567890"
def get_token():
return API_TOKEN
EOF
ln -s /tmp/poc_symlink/outside-secret.py /tmp/poc_symlink/safe-project-root/linked_module.py
import sys
from pathlib import Path
from unittest.mock import MagicMock
sys.modules["mgclient"] = MagicMock()
sys.modules["pymgclient"] = MagicMock()
from codebase_rag.tools.ast_grep_service import AstGrepService
SAFE_ROOT = "/tmp/poc_symlink/safe-project-root"
svc = AstGrepService(project_root=SAFE_ROOT)
matches = svc.search(pattern="API_TOKEN", language="python")
# -> match in reported file='linked_module.py' text='API_TOKEN' (read escape)
changes = svc.replace(pattern="API_TOKEN", rewrite="PWNED_BY_STRUCTURAL_REPLACE",
language="python", dry_run=False)
print(Path("/tmp/poc_symlink/outside-secret.py").read_text())
Rzeczywisty wynik uruchomienia:
[*] Calling AstGrepService.search('API_TOKEN', language='python') ...
match in reported file='linked_module.py' text='API_TOKEN'
match in reported file='linked_module.py' text='API_TOKEN'
[+] READ ESCAPE CONFIRMED: content of the out-of-root file was returned by
structural_search(), attributed to a path 'inside' the project root.
[*] Calling AstGrepService.replace(pattern='API_TOKEN',
rewrite='PWNED_BY_STRUCTURAL_REPLACE', dry_run=False) ...
wrote change to reported file='linked_module.py' matches=2
[*] Outside file content AFTER structural_replace:
------------------------------------------------------------
# Simulated sensitive file OUTSIDE the analyzed project root
PWNED_BY_STRUCTURAL_REPLACE = "sk-live-EXAMPLE-NOT-A-REAL-SECRET-1234567890"
def get_token():
return PWNED_BY_STRUCTURAL_REPLACE
------------------------------------------------------------
[+] WRITE ESCAPE CONFIRMED: a file OUTSIDE the configured project_root
(/tmp/poc_symlink/safe-project-root) was modified by structural_replace
via a symlink placed inside the root.
Wpływ
Każdy operator, który uruchomi cgr (wiersz poleceń CLI, tryb agentowy ask_agent lub narzędzia MCP structural_search/structural_replace) na repozytorium, które nie zostało w pełni zaudytowane — czyli w scenariuszu, do którego narzędzie zostało zaprojektowane ("query, understand, and edit multi-language codebases") — naraża się na wykorzystanie umieszczonego dowiązania symbolicznego do:
- Ujawnienia zawartości dowolnego pliku czytelnego dla procesu
cgr(dane uwierzytelniające, klucze SSH, pliki.env, kod źródłowy sąsiednich projektów) za pośrednictwemstructural_search, bez żadnej bramki zatwierdzania. - Nadpisania zawartości dowolnego pliku zapisywalnego dla procesu
cgrza pośrednictwemstructural_replace(dry_run=False), z pominięciem własnego mechanizmu zatwierdzania narzędzia przy wywołaniu przez protokół MCP.
Podziękowania: Dostxodjayev Abdullox (GitHub: squeeze440)
Co trzeba zrobić
Zastosuj ten sam wzorzec sprawdzania (resolve-then-contain), który jest już używany przez validate_project_path (codebase_rag/decorators.py:73-75) oraz absolute_path_within_project_root (codebase_rag/utils/path_utils.py:156-176), w should_skip_path. Odrzucaj każdą ścieżkę, której rozwiązana lokalizacja (po przejściu dowiązań symbolicznych) wykracza poza rozwiązany katalog główny projektu:
--- a/codebase_rag/utils/path_utils.py
+++ b/codebase_rag/utils/path_utils.py
@@ def should_skip_path(
_is_file = path.is_file() if is_file is None else is_file
if _is_file and path.suffix in cs.IGNORE_SUFFIXES:
return True
+ # Reject symlinks (or any path) that resolve outside the project root,
+ # mirroring validate_project_path's decorator (decorators.py:73-75) and
+ # absolute_path_within_project_root (this module, below).
+ try:
+ path.resolve().relative_to(repo_path.resolve())
+ except ValueError:
+ return True
rel_path = cached_relative_path(path, repo_path)
W praktyce ta pojedyncza zmiana w should_skip_path naprawia zarówno _classify_file (wyszukiwanie), jak i filtrowanie os.walk w _iter_source_files (zastępowanie), ponieważ oba komponenty przez nią przechodzą. W ramach obrony w głąb (defense in depth), _iter_source_files może dodatkowo całkowicie pomijać wpisy katalogowe będące dowiązaniami symbolicznymi (entry.is_symlink()) podczas os.walk.
Zaleca się aktualizację do wersji 0.0.587 lub nowszej.
Czego dotyczy
Kliknij technologię, aby zobaczyć wszystkie dotyczące jej podatności.
| Platforma | Paczka | Podatne wersje | Poprawka w wersji |
|---|---|---|---|
| Python (PyPI) | code-graph-rag | < 0.0.587 | 0.0.587 |
Odnośniki
- https://github.com/vitali87/code-graph-rag/security/advisories/GHSA-85gg-2gfq-q95m
- https://nvd.nist.gov/vuln/detail/CVE-2026-87008
- https://github.com/vitali87/code-graph-rag/commit/2648c95aa550ce2d9361a8e75ed669d5f4b451b8
- https://github.com/vitali87/code-graph-rag
- https://github.com/vitali87/code-graph-rag/releases/tag/v0.0.589
- Wektor CVSS
CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:N- Słabość (CWE)
CWE-22, CWE-59- Platforma
- Python (PyPI)
- Paczka
code-graph-rag- Ujawniono
- 09.11.2026
- Aktualizacja
- 11.11.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-85gg-2gfq-q95m - CC BY 4.0
Historia podatności: code-graph-rag
Wszystkie opisane podatności tej paczki (Python (PyPI)), od najnowszej. Widać, czy to jednorazowa wpadka, czy paczka, której trzeba pilnować.
- Wszystkich wpisów
- 2
- Pierwsza → ostatnia
- 11.2026 11.2026
- Bez poprawki
- 0
- Wykorzystywana w atakach
- 0
Rozkład istotności
- Wysoka 2
Ujawnienia w latach
- 2026: 2
-
Narzędzia strukturalne Code Graph RAG podążają za dowiązaniami symbolicznymi poza katalog główny 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.