Kaip veikia Codex izoliuotoji aplinka
Kaip Codex vykdo komandas jūsų kompiuteryje laikydamasis jūsų nustatytų ribojimų.
Siekdami apsaugoti agentus, OpenAI taikome daugiasluoksnės apsaugos(atsidaro naujame lange) principą. Nors šių pastangų pagrindas yra investicijos į mokymą ir suderinimą su žmogaus ketinimais, papildomų apsaugos funkcijų diegiame ir savo agentų infrastruktūroje Codex(atsidaro naujame lange). Viena dažniausių ir potencialiai rizikingų Codex užduočių – vykdyti komandas jūsų kompiuteryje. Todėl sukūrėme Codex izoliuotąją aplinką, kad Codex galėtų dirbti jūsų esamoje aplinkoje laikydamasis jūsų nustatytų failų sistemos ir tinklo ribojimų.
Izoliuotoji aplinka(atsidaro naujame lange) (atsidaro naujame lange)riboja, ką programa gali pasiekti veikdama. Nuotraukų tvarkymo užduočiai galite sukonfigūruoti Codex izoliuotąją aplinką taip, kad komandos galėtų skaityti ir keisti failus kataloge ~/Pictures, bet neturėtų prieigos prie tinklo ir negalėtų jų įkelti. Kodo peržiūrai galite leisti pasiekti internetinę dokumentaciją, o pirminio kodo failus palikti tik skaitomus. Naudotojai Codex izoliuotąją aplinką konfigūruoja naudodami (atsidaro naujame lange)leidimų profilius(atsidaro naujame lange), kurie apibrėžia Codex seanso failų sistemos ir tinklo ribojimus.
Šiame straipsnyje pirmiausia aptarsime kompromisus, kuriais grindžiamos numatytosios Codex izoliuotosios aplinkos nuostatos, tada paaiškinsime jos sandarą ir kaip infrastruktūra ją naudoja komandoms vykdyti. Parodysime, kaip galutiniai naudotojai ir įmonės gali pritaikyti leidimus savo poreikiams, o kūrėjai – panaudoti izoliuotąją aplinką savo įrankiuose. Galiausiai išnagrinėsime, kaip šie ribojimai užtikrinami sistemose macOS, Linux ir Windows.
Kurdami Codex laikomės principo nustatyti atsargias numatytąsias izoliuotosios aplinkos nuostatas, kurios vis tiek leistų atlikti prasmingą darbą. Pavyzdžiui, kai darbo erdvės šakninis katalogas yra Git saugykla, integruotas leidimų profilis :workspace:
Leidžia rašyti darbo erdvėje, tačiau tokius katalogus kaip
.gitir.codexpalieka tik skaitomus. Taip Codex gali redaguoti pirminį kodą neprašydamas leidimo kiekvienam pakeitimui, tačiau negali tiesiogiai keisti.codex/config.tomlar Git įvykių scenarijų kataloge.git/hooks.Suteikia plačią skaitymo prieigą prie failų sistemos, neviršijant esamų naudotojo OS leidimų. Kompiliatoriams, vykdymo aplinkoms ir programų surinkimo įrankiams reikia už saugyklos ribų esančių SDK, bibliotekų ir konfigūracijos. Apribojus skaitymą tik darbo erdve, sutriktų daugelis įprastų darbo eigų. Kita šio sprendimo pusė – kitur kompiuteryje esantys neskelbtini failai taip pat gali likti skaitomi, pavyzdžiui, konfigūracijos failai su API raktais.
Išjungia prieigą prie tinklo. Taip blokuojamas tiesioginis įkėlimas į išorines paslaugas, įskaitant bandymus nutekinti duomenis, kuriuos komanda gali skaityti. Kartu neleidžiamos ir teisėtos operacijos, pvz., priklausomybių atsisiuntimas, kurioms reikia papildomos prieigos.
Šie ribojimai užkerta kelią daugeliui nepageidaujamų veiksmų, tačiau žalingi veiksmai vis tiek įmanomi. Pavyzdžiui, agentas galėtų įterpti kenkėjišką kodą į vietoje įdiegtą paketą, tokį kaip node_modules/prettier. Toks pakeitimas gali būti nerodomas git status išvestyje, nes Git dažnai nepaiso node_modules katalogo. Jei naudotojo redaktorius išsaugant failą paleidžia tą Prettier kopiją, vien išsaugojus failą kenkėjiškas kodas gali būti įvykdytas už Codex izoliuotosios aplinkos ribų. Todėl taikome daugiasluoksnę apsaugą: izoliuotoji aplinka riboja komandų prieigą, o mokymas ir suderinimas su žmogaus ketinimais padeda modeliui naudotis šia prieiga pagal naudotojo tikslus.
Rekomendacijų, kaip pritaikyti izoliuotosios aplinkos leidimus ir derinti juos su kitomis apsaugos priemonėmis įmonės aplinkoje, rasite praktiniame Codex saugumo vadove(atsidaro naujame lange).
Virtualiosios mašinos ir konteineriai(atsidaro naujame lange) – du populiarūs izoliavimo mechanizmai, tačiau Codex izoliuotajai aplinkai pasirinkome kitą būdą. Užuot perkėlęs skaičiavimus į atskirą aplinką, Codex naudoja kiekvienos platformos izoliavimo priemones, kad apribotų komandas, veikiančias esamoje naudotojo aplinkoje.
Daugeliui kūrėjų nešiojamasis kompiuteris yra individualiai pritaikyta kūrimo aplinka, kurią jie gali bet kada keisti. Atkurti tokią aplinką Docker konteineryje gali būti nelengva, o kai kurioms darbo eigoms vis tiek reikia pagrindiniame kompiuteryje veikiančių įrankių.
Tarkime, naudojate Codex iOS programėlei kurti Mac kompiuteryje. Jei nuspręstumėte izoliuoti Codex paleisdami jį Docker konteineryje, Codex negalėtų paleisti iOS surinkimo įrankių rinkinio, sudaryto iš Mac skirtų vykdomųjų failų, ar iPhone simuliatoriaus kodui vykdyti. Docker pagrįstoje darbo eigoje surinkimą ir simuliatoriaus operacijas būtų galima perduoti pagrindiniam Mac kompiuteriui, tačiau jos būtų vykdomos už konteinerio izoliuotosios aplinkos ribų ir joms reikėtų atskirų ribojimų. Kurdami Codex siekiame paprastumo, todėl daug investuojame į konkrečioms OS pritaikytą izoliavimą, kad Codex galėtų veikti aplinkoje, geriausiai tinkančioje konkrečiai užduočiai.
Infrastruktūra suteikia prieigą prie šių OS būdingų izoliavimo mechanizmų per bendrą API sistemose macOS, Windows ir Linux. Ši API priima komandą ir leidimų profilį. Jei leidimų profilis suteikia ribotą prieigą prie tinklo, iškviečianti programa turi pateikti tinklo tarpinį serverį, kuris užtikrintų šiuos ribojimus:
Ši funkcija paleidžia procesą izoliuotojoje aplinkoje ir grąžina Child valdiklį, kurį infrastruktūra gali naudoti laukdama, kol procesas baigsis. Kiekvienas antrinis procesas paveldi pirminio proceso izoliavimo ribojimus, todėl jie galioja visame komandos pradėtame procesų medyje, net ir tiems palikuonims, kurie veikia ilgiau už pradinį procesą.
Toliau pateiktoje diagramoje parodyta, kaip šios dalys susijusios – nuo konfigūravimo iki komandos vykdymo izoliuotojoje aplinkoje. Tolesnėse skiltyse paaiškinamas kiekvienas etapas.

