Dentro del entorno aislado de Codex
Cómo Codex ejecuta comandos en tu equipo con límites que tú controlas.
En OpenAI, adoptamos un enfoque de defensa en profundidad(se abre en una nueva ventana) en lo que respecta a la protección de los agentes. Si bien nuestras inversiones en entrenamiento y alineación son fundamentales para este esfuerzo, también implementamos funciones en nuestro arnés de ejecución para agentes, Codex(se abre en una nueva ventana), para proporcionar protecciones adicionales. Dado que una de las acciones más habituales (y potencialmente arriesgadas) que realiza Codex es ejecutar comandos en tu ordenador, hemos creado el entorno aislado de Codex para que Codex pueda funcionar en tu entorno actual dentro de los límites del sistema de archivos y de la red que tú controlas.
Un (se abre en una nueva ventana)entorno aislado(se abre en una nueva ventana) limita a qué puede acceder un programa mientras se ejecuta. Para una tarea de organización de fotos, podrías configurar el entorno aislado de Codex para permitir que los comandos lean y modifiquen archivos en ~/Imágenes, al tiempo que se bloquea el acceso a la red para impedir las subidas. Para la revisión de código, podrías permitir el acceso a la documentación en línea, manteniendo los archivos fuente como de solo lectura. Los usuarios configuran el entorno aislado de Codex a través de (se abre en una nueva ventana)perfiles de permisos(se abre en una nueva ventana), que definen las restricciones del sistema de archivos y de la red para una sesión de Codex.
En este artículo, comenzaremos analizando las ventajas e inconvenientes que subyacen a los valores predeterminados del entorno de pruebas de Codex; a continuación, explicaremos el diseño de dicho entorno y cómo el arnés de ejecución lo utiliza para ejecutar comandos. Mostraremos cómo los usuarios finales y las empresas pueden adaptar sus permisos a sus necesidades y cómo los desarrolladores pueden reutilizar el entorno de pruebas en sus propias herramientas. Por último, examinaremos cómo se aplican estas restricciones en macOS, Linux y Windows.
En Codex, nuestra filosofía consiste en especificar valores predeterminados conservadores para el entorno aislado que, aun así, permitan realizar un trabajo significativo. Por ejemplo, con un repositorio de Git como raíz del espacio de trabajo, el perfil de permisos integrado :workspace:
Permite escribir en el Espacio de trabajo, a la vez que mantiene directorios como
.gity.codexen modo de solo lectura. Esto permite que Codex edite el código fuente sin pedir permiso para cada cambio y evita modificaciones directas en.codex/config.tomlo en los hooks de Git dentro de.git/hooks.Permite lecturas amplias del sistema de archivos, sujetas a los permisos del sistema operativo que tenga el usuario. Los compiladores, entornos de ejecución y herramientas de compilación dependen de SDK, bibliotecas y configuraciones que se encuentran fuera del repositorio. Restringir las lecturas al espacio de trabajo interrumpiría muchos flujos de trabajo habituales. La contrapartida es que los archivos confidenciales ubicados en otras partes del equipo también podrían seguir siendo legibles (como los archivos de configuración que contienen claves de API).
Desactiva el acceso a la red. Esto bloquea las subidas directas a servicios externos, incluidos los intentos de filtrar datos que el comando pueda leer. También impide operaciones legítimas, como la descarga de dependencias, que requieren acceso adicional.
Estas restricciones evitan una amplia gama de comportamientos indebidos, pero aún así siguen siendo posibles las acciones dañinas. Por ejemplo, el agente podría inyectar código malicioso en un paquete instalado localmente, como node_modules/prettier. Es posible que dicho cambio no aparezca en git status, ya que Git suele ignorar node_modules. Si el editor del usuario ejecuta esa copia de Prettier al guardar, el simple hecho de guardar un archivo podría ejecutar el código malicioso fuera del entorno aislado de Codex. Por eso adoptamos un enfoque de defensa en profundidad: el entorno aislado limita a qué comandos se puede acceder, mientras que el entrenamiento y la alineación ayudan al modelo a utilizar ese acceso de acuerdo con la intención del usuario.
Para obtener orientación sobre cómo personalizar los permisos del entorno aislado y combinarlos con otras protecciones en un entorno empresarial, consulta el manual de seguridad de Codex(se abre en una nueva ventana).
Las máquinas virtuales y los contenedores(se abre en una nueva ventana) son dos mecanismos muy utilizados para el sandboxing, pero en el sandbox de Codex adoptamos un enfoque diferente. En lugar de trasladar el procesamiento a un entorno independiente para proporcionar aislamiento, Codex utiliza las funciones de sandboxing de cada plataforma para restringir los comandos que se ejecutan en el entorno existente del usuario.
Para muchos desarrolladores, su ordenador portátil sirve como un entorno de desarrollo a medida que pueden modificar a su antojo. Reproducir ese entorno en un contenedor de Docker puede suponer un esfuerzo, y algunos flujos de trabajo siguen dependiendo de herramientas que se ejecutan en el host.
Por ejemplo, imaginemos que utilizamos Codex para desarrollar una aplicación para iOS en un Mac. Si decidimos aislar Codex ejecutándolo dentro de Docker, Codex no podría ejecutar la cadena de herramientas de compilación de iOS, compuesta por ejecutables nativos de Mac, ni podría iniciar el simulador de iPhone para ejecutar el código. Un flujo de trabajo basado en Docker podría delegar las compilaciones y las operaciones del simulador al equipo Mac anfitrión, pero esas operaciones se ejecutarían fuera del entorno aislado del contenedor y necesitarían sus propias restricciones. En el caso de Codex, preferimos mantener las cosas sencillas invirtiendo mucho en entornos aislados específicos para cada sistema operativo, de modo que Codex pueda ejecutarse en el entorno más adecuado para la tarea en cuestión.
El arnés de ejecución expone estos mecanismos de sandboxing específicos del sistema operativo a través de una API común para macOS, Windows y Linux. Esta API acepta un comando y un perfil de permisos. Si el perfil de permisos permite un acceso limitado a la red, el usuario que realiza la llamada debe proporcionar un proxy de red para hacer cumplir esos límites:
Esta función inicia el proceso en un entorno aislado y devuelve un identificador Child que el arnés de ejecución puede usar para esperar a que termine. Cada proceso secundario hereda las restricciones del entorno aislado de su proceso principal, por lo que esas restricciones se aplican a todo el árbol de procesos iniciado por el comando, incluso a los procesos descendientes que siguen activos después de que termina el proceso original.
El siguiente diagrama muestra cómo encajan estas piezas, desde la configuración hasta la ejecución de un comando en un entorno aislado. Las secciones siguientes explican cada etapa.

