Alta

AG2: La inyección de saltos de línea en SandboxShellTool elude allowed=[...] y readonly=True, permitiendo la ejecución arbitraria de comandos

  • Publicada: 10.11.2026
  • Actualizado: 12.11.2026 10:00

Resumen

Los modos restringidos de SandboxShellTool — allowed=[...] (lista explícita de comandos permitidos) y readonly=True (lista implícita de comandos permitidos READONLY_COMMANDS) — pueden ser eludidos incrustando un carácter de salto de línea dentro de la cadena del comando. El filtro solo inspecciona un conjunto de metacaracteres de shell de una sola línea, pero la ejecución pasa la cadena sin procesar a través de sh -c, donde una shell procesa un salto de línea incrustado exactamente igual que un separador de sentencias ;. Por lo tanto, un agente (o el contenido que lo dirija, por ejemplo, mediante inyección de instrucciones/prompt injection) puede ejecutar comandos de shell arbitrarios incluso si la herramienta fue configurada para permitir únicamente un prefijo de comando específico o solo comandos de solo lectura. Con el backend por defecto LocalEnvironment(), esto se traduce en un subproceso real en el host (su propio docstring señala: "Commands run via subprocess on the host, so there is no real isolation"), no en un contenedor aislado, por lo que constituye una ejecución de comandos completa en el host y no una simple fuga de un entorno previamente aislado.

Detalles

Ambos modos restringidos son aplicados por ShellAdapter._filter() en ag2/tools/sandbox/adapter/shell.py:

python
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 reutiliza esta misma rama: SandboxShellTool.__init__ / ShellAdapter.__init__ establece self._allowed = list(READONLY_COMMANDS) cuando readonly está definido y no se proporciona un allowed explícito, por lo que ambos modos comparten el mismo filtro y la misma vía de elusión.

contains_shell_operator() en ag2/tools/sandbox/filter.py comprueba el comando frente a:

python
_SHELL_OPERATORS: tuple[str, ...] = (">", ">>", "|", ";", "&&", "||", "`", "$(")

Esta tupla no contiene ninguna entrada para \n (ni \r). matches() solo verifica que el comando comience con un prefijo permitido seguido de un espacio o del final de la cadena; nunca inspecciona el resto del texto. La ejecución se realiza mediante:

python
argv = ["sh", "-c", command]
...
return await sandbox.exec(argv, env=self._env, timeout=self._timeout)

Una shell POSIX divide sh -c "<line1>\n<line2>" en dos sentencias secuenciales, exactamente igual que si estuvieran separadas por ;. Por lo tanto, un comando como "cat allowed_file.txt\nrm -rf /anything":

  1. Pasa matches("cat", command) — la cadena comienza con "cat ".
    1. Pasa contains_shell_operator(command) — \n no es un operador reconocido.
    1. Llega a sh -c "cat allowed_file.txt\nrm -rf /anything", que ejecuta ambas sentencias.

Prueba de concepto

Verificado directamente contra la rama actual main (github.com/ag2ai/ag2, commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0, clonado en 2026-09-21), importando el módulo real ag2/tools/sandbox/filter.py (solo stdlib, sin necesidad de otras dependencias de AG2) y reproduciendo textualmente la rama de lista de permitidos de ShellAdapter._filter():

bash
=== 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

Los tres intentos de encadenamiento estándar (;, &&, |) son rechazados correctamente por el filtro real, lo que confirma su funcionamiento; la variante separada por saltos de línea, con el mismo propósito, es aceptada por el mismo filtro en ambos modos restringidos, y una llamada real a sh -c confirma que la shell ejecuta ambas sentencias.

Impacto

