В изолираната среда на Codex
Как Codex изпълнява команди на машината ви с ограничения, които вие контролирате.
В OpenAI прилагаме защита в дълбочина(отваря се в нов прозорец), когато става въпрос за сигурността на агентите. Макар инвестициите ни в обучение и съгласуване с човешките цели да са в основата на тези усилия, внедряваме и функции в нашата рамка за агенти, Codex(отваря се в нов прозорец), които осигуряват допълнителна защита. Тъй като едно от най-честите (и потенциално рискови) действия на Codex е изпълнението на команди на компютъра ви, създадохме изолираната среда на Codex. Тя позволява на Codex да работи в съществуващата ви среда с ограничения за файловата система и мрежата, които вие контролирате.
Една (отваря се в нов прозорец)изолирана среда(отваря се в нов прозорец) ограничава достъпа на програмата по време на изпълнение. За задача по организиране на снимки можете да настроите изолираната среда на Codex така, че командите да четат и променят файлове в ~/Pictures, но да нямат достъп до мрежата, за да предотвратите качвания. За преглед на код можете да разрешите достъп до онлайн документация, като оставите файловете с изходен код само за четене. Потребителите конфигурират изолираната среда на Codex чрез (отваря се в нов прозорец)профили с разрешения(отваря се в нов прозорец), които определят ограниченията за файловата система и мрежата в дадена сесия на Codex.
В тази статия ще започнем с компромисите зад настройките по подразбиране на изолираната среда на Codex, след което ще обясним устройството ѝ и как рамката я използва за изпълнение на команди. Ще покажем как крайните потребители и предприятията могат да адаптират разрешенията ѝ към нуждите си и как разработчиците могат да използват изолираната среда в собствените си инструменти. Накрая ще разгледаме как тези ограничения се налагат в macOS, Linux и Windows.
В Codex се стремим към предпазливи настройки по подразбиране за изолираната среда, които все пак позволяват пълноценна работа. Например, когато Git хранилище е основната директория на работното пространство, вграденият профил с разрешения :workspace:
Разрешава запис в работното пространство, като оставя директории като
.gitи.codexсамо за четене. Това позволява на Codex да редактира изходния код, без да иска разрешение за всяка промяна, но предотвратява преки промени в.codex/config.tomlили Git hooks в.git/hooks.Разрешава широк достъп за четене до файловата система в рамките на съществуващите права на потребителя в ОС. Компилаторите, средите за изпълнение и инструментите за изграждане зависят от SDK, библиотеки и конфигурации извън хранилището. Ограничаването на четенето до работното пространство би нарушило много обичайни работни процеси. Компромисът е, че чувствителни файлове на други места в машината също може да останат достъпни за четене (например конфигурационни файлове с API ключове).
Изключва достъпа до мрежата. Това блокира директните качвания към външни услуги, включително опитите за изнасяне на данни, които командата може да прочете. То също така възпрепятства легитимни операции като изтеглянето на зависимости, за които е нужен допълнителен достъп.
Тези ограничения предотвратяват широк кръг нежелани действия, но вредни действия все още са възможни. Например агентът може да вмъкне злонамерен код в локално инсталиран пакет като node_modules/prettier. Такава промяна може да не се появи в git status, защото node_modules често се игнорира от Git. Ако редакторът на потребителя изпълнява това копие на Prettier при запис, самото записване на файл може да изпълни злонамерения код извън изолираната среда на Codex. Затова прилагаме защита в дълбочина: изолираната среда ограничава достъпа на командите, а обучението и съгласуването с човешките цели помагат на модела да използва този достъп според намеренията на потребителя.
За насоки как да адаптирате разрешенията на изолираната среда и да ги съчетаете с други защити в корпоративна среда вижте Практическото ръководство за сигурност на Codex(отваря се в нов прозорец).
Виртуалните машини и контейнерите(отваря се в нов прозорец) са два популярни механизма за изолация, но за изолираната среда на Codex използваме различен подход. Вместо да премества изчисленията в отделна среда, за да осигури изолация, Codex използва механизмите за изолация на всяка платформа, за да ограничава командите, изпълнявани в съществуващата среда на потребителя.
За много разработчици лаптопът е персонализирана среда за разработка, която могат да променят, когато пожелаят. Пресъздаването на тази среда в Docker контейнер може да изисква усилия, а някои работни процеси все пак зависят от инструменти, които работят на хоста.
Да вземем например използването на Codex за разработка на iOS приложение на Mac. Ако решите да изолирате Codex, като го изпълнявате в Docker, той няма да може да стартира набора от инструменти за изграждане на iOS приложения, съставен от изпълними файлове за Mac, нито да пусне iPhone симулатора, за да изпълни кода. Работен процес, базиран на Docker, може да делегира изграждането и операциите със симулатора на Mac хоста, но те ще се изпълняват извън изолираната среда на контейнера и ще се нуждаят от собствени ограничения. За Codex предпочитаме по-прост подход: инвестираме сериозно в специфични за ОС механизми за изолация, за да може Codex да работи в най-подходящата за конкретната задача среда.
Рамката предоставя тези специфични за ОС механизми за изолация чрез общ API за macOS, Windows и Linux. Този API приема команда и профил с разрешения. Ако профилът с разрешения допуска ограничен достъп до мрежата, извикващият код трябва да предостави мрежово прокси, което да налага тези ограничения:
Тази функция стартира процеса в изолирана среда и връща манипулатор Child, който рамката може да използва, за да изчака приключването му. Всеки дъщерен процес наследява ограниченията на изолираната среда на родителя си. Затова те важат за цялото дърво от процеси, създадено от командата, дори за наследници, които продължават да работят след приключването на първоначалния процес.
Следващата диаграма показва как тези елементи работят заедно — от конфигурирането до изпълнението на команда в изолирана среда. Следващите раздели обясняват всеки етап.