Como se explica en Desglose del bucle del agente de Codex, el arnés de ejecución de Codex se encarga de ejecutar las llamadas a herramientas que genera el modelo. Para las tareas de programación, la herramienta más utilizada es una herramienta de shell, que ejecuta comandos de forma muy similar a como lo haría una persona en un shell interactivo como Bash. Aquí examinaremos la herramienta de un ejemplo (se abre en una nueva ventana)exec_command(se abre en una nueva ventana) de shell(se abre en una nueva ventana) para ilustrar cómo el arnés de ejecución utiliza el entorno aislado para lograr las protecciones deseadas.
Esta es una versión simplificada de cómo el arnés de ejecución de Codex procesaría la llamada a la herramienta exec_command sin aislamiento:
Para ejecutar el comando en un entorno aislado, el arnés de ejecución reemplaza la llamada a subprocess.Popen() por spawn_command_under_sandbox(). El arnés de ejecución proporciona el perfil de permisos y, cuando es necesario, el proxy de red:
La herramienta exec_command también permite que el modelo solicite permisos distintos para un comando individual, pero el arnés de ejecución decide si concede la solicitud:
Cuando se especifica use_default, el arnés de ejecución usa la configuración predeterminada del entorno aislado para el turno. with_additional_permissions solicita permisos ampliados dentro del entorno aislado, mientras que require_escalated solicita ejecutar el comando fuera de él. Antes de ejecutar el comando, el arnés de ejecución evalúa la solicitud según las preferencias de la persona usuaria. (Por ejemplo, Codex puede mostrarle un prompt directamente a la persona usuaria o enviar la solicitud a revisión automática(se abre en una nueva ventana)). Si se autoriza la ejecución, Codex pasará el permission_profile y el network_proxy correspondientes a perform_exec_command_with_sandboxing(), junto con los argumentos del comando de la llamada original a ExecCommandToolCall.
La herramienta de shell es la principal usuaria de spawn_command_under_sandbox(), y el arnés de ejecución también reutiliza su infraestructura de aislamiento para operaciones como leer y modificar archivos locales. Este uso se extiende más allá del arnés de ejecución: el comando codex sandbox te permite incorporar la ejecución de comandos en un entorno aislado a tus propias herramientas, como veremos más adelante. A continuación, veremos cómo se definen los perfiles de permisos.
Un perfil de permisos con nombre te permite reutilizar las mismas restricciones de sistema de archivos y de red en distintos proyectos. Puedes definir tus propios perfiles en [permissions] dentro de config.toml. Por ejemplo, el siguiente código define un perfil llamado dev que amplía(se abre en una nueva ventana) el perfil integrado :workspace:
El perfil dev añade acceso de escritura a ~/build-cache e impone restricciones adicionales a los archivos del espacio de trabajo. Las entradas del sistema de archivos pueden conceder acceso de solo lectura(read), conceder acceso de lectura y escritura (write)o bloquear el acceso por completo (deny).
La tabla :workspace_roots te permite definir reglas para las rutas relativas a las raíces del espacio de trabajo de un proyecto. Por defecto, la CLI de Codex utiliza su directorio de trabajo como única raíz del espacio de trabajo, mientras que la aplicación de escritorio de ChatGPT utiliza las carpetas de código fuente del proyecto. Codex aplica cada regla a todas las raíces, por lo que la entrada .vscode en dev hace que el directorio .vscode sea de solo lectura en cada raíz.
Además de sus propias reglas, dev hereda las siguientes protecciones de :workspace:
A la hora de configurar la red para el entorno de pruebas en Codex, existen aproximadamente tres opciones:
Desactivar todo el acceso a la red (valor predeterminado para el perfil
:workspace)Habilitar el acceso completo y directo a la red (valor predeterminado para el perfil
:danger-full-access)Restringir el acceso a la red a un proxy, que decide qué permitir en función del perfil de permisos
Para conceder a dev acceso directo a la red, configura permissions.dev.network.enabled = true en el nivel superior de config.toml. Esto otorga acceso completo a la red cuando el proxy de red está desactivado.
Para restringir dev a un conjunto de dominios, habilita el proxy de red y configura sus reglas de dominio:
Las reglas de dominio admiten nombres exactos y patrones con comodines, y las reglas de denegación explícitas tienen prioridad sobre las de permiso. Las solicitudes a otros dominios requieren aprobación o se bloquean, tal y como se describe en Proxy de red más abajo.
Los usuarios individuales pueden configurar valores predeterminados que se aplican a todos los proyectos y anularlos para un proyecto de confianza concreto. Es posible que los administradores de empresa también deseen configurar valores predeterminados para sus usuarios y restringir qué ajustes pueden modificar dichos usuarios. Codex admite ambas opciones mediante la configuración por capas y los requisitos gestionados.
Tal y como se describe en Precedencia de configuración,(se abre en una nueva ventana) Codex fusiona los ajustes de varios archivos config.toml. Las tablas se fusionan de forma recursiva, prevaleciendo la fuente de mayor precedencia cuando los valores entran en conflicto. Las matrices se sustituyen en su totalidad.
Por eso los perfiles de permisos utilizan tablas para las rutas del sistema de archivos y los dominios de red. Un equipo puede añadir o sobrescribir entradas individuales en su propia configuración y hacer que los cambios se apliquen automáticamente a todas las demás entradas de la configuración base de la organización:
Los administradores también pueden proporcionar requisitos gestionados a(se abre en una nueva ventana) través de requirements.toml para limitar las opciones de configuración de los usuarios. Estos requisitos pueden proceder de múltiples fuentes, incluidos los archivos del sistema y las políticas proporcionadas por la nube. Un caso de uso habitual es especificar allowed_permission_profiles para limitar el conjunto de perfiles de permisos que un usuario empresarial puede seleccionar. Por ejemplo, un administrador podría especificar estos requisitos de la nube:
Los requisitos de la nube tendrían prioridad sobre el archivo de requisitos del sistema ubicado en /etc/codex/requirements.toml, por lo que ninguna entrada de ese archivo puede anular la especificación explícita ":danger-full-access" = false anterior. Si no se especifica :workspace, se permite que otra capa de requisitos proporcione esa entrada. Los perfiles cuyas entradas sean false o que no figuren en la tabla final fusionada no estarán disponibles.
Esta separación permite a las organizaciones imponer límites, mientras que los usuarios adaptan su configuración dentro de dichos límites. Los perfiles de permisos resultantes pueden ser utilizados por el arnés de ejecución o aplicados directamente a un comando, como veremos a continuación.
La CLI de Codex proporciona un comando sandbox para facilitar la ejecución de un comando arbitrario bajo un perfil de permisos definido en la configuración de Codex. Esto se utiliza habitualmente para probar el perfil, asegurándose de que el entorno de pruebas impide el comportamiento que se pretendía bloquear.
Por ejemplo, el siguiente comando intenta configurar VS Code para que ejecute un formateador automático malicioso al guardar. Suponiendo que .vscode ya existe, el perfil dev definido anteriormente debería bloquear esta escritura, ya que ese directorio es de solo lectura (codex sandbox trata cwd como raíz del espacio de trabajo por defecto):
De hecho, en macOS esto falla con el siguiente mensaje:
El comando codex sandbox hace que el mecanismo de sandboxing de Codex esté disponible independientemente de una sesión de agente. Puedes utilizar el mismo lenguaje de configuración y las restricciones específicas de la plataforma para limitar los comandos ejecutados por tus propias herramientas.
En el caso de un servidor MCP stdio configurado en config.toml, el arnés de ejecución de Codex no intenta aplicar sandboxing al comando utilizado para iniciar el servidor. Codex no puede deducir de forma fiable qué archivos o servicios de red necesita ese servidor, por lo que aplicar un perfil de entorno aislado predeterminado podría romper una configuración que, por lo demás, sería válida.
Por ejemplo, la forma estándar de configurar el servidor MCP @modelcontextprotocol/server-memory(se abre en una nueva ventana) para su uso con Codex es la siguiente:
Dado que este comando npx se ejecuta sin estar en un entorno aislado, puede escribir archivos y realizar solicitudes de red con los mismos permisos que el usuario que ejecuta Codex, lo cual es excesivamente permisivo. Para restringir el acceso, podemos definir un perfil de permisos llamado memory-mcp y, a continuación, envolver el comando original npx con codex sandbox --permission-profile memory-mcp para limitar dónde puede escribir el servidor e impedir que acceda a la red:
Antes de iniciar el servidor, crea su directorio de datos y rellena la caché de npm con el paquete fijado. Esto permite que npx --offline inicie el servidor bajo un perfil que deshabilita el acceso a la red:
Una vez que el paquete está almacenado en la caché, Codex puede iniciar el servidor de memoria sin acceso a la red, con las escrituras limitadas a la caché de npm y al directorio de datos del servidor.
La implementación del entorno aislado convierte un perfil de permisos en restricciones aplicadas por el sistema operativo. La lógica central de gestión de solicitudes y de políticas del proxy de red es común a los tres principales sistemas operativos, mientras que la configuración del proxy y su integración con el entorno aislado son específicas de cada sistema operativo. Analizaremos primero el proxy común y, a continuación, las implementaciones para macOS, Linux y Windows.
Para aplicar las restricciones de red de un perfil de permisos, el arnés de ejecución inicia un proxy de red y configura el entorno de pruebas para permitir conexiones con él, al tiempo que bloquea las conexiones directas a hosts externos. El proxy comprueba cada solicitud con respecto a las reglas de dominio del perfil para determinar si debe reenviarla.
En el repositorio de Codex, el proxy de red se implementa en el crate codex-network-proxy(se abre en una nueva ventana), que el arnés de ejecución usa como biblioteca, aunque también se puede compilar como una CLI independiente(se abre en una nueva ventana). Cuando se habilita, codex-network-proxy inicia de forma predeterminada tanto un proxy HTTP como un proxy SOCKS5. Las direcciones de estos proxies se comunican al proceso que inicia el entorno de pruebas mediante variables de entorno. Además de inyectar variables de entorno estándar como HTTP_PROXY, HTTPS_PROXY y ALL_PROXY, también se inyectan varias variables de entorno específicas de aplicaciones(se abre en una nueva ventana) conocidas (como PIP_PROXY). Cabe señalar que no todos los programas respetan estas variables de entorno. Si un programa intenta conectarse directamente a un host externo, las restricciones del entorno de pruebas del sistema operativo bloquean la conexión, como se describe en las secciones específicas de cada plataforma a continuación.
El proxy de red se encarga de implementar las restricciones de red definidas en un perfil de permisos. Por ejemplo, el perfil dev que se mostró antes permite solicitudes a *.openai.com y deniega explícitamente las solicitudes a evil.example. Cuando una solicitud se dirige a un dominio que no coincide con ninguna regla de permiso o denegación, el proxy puede suspenderla mientras delega la solicitud al arnés de ejecución para que la apruebe. Al igual que en el ejemplo de comando de shell, Codex puede mostrarle un prompt directamente al usuario o dirigir la solicitud a revisión automática(se abre en una nueva ventana). Al recibir una decisión, el proxy permite que la solicitud continúe o la rechaza con una respuesta de error.
El orden es importante en este caso porque incluso una consulta DNS puede filtrar información codificada en un nombre de host. Por lo tanto, el proxy resuelve el nombre de host solicitado solo después de determinar que está permitido o aprobado. Ten en cuenta que las reglas generales con comodines o el acceso a servicios DNS pueden seguir permitiendo la exfiltración basada en DNS.
En macOS, Codex usa Seatbelt(se abre en una nueva ventana), el mecanismo de aislamiento impuesto por el kernel de Apple. Las políticas de Seatbelt se escriben en Sandbox Profile Language (SBPL), un lenguaje basado en Scheme para expresar restricciones de aislamiento. Codex invoca Seatbelt mediante el comando /usr/bin/sandbox-exec de macOS. Al igual que codex sandbox, recibe opciones que describen el entorno aislado, seguidas del comando que se ejecutará:
El PROFILE es una cadena de SBPL que contiene entradas para configurar el entorno aislado. Por ejemplo, el siguiente fragmento de SBPL permite leer y escribir /dev/null y /dev/zero según la política del entorno aislado:
Cuando el proxy de red está habilitado como parte de una invocación de sandbox, se inyectan en el perfil reglas como las siguientes para limitar las conexiones a los puertos locales adecuados:
El perfil base de Codex comienza con (deny default), por lo que las conexiones salientes permanecen bloqueadas salvo que se permitan explícitamente.
Finalmente, el SBPL puede contener marcadores de posición que usan (param):
que se completan con las opciones -Dkey=value que se pasan a sandbox-exec.
Para implementar su propia API de entorno aislado, Codex construye la lista de argumentos(se abre en una nueva ventana) para sandbox-exec a partir de una política base(se abre en una nueva ventana) y luego usa permission_profile y otro contexto para modificarla y generar el perfil completo de Seatbelt. El perfil resultante y los argumentos -D asociados configuran las restricciones que aplica Seatbelt, mientras que el proxy de red aplica reglas de red adicionales. Una vez que se reúne la lista completa de argumentos, ejecutar sandbox-exec es sencillo.
Generar el SBPL correcto es difícil porque Apple no documenta el lenguaje para su uso por terceros. De hecho, man sandbox-exec indica The sandbox-exec command is DEPRECATED (el comando sandbox-exec está obsoleto), al igual que la función de biblioteca sandbox_init(), documentada en man 3 sandbox_init. Pese a esta advertencia, macOS aún incluye perfiles de Seatbelt en /usr/share/sandbox, y el software de terceros, incluidos Google Chrome y Chromium(se abre en una nueva ventana), sigue dependiendo de Seatbelt. Por eso, planeamos seguir usando Seatbelt en el futuro previsible.
Para crear el entorno aislado en Linux, Codex combina bubblewrap(se abre en una nueva ventana) (bwrap), una herramienta de línea de comandos para construir entornos aislados, y seccomp-bpf(se abre en una nueva ventana), un mecanismo del kernel de Linux para filtrar llamadas al sistema. Un asistente interno llamado codex-linux-sandbox coordina la configuración. Al igual que sandbox-exec en macOS, recibe una configuración del entorno aislado seguida del comando que debe ejecutar:
Cuando se requiere aislamiento del sistema de archivos o enrutamiento mediante proxy, codex-linux-sandbox invoca a bwrap para crear el entorno de sandbox inicial. A continuación, bwrap ejecuta codex-linux-sandbox --apply-seccomp-then-exec en su interior. Esta segunda invocación utiliza seccomp-bpf para aplicar restricciones adicionalesantes de ejecutar el comando del usuario.
Para crear ese entorno de sandbox inicial, Codex utiliza bubblewrap para generar una vista del sistema de archivos en un espacio de nombres de montaje independiente que refleje las reglas del sistema de archivos del perfil de permisos. Dado que esto es fundamental para la implementación del entorno de pruebas, Codex proporciona su propia copia de bwrap por si el usuario no ha instalado la suya propia, pero prefiere una instalación compatible de (se abre en una nueva ventana)bwrap(se abre en una nueva ventana) que se encuentre en PATH, cuando esté disponible. Empíricamente, algunas distribuciones de Linux desactivan el acceso a los espacios de nombres de usuario de forma predeterminada(se abre en una nueva ventana), pero conceden una excepción para el bwrap del sistema.
Al igual que sandbox-exec, bwrap toma una configuración de entorno aislado seguida de un comando que se ejecutará dentro de dicho entorno. En lugar de utilizar un lenguaje de configuración personalizado como SBPL, bwrap utiliza indicadores individuales para la configuración. Codex utiliza las siguientes opciones para crear la vista del sistema de archivos:
--bindpara especificar un archivo o directorio en el que se puede escribir--ro-bindpara especificar un archivo o directorio de solo lectura--perms 000 --tmpfs DIR --remount-ro DIRpara denegar el acceso aDIR--perms 000 --ro-bind-data FD FILEpara denegar el acceso aFILE(dondeFDes un descriptor de archivo abierto que apunta a/dev/null)
Para aplicar expresiones globales de denegación con estas opciones, Codex las expande a rutas concretas antes de ejecutar cada comando. Las nuevas rutas que coinciden no se añaden automáticamente a las restricciones del entorno aislado de ese comando.
Codex también especifica opciones como --unshare-ipc y --unshare-pid para impedir que el entorno aislado acceda a otros tipos de recursos del host, por lo que bubblewrap afecta a algo más que a la visibilidad de los archivos.
Al utilizar bubblewrap, Codex pasa --unshare-net siempre que la red esté desactivada o las conexiones deban pasar por el proxy de red, lo que creará un nuevo espacio de nombres de red para el entorno aislado. A continuación, utilizamos seccomp-bpf para aplicar restricciones adicionales a las llamadas al sistema de red y a las familias de sockets disponibles para el comando.
En concreto, utilizamos el crate seccompiler(se abre en una nueva ventana) para compilar dinámicamente un programa BPF basado en los filtros deseados(se abre en una nueva ventana) y aplicarlo a un proceso de lanzamiento en el entorno aislado, de modo que las restricciones se hereden en todo el árbol de procesos. Por lo tanto, bwrap no ejecuta el comando del usuario, sino que ejecuta el lanzador codex-linux-sandbox con sus propios argumentos de configuración, seguidos del comando del usuario:
Para aplicar filtros de seccomp sin privilegios elevados, el lanzador establece la marca de Linux no_new_privs (se abre en una nueva ventana). Los procesos secundarios heredan esta marca, que les impide obtener privilegios adicionales al ejecutar otro programa, como un ejecutable setuid.
Los filtros de seccomp dependen de la configuración de red. Cuando el acceso a la red está desactivado, bloqueamos varias llamadas al sistema relacionadas con la red,como connect(2) y bind(2). Sin embargo, cuando el proxy de red está habilitado en el entorno aislado, permitimos los sockets IP para que se pueda acceder al listener TCP creado por codex-linux-sandbox, pero bloqueamos por defecto la creación de sockets de dominio Unix independientes, ya que estos podrían permitir un acceso involuntario a los recursos del host.
Cuando la configuración del entorno aislado justifica el uso del proxy de red, el arnés de ejecución de Codex crea una instancia del proxy que puede reutilizarse en múltiples invocaciones de codex-linux-sandbox dentro del mismo hilo de Codex. Cada entorno aislado necesita una forma de acceder a ese proxy compartido desde su espacio de nombres de red aislado. Codex proporciona un listener TCP de bucle invertido dentro de ese espacio de nombres y se encarga de que un proceso externo al entorno aislado acepte sus conexiones y las retransmita al proxy.
Los siguientes diagramas ilustran esta configuración para un punto final de proxy, y en el último diagrama se muestra una conexión a través de él. Antes de iniciar bubblewrap, codex-linux-sandbox crea un par de sockets Unix que servirá como canal de control y se bifurca a sí mismo. El proceso hijo ejecuta run_host_bridge() y espera a recibir el descriptor de archivo del listener a través de ese canal:
En este ejemplo, el proceso padre utiliza exec para sustituir su imagen de programa por bwrap. Esto configura el entorno aislado y ejecuta codex-linux-sandbox --apply-seccomp-then-exec en su interior, pasando el descriptor de archivo (FD) del canal de control:
Dentro del espacio de nombres de red del entorno aislado, la segunda invocación de codex-linux-sandbox crea un listener TCP de bucle invertido y pasa su descriptor de archivo a través del socket. El listener permanece asociado al espacio de nombres de red del entorno aislado, lo que permite al proceso hijo que permaneció fuera del entorno aislado aceptar conexiones de los programas aislados, al tiempo que abre sus conexiones ascendentes en el espacio de nombres de red del host. Tras el traspaso, ambos procesos cierran sus descriptores del canal de control, y el proceso dentro del entorno aislado cierra su copia del oyente.
Una vez que el listener TCP está listo, el proceso dentro del entorno aislado establece el valor adecuado para HTTP_PROXY(se abre en una nueva ventana) y las variables de entorno relacionadas, de modo que apunten a ese listener. A continuación, aplica seccomp antes de crear un proceso secundario y ejecutar el comando del usuario:
El proceso fuera del entorno aislado mantiene abierto el listener. Por cada conexión aceptada, abre una conexión con el proxy configurado y retransmite datos en ambas direcciones.
Este mecanismo adicional proporciona al comando su propio espacio de nombres de red, incluida una interfaz de bucle invertido independiente. En macOS, Seatbelt permite que el comando se conecte directamente a puertos específicos de la interfaz de bucle invertido del host. En Linux, en cambio, el comando se conecta a un listener dentro de su espacio de nombres aislado, y un proceso fuera del entorno aislado retransmite esas conexiones al proxy configurado. El traspaso de descriptores hace posible esta conexión sin exponer el espacio de nombres de red del host al comando.
A principios de este año, implementamos y escribimos sobre nuestras iniciativas de sandboxing en Windows. Desde entonces, Microsoft ha lanzado una biblioteca llamada MXC, junto con nuevas funciones para el aislamiento de procesos dentro del sistema operativo Windows. Actualmente estamos sustituyendo nuestro entorno de sandboxing actual por otro que utiliza la biblioteca MXC.
MXC (Microsoft eXecution Container) es un sistema de ejecución de código en entorno aislado(se abre en una nueva ventana) de Microsoft que admite varios backends de contención en Windows, Linux y macOS. Codex admite un entorno aislado basado en MXC en dispositivos Windows compatibles, utilizando el aislamiento nativo de procesos para restringir los comandos dentro del entorno existente del usuario.
Estamos realizando la transición a MXC para mejorar la seguridad y la usabilidad, al tiempo que subsanamos varias limitaciones de nuestro entorno aislado actual para Windows:
Necesidad de acceso elevado o de administrador para configurar el entorno aislado
Operaciones de comprobación y configuración de ACL costosas y lentas
Estado persistente de la configuración del entorno aislado en el equipo host, incluyendo
ACL
Reglas de cortafuegos
Usuarios del entorno aislado
Archivos del plano de control
MXC expone un esquema de configuración JSON(se abre en una nueva ventana). Codex utiliza el SDK de MXC(se abre en una nueva ventana) para crear una solicitud de ejecución que siga dicho esquema y que contenga el comando, el directorio de trabajo, el entorno y los permisos. Dichos permisos abarcan el acceso al sistema de archivos y a la red, así como a recursos de Windows como el escritorio y el portapapeles.
Codex utiliza ajustes fijos para varios controles con el fin de equilibrar la compatibilidad y la seguridad. Permite la lectura del registro y mantiene el acceso a Win32k y al escritorio que PowerShell necesita durante el inicio. Se desactivan el acceso al portapapeles, la inyección de entradas y los controles del escritorio y de la configuración del sistema. Por último, se impide que MXC recurra a la modificación de los permisos del sistema de archivos del host.
Codex traduce las reglas de sistema de archivos y de red del perfil de permisos a la configuración de MXC. Utilizando el perfil anterior dev y suponiendo que:
C:\,D:\yZ:\son las únicas unidades locales del equipo.La raíz del espacio de trabajo y el directorio de trabajo son
C:\work\demo.El directorio personal del usuario es
D:\Users\dev, así que~/build-cachese resuelve comoD:\Users\dev\build-cache.El patrón de exclusión solo coincide con
C:\work\demo\config\dev.envyC:\work\demo\config\prod.env.
La configuración correspondiente de MXC incluiría:
La política del sistema de archivos de MXC deniega el acceso de forma predeterminada. Por lo tanto, Codex añade permisos de solo lectura para las raíces de las unidades locales con el fin de proporcionar los amplios derechos de lectura que permite este perfil. Estos permisos se aplican de forma recursiva, siempre que lo permitan los permisos existentes del sistema operativo del usuario.
Una salvedad: los permisos de escritura en la raíz de la unidad no se aplican de forma recursiva, por lo que Codex los amplía para incluir los subdirectorios inmediatos existentes de la unidad.
Las rutas más específicas anulan los permisos de los antepasados, por lo que C:\work\demo puede ser escribible bajo un C:\ de solo lectura, mientras que C:\work\demo\.git sigue siendo de solo lectura.
Cuando diferentes formas de escribir una ruta o alias de enlaces simbólicos/uniones hacen referencia a la misma ruta, MXC aplica el permiso más restrictivo: denegar tiene prioridad sobre solo lectura, que a su vez tiene prioridad sobre lectura y escritura.
MXC solo admite rutas de denegación concretas, por lo que Codex expande los globs de denegación a los archivos y directorios que coincidan antes de la ejecución. Las nuevas rutas que coincidan con el glob no se añaden automáticamente mientras se está ejecutando el comando.
Las reglas de dominio como *.openai.com se aplican mediante el proxy de red compartido de Codex descrito anteriormente. Codex ejecuta ese proxy fuera del entorno aislado y transmite sus direcciones al comando a través de las mismas variables de entorno estándar *_PROXY mencionadas anteriormente. MXC bloquea las conexiones externas directas, al tiempo que permite las conexiones de bucle de retorno del host, incluido el acceso al proxy. Se puede seguir accediendo a otros servicios locales.
Tanto en macOS como en Linux y Windows, el arnés de ejecución utiliza la misma API de entorno aislado para ejecutar comandos bajo un perfil de permisos. Las implementaciones específicas de cada plataforma se encargan de la configuración necesaria para aplicar dichas restricciones.
Escribir y ejecutar código ofrece a los agentes una forma flexible de resolver problemas más allá del desarrollo de software. El entorno aislado de Codex les permite utilizar esa capacidad en el entorno existente del usuario con límites explícitos en el acceso al sistema de archivos y a la red. Se trata de un elemento básico reutilizable dentro del arnés de ejecución, y el comando codex sandbox lo pone a disposición de las herramientas que el usuario cree por sí mismo.
A medida que los agentes asumen más tareas, queremos que el entorno aislado resulte práctico para un mayor número de herramientas y entornos. Esto implica facilitar la configuración de los permisos y aprovechar las mejores protecciones del sistema operativo a medida que estén disponibles. Nuestro objetivo es ampliar las capacidades de los agentes, al tiempo que se mantiene el control de los usuarios sobre a qué pueden acceder.


