Code Graph RAG: Strukturelle Werkzeuge folgen symbolischen Links außerhalb der Root
Ein entfernter oder lokaler Angreifer, der einen symbolischen Link in ein von code-graph-rag analysiertes Quellcode-Repository einfügen kann, kann die Werkzeuge structural_search und structural_replace (unterstützt von AstGrepService, bereitgestellt sowohl als MCP-Tools als auch als agentenbasierte KI-Tools) dazu veranlassen, beliebige Dateien außerhalb des konfigurierten Projektstamms zu lesen und – über structural_replace mit dry_run=False – zu überschreiben. Dies ist möglich, da die Pfadüberprüfung des Werkzeugs (should_skip_path/_classify_file) lediglich lexikalisch auf dem nicht aufgelösten Pfad durchgeführt wird und niemals Path.is_symlink() prüft oder .resolve() aufruft, anders als der (korrekte) projekteigene validate_project_path-Dekorator, der an anderer Stelle verwendet wird.
Getestet wurde dies bei Commit 90a3ed3cbdc7d3bb8036985b851cc7c9a3ba9c57 (pyproject-Version 0.0.550), dem aktuellen main zum Testzeitpunkt. Es wurde bestätigt, dass dieser Commit bereits den Fix für den vorherigen Sicherheitshinweis (GHSA-vvr2-h2jp-838m: paginierte read_file-Pfadüberquerung) und das neuere HTTP-MCP-Bearer-Auth-Gate (_validate_http_exposure in codebase_rag/mcp/server.py) enthält. Es handelt sich um ein eigenständiges, weiterhin offenes Problem zusätzlich zu diesen Korrekturen, in einer anderen Komponente mit einer anderen Ursache und schwerwiegenderen Auswirkungen (Schreiben, nicht nur Lesen).
Details
AstGrepService (codebase_rag/tools/ast_grep_service.py) unterstützt sowohl die structural_search- als auch die structural_replace-MCP-/Agenten-Tools. Es zählt Kandidatendateien mit os.walk() auf und sichert jeden Pfad nur über should_skip_path() ab:
codebase_rag/tools/ast_grep_service.py:84-109(_iter_source_files) – durchläuftself.project_rootmitos.walk(); jeder zurückgegebene Eintrag, der kein Verzeichnis ist (einschließlich eines Symlinks, der auf eine beliebige Stelle auf der Festplatte verweist), wird als relevante Datei behandelt.codebase_rag/tools/ast_grep_service.py:61-82(_classify_file) – die einzige Containment-Prüfung istshould_skip_path(...), gefolgt vonabs_path.relative_to(self.project_root)(Zeile 82);abs_pathwird nie aufgelöst, sodass diese Prüfung rein lexikalisch bzw. zeichenkettenbasiert ist.codebase_rag/utils/path_utils.py:80-109(should_skip_path) undcodebase_rag/utils/path_utils.py:35-37(cached_relative_path) – berechnetrel_path = file_path.relative_to(repo_path), ohne jemals.resolve()oderPath.is_symlink()aufzurufen.- Lese-Senke:
codebase_rag/tools/ast_grep_service.py:143-144(search) –source = self._read(abs_path)ruftpath.read_text()auf, dem Python über den Symlink zu seinem realen Ziel folgt. - Schreib-Senke:
codebase_rag/tools/ast_grep_service.py:187-208(replace), Zeile 208 –abs_path.write_text(new_source, ...), wenndry_run=False, folgt erneut dem Symlink und überschreibt den Inhalt der tatsächlichen Zieldatei.
Dies widerspricht der Vorgehensweise im restlichen Codebestand für dieselbe Risikoklasse. Die Datei-Lese-/Schreib-/Bearbeitungswerkzeuge (file_reader.py, file_writer.py, file_editor.py) sind alle durch validate_project_path (codebase_rag/decorators.py:73-75) geschützt:
full_path = (self.project_root / file_path_str).resolve()
project_root = self.project_root.resolve()
full_path.relative_to(project_root)
.resolve() folgt Symlinks, bevor die Containment-Prüfung ausgeführt wird, sodass diese Werkzeuge Ziele außerhalb des Stammpfads korrekt ablehnen. Die eigene Funktion absolute_path_within_project_root() (codebase_rag/utils/path_utils.py:156-176) von path_utils.py dokumentiert dasselbe Prinzip explizit in ihrem Docstring: "The resolve() calls are load-bearing: containment is checked lexically, so an unresolved .. segment or symlink would escape the root." – jedoch wendet should_skip_path()/AstGrepService dieses Muster niemals an.
Erreichbarkeit: structural_search (codebase_rag/tools/structural_search.py:24-46) besitzt keinerlei requires_approval-Flag – im KI-Orchestrator-Modus kann das Modell die Funktion autonom ohne menschliche Bestätigung aufrufen. structural_replace (codebase_rag/tools/structural_editor.py:52-57) ist als requires_approval=True gekennzeichnet, aber dieses Flag wird nur von der eigenen Agentenschleife von pydantic-ai erzwungen – der MCP-Server-Pfad umgeht dies vollständig: MCPToolsRegistry.structural_replace (codebase_rag/mcp/tools.py:586-596) ruft self._structural_editor_tool.function(...) direkt auf, registriert ohne jegliches Genehmigungskonzept in codebase_rag/mcp/tools.py:369-388. Jeder MCP-Client, der Werkzeuge aufrufen kann, kann structural_replace mit dry_run=False in einem einzigen Aufruf ausführen.
Proof of Concept
Dynamisch gegen das installierte Paket bestätigt (mgclient/pymgclient gemockt, wie im PoC des vorherigen Hinweises, da der native Memgraph-Client für diesen Codepfad nicht erforderlich ist).
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())
Tatsächliche Ausgabe des Testlaufs:
[*] 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.
Auswirkungen
Jeder Betreiber, der cgr (CLI, agentischer ask_agent-Modus oder die MCP-Tools structural_search/structural_replace) auf ein nicht vollständig geprüftes Repository anwendet – genau der vorgesehene Anwendungszweck dieses Tools ("query, understand, and edit multi-language codebases") –, riskiert, dass ein platziertes Symlink für Folgendes ausgenutzt wird:
- Offenlegung des Inhalts jeder Datei, die vom
cgr-Prozess gelesen werden kann (Anmeldedaten, SSH-Schlüssel,.env-Dateien, Quellcode benachbarter Projekte), überstructural_search, ganz ohne Genehmigungsschranke. - Überschreiben des Inhalts jeder Datei, die vom
cgr-Prozess beschrieben werden kann, überstructural_replace(dry_run=False), wodurch bei Aufrufen über das MCP-Protokoll die interne Genehmigungsschranke des Werkzeugs umgangen wird.
Danksagung: Dostxodjayev Abdullox (GitHub: squeeze440)
Was zu tun ist
Wenden Sie dasselbe Resolve-then-Contain-Muster, das bereits von validate_project_path (codebase_rag/decorators.py:73-75) und absolute_path_within_project_root (codebase_rag/utils/path_utils.py:156-176) verwendet wird, auf should_skip_path an. Weisen Sie jeden Pfad ab, dessen aufgelöster Speicherort (nach Verfolgen von Symlinks) den aufgelösten Projektstamm verlässt:
--- 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)
Konkret behebt diese eine Änderung in should_skip_path sowohl _classify_file (Suche) als auch die Filterung von os.walk in _iter_source_files (Ersetzen), da beide darüber geroutet werden. Als Defense-in-Depth-Maßnahme könnte _iter_source_files symverlinkte Verzeichniseinträge während os.walk direkt überspringen (entry.is_symlink()).
Ein Update auf Version 0.0.587 oder höher wird empfohlen.
Betroffene Software
Klicken Sie auf eine Technologie, um alle zugehörigen Schwachstellen anzuzeigen.
| Plattform | Paket | Anfällige Versionen | Behoben in |
|---|---|---|---|
| Python (PyPI) | code-graph-rag | < 0.0.587 | 0.0.587 |
Verweise
- 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
- CVSS-Vektor
CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:N- Schwäche (CWE)
CWE-22, CWE-59- Plattform
- Python (PyPI)
- Paket
code-graph-rag- Veröffentlicht
- 09.11.2026
- Aktualisiert
- 11.11.2026 10:00
Quellen und Lizenzen · Von DockRay bearbeitet oder übersetzt; Rechte und Lizenzen der Quellen bleiben erhalten.
OSV / GitHub Advisory Database - GHSA-85gg-2gfq-q95m - CC BY 4.0
Schwachstellenhistorie: code-graph-rag
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.
- Einträge insgesamt
- 2
- Erste → letzte
- 11.2026 11.2026
- Ohne Fix
- 0
- In Angriffen ausgenutzt
- 0
Verteilung nach Schweregrad
- Hoch 2
Veröffentlichungen pro Jahr
- 2026: 2
-
Code Graph RAG: Strukturelle Werkzeuge folgen symbolischen Links außerhalb der Root dieser Eintrag
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.