Kaip paaiškinta straipsnyje Kaip veikia Codex agento ciklas, Codex infrastruktūra atsakinga už modelio sugeneruotų įrankių iškvietimų vykdymą. Programavimo užduotims dažniausiai naudojamas apvalkalo įrankis, kuris vykdo komandas panašiai kaip naudotojas interaktyviame apvalkale, pvz., Bash. Čia nagrinėsime vienkartinio vykdymo (atsidaro naujame lange)exec_command(atsidaro naujame lange) apvalkalo įrankį(atsidaro naujame lange), kad parodytume, kaip infrastruktūra pasitelkia izoliuotąją aplinką reikiamai apsaugai užtikrinti.
Tai supaprastintas pavyzdys, kaip Codex infrastruktūra vykdytų įrankio exec_command iškvietimą be izoliavimo:
Norėdama izoliuoti komandą, infrastruktūra pakeičia subprocess.Popen() iškvietimą į spawn_command_under_sandbox(). Infrastruktūra pateikia leidimų profilį ir, kai reikia, tinklo tarpinį serverį:
Įrankis exec_command taip pat leidžia modeliui prašyti kitokių leidimų atskirai komandai, tačiau infrastruktūra nusprendžia, ar prašymą patenkinti:
Nurodžius use_default, infrastruktūra naudoja numatytąją to pokalbio žingsnio izoliuotosios aplinkos konfigūraciją. with_additional_permissions prašo platesnės prieigos izoliuotojoje aplinkoje, o require_escalated – vykdymo už jos ribų. Prieš vykdydama komandą, infrastruktūra įvertina prašymą pagal naudotojo nuostatas. (Pavyzdžiui, Codex gali tiesiogiai paprašyti naudotojo patvirtinimo arba nukreipti prašymą į automatinę peržiūrą(atsidaro naujame lange).) Jei vykdymas leidžiamas, Codex perduoda tinkamus permission_profile ir network_proxy funkcijai perform_exec_command_with_sandboxing() kartu su komandos argumentais iš pradinio ExecCommandToolCall.
Apvalkalo įrankis dažniausiai naudoja spawn_command_under_sandbox(), o infrastruktūra izoliavimo priemones pakartotinai pasitelkia ir tokioms operacijoms kaip vietinių failų skaitymas bei keitimas. Pakartotinis naudojimas neapsiriboja infrastruktūra: komanda codex sandbox leidžia įtraukti izoliuotą komandų vykdymą į savo įrankius, kaip parodysime vėliau. Toliau apžvelgsime, kaip apibrėžiami leidimų profiliai.
Pavadintas leidimų profilis leidžia tuos pačius failų sistemos ir tinklo ribojimus naudoti skirtinguose projektuose. Savo profilius galite apibrėžti failo config.toml skiltyje [permissions]. Pavyzdžiui, toliau apibrėžiamas profilis dev, kuris išplečia(atsidaro naujame lange) integruotą profilį :workspace:
Profilis dev suteikia rašymo prieigą prie ~/build-cache ir papildomai apriboja darbo erdvės failus. Failų sistemos įrašai gali suteikti tik skaitymo prieigą (read), skaitymo ir rašymo prieigą (write) arba visiškai uždrausti prieigą (deny).
Lentelėje :workspace_roots galite apibrėžti kelių taisykles projekto darbo erdvės šakninių katalogų atžvilgiu. Pagal numatytąsias nuostatas Codex CLI naudoja savo darbinį katalogą kaip vienintelį darbo erdvės šakninį katalogą, o ChatGPT darbalaukio programa naudoja projekto pirminio kodo aplankus. Codex kiekvieną taisyklę taiko visiems šakniniams katalogams, todėl profilio dev įrašas .vscode kiekviename jų esantį katalogą .vscode padaro tik skaitomą.
Be savo taisyklių, dev iš :workspace paveldi šias apsaugos priemones:
Konfigūruojant Codex izoliuotosios aplinkos tinklą, iš esmės galima rinktis iš trijų variantų:
Visiškai išjungti prieigą prie tinklo (numatytoji profilio
:workspacenuostata)Įjungti visišką tiesioginę prieigą prie tinklo (numatytoji profilio
:danger-full-accessnuostata)Leisti prieigą prie tinklo tik per tarpinį serverį, kuris pagal leidimų profilį nusprendžia, ką praleisti
Norėdami suteikti dev tiesioginę prieigą prie tinklo, failo config.toml aukščiausiame lygyje nustatykite permissions.dev.network.enabled = true. Kai tinklo tarpinis serveris išjungtas, tai suteikia visišką prieigą prie tinklo.
Norėdami apriboti dev prieigą iki tam tikrų domenų, įjunkite tinklo tarpinį serverį ir sukonfigūruokite jo domenų taisykles:
Domenų taisyklės palaiko tikslius pavadinimus ir šablonus su pakaitos simboliais. Aiškiai nurodytos draudimo taisyklės turi pirmenybę prieš leidimo taisykles. Užklausoms į kitus domenus reikia patvirtinimo arba jos blokuojamos, kaip aprašyta toliau esančioje skiltyje Tinklo tarpinis serveris.
Naudotojai gali nustatyti numatytąsias nuostatas visiems projektams ir jas pakeisti konkrečiam patikimam projektui. Įmonių administratoriai taip pat gali norėti nustatyti numatytąsias nuostatas savo naudotojams ir apriboti, kurias iš jų naudotojai gali keisti. Codex palaiko abi galimybes pasitelkdamas sluoksniuotą konfigūraciją ir centralizuotai valdomus reikalavimus.
Kaip aprašyta skiltyje Konfigūracijos pirmenybė,(atsidaro naujame lange) Codex sujungia nuostatas iš kelių config.toml failų. Lentelės sujungiamos rekursyviai, o reikšmėms prieštaraujant pasirenkamas aukštesnę pirmenybę turintis šaltinis. Masyvai pakeičiami visi.
Todėl leidimų profiliuose failų sistemos keliams ir tinklo domenams naudojamos lentelės. Komanda savo konfigūracijoje gali pridėti arba pakeisti atskirus įrašus ir automatiškai paveldėti visų kitų organizacijos bazinės konfigūracijos įrašų pakeitimus:
Administratoriai taip pat gali per requirements.toml pateikti centralizuotai valdomus reikalavimus(atsidaro naujame lange), kad apribotų naudotojų konfigūravimo galimybes. Šie reikalavimai gali būti gaunami iš kelių šaltinių, įskaitant sistemos failus ir debesijoje pateikiamą politiką. Dažnai nurodomas allowed_permission_profiles, kad būtų apribotas leidimų profilių rinkinys, iš kurio gali rinktis įmonės naudotojas. Pavyzdžiui, administratorius galėtų nurodyti šiuos debesijos reikalavimus:
Debesijos reikalavimai turėtų pirmenybę prieš sistemos reikalavimų failą /etc/codex/requirements.toml, todėl šio failo įrašas negali pakeisti pirmiau aiškiai nurodyto ":danger-full-access" = false. Palikus :workspace nenurodytą, šį įrašą gali pateikti kitas reikalavimų sluoksnis. Profiliai, kurių įrašų reikšmė yra false arba kurių nėra galutinėje sujungtoje lentelėje, nepasiekiami.
Toks atskyrimas leidžia organizacijoms užtikrinti ribojimus, o naudotojams – pritaikyti konfigūraciją jų neperžengiant. Gautus leidimų profilius gali naudoti infrastruktūra arba juos galima taikyti tiesiogiai komandai, kaip netrukus parodysime.
Codex CLI pateikia komandą sandbox, kuri leidžia lengvai vykdyti bet kurią komandą pagal Codex konfigūracijoje apibrėžtą leidimų profilį. Ji dažnai naudojama profiliui išbandyti ir įsitikinti, kad izoliuotoji aplinka neleidžia atlikti veiksmų, kuriuos turi blokuoti.
Pavyzdžiui, toliau pateikta komanda bando sukonfigūruoti VS Code taip, kad išsaugant failą būtų paleista kenkėjiška automatinio formatavimo programa. Jei .vscode jau yra, pirmiau apibrėžtas dev profilis turėtų blokuoti šį rašymą, nes katalogas yra tik skaitomas (codex sandbox pagal numatytąsias nuostatas laiko cwd darbo erdvės šakniniu katalogu):
Iš tiesų sistemoje macOS ši operacija nepavyksta ir pateikiama:
Komanda codex sandbox leidžia naudoti Codex izoliavimo mechanizmą nepriklausomai nuo agento seanso. Galite naudoti tą pačią konfigūravimo kalbą ir platformai pritaikytą ribojimų užtikrinimą, kad apribotumėte savo įrankių paleidžiamas komandas.
Kai stdio MCP serveris sukonfigūruotas faile config.toml, Codex infrastruktūra nebando izoliuoti komandos, kuria jis paleidžiamas. Codex negali patikimai nustatyti, kokių failų ar tinklo paslaugų reikia serveriui, todėl pritaikius numatytąjį izoliuotosios aplinkos profilį gali nebeveikti šiaip tinkama konfigūracija.
Pavyzdžiui, įprastai MCP serveris @modelcontextprotocol/server-memory(atsidaro naujame lange) darbui su Codex konfigūruojamas taip:
Kadangi ši npx komanda vykdoma neizoliuotai, ji gali rašyti failus ir siųsti tinklo užklausas turėdama tuos pačius leidimus kaip Codex paleidęs naudotojas. Tai pernelyg plati prieiga. Norėdami ją apriboti, galime apibrėžti leidimų profilį memory-mcp ir pradinę npx komandą vykdyti per codex sandbox --permission-profile memory-mcp. Taip apribosime, kur serveris gali rašyti, ir neleisime jam pasiekti tinklo:
Prieš paleisdami serverį, sukurkite jo duomenų katalogą ir į npm podėlį įrašykite fiksuotos versijos paketą. Tada npx --offline galės paleisti serverį pagal profilį, kuriame prieiga prie tinklo išjungta:
Kai paketas įrašytas į podėlį, Codex gali paleisti atminties serverį be prieigos prie tinklo, leisdamas rašyti tik į npm podėlį ir serverio duomenų katalogą.
Izoliuotosios aplinkos realizacija leidimų profilį paverčia operacinės sistemos užtikrinamais ribojimais. Pagrindinė tinklo tarpinio serverio užklausų apdorojimo ir politikos logika bendra visoms trims pagrindinėms operacinėms sistemoms, o jo parengimas ir integravimas su izoliuotąja aplinka priklauso nuo OS. Pirmiausia išnagrinėsime bendrą tarpinį serverį, tada – realizacijas sistemose macOS, Linux ir Windows.
Kad užtikrintų leidimų profilio tinklo ribojimus, infrastruktūra paleidžia tinklo tarpinį serverį ir sukonfigūruoja izoliuotąją aplinką taip, kad būtų leidžiama jungtis prie jo, bet blokuojami tiesioginiai ryšiai su išoriniais kompiuteriais. Tarpinis serveris tikrina kiekvieną užklausą pagal profilio domenų taisykles ir nusprendžia, ar ją persiųsti.
Codex saugykloje tinklo tarpinis serveris realizuotas pakete codex-network-proxy(atsidaro naujame lange), kurį infrastruktūra naudoja kaip biblioteką, nors jį galima sukompiliuoti ir kaip atskirą CLI įrankį(atsidaro naujame lange). Įjungtas codex-network-proxy pagal numatytąsias nuostatas paleidžia ir HTTP, ir SOCKS5 tarpinį serverį. Šių tarpinių serverių adresai izoliuotosios aplinkos paleistam procesui perduodami per aplinkos kintamuosius. Be standartinių aplinkos kintamųjų, tokių kaip HTTP_PROXY, HTTPS_PROXY ir ALL_PROXY, įterpiama ir keletas plačiai naudojamų konkrečioms programoms skirtų aplinkos kintamųjų(atsidaro naujame lange), pvz., PIP_PROXY. Tiesa, ne visos programos atsižvelgia į šiuos aplinkos kintamuosius. Jei programa bando tiesiogiai prisijungti prie išorinio kompiuterio, operacinės sistemos izoliavimo ribojimai tai blokuoja, kaip aprašyta toliau pateiktose atskirų platformų skiltyse.
Tinklo tarpinis serveris atsakingas už leidimų profilyje apibrėžtų tinklo ribojimų užtikrinimą. Pavyzdžiui, anksčiau pateiktas profilis dev leidžia užklausas į *.openai.com ir aiškiai draudžia užklausas į evil.example. Kai užklausa skirta domenui, neatitinkančiam jokios leidimo ar draudimo taisyklės, tarpinis serveris gali ją pristabdyti ir perduoti infrastruktūrai patvirtinti. Kaip ir apvalkalo komandos pavyzdyje, Codex gali tiesiogiai paprašyti naudotojo patvirtinimo arba nukreipti užklausą į automatinę peržiūrą(atsidaro naujame lange). Gavęs sprendimą, tarpinis serveris leidžia tęsti užklausą arba ją atmeta grąžindamas klaidos atsakymą.
Veiksmų tvarka čia svarbi, nes net DNS paieška gali nutekinti pagrindinio kompiuterio varde užkoduotą informaciją. Todėl tarpinis serveris nustato užklausoje nurodyto pagrindinio kompiuterio vardo IP adresą tik įsitikinęs, kad užklausa leidžiama arba patvirtinta. Atkreipkite dėmesį, kad plačios taisyklės su pakaitos simboliais arba prieiga prie DNS paslaugų vis tiek gali leisti nutekinti duomenis per DNS.
Sistemoje macOS Codex naudoja Seatbelt(atsidaro naujame lange) – Apple izoliavimo mechanizmą, kurio ribojimus užtikrina branduolys. Seatbelt politika rašoma Sandbox Profile Language (SBPL) – Scheme pagrįsta kalba izoliavimo ribojimams aprašyti. Codex iškviečia Seatbelt per macOS komandą /usr/bin/sandbox-exec. Kaip ir codex sandbox, ji priima izoliuotąją aplinką aprašančius parametrus, po kurių nurodoma vykdytina komanda:
PROFILE yra SBPL eilutė su įrašais, kuriais konfigūruojama izoliuotoji aplinka. Pavyzdžiui, toliau pateikta SBPL ištrauka pagal izoliuotosios aplinkos politiką leidžia skaityti /dev/null ir /dev/zero bei į juos rašyti:
Kai iškviečiant izoliuotąją aplinką įjungiamas tinklo tarpinis serveris, į profilį įterpiamos tokios taisyklės kaip pateiktos toliau, kad ryšiai būtų leidžiami tik su atitinkamais vietiniais prievadais:
Bazinis Codex profilis prasideda nuo (deny default), todėl išeinantys ryšiai lieka užblokuoti, nebent jie aiškiai leidžiami.
Galiausiai SBPL gali būti vietaženklių, aprašytų naudojant (param):
jų reikšmės užpildomos pagal sandbox-exec perduotus parametrus -Dkey=value.
Realizuodamas savo izoliuotosios aplinkos API, Codex sudaro argumentų sąrašą(atsidaro naujame lange) komandai sandbox-exec, pradėdamas nuo bazinės politikos(atsidaro naujame lange). Tada pagal permission_profile ir kitą kontekstą ją papildo, kad gautų visą Seatbelt profilį. Gautas profilis ir kartu pateikti -D argumentai nustato Seatbelt užtikrinamus ribojimus, o tinklo tarpinis serveris užtikrina papildomas tinklo taisykles. Surinkus visą argumentų sąrašą, iškviesti sandbox-exec paprasta.
Sugeneruoti teisingą SBPL sudėtinga, nes Apple nepateikia šios kalbos dokumentacijos trečiosioms šalims. Iš tiesų man sandbox-exec nurodo The sandbox-exec command is DEPRECATED (pasenusia taip pat laikoma bibliotekos funkcija sandbox_init(), aprašyta man 3 sandbox_init). Nepaisant įspėjimo apie pasenimą, macOS vis dar pateikia Seatbelt profilius kataloge /usr/share/sandbox, o trečiųjų šalių programinė įranga, įskaitant Google Chrome ir Chromium(atsidaro naujame lange), ir toliau remiasi Seatbelt. Todėl artimiausioje ateityje planuojame ir toliau naudoti Seatbelt.
Izoliuotajai aplinkai sistemoje Linux sukurti Codex naudoja du mechanizmus: bubblewrap(atsidaro naujame lange) (bwrap) – komandų eilutės įrankį izoliuotosioms aplinkoms kurti – ir seccomp-bpf(atsidaro naujame lange) – Linux branduolio mechanizmą sisteminiams iškvietimams filtruoti. Parengimą koordinuoja vidinė pagalbinė programa codex-linux-sandbox. Kaip ir sandbox-exec sistemoje macOS, ji priima izoliuotosios aplinkos konfigūraciją, po kurios nurodoma vykdytina komanda:
Kai reikia izoliuoti failų sistemą arba nukreipti ryšius per tarpinį serverį, codex-linux-sandbox iškviečia bwrap, kad sukurtų pradinę izoliuotąją aplinką. Tada bwrap joje paleidžia codex-linux-sandbox --apply-seccomp-then-exec. Šis antrasis iškvietimas naudoja seccomp-bpf papildomiems ribojimams pritaikyti prieš vykdant naudotojo komandą.
Pradinei izoliuotajai aplinkai sukurti Codex naudoja bubblewrap: atskiroje prijungimo taškų vardų srityje sukuriamas failų sistemos vaizdas, atitinkantis leidimų profilio failų sistemos taisykles. Kadangi tai esminė izoliavimo mechanizmo dalis, Codex pateikia savo bwrap kopiją, jei naudotojas jos nėra įdiegęs, tačiau, kai įmanoma, pirmenybę teikia suderinamai įdiegtai (atsidaro naujame lange)bwrap(atsidaro naujame lange) versijai, rastai pagal PATH. Praktikoje kai kurie Linux platinamieji paketai pagal numatytąsias nuostatas išjungia prieigą prie naudotojo vardų sričių(atsidaro naujame lange), tačiau sistemos bwrap taiko išimtį.
Kaip ir sandbox-exec, bwrap priima izoliuotosios aplinkos konfigūraciją, o po jos – toje aplinkoje vykdytiną komandą. Užuot naudojęs specialią konfigūravimo kalbą, tokią kaip SBPL, bwrap konfigūruojamas atskirais parametrais. Failų sistemos vaizdui sukurti Codex naudoja šiuos parametrus:
--bind– failui arba katalogui, į kurį galima rašyti, nurodyti--ro-bind– tik skaitomam failui arba katalogui nurodyti--perms 000 --tmpfs DIR --remount-ro DIR– prieigai prieDIRuždrausti--perms 000 --ro-bind-data FD FILE– prieigai prieFILEuždrausti (čiaFDyra atviro/dev/nullfailo deskriptorius)
Kad šiais parametrais pritaikytų draudimo šablonus, prieš paleisdamas kiekvieną komandą Codex išskleidžia juos į konkrečius kelius. Nauji šablonus atitinkantys keliai automatiškai neįtraukiami į tos komandos izoliuotosios aplinkos ribojimus.
Codex taip pat nurodo tokius parametrus kaip --unshare-ipc ir --unshare-pid, kad izoliuotoji aplinka negalėtų pasiekti kitų tipų išteklių pagrindiniame kompiuteryje. Taigi bubblewrap riboja ne vien failų matomumą.
Naudodamas bubblewrap, Codex perduoda --unshare-net, kai tinklas išjungtas arba ryšiai turi eiti per tinklo tarpinį serverį. Taip izoliuotajai aplinkai sukuriama nauja tinklo vardų sritis. Tada naudojame seccomp-bpf, kad papildomai apribotume komandai prieinamus tinklo sisteminius iškvietimus ir lizdų šeimas.
Tiksliau, naudojame paketą seccompiler(atsidaro naujame lange), kad dinamiškai sukompiliuotume BPF programą pagal norimus filtrus(atsidaro naujame lange) ir pritaikytume ją paleidimo procesui izoliuotojoje aplinkoje, kad ribojimus paveldėtų visas procesų medis. Todėl bwrap vykdo ne naudotojo komandą, o codex-linux-sandbox paleidimo programą su jos konfigūracijos argumentais, po kurių nurodoma naudotojo komanda:
Kad galėtų pritaikyti seccomp filtrus be aukštesnių teisių, paleidimo programa nustato Linux no_new_privs vėliavėlę(atsidaro naujame lange). Šią vėliavėlę paveldi antriniai procesai. Ji neleidžia jiems įgyti papildomų teisių vykdant kitą programą, pvz., vykdomąjį failą su setuid.
seccomp filtrai priklauso nuo tinklo konfigūracijos. Kai prieiga prie tinklo išjungta, blokuojame kelis su tinklu susijusius sisteminius iškvietimus, pvz., connect(2) ir bind(2). Tačiau kai izoliuotojoje aplinkoje įjungtas tinklo tarpinis serveris, leidžiame IP lizdus, kad būtų galima pasiekti codex-linux-sandbox sukurtą TCP klausytuvą. Savarankiškų Unix domeno lizdų kūrimą pagal numatytąsias nuostatas blokuojame, nes jie galėtų netyčia suteikti prieigą prie pagrindinio kompiuterio išteklių.
Kai pagal izoliuotosios aplinkos konfigūraciją reikia tinklo tarpinio serverio, Codex infrastruktūra sukuria vieną jo egzempliorių, kurį galima pakartotinai naudoti keliems codex-linux-sandbox iškvietimams toje pačioje Codex gijoje. Kiekvienai izoliuotajai aplinkai reikia būdo pasiekti šį bendrą tarpinį serverį iš savo izoliuotos tinklo vardų srities. Codex toje vardų srityje sukuria grįžtamojo ryšio TCP klausytuvą ir užtikrina, kad už izoliuotosios aplinkos ribų veikiantis procesas priimtų jo ryšius ir perduotų juos tarpiniam serveriui.
Toliau pateiktos diagramos iliustruoja šią sąrangą vienam tarpinio serverio prieigos taškui, o paskutinėje parodytas vienas per jį užmegztas ryšys. Prieš paleisdamas bubblewrap, codex-linux-sandbox sukuria Unix lizdų porą valdymo kanalui ir išsišakoja į du procesus. Antrinis procesas vykdo run_host_bridge() ir laukia, kol šiuo kanalu gaus klausytuvo failo deskriptorių:
Šiame pavyzdyje pirminis procesas naudoja exec, kad pakeistų savo programos atvaizdą į bwrap. Taip parengiama izoliuotoji aplinka ir joje paleidžiama codex-linux-sandbox --apply-seccomp-then-exec, kartu perduodant valdymo kanalo failo deskriptorių:
Izoliuotosios aplinkos tinklo vardų srityje antrasis codex-linux-sandbox iškvietimas sukuria grįžtamojo ryšio TCP klausytuvą ir per lizdą perduoda jo failo deskriptorių. Klausytuvas lieka susietas su izoliuotosios aplinkos tinklo vardų sritimi. Todėl už jos ribų likęs antrinis procesas gali priimti izoliuotų programų ryšius, o savo ryšius su tarpiniu serveriu užmegzti pagrindinio kompiuterio tinklo vardų srityje. Po perdavimo abu procesai uždaro savo valdymo kanalo deskriptorius, o izoliuotojoje aplinkoje veikiantis procesas uždaro savo klausytuvo kopiją.
Kai TCP klausytuvas parengiamas, izoliuotojoje aplinkoje veikiantis procesas nustato tinkamą HTTP_PROXY(atsidaro naujame lange) ir susijusių aplinkos kintamųjų reikšmę, nurodančią tą klausytuvą. Tada, prieš sukurdamas antrinį procesą ir vykdydamas naudotojo komandą, jis pritaiko seccomp:
Už izoliuotosios aplinkos ribų veikiantis procesas palieka klausytuvą atvirą. Kiekvienam priimtam ryšiui jis užmezga ryšį su sukonfigūruotu tarpiniu serveriu ir perduoda duomenis abiem kryptimis.
Šis papildomas mechanizmas suteikia komandai atskirą tinklo vardų sritį su atskira grįžtamojo ryšio sąsaja. Sistemoje macOS Seatbelt leidžia komandai tiesiogiai jungtis prie nurodytų pagrindinio kompiuterio grįžtamojo ryšio sąsajos prievadų. Sistemoje Linux komanda jungiasi prie klausytuvo savo izoliuotoje vardų srityje, o už izoliuotosios aplinkos ribų veikiantis procesas perduoda šiuos ryšius sukonfigūruotam tarpiniam serveriui. Perduodant deskriptorių šį ryšį galima užmegzti nesuteikiant komandai prieigos prie pagrindinio kompiuterio tinklo vardų srities.
Šių metų pradžioje įdiegėme izoliavimo mechanizmą sistemoje Windows ir aprašėme šį darbą. Nuo tada Microsoft išleido biblioteką MXC ir naujų procesų izoliavimo funkcijų operacinėje sistemoje Windows. Šiuo metu esamą izoliuotąją aplinką keičiame nauja, kurioje naudojama MXC biblioteka.
MXC (Microsoft eXecution Container) – tai Microsoft kodo vykdymo izoliuotojoje aplinkoje sistema(atsidaro naujame lange), palaikanti kelis izoliavimo mechanizmus sistemose Windows, Linux ir macOS. Suderinamuose Windows įrenginiuose Codex palaiko MXC pagrįstą izoliuotąją aplinką ir naudoja integruotą procesų izoliavimą, kad apribotų komandas esamoje naudotojo aplinkoje.
Pereiname prie MXC, kad pagerintume saugumą ir naudojimo patogumą bei pašalintume kelis dabartinės Windows izoliuotosios aplinkos trūkumus:
Izoliuotajai aplinkai parengti reikia aukštesnių arba administratoriaus teisių
ACL tikrinimo ir nustatymo operacijos lėtos ir reikalauja daug išteklių
Pagrindiniame kompiuteryje išlieka izoliuotosios aplinkos parengimo būsena, įskaitant:
Prieigos valdymo sąrašus (ACL)
Užkardos taisykles
Izoliuotosios aplinkos naudotojus
Valdymo lygmens failus
MXC pateikia JSON konfigūracijos schemą(atsidaro naujame lange). Codex naudoja MXC SDK(atsidaro naujame lange), kad pagal šią schemą sudarytų vykdymo užklausą, apimančią komandą, darbinį katalogą, aplinką ir leidimus. Šie leidimai apima prieigą prie failų sistemos ir tinklo, taip pat Windows išteklių, pvz., darbalaukio ir iškarpinės.
Siekdamas suderinti suderinamumą ir saugumą, Codex kelioms valdymo priemonėms naudoja fiksuotas nuostatas. Jis leidžia skaityti registrą ir palieka prieigą prie Win32k bei darbalaukio, kurios reikia paleidžiamai PowerShell. Prieiga prie iškarpinės, įvesties įterpimas, darbalaukio ir sistemos nuostatų valdymas išjungti. Galiausiai MXC neleidžiama kaip atsarginio sprendimo naudoti pagrindinio kompiuterio failų sistemos leidimų keitimo.
Codex leidimų profilio failų sistemos ir tinklo taisykles paverčia MXC konfigūracija. Naudojant ankstesnį dev profilį ir darant prielaidą, kad:
C:\,D:\irZ:\yra vieninteliai vietiniai kompiuterio diskai.Darbo erdvės šakninis katalogas ir darbinis katalogas yra
C:\work\demo.Naudotojo namų katalogas yra
D:\Users\dev, todėl~/build-cacheatitinkaD:\Users\dev\build-cache.Draudimo šablonas atitinka tik
C:\work\demo\config\dev.envirC:\work\demo\config\prod.env.
Atitinkamos MXC nuostatos apimtų:
MXC failų sistemos politika pagal numatytąsias nuostatas draudžia prieigą. Todėl Codex prideda tik skaitymo leidimus vietinių diskų šakniniams katalogams, kad suteiktų šiame profilyje numatytą plačią skaitymo prieigą. Šie leidimai taikomi rekursyviai, neviršijant esamų naudotojo OS leidimų.
Yra viena išimtis: diskų šakniniams katalogams suteikti rašymo leidimai netaikomi rekursyviai, todėl Codex juos išplečia, kad jie apimtų esamus tiesioginius disko elementus.
Konkretesnių kelių leidimai turi pirmenybę prieš aukštesnių katalogų leidimus, todėl į C:\work\demo galima rašyti, net jei C:\ leidžiama tik skaityti, o C:\work\demo\.git lieka tik skaitomas.
Kai skirtingi kelio užrašymo būdai arba simbolinių nuorodų ar katalogų jungčių pseudonimai nurodo tą patį kelią, MXC taiko griežtesnį leidimą: draudimas turi pirmenybę prieš tik skaitymo leidimą, o šis – prieš skaitymo ir rašymo leidimą.
MXC priima tik konkrečius draudžiamus kelius, todėl prieš paleidimą Codex išskleidžia draudimo šablonus į juos atitinkančius failus ir katalogus. Komandai veikiant, nauji šabloną atitinkantys keliai automatiškai neįtraukiami.
Domenų taisykles, pvz., *.openai.com, užtikrina anksčiau aprašytas bendras Codex tinklo tarpinis serveris. Codex paleidžia šį tarpinį serverį už izoliuotosios aplinkos ribų ir perduoda jo adresus komandai per tuos pačius anksčiau minėtus standartinius aplinkos kintamuosius *_PROXY. MXC blokuoja tiesioginius išorinius ryšius, bet leidžia ryšius per pagrindinio kompiuterio grįžtamojo ryšio sąsają, įskaitant prieigą prie tarpinio serverio. Kitos vietinės paslaugos lieka pasiekiamos.
Sistemose macOS, Linux ir Windows infrastruktūra naudoja tą pačią izoliuotosios aplinkos API komandoms paleisti pagal leidimų profilį. Kiekvienai platformai pritaikytos realizacijos pasirūpina šiems ribojimams taikyti būtinu parengimu.
Rašydami ir vykdydami kodą, agentai gali lanksčiai spręsti ne tik programinės įrangos kūrimo užduotis. Codex izoliuotoji aplinka leidžia jiems naudotis šia galimybe esamoje naudotojo aplinkoje, aiškiai apribojant prieigą prie failų sistemos ir tinklo. Tai pakartotinai naudojamas bazinis infrastruktūros komponentas, o komanda codex sandbox leidžia jį pasitelkti ir jūsų kuriamuose įrankiuose.
Agentams imantis vis daugiau užduočių, siekiame, kad izoliavimą būtų praktiška naudoti su daugiau įrankių ir aplinkų. Tam reikia paprasčiau konfigūruojamų leidimų ir galimybės pasinaudoti geresnėmis operacinių sistemų apsaugos priemonėmis, kai jos tampa prieinamos. Mūsų tikslas – plėsti agentų galimybes, kartu paliekant žmonėms galimybę kontroliuoti jų prieigą.