Както е обяснено в Разглеждане на цикъла на агента Codex, рамката на Codex отговаря за изпълнението на извикванията на инструменти, генерирани от модела. При задачи по програмиране най-често се използва инструмент за командна обвивка, който изпълнява команди подобно на потребител в интерактивна обвивка като Bash. Тук ще разгледаме еднократния (отваря се в нов прозорец)инструмент за командна обвивка(отваря се в нов прозорец) exec_command(отваря се в нов прозорец), за да покажем как рамката използва изолираната среда за постигане на желаните защити.
Това е опростена версия на начина, по който рамката на Codex би обработила извикването на инструмента exec_command без изолация:
За да изолира командата, рамката заменя извикването на subprocess.Popen() със spawn_command_under_sandbox(). Рамката предоставя профила с разрешения и при нужда — мрежовото прокси:
Инструментът exec_command също позволява на модела да поиска различни разрешения за отделна команда, но рамката решава дали да одобри заявката:
Когато е зададено use_default, рамката използва конфигурацията по подразбиране на изолираната среда за текущия ход. with_additional_permissions заявява разширен достъп в изолираната среда, а require_escalated — изпълнение извън нея. Рамката оценява заявката според предпочитанията на потребителя, преди да изпълни командата. (Например Codex може да попита потребителя директно или да насочи заявката към автоматичен преглед(отваря се в нов прозорец).) Ако изпълнението е разрешено, Codex ще подаде подходящите permission_profile и network_proxy на perform_exec_command_with_sandboxing() заедно с аргументите на командата от първоначалното ExecCommandToolCall.
Инструментът за командна обвивка е основният ползвател на spawn_command_under_sandbox(), а рамката използва същата инфраструктура за изолация и за операции като четене и промяна на локални файлове. Тази повторна употреба излиза извън рамката: командата codex sandbox ви позволява да включите изпълнение на команди в изолирана среда в собствените си инструменти, както ще видим по-късно. След това ще разгледаме как се дефинират профилите с разрешения.
Именуваният профил с разрешения ви позволява да използвате едни и същи ограничения за файловата система и мрежата в различни проекти. Можете да дефинирате собствени профили в [permissions] във файла config.toml. Например следната конфигурация дефинира профил с име dev, който разширява(отваря се в нов прозорец) вградения профил :workspace:
Профилът dev добавя достъп за запис до ~/build-cache и налага допълнителни ограничения върху файловете в работното пространство. Записите за файловата система могат да предоставят достъп само за четене (read), достъп за четене и запис (write) или да блокират достъпа изцяло (deny).
Таблицата :workspace_roots ви позволява да дефинирате правила за пътища спрямо основните директории на работното пространство на проекта. По подразбиране CLI на Codex използва работната си директория като единствена основна директория на работното пространство, а настолното приложение ChatGPT използва папките с изходния код на проекта. Codex прилага всяко правило към всяка основна директория, така че записът .vscode в dev прави директорията .vscode само за четене във всяка от тях.
Освен собствените си правила, dev наследява следните защити от :workspace:
При конфигурирането на мрежата за изолираната среда в Codex има общо три възможности:
Изключване на целия мрежов достъп (по подразбиране за профила
:workspace)Разрешаване на пълен, директен мрежов достъп (по подразбиране за профила
:danger-full-access)Ограничаване на мрежовия достъп до прокси, което решава какво да пропуска според профила с разрешения
За да предоставите на dev директен достъп до мрежата, задайте permissions.dev.network.enabled = true на най-горното ниво в config.toml. Това предоставя пълен достъп до мрежата, когато мрежовото прокси е изключено.
За да ограничите dev до определени домейни, включете мрежовото прокси и конфигурирайте правилата му за домейни:
Правилата за домейни поддържат точни имена и шаблони със заместващи символи, като изричните забрани имат предимство пред разрешенията. Заявките към други домейни изискват одобрение или се блокират, както е описано по-долу в Мрежово прокси.
Отделните потребители могат да задават настройки по подразбиране за всички проекти и да ги заменят за конкретен доверен проект. Корпоративните администратори също може да искат да зададат настройки по подразбиране за своите потребители и да ограничат кои настройки могат да променят те. Codex поддържа и двете чрез конфигурация на слоеве и управлявани изисквания.
Както е описано в Приоритет на конфигурациите,(отваря се в нов прозорец) Codex обединява настройки от множество файлове config.toml. Таблиците се обединяват рекурсивно, като при конфликт на стойности се използва източникът с по-висок приоритет. Масивите се заменят изцяло.
Затова профилите с разрешения използват таблици за пътищата във файловата система и мрежовите домейни. Екипът може да добавя или заменя отделни записи в собствената си конфигурация и автоматично да наследява промените във всички останали записи от базовата конфигурация на организацията:
Администраторите могат също да задават управлявани изисквания(отваря се в нов прозорец) чрез requirements.toml, за да ограничат избора на конфигурация от потребителите. Тези изисквания могат да идват от множество източници, включително системни файлове и политика, предоставена от облака. Често се задава allowed_permission_profiles, за да се ограничи наборът от профили с разрешения, които корпоративният потребител може да избира. Например администратор може да зададе следните облачни изисквания:
Облачните изисквания имат предимство пред системния файл с изисквания в /etc/codex/requirements.toml, така че запис в този файл не може да отмени изрично зададеното по-горе ":danger-full-access" = false. Ако :workspace остане неуказан, друг слой с изисквания може да предостави този запис. Профилите, чиито записи са false или липсват в окончателната обединена таблица, не са достъпни.
Това разделение позволява на организациите да налагат ограничения, а на потребителите — да адаптират конфигурацията си в тези рамки. Получените профили с разрешения могат да се използват от рамката или да се прилагат директно към команда, както ще видим по-нататък.
CLI на Codex предоставя команда sandbox, която улеснява изпълнението на произволна команда с профил с разрешения, дефиниран в конфигурацията на Codex. Тя обикновено се използва за тестване на профила, за да се провери дали изолираната среда предотвратява действията, които трябва да блокира.
Например следната команда се опитва да конфигурира VS Code да изпълнява злонамерен инструмент за автоматично форматиране при запис. Ако .vscode вече съществува, дефинираният по-горе профил dev би трябвало да блокира този запис, защото директорията е само за четене (по подразбиране codex sandbox третира cwd като основна директория на работното пространство):
Действително, в macOS това завършва с грешка:
Командата codex sandbox прави механизма за изолация на Codex достъпен независимо от сесията на агент. Можете да използвате същия конфигурационен език и специфичните за платформата механизми за налагане на ограничения върху команди, стартирани от собствените ви инструменти.
За stdio MCP сървър, конфигуриран в config.toml, рамката на Codex не се опитва да изолира командата, с която се стартира сървърът. Codex не може надеждно да определи от кои файлове или мрежови услуги се нуждае този сървър, затова прилагането на профил за изолация по подразбиране би могло да наруши иначе валидна конфигурация.
Например стандартният начин за конфигуриране на MCP сървъра @modelcontextprotocol/server-memory(отваря се в нов прозорец) за използване с Codex е следният:
Тъй като тази команда npx се изпълнява без изолация, тя може да записва файлове и да изпраща мрежови заявки със същите права като потребителя, който изпълнява Codex. Това ѝ дава прекомерни права. За да я ограничим, можем да дефинираме профил с разрешения с име memory-mcp и да изпълняваме оригиналната команда npx чрез codex sandbox --permission-profile memory-mcp. Така ще ограничим къде сървърът може да записва и ще му забраним достъпа до мрежата:
Преди да стартирате сървъра, създайте директорията му за данни и добавете фиксираната версия на пакета в кеша на npm. Това позволява на npx --offline да стартира сървъра с профил, който изключва достъпа до мрежата:
След като пакетът е кеширан, Codex може да стартира сървъра за памет без достъп до мрежата, като записът е ограничен до кеша на npm и директорията за данни на сървъра.
Реализацията на изолираната среда преобразува профила с разрешения в ограничения, налагани от операционната система. Основната логика на мрежовото прокси за обработка на заявки и прилагане на политики е обща за трите основни операционни системи, а настройването му и интеграцията с изолираната среда са специфични за ОС. Първо ще разгледаме общото прокси, а след това реализациите за macOS, Linux и Windows.
За да наложи мрежовите ограничения на профила с разрешения, рамката стартира мрежово прокси и конфигурира изолираната среда да допуска връзки към него, като блокира директните връзки към външни хостове. Проксито проверява всяка заявка спрямо правилата за домейни на профила, за да реши дали да я препрати.
В хранилището на Codex мрежовото прокси е реализирано в пакета codex-network-proxy(отваря се в нов прозорец). Рамката го използва като библиотека, но той може да бъде изграден и като самостоятелен CLI(отваря се в нов прозорец). Когато е включен, codex-network-proxy по подразбиране стартира както HTTP прокси, така и SOCKS5 прокси. Адресите на тези проксита се предават на процеса, стартиран от изолираната среда, чрез променливи на средата. Освен стандартните променливи на средата като HTTP_PROXY, HTTPS_PROXY и ALL_PROXY, се задават и редица добре познати променливи на средата за конкретни приложения(отваря се в нов прозорец) (като PIP_PROXY). Разбира се, не всички програми се съобразяват с тези променливи на средата. Ако програма се опита да се свърже директно с външен хост, ограниченията на изолираната среда, наложени от операционната система, я блокират, както е описано в разделите за отделните платформи по-долу.
Мрежовото прокси отговаря за прилагането на мрежовите ограничения, дефинирани в профила с разрешения. Например показаният по-рано профил dev разрешава заявки към *.openai.com и изрично забранява заявки към evil.example. Когато заявка е насочена към домейн, който не съвпада с правило за разрешаване или забрана, проксито може да я задържи, докато поиска одобрение от рамката. Както в примера с командата за обвивката, Codex може да попита потребителя директно или да насочи заявката към автоматичен преглед(отваря се в нов прозорец). След като получи решение, проксито или пропуска заявката, или я отхвърля с отговор за грешка.
Тук редът е важен, защото дори DNS заявка може да разкрие информация, кодирана в име на хост. Затова проксито разрешава заявеното име на хост до адрес едва след като установи, че то е позволено или одобрено. Имайте предвид, че широките правила със заместващи символи или достъпът до DNS услуги все пак могат да позволят изнасяне на данни чрез DNS.
В macOS Codex използва Seatbelt(отваря се в нов прозорец) — механизма на Apple за изолация, налагана от ядрото. Политиките на Seatbelt се пишат на Sandbox Profile Language (SBPL) — език, базиран на Scheme, за описване на ограниченията на изолираната среда. Codex извиква Seatbelt чрез командата /usr/bin/sandbox-exec на macOS. Подобно на codex sandbox, тя приема опции, описващи изолираната среда, последвани от командата за изпълнение:
PROFILE е низ на SBPL, съдържащ записи за конфигуриране на изолираната среда. Например следният фрагмент на SBPL разрешава четене и запис в /dev/null и /dev/zero според политиката на изолираната среда:
Когато мрежовото прокси е включено при стартиране на изолираната среда, в профила се добавят правила като следните, за да ограничат връзките до съответните локални портове:
Базовият профил на Codex започва с (deny default), така че изходящите връзки остават блокирани, освен ако не са изрично разрешени.
Накрая, SBPL може да съдържа заместители чрез (param):
които се попълват чрез опциите -Dkey=value, подадени на sandbox-exec.
За да реализира собствения си API за изолация, Codex съставя списъка с аргументи(отваря се в нов прозорец) за sandbox-exec, като започва от базова политика(отваря се в нов прозорец). След това я допълва с permission_profile и друг контекст, за да получи пълния профил на Seatbelt. Полученият профил и съпътстващите аргументи -D конфигурират ограниченията, налагани от Seatbelt, а мрежовото прокси налага допълнителни мрежови правила. След като е съставен пълният списък с аргументи, извикването на sandbox-exec е лесно.
Генерирането на правилен SBPL е трудно, защото Apple не документира езика за използване от трети страни. Всъщност man sandbox-exec посочва The sandbox-exec command is DEPRECATED (същото важи и за библиотечната функция sandbox_init(), документирана чрез man 3 sandbox_init). Въпреки предупреждението за оттегляне, macOS все още включва профили на Seatbelt в /usr/share/sandbox, а софтуер на трети страни, включително Google Chrome и Chromium(отваря се в нов прозорец), продължава да разчита на Seatbelt. Затова планираме да продължим да използваме Seatbelt в обозримо бъдеще.
За да създаде изолираната среда в Linux, Codex съчетава bubblewrap(отваря се в нов прозорец) (bwrap), инструмент за командния ред за изграждане на изолирани среди, и seccomp-bpf(отваря се в нов прозорец), механизъм в ядрото на Linux за филтриране на системни извиквания. Вътрешна помощна програма с име codex-linux-sandbox координира настройването. Подобно на sandbox-exec в macOS, тя приема конфигурация на изолираната среда, последвана от команда за изпълнение:
Когато е нужна изолация на файловата система или маршрутизиране през прокси, codex-linux-sandbox извиква bwrap, за да създаде първоначалната изолирана среда. След това bwrap стартира codex-linux-sandbox --apply-seccomp-then-exec в нея. Това второ извикване използва seccomp-bpf, за да приложи допълнителни ограничения, преди да изпълни командата на потребителя.
За да изгради първоначалната изолирана среда, Codex използва bubblewrap, за да създаде изглед на файловата система в отделно пространство от имена за монтиране, отразяващ правилата за файловата система в профила с разрешения. Тъй като това е основен елемент на изолацията, Codex включва собствено копие на bwrap, в случай че потребителят не го е инсталирал. При наличие на такава обаче той предпочита съвместима инсталация на (отваря се в нов прозорец)bwrap(отваря се в нов прозорец), намерена в PATH. На практика някои Linux дистрибуции забраняват достъпа до потребителски пространства от имена по подразбиране(отваря се в нов прозорец), но правят изключение за системния bwrap.
Също като sandbox-exec, bwrap приема конфигурация на изолираната среда, последвана от команда за изпълнение в нея. Вместо специализиран конфигурационен език като SBPL, bwrap използва отделни флагове за конфигуриране. Codex използва следните опции, за да създаде изгледа на файловата система:
--bindза задаване на файл или директория с достъп за запис--ro-bindза задаване на файл или директория само за четене--perms 000 --tmpfs DIR --remount-ro DIRза забрана на достъпа доDIR--perms 000 --ro-bind-data FD FILEза забрана на достъпа доFILE(къдетоFDе отворен файлов дескриптор към/dev/null)
За да приложи шаблони glob за забрана чрез тези опции, Codex ги разгръща до конкретни пътища преди стартирането на всяка команда. Нови съвпадащи пътища не се добавят автоматично към ограниченията на изолираната среда за тази команда.
Codex задава и опции като --unshare-ipc и --unshare-pid, за да предотврати достъпа на изолираната среда до други видове ресурси на хоста. Затова bubblewrap влияе не само върху видимостта на файловете.
При използване на bubblewrap Codex подава --unshare-net винаги когато мрежата е изключена или връзките трябва да минават през мрежовото прокси. Това създава ново мрежово пространство от имена за изолираната среда. След това използваме seccomp-bpf, за да наложим допълнителни ограничения върху мрежовите системни извиквания и семействата сокети, достъпни за командата.
По-конкретно използваме пакета seccompiler(отваря се в нов прозорец), за да компилираме динамично BPF програма според желаните филтри(отваря се в нов прозорец) и да я приложим към стартиращ процес в изолираната среда, така че ограниченията да се наследят от цялото дърво от процеси. Затова bwrap не изпълнява командата на потребителя, а стартиращата програма codex-linux-sandbox със собствените ѝ конфигурационни аргументи, последвани от командата на потребителя:
За да приложи seccomp филтри без повишени привилегии, стартиращата програма задава флага no_new_privs на Linux(отваря се в нов прозорец). Този флаг се наследява от дъщерните процеси и им пречи да получават допълнителни привилегии при изпълнение на друга програма, например изпълним файл със setuid.
Филтрите seccomp зависят от мрежовата конфигурация. Когато достъпът до мрежата е изключен, блокираме редица мрежови системни извиквания, като connect(2) и bind(2). Когато обаче мрежовото прокси е включено в изолираната среда, разрешаваме IP сокети, за да е достъпен слушащият TCP сокет, създаден от codex-linux-sandbox. По подразбиране блокираме създаването на самостоятелни Unix domain сокети, тъй като те биха могли неволно да осигурят достъп до ресурси на хоста.
Когато конфигурацията на изолираната среда изисква мрежово прокси, рамката на Codex създава една негова инстанция, която може да се използва при множество извиквания на codex-linux-sandbox в рамките на един и същ разговор в Codex. Всяка изолирана среда се нуждае от начин да достига до това споделено прокси от своето изолирано мрежово пространство от имена. Codex осигурява слушащ TCP сокет на loopback интерфейса в това пространство от имена и организира процес извън изолираната среда, който да приема връзките му и да ги препредава към проксито.
Следващите диаграми илюстрират тази конфигурация за една крайна точка на проксито, като последната показва една връзка през нея. Преди да стартира bubblewrap, codex-linux-sandbox създава двойка Unix сокети за управляващ канал и се разклонява. Дъщерният процес изпълнява run_host_bridge() и изчаква да получи файловия дескриптор на слушащия сокет по този канал:
В този пример родителският процес използва exec, за да замени програмния си образ с bwrap. Това настройва изолираната среда и стартира codex-linux-sandbox --apply-seccomp-then-exec в нея, като предава и файловия дескриптор на управляващия канал:
В мрежовото пространство от имена на изолираната среда второто извикване на codex-linux-sandbox създава слушащ TCP сокет на loopback интерфейса и предава файловия му дескриптор през сокета. Слушащият сокет остава свързан с мрежовото пространство от имена на изолираната среда. Това позволява на дъщерния процес, останал извън нея, да приема връзки от изолирани програми, докато отваря връзките си към проксито в мрежовото пространство от имена на хоста. След предаването двата процеса затварят дескрипторите си за управляващия канал, а процесът в изолираната среда затваря своето копие на слушащия сокет.
След като слушащият TCP сокет е готов, процесът в изолираната среда задава подходяща стойност за HTTP_PROXY(отваря се в нов прозорец) и свързаните променливи на средата, така че да сочат към този сокет. След това прилага seccomp, преди да се разклони и да изпълни командата на потребителя:
Процесът извън изолираната среда държи слушащия сокет отворен. За всяка приета връзка той отваря връзка към конфигурираното прокси и препредава данни в двете посоки.
Този допълнителен механизъм осигурява на командата собствено мрежово пространство от имена, включително отделен loopback интерфейс. В macOS Seatbelt позволява на командата да се свързва директно към определени портове на loopback интерфейса на хоста. В Linux командата вместо това се свързва към слушащ сокет в своето изолирано пространство от имена, а процес извън изолираната среда препредава тези връзки към конфигурираното прокси. Предаването на дескриптора прави тази връзка възможна, без командата да получава достъп до мрежовото пространство от имена на хоста.
По-рано тази година реализирахме изолирана среда за Windows и описахме работата си по нея. Оттогава Microsoft пусна библиотека, наречена MXC, заедно с нови функции за изолиране на процеси в операционната система Windows. В момента заменяме съществуващата си изолирана среда с такава, която използва библиотеката MXC.
MXC (Microsoft eXecution Container) е система за изпълнение на код в изолирана среда(отваря се в нов прозорец) от Microsoft, която поддържа няколко механизма за изолация в Windows, Linux и macOS. Codex поддържа изолирана среда, базирана на MXC, на съвместими устройства с Windows. Тя използва вградената изолация на процеси, за да ограничава командите в съществуващата среда на потребителя.
Преминаваме към MXC, за да подобрим сигурността и удобството при работа и да преодолеем няколко недостатъка на съществуващата ни изолирана среда за Windows:
Необходимост от повишени/администраторски права за настройване на изолираната среда
Ресурсоемки и бавни операции за проверка и задаване на ACL
Оставащи на хост машината настройки на изолираната среда, включително
Списъци за контрол на достъпа (ACL)
Правила на защитната стена
Потребители на изолираната среда
Файлове на управляващия слой
MXC предоставя JSON схема за конфигурация(отваря се в нов прозорец). Codex използва MXC SDK(отваря се в нов прозорец), за да създаде заявка за изпълнение по тази схема, съдържаща командата, работната директория, средата и разрешенията. Тези разрешения обхващат достъпа до файловата система и мрежата, както и до ресурси на Windows като работния плот и клипборда.
Codex използва фиксирани настройки за няколко механизма за контрол, за да балансира съвместимостта и сигурността. Той разрешава четенето на системния регистър и запазва достъпа до Win32k и работния плот, от който PowerShell се нуждае при стартиране. Достъпът до клипборда, симулирането на потребителски вход и управлението на работния плот и системните настройки са изключени. Накрая, на MXC е забранено да прибягва до промяна на разрешенията за файловата система на хоста като резервен вариант.
Codex преобразува правилата за файловата система и мрежата от профила с разрешения в конфигурация за MXC. Ако използваме предходния профил dev и приемем, че:
C:\,D:\иZ:\са единствените локални дискове на машината.Основната директория на работното пространство и работната директория са
C:\work\demo.Домашната директория на потребителя е
D:\Users\dev, така че~/build-cacheсе преобразува вD:\Users\dev\build-cache.Шаблонът glob за забрана съвпада само с
C:\work\demo\config\dev.envиC:\work\demo\config\prod.env.
Съответните настройки на MXC ще включват:
Политиката на MXC за файловата система забранява достъпа по подразбиране. Затова Codex добавя разрешения само за четене за кореновите директории на локалните дискове, за да осигури широкия достъп за четене, позволен от този профил. Тези разрешения се прилагат рекурсивно в рамките на съществуващите права на потребителя в ОС.
Има една особеност: разрешенията за запис за кореновите директории на дисковете не се прилагат рекурсивно, затова Codex ги разширява, за да включи съществуващите преки поддиректории и файлове на диска.
По-конкретните пътища имат предимство пред разрешенията за родителските директории. Така C:\work\demo може да допуска запис в C:\, който е само за четене, а C:\work\demo\.git да остане само за четене.
Когато различни изписвания на пътя или псевдоними чрез символни връзки/junction точки сочат към един и същ път, MXC прилага по-строгото разрешение: забраната има предимство пред достъпа само за четене, а той — пред достъпа за четене и запис.
MXC приема само конкретни пътища за забрана, затова преди стартиране Codex разгръща шаблоните glob до съответстващите файлове и директории. Нови пътища, съвпадащи с шаблона, не се добавят автоматично, докато командата се изпълнява.
Правилата за домейни, като *.openai.com, се налагат от общото мрежово прокси на Codex, описано по-горе. Codex изпълнява това прокси извън изолираната среда и предава адресите му на командата чрез същите стандартни променливи на средата *_PROXY, споменати по-рано. MXC блокира директните външни връзки, но допуска връзки към loopback интерфейса на хоста, включително достъп до проксито. Другите локални услуги остават достъпни.
В macOS, Linux и Windows рамката използва един и същ API за изолация, за да стартира команди с профил с разрешения. Специфичните за платформата реализации извършват необходимите настройки за прилагане на тези ограничения.
Писането и изпълнението на код дава на агентите гъвкав начин за решаване на задачи извън разработката на софтуер. Изолираната среда на Codex им позволява да използват тази възможност в съществуващата среда на потребителя с изрични ограничения за достъпа до файловата система и мрежата. Тя е базов компонент за многократна употреба в рамката, а командата codex sandbox я прави достъпна за инструментите, които създавате сами.
С поемането на все повече задачи от агентите искаме да направим изолацията практична за повече инструменти и среди. Това означава да улесним конфигурирането на разрешенията и да използваме по-добри защити на операционните системи, когато те станат достъпни. Целта ни е да разширим възможностите на агентите, като оставим контрола върху достъпа им в ръцете на хората.


