AG2: Wstrzyknięcie znaku nowej linii w SandboxShellTool omija allowed=[...] i readonly=True, umożliwiając wykonanie dowolnych poleceń
Podsumowanie
Tryby ograniczone narzędzia SandboxShellTool — allowed=[...] (jawna lista dozwolonych poleceń) oraz readonly=True (niejawna lista dozwolonych poleceń READONLY_COMMANDS) — mogą zostać pominięte poprzez umieszczenie znaku nowej linii wewnątrz ciągu polecenia. Mechanizm filtrujący sprawdza jedynie jednoliniowy zestaw metaznaków powłoki, podczas gdy wykonanie przekazuje surowy ciąg znaków do sh -c, gdzie powłoka traktuje osadzony znak nowej linii dokładnie tak samo jak separator instrukcji ;. Agent (lub treść sterująca agentem, np. w wyniku prompt injection) może zatem wykonać dowolne polecenia powłoki, nawet jeśli narzędzie zostało skonfigurowane tak, aby zezwalać wyłącznie na określony prefiks polecenia lub wyłącznie na polecenia tylko do odczytu. W przypadku domyślnego backendu LocalEnvironment() polecenia uruchamiane są w rzeczywistym podprocesie na hoście (zgodnie z własnym ciągiem dokumentacyjnym: „Commands run via subprocess on the host, so there is no real isolation”), a nie w odizolowanym kontenerze, co oznacza pełne wykonanie poleceń na hoście, a nie tylko ucieczkę z uprzednio zabezpieczonego środowiska piaskownicy.
Szczegóły
Oba tryby ograniczone są egzekwowane przez ShellAdapter._filter() w ag2/tools/sandbox/adapter/shell.py:
def _filter(self, command: str) -> str | None:
if self._allowed is not None:
if not any(matches(p, command) for p in self._allowed):
return f"Command not allowed: {command!r}"
if contains_shell_operator(command):
return f"Command not allowed (shell operators are not permitted in restricted mode): {command!r}"
...
readonly=True wykorzystuje dokładnie to samo odgałęzienie: SandboxShellTool.__init__ / ShellAdapter.__init__ ustawia self._allowed = list(READONLY_COMMANDS), gdy zdefiniowano readonly i nie podano jawnego allowed, przez co oba tryby współdzielą ten sam filtr i podatność na obejście.
contains_shell_operator() w ag2/tools/sandbox/filter.py weryfikuje polecenie pod kątem:
_SHELL_OPERATORS: tuple[str, ...] = (">", ">>", "|", ";", "&&", "||", "`", "$(")
Krotka ta nie zawiera wpisu dla \n (ani \r). matches() sprawdza jedynie, czy polecenie rozpoczyna się od dozwolonego prefiksu, po którym następuje spacja lub koniec ciągu znaków; dalsza część ciągu nie jest w ogóle weryfikowana. Wykonanie odbywa się poprzez:
argv = ["sh", "-c", command]
...
return await sandbox.exec(argv, env=self._env, timeout=self._timeout)
Powłoka POSIX dzieli sh -c "<line1>\n<line2>" na dwie sekwencyjne instrukcje, dokładnie tak samo, jakby były one oddzielone znakiem ;. Z tego powodu polecenie takie jak "cat allowed_file.txt\nrm -rf /anything":
- Przechodzi test
matches("cat", command)— ciąg zaczyna się od"cat ". -
- Przechodzi test
contains_shell_operator(command)—\nnie jest rozpoznawanym operatorem.
- Przechodzi test
-
- Trafia do
sh -c "cat allowed_file.txt\nrm -rf /anything", co prowadzi do wykonania obu instrukcji.
- Trafia do
Proof of Concept
Podatność została zweryfikowana bezpośrednio w bieżącej gałęzi main (github.com/ag2ai/ag2, commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0, sklonowany 2026-09-21) poprzez zaimportowanie rzeczywistego modułu ag2/tools/sandbox/filter.py (wyłącznie biblioteka standardowa, bez konieczności instalowania innych zależności AG2) i odtworzenie logiki gałęzi allowlisty z ShellAdapter._filter():
=== allowed=['cat'] ===
'cat /etc/passwd; rm -rf /tmp/x' -> Command not allowed (shell operators are not permitted in restricted mode): ...
'cat /etc/passwd && rm -rf /tmp/x' -> Command not allowed (shell operators are not permitted in restricted mode): ...
'cat /etc/passwd | rm -rf /tmp/x' -> Command not allowed (shell operators are not permitted in restricted mode): ...
'cat /etc/passwd\nrm -rf /tmp/x' -> None <-- BYPASS: newline variant is NOT rejected
=== readonly=True (uses READONLY_COMMANDS as the allowed list) ===
'echo hi\nid' -> None <-- BYPASS in readonly mode too
=== sh -c really treats the embedded newline as a second statement (mirrors ShellAdapter._exec_async) ===
$ sh -c 'echo first-command-output\necho SECOND-STATEMENT-RAN-$((21*2))'
first-command-output
SECOND-STATEMENT-RAN-42
Trzy standardowe próby łączenia poleceń (;, &&, |) są prawidłowo odrzucane przez filtr, co potwierdza jego działanie; jednak wariant rozdzielony znakiem nowej linii, realizujący ten sam zamiar, zostaje zaakceptowany przez ten sam filtr w obu trybach ograniczonych, a wywołanie sh -c potwierdza, że powłoka wykonuje obie instrukcje.
Wpływ
Każdy agent skonfigurowany z SandboxShellTool(allowed=[...]) lub SandboxShellTool(readonly=True) — dwiema konfiguracjami, które dokumentacja narzędzia przedstawia jako rzeczywiste granice bezpieczeństwa, w przeciwieństwie do blocked, o którym ta sama dokumentacja wprost mówi: „is not a security boundary” — może zostać zmuszony do wykonania dowolnych poleceń powłoki za pomocą pojedynczego znaku nowej linii umieszczonego w argumencie polecenia. Ponieważ argumenty narzędzi są generowane przez model LLM i mogą być sterowane przez treści przetwarzane przez agenta (pobrany dokument, dane wyjściowe narzędzia lub jakikolwiek inny tekst trafiający do modelu — tj. pośrednie wstrzyknięcie promptu / indirect prompt injection), podatność można wywołać bez konieczności wprowadzania złośliwego polecenia bezpośrednio przez operatora agenta. W przypadku domyślnego backendu LocalEnvironment() wykonanie poleceń następuje w procesie hosta uruchamiającym agenta i nie jest ograniczone do kontenera.
Sugerowane środki zaradcze
- Dodanie
"\n"oraz"\r"do_SHELL_OPERATORSwag2/tools/sandbox/filter.py, abycontains_shell_operator()odrzucał osadzone znaki nowej linii w taki sam sposób, w jaki odrzuca;. - Bardziej niezawodnym rozwiązaniem jest wykonywanie poleceń z białej listy / tylko do odczytu bez wywoływania powłoki w trybie ograniczonym (
shlex.split+ exec bez wrapperash -c), dzięki czemu przekierowania, łączenie poleceń, podstawienia oraz wszelkie separatory instrukcji stają się nieskuteczne z założenia architektonicznego, zamiast polegać na enumeracyjnej czarnej liście.
Testowane środowisko
- Repozytorium: github.com/ag2ai/ag2, commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0 (main), sklonowane 2026-09-21.
- Pakiet PyPI
ag2, wersja 1.0.5 zgodnie zpyproject.tomlw tym commicie. - Python 3, wyłącznie biblioteka standardowa (
subprocess,importlib) w połączeniu z rzeczywistym, niezmodyfikowanymag2/tools/sandbox/filter.py— brak wymaganych zależności runtime AG2 do odtworzenia problemu.
Co trzeba zrobić
W przypadku pakietu ag2 należy zaktualizować go do wersji 1.1.1 lub nowszej. Dla pakietu autogen wersja naprawiona nie została ustalona. Alternatywnie można zastosować sugerowane środki zaradcze: odrzucanie znaków nowej linii w filtrze wejściowym lub wykonywanie dozwolonych poleceń bezpośrednio bez użycia powłoki.
Czego dotyczy
Kliknij technologię, aby zobaczyć wszystkie dotyczące jej podatności.
| Platforma | Paczka | Podatne wersje | Poprawka w wersji |
|---|---|---|---|
| Python (PyPI) | ag2 | >= 0.13.2, < 1.1.1 | 1.1.1 |
| Python (PyPI) | autogen | >= 0.13.2, <= 0.14.1 | brak poprawki |
Odnośniki
- Wektor CVSS
CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H- Słabość (CWE)
CWE-184, CWE-78- Platforma
- Python (PyPI)
- Paczka
ag2, autogen- Ujawniono
- 10.11.2026
- Aktualizacja
- 12.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-2h4w-29cv-2cmv - CC BY 4.0
Historia podatności: ag2
Wszystkie opisane podatności tej paczki (Python (PyPI)), 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.