AG2: Newline-Injection in SandboxShellTool umgeht allowed=[...] und readonly=True und ermöglicht die Ausführung beliebiger Befehle
Zusammenfassung
Die eingeschränkten Modi von SandboxShellTool – allowed=[...] (explizite Befehls-Allowlist) sowie readonly=True (implizite READONLY_COMMANDS-Allowlist) – können beide durch das Einfügen eines Zeilenumbruchzeichens (Newline) innerhalb der Befehlszeichenkette umgangen werden. Die Filterung prüft lediglich eine einzeilige Menge von Shell-Metazeichen, die Ausführung leitet den Roh-String jedoch an sh -c weiter, wo eine Shell einen eingebetteten Zeilenumbruch exakt wie ein ;-Anweisungstrennzeichen interpretiert. Ein Agent (oder Inhalte, die den Agenten steuern, z. B. über Prompt-Injection) kann daher beliebige Shell-Befehle ausführen, selbst wenn das Tool so konfiguriert wurde, dass nur ein bestimmtes Befehlspräfix oder ausschließlich schreibgeschützte Befehle zulässig sind. Mit dem Standard-Backend LocalEnvironment() handelt es sich hierbei um einen echten Host-Subprozess (laut eigenem Docstring: „Commands run via subprocess on the host, so there is no real isolation“) und nicht um einen isolierten Container. Es liegt somit eine vollständige Befehlsausführung auf dem Host-System vor und nicht lediglich ein Ausbruch aus einer bereits isolierten Sandbox-Umgebung.
Details
Beide eingeschränkten Modi werden durch ShellAdapter._filter() in ag2/tools/sandbox/adapter/shell.py durchgesetzt:
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 nutzt exakt denselben Zweig: SandboxShellTool.__init__ / ShellAdapter.__init__ setzt self._allowed = list(READONLY_COMMANDS), wenn readonly festgelegt ist und kein explizites allowed angegeben wurde. Beide Modi teilen sich somit denselben Filter und denselben Bypass.
contains_shell_operator() in ag2/tools/sandbox/filter.py prüft den Befehl anhand von:
_SHELL_OPERATORS: tuple[str, ...] = (">", ">>", "|", ";", "&&", "||", "`", "$(")
Dieses Tupel enthält keinen Eintrag für \n (oder \r). matches() prüft lediglich, ob der Befehl mit einem zulässigen Präfix beginnt, gefolgt von einem Leerzeichen oder dem Ende der Zeichenkette; der verbleibende Teil des Strings wird nicht überprüft. Die Ausführung erfolgt über:
argv = ["sh", "-c", command]
...
return await sandbox.exec(argv, env=self._env, timeout=self._timeout)
Eine POSIX-Shell teilt sh -c "<line1>\n<line2>" in zwei aufeinanderfolgende Anweisungen auf, genau wie bei einer Trennung durch ;. Ein Befehl wie "cat allowed_file.txt\nrm -rf /anything":
- Passiert
matches("cat", command)– die Zeichenkette beginnt mit"cat ". -
- Passiert
contains_shell_operator(command)–\nist kein erkanntes Metazeichen.
- Passiert
-
- Erreicht
sh -c "cat allowed_file.txt\nrm -rf /anything", wodurch beide Anweisungen ausgeführt werden.
- Erreicht
Proof of Concept
Direkt auf dem aktuellen Branch main verifiziert (github.com/ag2ai/ag2, Commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0, geklont 2026-09-21), indem das reale Modul ag2/tools/sandbox/filter.py importiert wurde (nur Standardbibliothek, keine weiteren AG2-Abhängigkeiten erforderlich) und der Allowlist-Zweig von ShellAdapter._filter() wortgetreu nachgebildet wurde:
=== 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
Die drei standardmäßigen Verkettungsversuche (;, &&, |) werden durch den Filter korrekt abgewiesen, was bestätigt, dass die Filterprüfung aktiv ist. Die durch Zeilenumbrüche getrennte Variante, die denselben Zweck erfüllt, wird von dem identischen Filter in beiden eingeschränkten Modi akzeptiert. Ein realer Aufruf von sh -c bestätigt, dass die Shell beide Anweisungen ausführt.
Auswirkungen
Jeder Agent, der mit SandboxShellTool(allowed=[...]) oder SandboxShellTool(readonly=True) konfiguriert ist – den beiden Konfigurationen, die laut dem eigenen Docstring des Tools tatsächliche Sicherheitsgrenzen darstellen (im Gegensatz zu blocked, bei dem derselbe Docstring explizit festhält, dass es sich um „keine Sicherheitsgrenze“ handelt) –, kann über einen einzelnen eingebetteten Zeilenumbruch im Befehlsargument dazu gebracht werden, beliebige Shell-Befehle auszuführen. Da Tool-Argumente durch ein LLM erzeugt werden und durch vom Agenten verarbeitete Inhalte (ein abgerufenes Dokument, Tool-Ausgaben oder beliebiger anderer Text, der das Modell erreicht – d. h. indirekte Prompt-Injection) gesteuert werden können, ist dieses Verhalten erreichbar, ohne dass der Operator des Agenten den schadhaften Befehl selbst verfassen muss. Mit dem standardmäßigen LocalEnvironment()-Backend erfolgt die Befehlsausführung im Host-Prozess, der den Agenten ausführt, und ist nicht auf einen Container beschränkt.
Empfohlene Abhilfemaßnahmen
- Hinzufügen von
"\n"und"\r"zu_SHELL_OPERATORSinag2/tools/sandbox/filter.py, sodasscontains_shell_operator()eingebettete Zeilenumbrüche analog zu;abweist. - Robuster: Ausführen von Befehlen aus der Allowlist bzw. von Readonly-Befehlen im eingeschränkten Modus ohne Aufruf einer Shell (
shlex.split+ Exec ohnesh -c-Wrapper), sodass Weiterleitungen, Verkettungen, Substitutionen und jegliche Arten von Anweisungstrennzeichen konstruktionsbedingt wirkungslos sind, anstatt sich auf eine Aufzählung in einer Denylist zu verlassen.
Getestete Umgebung
- Repository: github.com/ag2ai/ag2, Commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0 (main), geklont 2026-09-21.
- PyPI-Paket
ag2, Version 1.0.5 lautpyproject.tomlin diesem Commit. - Python 3, ausschließlich Standardbibliothek (
subprocess,importlib) gegen das reale, unveränderte Modulag2/tools/sandbox/filter.py– keine AG2-Laufzeitabhängigkeiten zur Reproduktion erforderlich.
Was zu tun ist
Für ag2 auf Version 1.1.1 oder höher aktualisieren. Für autogen ist derzeit keine behobene Version festgelegt. Als Übergangslösung können die im Quelltext genannten Maßnahmen umgesetzt werden: Zeilenumbruchzeichen in der Filterung abweisen oder Befehle ohne Shell-Wrapper ausführen.
Betroffene Software
Klicken Sie auf eine Technologie, um alle zugehörigen Schwachstellen anzuzeigen.
| Plattform | Paket | Anfällige Versionen | Behoben in |
|---|---|---|---|
| Python (PyPI) | ag2 | >= 0.13.2, < 1.1.1 | 1.1.1 |
| Python (PyPI) | autogen | >= 0.13.2, <= 0.14.1 | keine Korrektur |
Verweise
- CVSS-Vektor
CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H- Schwäche (CWE)
CWE-184, CWE-78- Plattform
- Python (PyPI)
- Paket
ag2, autogen- Veröffentlicht
- 10.11.2026
- Aktualisiert
- 12.11.2026 10:00
Quellen und Lizenzen · Von DockRay bearbeitet oder übersetzt; Rechte und Lizenzen der Quellen bleiben erhalten.
OSV / GitHub Advisory Database - GHSA-2h4w-29cv-2cmv - CC BY 4.0
Schwachstellenhistorie: ag2
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.
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.