Cualquier agente configurado con SandboxShellTool(allowed=[...]) o SandboxShellTool(readonly=True) —las dos configuraciones que el propio docstring de la herramienta presenta como límites reales de seguridad, a diferencia de blocked, sobre el cual el mismo docstring indica explícitamente que "is not a security boundary"— puede ser inducido a ejecutar comandos de shell arbitrarios mediante un único salto de línea incrustado en el argumento del comando. Debido a que los argumentos de la herramienta son generados por el LLM y pueden ser dirigidos por el contenido que el agente procesa (un documento descargado, la salida de una herramienta o cualquier otro texto que llegue al modelo, es decir, inyección indirecta de instrucciones), esto es accesible sin que el operador del agente escriba manualmente el comando malicioso. Con el backend predeterminado LocalEnvironment(), la ejecución ocurre en el proceso anfitrión que ejecuta el agente, sin estar confinada a un contenedor.

Mitigación sugerida

  • Añadir "\n" y "\r" a _SHELL_OPERATORS en ag2/tools/sandbox/filter.py para que contains_shell_operator() rechace los saltos de línea incrustados de la misma manera que rechaza ;.
  • De forma más robusta, ejecutar los comandos permitidos o de solo lectura sin invocar una shell en el modo restringido (shlex.split + exec sin el contenedor sh -c), de modo que las redirecciones, encadenamientos, sustituciones y cualquier tipo de separador de sentencias queden inhabilitados por diseño en lugar de depender de una lista de denegación exhaustiva.

Entorno probado

  • Repositorio: github.com/ag2ai/ag2, commit a05ff1cb6ff4955ef252a4e0d4a27d3a32ad57f0 (main), clonado en 2026-09-21.
  • Paquete PyPI ag2, versión 1.0.5 según pyproject.toml en este commit.
  • Python 3, solo stdlib (subprocess, importlib) contra el módulo real y sin modificar ag2/tools/sandbox/filter.py — no se requirieron dependencias en tiempo de ejecución de AG2 para reproducirlo.

Qué hacer

Para ag2, actualice a la versión 1.1.1 o posterior. Para autogen, no se ha establecido una versión corregida. Como alternativa, aplique las mitigaciones sugeridas: rechazar caracteres de salto de línea en el filtro o ejecutar los comandos permitidos sin un contenedor de shell.

Software afectado

Haz clic en una tecnología para ver todas sus vulnerabilidades.

PlataformaPaqueteVersiones vulnerablesCorregida en
Python (PyPI) ag2 >= 0.13.2, < 1.1.1 1.1.1
Python (PyPI) autogen >= 0.13.2, <= 0.14.1 sin corrección

Referencias

Puntuación CVSS 8.8/10
Vector CVSS
CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H
Debilidad (CWE)
CWE-184, CWE-78
Plataforma
Python (PyPI)
Paquete
ag2, autogen
Publicada
10.11.2026
Actualizado
12.11.2026 10:00

Fuentes y licencias · Editado o traducido por DockRay; se mantienen los derechos y las licencias de las fuentes.

OSV / GitHub Advisory Database - GHSA-2h4w-29cv-2cmv - CC BY 4.0

Historial de vulnerabilidades: ag2

Todas las vulnerabilidades publicadas de este paquete (Python (PyPI)), de la más reciente a la más antigua. Muestra si es un fallo aislado o un paquete que hay que vigilar.

Esta es la única vulnerabilidad conocida de este paquete.

Identifica las vulnerabilidades de tu aplicación

Con la integración de DockRay y el inventario de software activado, DockRay compara las versiones notificadas de los componentes con las vulnerabilidades conocidas y avisa de las coincidencias confirmadas. La cobertura depende de la tecnología compatible y de los avisos disponibles.

Conectar tu aplicación
Newsletter DockRay

La seguridad de tus aplicaciones en tu correo

Vulnerabilidades importantes, recomendaciones concretas y consejos prácticos para tus aplicaciones. Elige tus tecnologías y sigue lo que importa para tu proyecto.

  • Un resumen diario de nuevas vulnerabilidades, también las críticas.
  • Avisos sobre actualizaciones importantes.
  • Consejos prácticos sobre seguridad y monitorización de aplicaciones.

Déjalo vacío para recibir avisos de todas las tecnologías.

Suscripción gratuita. Date de baja con un clic en cualquier correo.