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 хуктарын тікелей өзгерте алмайды.Пайдаланушының ОЖ-дегі бар құқықтары шегінде файлдық жүйені кең ауқымда оқуға рұқсат береді. Компиляторлар, орындалу орталары және құрастыру құралдары репозиторийден тыс SDK жиынтықтарына, кітапханаларға және конфигурацияға тәуелді. Оқуды тек жұмыс кеңістігімен шектеу көптеген қалыпты жұмыс процестерін бұзар еді. Алайда мұның салдарынан компьютердің басқа жеріндегі құпия файлдар да оқуға ашық қалуы мүмкін (мысалы, API кілттері бар конфигурация файлдары).
Желіге қолжетімділікті өшіреді. Бұл сыртқы қызметтерге тікелей жүктеуді, соның ішінде команда оқи алатын деректерді жасырын әкету әрекеттерін бұғаттайды. Сонымен қатар тәуелділіктерді жүктеу сияқты заңды операцияларға да кедергі келтіреді — оларға қосымша рұқсат керек.
Бұл шектеулер көптеген зиянды әрекетті болдырмайды, бірақ зиян келтіру мүмкіндігін толық жоймайды. Мысалы, агент node_modules/prettier сияқты жергілікті орнатылған пакетке зиянды код енгізуі мүмкін. Мұндай өзгеріс git status нәтижесінде көрінбеуі мүмкін, себебі Git көбіне node_modules каталогін елемейді. Егер пайдаланушы редакторы файлды сақтағанда Prettier бағдарламасының сол көшірмесін іске қосса, файлды жай ғана сақтау зиянды кодты Codex оқшауланған ортасынан тыс орындауы мүмкін. Сондықтан біз көпқабатты қорғанысты қолданамыз: оқшауланған орта командалардың қолжетімділігін шектейді, ал оқыту мен сәйкестендіру модельге сол қолжетімділікті пайдаланушы ниетіне сай пайдалануға көмектеседі.
Кәсіпорын ортасында оқшаулау рұқсаттарын бейімдеу және оларды басқа қорғаныс шараларымен үйлестіру жөнінде Codex қауіпсіздігі жөніндегі практикалық нұсқаулықты(жаңа терезеде ашылады) қараңыз.
Виртуалды машиналар мен контейнерлер(жаңа терезеде ашылады) — оқшаулаудың кең тараған екі тетігі. Бірақ Codex оқшауланған ортасында біз басқа тәсілді қолданамыз. Оқшаулау үшін есептеуді бөлек ортаға көшірудің орнына, Codex пайдаланушының бар ортасында орындалатын командаларды шектеу үшін әр платформаның оқшаулау мүмкіндіктерін қолданады.
Көптеген әзірлеуші үшін ноутбук — өзіне лайықтап бапталған, кез келген сәтте өзгерте алатын әзірлеу ортасы. Сол ортаны Docker контейнерінде қайталап жасау күш жұмсауды талап етеді, ал кейбір жұмыс процестері хостта орындалатын құралдарға бәрібір тәуелді.
Мысалы, Mac компьютерінде iOS қолданбасын әзірлеу үшін Codex пайдалануды қарастырайық. Codex жүйесін Docker ішінде іске қосып оқшауласаңыз, ол Mac жүйесіне арналған орындалатын файлдардан тұратын iOS құрастыру құралдарын да, кодты іске қосатын iPhone симуляторын да орындай алмайды. Docker негізіндегі жұмыс процесі құрастыруды және симулятор операцияларын Mac хостына тапсыра алады. Бірақ ол операциялар контейнердің оқшауланған ортасынан тыс орындалады, сондықтан оларға жеке шектеулер қажет. Codex үшін біз күрделілікті азайтуды жөн көреміз: әр ОЖ-ге тән оқшаулауға көп күш жұмсаймыз, сонда Codex нақты тапсырмаға ең қолайлы ортада жұмыс істей алады.
Тапсырма ортасы ОЖ-ге тән осы оқшаулау тетіктерін macOS, Windows және Linux үшін ортақ API арқылы ұсынады. Бұл 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 мәндерін бастапқы ExecCommandToolCall шақыруындағы команда аргументтерімен бірге perform_exec_command_with_sandboxing() функциясына береді.
spawn_command_under_sandbox() функциясын негізінен қабықша құралы пайдаланады. Тапсырма ортасы оқшаулау инфрақұрылымын жергілікті файлдарды оқу және өзгерту сияқты операцияларға да қайта қолданады. Қайта пайдалану тапсырма ортасымен шектелмейді: кейінірек көрсететініміздей, codex sandbox командасы оқшауланған команда орындауды өз құралдарыңызға қосуға мүмкіндік береді. Енді рұқсаттар профильдерінің қалай анықталатынын қарастырайық.
Атауы бар рұқсаттар профилі файлдық жүйе мен желіге қойылған бірдей шектеулерді әр жобада қайта қолдануға мүмкіндік береді. Өз профильдеріңізді config.toml файлының [permissions] бөлімінде анықтай аласыз. Мысалы, төменде кіріктірілген :workspace профилін кеңейтетін(жаңа терезеде ашылады) dev атты профиль анықталған:
dev профилі ~/build-cache каталогіне жазу рұқсатын қосып, жұмыс кеңістігіндегі файлдарға қосымша шектеулер қояды. Файлдық жүйе жазбалары тек оқуға (read), оқуға және жазуға (write) рұқсат бере алады немесе қолжетімділікті толық бұғаттай алады (deny).
:workspace_roots кестесі жоба жұмыс кеңістігінің түбірлеріне қатысты жолдар үшін ережелер анықтауға мүмкіндік береді. Әдепкіде Codex CLI өз жұмыс каталогін жұмыс кеңістігінің жалғыз түбірі ретінде қолданады, ал ChatGPT компьютерлік қолданбасы жобаның бастапқы код қалталарын пайдаланады. Codex әр ережені барлық түбірге қолданады. Сондықтан dev ішіндегі .vscode жазбасы әр түбірдің астындағы .vscode каталогін тек оқуға ашық етеді.
Өз ережелеріне қоса, dev профилі :workspace профилінен мына қорғаныс шараларын мұралайды:
Codex оқшауланған ортасының желісін баптаудың негізінен үш нұсқасы бар:
Желіге барлық қолжетімділікті өшіру (
:workspaceпрофилінің әдепкі күйі)Желіге толық әрі тікелей қолжетімділік беру (
:danger-full-accessпрофилінің әдепкі күйі)Желіге қолжетімділікті проксимен шектеу; прокси рұқсаттар профиліне қарай нені өткізу керегін шешеді
dev профиліне желіге тікелей қолжетімділік беру үшін config.toml файлының жоғарғы деңгейіне permissions.dev.network.enabled = true мәнін орнатыңыз. Желілік прокси өшірулі болса, бұл желіге толық қолжетімділік береді.
dev профилін белгілі бір домендермен шектеу үшін желілік проксиді қосып, оның домен ережелерін баптаңыз:
Домен ережелері нақты атаулар мен алмастыру таңбалары бар үлгілерді қолдайды. Нақты тыйым салу ережелері рұқсат беру ережелерінен басым. Басқа домендерге сұраулар төмендегі Желілік прокси бөлімінде сипатталғандай мақұлдауды қажет етеді немесе бұғатталады.
Жеке пайдаланушылар барлық жобаға ортақ әдепкі баптауларды орнатып, нақты сенімді жоба үшін оларды өзгерте алады. Кәсіпорын әкімшілері де пайдаланушыларға әдепкі баптаулар орнатып, олардың қай параметрлерді өзгерте алатынын шектеуді қалауы мүмкін. Codex екеуін де қабатты конфигурация және басқарылатын талаптар арқылы қолдайды.
«Конфигурация басымдығы»(жаңа терезеде ашылады) бөлімінде сипатталғандай, Codex бірнеше config.toml файлындағы баптауларды біріктіреді. Кестелер рекурсивті біріктіріледі; мәндер қайшы келсе, басымдығы жоғары дереккөздің мәні алынады. Массивтер тұтас ауыстырылады.
Сондықтан рұқсаттар профильдері файлдық жүйе жолдары мен желі домендері үшін кестелерді қолданады. Команда өз конфигурациясында жеке жазбаларды қосып не өзгертіп, ұйымның базалық конфигурациясындағы барлық басқа жазбалардың өзгерістерін автоматты түрде мұралай алады:
Әкімшілер пайдаланушылардың конфигурация таңдауын шектеу үшін requirements.toml арқылы басқарылатын талаптар(жаңа терезеде ашылады) да бере алады. Бұл талаптар бірнеше дереккөзден, соның ішінде жүйелік файлдар мен бұлттан берілетін саясаттан келуі мүмкін. Кең тараған қолдану тәсілі — кәсіпорын пайдаланушысы таңдай алатын рұқсаттар профильдерін шектеу үшін allowed_permission_profiles мәнін көрсету. Мысалы, әкімші мына бұлттық талаптарды белгілей алады:
Бұлттық талаптар /etc/codex/requirements.toml жүйелік талаптар файлынан басым болады. Сондықтан сол файлдағы жазба жоғарыдағы нақты ":danger-full-access" = false мәнін өзгерте алмайды. :workspace мәнін көрсетпеу сол жазбаны талаптардың басқа қабатынан алуға мүмкіндік береді. Қорытынды біріктірілген кестеде мәні false болған немесе жазбасы жоқ профильдер қолжетімсіз болады.
Бұл бөлу ұйымдарға шектеулерді міндетті етуге, ал пайдаланушыларға сол шектеулер аясында конфигурацияны өзіне бейімдеуге мүмкіндік береді. Алынған рұқсаттар профильдерін тапсырма ортасы пайдалана алады немесе келесі бөлімде көрсетілгендей, оларды командаға тікелей қолдануға болады.
Codex CLI кез келген команданы Codex конфигурациясында анықталған рұқсаттар профилімен орындауды жеңілдететін sandbox командасын ұсынады. Ол әдетте профильді сынап, оқшауланған ортаның көзделген әрекеттерді шынымен бұғаттайтынын тексеру үшін қолданылады.
Мысалы, төмендегі команда VS Code редакторын файл сақталғанда зиянды автоматты пішімдеушіні іске қосатындай баптауға тырысады. Егер .vscode каталогі бұрыннан бар болса, жоғарыдағы dev профилі бұл жазуды бұғаттауы тиіс, себебі каталог тек оқуға ашық (codex sandbox әдепкіде cwd каталогін жұмыс кеңістігінің түбірі деп есептейді):
Шынында да, macOS жүйесінде әрекет мына қатемен аяқталады:
codex sandbox командасы Codex оқшаулау тетігін агент сеансынан тәуелсіз қолдануға мүмкіндік береді. Өз құралдарыңыз іске қосатын командаларды шектеу үшін сол конфигурация тілі мен платформаға тән шектеу тетіктерін қолдана аласыз.
config.toml ішінде бапталған stdio MCP сервері үшін Codex тапсырма ортасы серверді іске қосатын команданы оқшаулауға тырыспайды. Codex серверге қандай файлдар немесе желілік қызметтер қажет екенін сенімді анықтай алмайды. Сондықтан әдепкі оқшаулау профилін қолдану дұрыс конфигурацияның өзін істен шығаруы мүмкін.
Мысалы, @modelcontextprotocol/server-memory(жаңа терезеде ашылады) MCP серверін 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 Apple компаниясының ядро деңгейінде орындалатын оқшаулау тетігін — Seatbelt(жаңа терезеде ашылады) қолданады. Seatbelt саясаттары оқшаулау шектеулерін сипаттауға арналған, Scheme негізіндегі Sandbox Profile Language (SBPL) тілінде жазылады. Codex Seatbelt тетігін macOS жүйесінің /usr/bin/sandbox-exec командасы арқылы шақырады. codex sandbox сияқты, ол алдымен оқшауланған ортаны сипаттайтын параметрлерді, содан кейін орындалатын команданы қабылдайды:
PROFILE — оқшауланған ортаны баптайтын жазбалары бар SBPL жолы. Мысалы, мына SBPL үзіндісі оқшаулау саясаты аясында /dev/null және /dev/zero файлдарын оқуға және жазуға ашады:
Оқшауланған орта шақырылғанда желілік прокси қосылса, қосылымдарды тиісті жергілікті порттармен шектеу үшін профильге мынадай ережелер енгізіледі:
Codex базалық профилі (deny default) ережесінен басталады. Сондықтан нақты рұқсат берілмесе, шығыс қосылымдары бұғатталған күйде қалады.
Сонымен қатар SBPL ішінде (param) арқылы берілген толтырғыштар болуы мүмкін:
Олар sandbox-exec командасына берілетін -Dkey=value параметрлерімен толтырылады.
Өз оқшаулау API интерфейсін іске асыру үшін Codex базалық саясаттан(жаңа терезеде ашылады) бастап sandbox-exec үшін аргументтер тізімін құрады(жаңа терезеде ашылады). Одан кейін permission_profile мен басқа контекст арқылы оны толықтырып, толық Seatbelt профилін жасайды. Алынған профиль мен оған ілеспе -D аргументтері Seatbelt орындататын шектеулерді баптайды, ал желілік прокси қосымша желі ережелерін орындатады. Аргументтердің толық тізімі дайын болған соң sandbox-exec командасын шақыру оңай.
Дұрыс SBPL жасау қиын, өйткені Apple бұл тілді үшінші тараптардың қолдануына арнап құжаттамаған. Шынында да, man sandbox-exec құжатында The sandbox-exec command is DEPRECATED деп жазылған (man 3 sandbox_init арқылы құжатталған sandbox_init() кітапхана функциясы да ескірген деп белгіленген). Ескіргені туралы ескертуге қарамастан, macOS әлі де /usr/share/sandbox ішінде Seatbelt профильдерін жеткізеді. Үшінші тарап бағдарламалары да, соның ішінде Google Chrome мен Chromium(жаңа терезеде ашылады), Seatbelt тетігіне сүйенуді жалғастыруда. Сондықтан таяу болашақта Seatbelt қолдануды жалғастыруды жоспарлап отырмыз.
Linux жүйесінде оқшауланған орта жасау үшін Codex екі тетікті бірге қолданады: оқшауланған орталар құратын командалық жол құралы bubblewrap(жаңа терезеде ашылады) (bwrap) және жүйелік шақыруларды сүзетін Linux ядросының тетігі seccomp-bpf(жаңа терезеде ашылады). Баптауды codex-linux-sandbox атты ішкі көмекші құрал үйлестіреді. macOS жүйесіндегі sandbox-exec сияқты, ол алдымен оқшауланған орта конфигурациясын, содан кейін орындалатын команданы қабылдайды:
Файлдық жүйені оқшаулау немесе прокси арқылы бағыттау қажет болғанда, codex-linux-sandbox бастапқы оқшауланған ортаны құру үшін bwrap құралын шақырады. Содан кейін bwrap оның ішінде codex-linux-sandbox --apply-seccomp-then-exec командасын іске қосады. Бұл екінші шақыру пайдаланушы командасын орындамас бұрын seccomp-bpf арқылы қосымша шектеулер қояды.
Бастапқы оқшауланған ортаны құру үшін Codex bubblewrap арқылы бөлек тіркеу атаулар кеңістігінде рұқсаттар профилінің ережелеріне сай файлдық жүйе көрінісін жасайды. Бұл оқшаулау тетігінің негізі болғандықтан, пайдаланушы өзі орнатпаған жағдайға арнап Codex bwrap көшірмесін өзімен бірге жеткізеді. Бірақ PATH ішінде үйлесімді нұсқа бар болса, сол орнатылған нұсқаны артық көреді: (жаңа терезеде ашылады)bwrap(жаңа терезеде ашылады). Тәжірибеде кейбір 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 тек файлдардың көрінуін ғана шектемейді.
Желі өшірілгенде немесе қосылымдар желілік прокси арқылы өтуі тиіс болғанда, Codex bubblewrap құралына --unshare-net параметрін береді. Бұл оқшауланған ортаға жаңа желілік атаулар кеңістігін жасайды. Одан кейін командаға қолжетімді желілік жүйелік шақырулар мен сокет топтарына қосымша шектеулер қою үшін seccomp-bpf қолданамыз.
Нақтырақ айтқанда, seccompiler пакетімен(жаңа терезеде ашылады) қажетті сүзгілерге сай BPF бағдарламасын динамикалық түрде компиляциялаймыз(жаңа терезеде ашылады). Оны оқшауланған ортадағы іске қосушы процеске қолданамыз, сонда шектеулер бүкіл процестер ағашына мұраланады. Сондықтан bwrap пайдаланушы командасын емес, codex-linux-sandbox іске қосушысын орындайды: алдымен оның конфигурация аргументтері, содан кейін пайдаланушы командасы беріледі:
seccomp сүзгілерін жоғары артықшылықтарсыз қолдану үшін іске қосушы Linux жүйесінің no_new_privs жалаушасын орнатады(жаңа терезеде ашылады). Бұл жалауша еншілес процестерге мұраланып, басқа бағдарламаны, мысалы setuid орындалатын файлын іске қосқанда қосымша артықшылықтар алуына жол бермейді.
seccomp сүзгілері желі конфигурациясына тәуелді. Желіге қолжетімділік өшірілгенде, connect(2) және bind(2) сияқты бірқатар желілік жүйелік шақыруды бұғаттаймыз. Ал оқшауланған ортада желілік прокси қосылғанда, codex-linux-sandbox жасаған TCP тыңдағышына жету үшін IP сокеттеріне рұқсат береміз. Бірақ жеке Unix домендік сокеттерін жасау әдепкіде бұғатталады, өйткені олар хост ресурстарына байқаусызда қол жеткізуге жол ашуы мүмкін.
Оқшауланған орта конфигурациясы желілік проксиді қажет етсе, Codex тапсырма ортасы проксидің бір данасын жасайды. Оны бір Codex диалогында codex-linux-sandbox бірнеше рет шақырылғанда қайта пайдалануға болады. Әр оқшауланған орта өз желілік атаулар кеңістігінен сол ортақ проксиге жетуі керек. Codex сол кеңістікте кері байланыс TCP тыңдағышын жасап, ортадан тыс процестің оның қосылымдарын қабылдап, проксиге жеткізуін ұйымдастырады.
Төмендегі диаграммалар бұл құрылымды бір прокси соңғы нүктесі үшін көрсетеді; соңғы диаграммада сол нүкте арқылы өтетін бір қосылым берілген. bubblewrap іске қосылмас бұрын codex-linux-sandbox басқару арнасы ретінде Unix сокеттер жұбын жасап, өзінен еншілес процесс таратады. Еншілес процесс run_host_bridge() функциясын орындап, сол арна арқылы тыңдағыштың файл дескрипторын күтеді:
Бұл мысалда ата-аналық процесс exec арқылы өзінің бағдарламалық бейнесін bwrap бағдарламасымен алмастырады. Ол оқшауланған ортаны баптап, оның ішінде басқару арнасының FD дескрипторын бере отырып, codex-linux-sandbox --apply-seccomp-then-exec командасын іске қосады:
Оқшауланған ортаның желілік атаулар кеңістігінде codex-linux-sandbox екінші рет шақырылғанда, кері байланыс TCP тыңдағышын жасап, оның файл дескрипторын сокет арқылы жібереді. Тыңдағыш оқшауланған ортаның желілік атаулар кеңістігімен байланысты болып қалады. Соның арқасында ортадан тыс қалған еншілес процесс оқшауланған бағдарламалардан қосылым қабылдап, ал проксиге баратын өз қосылымдарын хосттың желілік атаулар кеңістігінде аша алады. Дескриптор берілгеннен кейін екі процесс те басқару арнасының дескрипторларын жабады, ал оқшауланған орта ішіндегі процесс тыңдағыштың өз көшірмесін де жабады.
TCP тыңдағышы дайын болғанда, оқшауланған орта ішіндегі процесс сол тыңдағышқа бағыттау үшін HTTP_PROXY айнымалысының тиісті мәнін орнатады(жаңа терезеде ашылады) және оған қатысты орта айнымалыларын баптайды. Содан кейін еншілес процесс жасап, пайдаланушы командасын орындамас бұрын seccomp шектеулерін қолданады:
Оқшауланған ортадан тыс процесс тыңдағышты ашық ұстайды. Әр қабылданған қосылым үшін ол бапталған проксиге қосылып, деректерді екі бағытта тасымалдайды.
Бұл қосымша тетік командаға бөлек кері байланыс интерфейсі бар жеке желілік атаулар кеңістігін береді. macOS жүйесінде Seatbelt командаға хосттың кері байланыс интерфейсіндегі белгіленген порттарға тікелей қосылуға мүмкіндік береді. Ал Linux жүйесінде команда өзінің оқшауланған атаулар кеңістігіндегі тыңдағышқа қосылады; ортадан тыс процесс сол қосылымдарды бапталған проксиге жеткізеді. Дескрипторды беру арқылы бұл қосылымды командаға хосттың желілік атаулар кеңістігін ашпай-ақ орнатуға болады.
Осы жылдың басында біз Windows жүйесінде оқшаулауды іске асырып, бұл бағыттағы жұмысымыз туралы жазған едік. Содан бері Microsoft Windows операциялық жүйесінде процестерді оқшаулаудың жаңа мүмкіндіктерімен бірге MXC кітапханасын шығарды. Қазір біз қолданыстағы оқшауланған ортаны MXC кітапханасын пайдаланатын нұсқамен ауыстырып жатырмыз.
MXC (Microsoft eXecution Container) — Microsoft ұсынған кодты оқшауланған ортада орындау жүйесі(жаңа терезеде ашылады). Ол Windows, Linux және macOS жүйелеріндегі бірнеше оқшаулау тетігін қолдайды. Үйлесімді Windows құрылғыларында Codex MXC негізіндегі оқшауланған ортаны қолдайды. Пайдаланушының бар ортасында командаларды шектеу үшін жүйенің кіріктірілген процесс оқшаулау мүмкіндігін пайдаланады.
Біз қауіпсіздік пен қолдану ыңғайлылығын жақсарту және Windows жүйесіндегі қазіргі оқшауланған ортаның мына кемшіліктерін жою үшін MXC жүйесіне көшіп жатырмыз:
Ортаны баптау үшін жоғары артықшылықтар не әкімші құқықтарының қажет болуы
ACL тексеру және орнату операцияларының көп ресурс жұмсап, баяу орындалуы
Хост компьютерде оқшауланған орта баптауларының тұрақты сақталуы, соның ішінде:
Қолжетімділікті басқару тізімдері (ACL)
Желіаралық қалқан ережелері
Оқшауланған орта пайдаланушылары
Басқару қабатының файлдары
MXC JSON конфигурация схемасын(жаңа терезеде ашылады) ұсынады. Codex MXC SDK(жаңа терезеде ашылады) арқылы осы схемаға сай орындау сұрауын құрады. Сұрауда команда, жұмыс каталогі, орта және рұқсаттар қамтылады. Бұл рұқсаттар файлдық жүйе мен желіге, сондай-ақ жұмыс үстелі және алмасу буфері сияқты Windows ресурстарына қолжетімділікті қамтиды.
Үйлесімділік пен қауіпсіздікті тең ұстау үшін Codex бірқатар басқару параметрлерінің мәндерін бекітіп қояды. Ол тізілімді оқуға рұқсат береді және PowerShell іске қосылғанда қажет болатын Win32k пен жұмыс үстеліне қолжетімділікті сақтайды. Алмасу буферіне қолжетімділік, енгізу оқиғаларын жасанды жіберу, жұмыс үстелі мен жүйе баптауларын басқару өшіріледі. Соңында, 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:\ ішінде C:\work\demo жазуға ашық болып, ал C:\work\demo\.git тек оқуға ашық қала алады.
Бір жолдың түрлі жазылуы немесе символдық сілтемелер мен junction бүркеншік атаулары бір жолды көрсетсе, MXC қатаңырақ рұқсатты қолданады: тыйым салу тек оқудан, ал тек оқу оқу-жазудан басым болады.
MXC тек нақты тыйым салынған жолдарды қабылдайды. Сондықтан Codex іске қосар алдында тыйым салу glob үлгілерін сәйкес файлдар мен каталогтер тізіміне айналдырады. Команда орындалып жатқанда glob үлгісіне сәйкес келетін жаңа жолдар автоматты түрде қосылмайды.
*.openai.com сияқты домен ережелерін жоғарыда сипатталған ортақ Codex желілік проксиі орындатады. Codex бұл проксиді оқшауланған ортадан тыс іске қосып, оның мекенжайларын командаға жоғарыда айтылған стандартты *_PROXY орта айнымалылары арқылы береді. MXC сыртқа тікелей қосылуды бұғаттайды, бірақ хосттың кері байланыс интерфейсіне, соның ішінде проксиге қосылуға рұқсат береді. Басқа жергілікті қызметтер де қолжетімді болып қалады.
macOS, Linux және Windows жүйелерінде тапсырма ортасы командаларды рұқсаттар профилімен іске қосу үшін бірдей оқшаулау API интерфейсін пайдаланады. Әр платформаға тән іске асыру нұсқалары осы шектеулерді қолдануға қажетті баптауды орындайды.
Код жазу және орындау агенттерге бағдарламалық жасақтама әзірлеуден тыс мәселелерді де икемді шешуге мүмкіндік береді. Codex оқшауланған ортасы бұл мүмкіндікті пайдаланушының бар ортасында, файлдық жүйе мен желіге қолжетімділіктің нақты шектеулерімен қолдануға жол ашады. Бұл — тапсырма ортасында қайта қолданылатын базалық тетік. Ал codex sandbox командасы оны өзіңіз жасаған құралдарға да қолжетімді етеді.
Агенттер көбірек тапсырма атқарған сайын, біз оқшаулауды көбірек құрал мен ортада қолдануға ыңғайлы еткіміз келеді. Бұл үшін рұқсаттарды баптауды жеңілдетіп, операциялық жүйелерде жетілдірілген қорғаныс мүмкіндіктері пайда болған сайын оларды пайдалану қажет. Мақсатымыз — агенттердің мүмкіндіктерін кеңейте отырып, олардың неге қол жеткізе алатынын адамдардың бақылауында қалдыру.


