Unutar izoliranog okruženja za Codex
Kako Codex izvršava naredbe na vašem računalu uz ograničenja koja vi kontrolirate.
U tvrtki OpenAI zaštiti agenata pristupamo primjenom višeslojne obrane(otvara se u novom prozoru). Iako su naša ulaganja u treniranje i usklađivanje temelj tog rada, u naš agentski testni sklop Codex(otvara se u novom prozoru) ugrađujemo i značajke koje pružaju dodatnu zaštitu. Budući da je izvršavanje naredbi na vašem računalu jedna od najčešćih (i potencijalno rizičnih) radnji koje Codex obavlja, izradili smo izolirano okruženje za Codex kako bi mogao raditi u vašem postojećem okruženju uz ograničenja pristupa datotečnom sustavu i mreži koja vi kontrolirate.
(otvara se u novom prozoru)Izolirano okruženje(otvara se u novom prozoru) ograničava čemu program može pristupiti tijekom rada. Za zadatak organiziranja fotografija možete konfigurirati izolirano okruženje za Codex tako da naredbama dopustite čitanje i izmjenu datoteka u direktoriju ~/Pictures, a blokirate pristup mreži kako biste spriječili prijenos datoteka. Za pregled koda možete dopustiti pristup mrežnoj dokumentaciji, a izvorne datoteke zadržati dostupnima samo za čitanje. Korisnici konfiguriraju izolirano okruženje za Codex putem (otvara se u novom prozoru)profila dopuštenja(otvara se u novom prozoru), koji definiraju ograničenja pristupa datotečnom sustavu i mreži za sesiju u Codexu.
U ovom ćemo članku najprije objasniti kompromise iza zadanih postavki izoliranog okruženja za Codex, a zatim njegov dizajn i način na koji ga testni sklop upotrebljava za izvršavanje naredbi. Pokazat ćemo kako krajnji korisnici i tvrtke mogu prilagoditi dopuštenja svojim potrebama te kako razvojni inženjeri mogu ponovno upotrijebiti izolirano okruženje u vlastitim alatima. Na kraju ćemo razmotriti kako se ta ograničenja provode na sustavima macOS, Linux i Windows.
U Codexu nastojimo postaviti oprezne zadane postavke izoliranog okruženja koje i dalje omogućuju koristan rad. Primjerice, kad je Git repozitorij korijenski direktorij radnog prostora, ugrađeni profil dopuštenja :workspace:
Dopušta pisanje unutar radnog prostora, dok direktorije kao što su
.giti.codexzadržava dostupnima samo za čitanje. Time Codex može uređivati izvorni kod bez traženja dopuštenja za svaku promjenu, a sprječavaju se izravne izmjene datoteke.codex/config.tomlili Git hookova u direktoriju.git/hooks.Dopušta opsežno čitanje datotečnog sustava u okviru postojećih korisnikovih dopuštenja u operacijskom sustavu. Prevoditelji, izvršna okruženja i alati za izgradnju ovise o SDK-ovima, bibliotekama i konfiguraciji izvan repozitorija. Ograničavanje čitanja na radni prostor onemogućilo bi mnoge uobičajene radne procese. Kompromis je u tome što i osjetljive datoteke drugdje na računalu mogu ostati dostupne za čitanje (primjerice konfiguracijske datoteke koje sadrže API ključeve).
Onemogućuje pristup mreži. Time se blokira izravan prijenos na vanjske servise, uključujući pokušaje neovlaštenog izvlačenja podataka koje naredba može čitati. Ujedno se sprječavaju i legitimne operacije, poput preuzimanja ovisnosti, za koje je potreban dodatni pristup.
Ta ograničenja sprječavaju velik broj neželjenih ponašanja, ali štetne radnje i dalje su moguće. Primjerice, agent bi mogao umetnuti zlonamjerni kod u lokalno instaliran paket kao što je node_modules/prettier. Takva se promjena možda ne bi prikazala u rezultatu naredbe git status jer Git često zanemaruje node_modules. Ako korisnikov uređivač pri spremanju pokreće tu kopiju Prettiera, samo spremanje datoteke moglo bi izvršiti zlonamjerni kod izvan izoliranog okruženja za Codex. Zato primjenjujemo višeslojnu obranu: izolirano okruženje ograničava čemu naredbe mogu pristupiti, a treniranje i usklađivanje pomažu modelu da taj pristup upotrebljava u skladu s korisnikovom namjerom.
Smjernice za prilagodbu dopuštenja izoliranog okruženja i njihovo kombiniranje s drugim zaštitama u poslovnom okruženju potražite u praktičnom vodiču za sigurnost u Codexu(otvara se u novom prozoru).
Virtualni strojevi i kontejneri(otvara se u novom prozoru) dva su popularna mehanizma izolacije, no za izolirano okruženje za Codex odabrali smo drukčiji pristup. Umjesto premještanja obrade u zasebno okruženje radi izolacije, Codex upotrebljava mehanizme izolacije svake platforme kako bi ograničio naredbe koje se izvršavaju u postojećem korisnikovu okruženju.
Mnogim razvojnim inženjerima prijenosno računalo služi kao prilagođeno razvojno okruženje koje mogu mijenjati kad god požele. Reprodukcija tog okruženja u Docker kontejneru može zahtijevati trud, a neki radni procesi i dalje ovise o alatima koji se izvršavaju na glavnom računalu.
Razmotrimo, primjerice, upotrebu Codexa za razvoj aplikacije za iOS na Macu. Kad biste odlučili izolirati Codex pokretanjem unutar Dockera, ne bi mogao pokrenuti lanac alata za izgradnju aplikacija za iOS, koji se sastoji od izvornih izvršnih datoteka za Mac, niti bi mogao pokrenuti simulator iPhonea radi izvršavanja koda. Radni proces temeljen na Dockeru mogao bi prepustiti izgradnju i operacije simulatora glavnom računalu Mac, no te bi se operacije izvršavale izvan izoliranog okruženja kontejnera i trebale bi vlastita ograničenja. Za Codex radije zadržavamo jednostavnost i mnogo ulažemo u izolaciju specifičnu za operacijski sustav kako bi Codex mogao raditi u okruženju koje najbolje odgovara konkretnom zadatku.
Testni sklop pruža pristup tim mehanizmima izolacije specifičnima za operacijski sustav putem zajedničkog API-ja za macOS, Windows i Linux. Taj API prima naredbu i profil dopuštenja. Ako profil dopuštenja dopušta ograničen pristup mreži, pozivatelj mora osigurati mrežni proxy koji provodi ta ograničenja:
Ta funkcija pokreće proces u izoliranom okruženju i vraća referencu Child koju testni sklop može upotrijebiti za čekanje njegova završetka. Svaki podređeni proces nasljeđuje ograničenja izoliranog okruženja svojeg nadređenog procesa, pa ta ograničenja vrijede za cijelo stablo procesa pokrenuto naredbom, čak i za potomke koji nastave raditi nakon završetka izvornog procesa.
Sljedeći dijagram pokazuje kako se ti dijelovi povezuju, od konfiguracije do izvršavanja naredbe u izoliranom okruženju. Odjeljci u nastavku objašnjavaju svaku fazu.

Kao što je objašnjeno u članku Detaljan pogled na petlju agenta Codex, testni sklop Codexa odgovoran je za izvršavanje poziva alata koje generira model. Za zadatke programiranja najčešće se upotrebljava alat ljuske, koji izvršava naredbe slično kao korisnik u interaktivnoj ljusci poput Basha. Ovdje ćemo razmotriti jednokratni (otvara se u novom prozoru)alat ljuske(otvara se u novom prozoru) exec_command(otvara se u novom prozoru) kako bismo pokazali kako testni sklop upotrebljava izolirano okruženje za postizanje željene zaštite.
Ovo je pojednostavnjeni prikaz načina na koji bi testni sklop Codexa obradio poziv alata exec_command bez izolacije:
Kako bi izolirao naredbu, testni sklop zamjenjuje poziv subprocess.Popen() pozivom spawn_command_under_sandbox(). Testni sklop prosljeđuje profil dopuštenja i, po potrebi, mrežni proxy:
Alat exec_command modelu omogućuje i traženje drukčijih dopuštenja za pojedinu naredbu, no testni sklop odlučuje hoće li odobriti zahtjev:
Kad je naveden use_default, testni sklop upotrebljava zadanu konfiguraciju izoliranog okruženja za taj korak interakcije. with_additional_permissions traži prošireni pristup unutar izoliranog okruženja, dok require_escalated traži izvršavanje izvan njega. Testni sklop procjenjuje zahtjev na temelju korisnikovih postavki prije izvršavanja naredbe. (Primjerice, Codex može izravno zatražiti odobrenje korisnika ili usmjeriti zahtjev na automatski pregled(otvara se u novom prozoru).) Ako je izvršavanje odobreno, Codex će proslijediti odgovarajuće vrijednosti permission_profile i network_proxy funkciji perform_exec_command_with_sandboxing(), uz argumente naredbe iz izvornog poziva ExecCommandToolCall.
Alat ljuske primarni je korisnik funkcije spawn_command_under_sandbox(), a testni sklop ponovno upotrebljava svoju infrastrukturu izolacije i za operacije poput čitanja i izmjene lokalnih datoteka. Ta ponovna upotreba nije ograničena na testni sklop: naredba codex sandbox omogućuje vam da izvršavanje naredbi u izoliranom okruženju ugradite u vlastite alate, kao što ćemo vidjeti kasnije. U nastavku ćemo pogledati kako se definiraju profili dopuštenja.
Imenovani profil dopuštenja omogućuje ponovnu upotrebu istih ograničenja pristupa datotečnom sustavu i mreži u različitim projektima. Vlastite profile možete definirati u odjeljku [permissions] datoteke config.toml. Primjerice, sljedeća konfiguracija definira profil pod nazivom dev koji proširuje(otvara se u novom prozoru) ugrađeni profil :workspace:
Profil dev dodaje dopuštenje za pisanje u ~/build-cache i uvodi dodatna ograničenja za datoteke u radnom prostoru. Unosi za datotečni sustav mogu dopustiti pristup samo za čitanje (read), pristup za čitanje i pisanje (write) ili potpuno blokirati pristup (deny).
Tablica :workspace_roots omogućuje definiranje pravila za putanje relativne u odnosu na korijenske direktorije radnog prostora projekta. Codex CLI prema zadanim postavkama upotrebljava svoj radni direktorij kao jedini korijenski direktorij radnog prostora, dok aplikacija ChatGPT za računala upotrebljava mape izvornog koda projekta. Codex primjenjuje svako pravilo na svaki korijenski direktorij, pa unos .vscode u profilu dev čini direktorij .vscode dostupnim samo za čitanje unutar svakog korijenskog direktorija.
Uz vlastita pravila, dev nasljeđuje sljedeće zaštite iz profila :workspace:
Za konfiguriranje mreže izoliranog okruženja u Codexu postoje otprilike tri mogućnosti:
Onemogućiti sav pristup mreži (zadano za profil
:workspace)Omogućiti potpun, izravan pristup mreži (zadano za profil
:danger-full-access)Ograničiti pristup mreži na proxy koji na temelju profila dopuštenja odlučuje što će propustiti
Kako biste profilu dev omogućili izravan pristup mreži, postavite permissions.dev.network.enabled = true na najvišoj razini datoteke config.toml. Time se dopušta potpun pristup mreži kad je mrežni proxy onemogućen.
Kako biste dev ograničili na skup domena, omogućite mrežni proxy i konfigurirajte njegova pravila za domene:
Pravila za domene podržavaju točne nazive i uzorke sa zamjenskim znakovima, pri čemu izričite zabrane imaju prednost pred dopuštenjima. Zahtjevi prema drugim domenama zahtijevaju odobrenje ili se blokiraju, kako je opisano u odjeljku Mrežni proxy u nastavku.
Pojedinačni korisnici mogu konfigurirati zadane postavke koje vrijede za sve projekte i nadjačati ih za određeni pouzdani projekt. Administratori u tvrtkama također mogu htjeti konfigurirati zadane postavke za korisnike i ograničiti koje postavke oni smiju mijenjati. Codex podržava oboje putem slojevite konfiguracije i upravljanih zahtjeva.
Kao što je opisano u odjeljku Redoslijed prednosti konfiguracije,(otvara se u novom prozoru) Codex objedinjuje postavke iz više datoteka config.toml. Tablice se objedinjuju rekurzivno, a u slučaju sukoba vrijednosti prednost ima izvor višeg prioriteta. Polja se zamjenjuju u cijelosti.
Zato profili dopuštenja upotrebljavaju tablice za putanje datotečnog sustava i mrežne domene. Tim može dodati ili nadjačati pojedinačne unose u vlastitoj konfiguraciji i automatski naslijediti promjene svih ostalih unosa u osnovnoj konfiguraciji organizacije:
Administratori mogu navesti i upravljane zahtjeve(otvara se u novom prozoru) putem datoteke requirements.toml kako bi ograničili korisnikov izbor konfiguracije. Ti zahtjevi mogu dolaziti iz više izvora, uključujući sistemske datoteke i pravila iz oblaka. Uobičajena je primjena postavljanje opcije allowed_permission_profiles radi ograničavanja skupa profila dopuštenja koje korisnik u tvrtki može odabrati. Primjerice, administrator bi mogao navesti ove zahtjeve iz oblaka:
Zahtjevi iz oblaka imali bi prednost pred sistemskom datotekom zahtjeva na putanji /etc/codex/requirements.toml, pa unos u toj datoteci ne može nadjačati prethodnu izričitu postavku ":danger-full-access" = false. Ako :workspace ostane nedefiniran, drugi sloj zahtjeva može navesti taj unos. Profili čiji unosi imaju vrijednost false ili ih nema u konačnoj objedinjenoj tablici nisu dostupni.
To razdvajanje organizacijama omogućuje provođenje ograničenja, dok korisnici mogu prilagođavati konfiguraciju unutar tih granica. Dobivene profile dopuštenja može upotrebljavati testni sklop ili se mogu izravno primijeniti na naredbu, kao što ćemo vidjeti u nastavku.
Codex CLI pruža naredbu sandbox koja olakšava izvršavanje proizvoljne naredbe uz profil dopuštenja definiran u konfiguraciji Codexa. Najčešće se upotrebljava za testiranje profila kako bi se provjerilo sprječava li izolirano okruženje ponašanje koje bi trebalo blokirati.
Primjerice, sljedeća naredba pokušava konfigurirati VS Code tako da pri spremanju pokrene zlonamjerni alat za automatsko oblikovanje. Pod pretpostavkom da .vscode već postoji, prethodno definirani profil dev trebao bi blokirati to pisanje jer je taj direktorij dostupan samo za čitanje (codex sandbox prema zadanim postavkama tretira cwd kao korijenski direktorij radnog prostora):
Doista, na sustavu macOS to ne uspijeva uz sljedeću poruku:
Naredba codex sandbox omogućuje upotrebu mehanizma izolacije Codexa neovisno o sesiji agenta. Isti konfiguracijski jezik i provedbu specifičnu za platformu možete upotrijebiti za ograničavanje naredbi koje pokreću vaši alati.
Za stdio MCP poslužitelj konfiguriran u datoteci config.toml, testni sklop Codexa ne pokušava izolirati naredbu kojom se poslužitelj pokreće. Codex ne može pouzdano zaključiti koje su datoteke ili mrežni servisi tom poslužitelju potrebni, pa bi primjena zadanog profila izoliranog okruženja mogla onemogućiti rad inače valjane konfiguracije.
Primjerice, standardni način konfiguriranja MCP poslužitelja @modelcontextprotocol/server-memory(otvara se u novom prozoru) za upotrebu s Codexom izgleda ovako:
Budući da se ta naredba npx izvršava bez izolacije, može pisati datoteke i slati mrežne zahtjeve s istim dopuštenjima kao korisnik koji pokreće Codex, što joj daje preširoke ovlasti. Kako bismo je ograničili, možemo definirati profil dopuštenja pod nazivom memory-mcp, a zatim izvornu naredbu npx pokrenuti putem naredbe codex sandbox --permission-profile memory-mcp kako bismo ograničili gdje poslužitelj može pisati i onemogućili mu pristup mreži:
Prije pokretanja poslužitelja stvorite njegov podatkovni direktorij i u predmemoriju npm-a pohranite paket s fiksiranom verzijom. Time npx --offline može pokrenuti poslužitelj uz profil koji onemogućuje pristup mreži:
Kad je paket u predmemoriji, Codex može pokrenuti poslužitelj za memoriju bez pristupa mreži, uz pisanje ograničeno na predmemoriju npm-a i podatkovni direktorij poslužitelja.
Implementacija izoliranog okruženja pretvara profil dopuštenja u ograničenja koja provodi operacijski sustav. Osnovna logika obrade zahtjeva i pravila mrežnog proxyja zajednička je svim trima glavnim operacijskim sustavima, dok su postavljanje proxyja i njegova integracija s izoliranim okruženjem specifični za operacijski sustav. Najprije ćemo razmotriti zajednički proxy, a zatim implementacije za macOS, Linux i Windows.
Kako bi proveo mrežna ograničenja profila dopuštenja, testni sklop pokreće mrežni proxy i konfigurira izolirano okruženje tako da dopušta veze s njim, a blokira izravne veze s vanjskim računalima. Proxy provjerava svaki zahtjev prema pravilima za domene iz profila kako bi odredio treba li ga proslijediti.
U repozitoriju Codexa mrežni je proxy implementiran u paketu codex-network-proxy(otvara se u novom prozoru), koji testni sklop upotrebljava kao biblioteku, iako se može izgraditi i kao samostalni CLI(otvara se u novom prozoru). Kad je omogućen, codex-network-proxy prema zadanim postavkama pokreće i HTTP proxy i SOCKS5 proxy. Te se adrese proxyja prenose procesu pokrenutom u izoliranom okruženju putem varijabli okruženja. Uz standardne varijable okruženja kao što su HTTP_PROXY, HTTPS_PROXY i ALL_PROXY, postavlja se i niz poznatih varijabli okruženja specifičnih za aplikacije(otvara se u novom prozoru) (kao što je PIP_PROXY). Doduše, ne uzimaju svi programi te varijable okruženja u obzir. Ako program pokuša uspostaviti izravnu vezu s vanjskim računalom, ograničenja izoliranog okruženja koja provodi operacijski sustav blokiraju je, kao što je opisano u odjeljcima za pojedine platforme u nastavku.
Mrežni proxy odgovoran je za provedbu mrežnih ograničenja definiranih u profilu dopuštenja. Primjerice, prethodno prikazani profil dev dopušta zahtjeve prema *.openai.com i izričito zabranjuje zahtjeve prema evil.example. Kad zahtjev cilja domenu koja ne odgovara nijednom pravilu dopuštenja ili zabrane, proxy može privremeno zaustaviti zahtjev dok od testnog sklopa traži odobrenje. Kao u primjeru naredbe ljuske, Codex može izravno zatražiti odobrenje korisnika ili usmjeriti zahtjev na automatski pregled(otvara se u novom prozoru). Nakon primitka odluke proxy dopušta nastavak zahtjeva ili ga odbija odgovorom s pogreškom.
Redoslijed je ovdje važan jer čak i DNS upit može otkriti informacije kodirane u nazivu računala. Proxy stoga razrješava traženi naziv računala tek nakon što utvrdi da je dopušten ili odobren. Imajte na umu da široka pravila sa zamjenskim znakovima ili pristup DNS servisima i dalje mogu omogućiti neovlašteno izvlačenje podataka putem DNS-a.
Na sustavu macOS Codex upotrebljava Seatbelt(otvara se u novom prozoru), Appleov mehanizam izolacije koji provodi jezgra sustava. Pravila za Seatbelt pišu se u jeziku Sandbox Profile Language (SBPL), jeziku temeljenom na Schemeu za izražavanje ograničenja izoliranog okruženja. Codex poziva Seatbelt putem naredbe /usr/bin/sandbox-exec u sustavu macOS. Poput naredbe codex sandbox, prima opcije koje opisuju izolirano okruženje, a zatim naredbu za izvršavanje:
PROFILE je niz znakova u SBPL-u koji sadrži unose za konfiguriranje izoliranog okruženja. Primjerice, sljedeći isječak SBPL-a prema pravilima izoliranog okruženja dopušta čitanje i pisanje za /dev/null i /dev/zero:
Kad je mrežni proxy omogućen pri pokretanju izoliranog okruženja, u profil se umeću pravila poput sljedećih kako bi se veze ograničile na odgovarajuće lokalne priključke:
Osnovni profil Codexa počinje s (deny default), pa odlazne veze ostaju blokirane osim ako nisu izričito dopuštene.
Naposljetku, SBPL može sadržavati rezervirana mjesta uz upotrebu izraza (param):
koja se popunjavaju opcijama -Dkey=value proslijeđenima naredbi sandbox-exec.
Kako bi implementirao vlastiti API izoliranog okruženja, Codex sastavlja popis argumenata(otvara se u novom prozoru) za sandbox-exec polazeći od osnovnih pravila(otvara se u novom prozoru), a zatim ih dopunjuje pomoću permission_profile i drugog konteksta kako bi dobio potpuni profil za Seatbelt. Dobiveni profil i pripadajući argumenti -D konfiguriraju ograničenja koja provodi Seatbelt, dok mrežni proxy provodi dodatna mrežna pravila. Kad je potpuni popis argumenata sastavljen, pozivanje naredbe sandbox-exec jednostavno je.
Generiranje ispravnog SBPL-a zahtjevno je jer Apple ne dokumentira taj jezik za upotrebu trećih strana. Štoviše, man sandbox-exec navodi The sandbox-exec command is DEPRECATED (kao i bibliotečna funkcija sandbox_init(), dokumentirana putem man 3 sandbox_init). Unatoč upozorenju o zastarjelosti, macOS i dalje isporučuje profile za Seatbelt u direktoriju /usr/share/sandbox, a softver trećih strana, uključujući Google Chrome i Chromium(otvara se u novom prozoru), i dalje se oslanja na Seatbelt. Zato planiramo nastaviti upotrebljavati Seatbelt u doglednoj budućnosti.
Za stvaranje izoliranog okruženja na Linuxu Codex kombinira bubblewrap(otvara se u novom prozoru) (bwrap), alat naredbenog retka za izgradnju izoliranih okruženja, i seccomp-bpf(otvara se u novom prozoru), mehanizam jezgre Linuxa za filtriranje sistemskih poziva. Interni pomoćni program pod nazivom codex-linux-sandbox koordinira postavljanje. Poput naredbe sandbox-exec na sustavu macOS, prima konfiguraciju izoliranog okruženja, a zatim naredbu za izvršavanje:
Kad je potrebna izolacija datotečnog sustava ili usmjeravanje putem proxyja, codex-linux-sandbox poziva bwrap kako bi stvorio početno izolirano okruženje. bwrap zatim unutar njega pokreće codex-linux-sandbox --apply-seccomp-then-exec. Taj drugi poziv upotrebljava seccomp-bpf za primjenu dodatnih ograničenja prije pokretanja korisnikove naredbe.
Za stvaranje tog početnog izoliranog okruženja Codex upotrebljava bubblewrap kako bi u zasebnom imenskom prostoru montiranja stvorio prikaz datotečnog sustava koji odražava pravila datotečnog sustava iz profila dopuštenja. Budući da je to temelj implementacije izoliranog okruženja, Codex uključuje vlastitu kopiju alata bwrap za slučaj da ga korisnik nije instalirao, no prednost daje kompatibilnoj instalaciji alata (otvara se u novom prozoru)bwrap(otvara se u novom prozoru) pronađenoj u PATH, ako je dostupna. U praksi neke distribucije Linuxa prema zadanim postavkama onemogućuju pristup korisničkim imenskim prostorima(otvara se u novom prozoru), ali dopuštaju iznimku za sistemski bwrap.
Poput naredbe sandbox-exec, bwrap prima konfiguraciju izoliranog okruženja, a zatim naredbu koja će se u njemu izvršiti. Umjesto posebnog konfiguracijskog jezika poput SBPL-a, bwrap za konfiguraciju upotrebljava pojedinačne zastavice. Codex upotrebljava sljedeće opcije za stvaranje prikaza datotečnog sustava:
--bindza određivanje datoteke ili direktorija u koje je dopušteno pisanje--ro-bindza određivanje datoteke ili direktorija dostupnih samo za čitanje--perms 000 --tmpfs DIR --remount-ro DIRza zabranu pristupa direktorijuDIR--perms 000 --ro-bind-data FD FILEza zabranu pristupa datoteciFILE(pri čemu jeFDotvoreni deskriptor datoteke/dev/null)
Kako bi tim opcijama primijenio glob uzorke zabrane, Codex ih proširuje u konkretne putanje prije pokretanja svake naredbe. Nove putanje koje se podudaraju s uzorkom ne dodaju se automatski ograničenjima izoliranog okruženja te naredbe.
Codex navodi i opcije kao što su --unshare-ipc i --unshare-pid kako bi izoliranom okruženju onemogućio pristup drugim vrstama resursa glavnog računala, pa bubblewrap ne utječe samo na vidljivost datoteka.
Pri upotrebi alata bubblewrap Codex prosljeđuje --unshare-net kad god je mreža onemogućena ili veze moraju prolaziti kroz mrežni proxy, čime se stvara novi mrežni imenski prostor za izolirano okruženje. Zatim upotrebljavamo seccomp-bpf kako bismo dodatno ograničili mrežne sistemske pozive i obitelji utičnica dostupne naredbi.
Konkretno, upotrebljavamo paket seccompiler(otvara se u novom prozoru) kako bismo dinamički preveli BPF program na temelju željenih filtara(otvara se u novom prozoru) i primijenili ga na pokretački proces u izoliranom okruženju kako bi cijelo stablo procesa naslijedilo ograničenja. Zato bwrap ne izvršava korisnikovu naredbu, nego pokreće codex-linux-sandbox s vlastitim konfiguracijskim argumentima, nakon kojih slijedi korisnikova naredba:
Kako bi primijenio filtre seccomp bez povišenih ovlasti, pokretački program postavlja zastavicu no_new_privs u Linuxu(otvara se u novom prozoru). Tu zastavicu nasljeđuju podređeni procesi, a ona im onemogućuje stjecanje dodatnih ovlasti pri izvršavanju drugog programa, primjerice izvršne datoteke s oznakom setuid.
Filtri seccomp ovise o mrežnoj konfiguraciji. Kad je pristup mreži onemogućen, blokiramo niz sistemskih poziva povezanih s mrežom, kao što su connect(2) i bind(2). No kad je u izoliranom okruženju omogućen mrežni proxy, dopuštamo IP utičnice kako bi TCP osluškivač koji stvara codex-linux-sandbox bio dostupan, ali prema zadanim postavkama blokiramo stvaranje samostalnih utičnica Unix domene jer bi one mogle omogućiti nenamjeran pristup resursima glavnog računala.
Kad konfiguracija izoliranog okruženja zahtijeva mrežni proxy, testni sklop Codexa stvara jednu instancu proxyja koja se može ponovno upotrijebiti pri više poziva programa codex-linux-sandbox unutar iste niti u Codexu. Svako izolirano okruženje mora moći pristupiti tom zajedničkom proxyju iz svojeg izoliranog mrežnog imenskog prostora. Codex unutar tog imenskog prostora osigurava TCP osluškivač na povratnom sučelju i postavlja proces izvan izoliranog okruženja koji prihvaća njegove veze i prosljeđuje ih proxyju.
Sljedeći dijagrami prikazuju taj raspored za jednu krajnju točku proxyja, a na posljednjem je dijagramu prikazana jedna veza koja prolazi kroz nju. Prije pokretanja alata bubblewrap, codex-linux-sandbox stvara par Unix utičnica koji služi kao upravljački kanal i račva vlastiti proces. Podređeni proces izvršava run_host_bridge() i čeka da putem tog kanala primi deskriptor datoteke osluškivača:
U ovom primjeru nadređeni proces upotrebljava exec kako bi svoju programsku sliku zamijenio programom bwrap. Time se postavlja izolirano okruženje i u njemu pokreće codex-linux-sandbox --apply-seccomp-then-exec, uz prosljeđivanje deskriptora datoteke upravljačkog kanala:
Unutar mrežnog imenskog prostora izoliranog okruženja drugi poziv programa codex-linux-sandbox stvara TCP osluškivač na povratnom sučelju i prosljeđuje njegov deskriptor datoteke putem utičnice. Osluškivač ostaje povezan s mrežnim imenskim prostorom izoliranog okruženja. To podređenom procesu koji je ostao izvan izoliranog okruženja omogućuje prihvaćanje veza iz izoliranih programa, dok veze prema proxyju otvara u mrežnom imenskom prostoru glavnog računala. Nakon predaje oba procesa zatvaraju svoje deskriptore upravljačkog kanala, a proces unutar izoliranog okruženja zatvara svoju kopiju osluškivača.
Kad je TCP osluškivač spreman, proces unutar izoliranog okruženja postavlja odgovarajuću vrijednost za HTTP_PROXY(otvara se u novom prozoru) i povezane varijable okruženja tako da upućuju na taj osluškivač. Zatim primjenjuje seccomp prije račvanja procesa i izvršavanja korisnikove naredbe:
Proces izvan izoliranog okruženja drži osluškivač otvorenim. Za svaku prihvaćenu vezu otvara vezu s konfiguriranim proxyjem i prenosi podatke u oba smjera.
Ti dodatni mehanizmi naredbi daju vlastiti mrežni imenski prostor, uključujući zasebno povratno sučelje. Na sustavu macOS Seatbelt naredbi dopušta izravno povezivanje s određenim priključcima na povratnom sučelju glavnog računala. Na Linuxu se naredba umjesto toga povezuje s osluškivačem unutar svojeg izoliranog imenskog prostora, a proces izvan izoliranog okruženja prosljeđuje te veze konfiguriranom proxyju. Predaja deskriptora omogućuje tu vezu bez izlaganja mrežnog imenskog prostora glavnog računala naredbi.
Ranije ove godine implementirali smo izolirano okruženje na Windowsu i pisali o svojem radu na njemu. Otad je Microsoft objavio biblioteku pod nazivom MXC uz nove značajke za izolaciju procesa unutar operacijskog sustava Windows. Trenutačno zamjenjujemo postojeće izolirano okruženje onim koje upotrebljava biblioteku MXC.
MXC (Microsoft eXecution Container) Microsoftov je sustav za izvršavanje koda u izoliranom okruženju(otvara se u novom prozoru) koji podržava nekoliko pozadinskih mehanizama izolacije na Windowsu, Linuxu i sustavu macOS. Codex podržava izolirano okruženje temeljeno na MXC-u na kompatibilnim uređajima sa sustavom Windows, koristeći ugrađenu izolaciju procesa za ograničavanje naredbi unutar postojećeg korisnikova okruženja.
Prelazimo na MXC kako bismo poboljšali sigurnost i upotrebljivost te uklonili nekoliko ograničenja postojećeg izoliranog okruženja za Windows:
Potrebu za povišenim ili administratorskim ovlastima za postavljanje izoliranog okruženja
Zahtjevne i spore operacije provjere i postavljanja ACL-ova
Trajno stanje postavki izoliranog okruženja na glavnom računalu, uključujući
ACL-ove
Pravila vatrozida
Korisnike izoliranog okruženja
Datoteke upravljačke ravnine
MXC pruža JSON shemu konfiguracije(otvara se u novom prozoru). Codex upotrebljava MXC SDK(otvara se u novom prozoru) za izradu zahtjeva za izvršavanje prema toj shemi, koji sadrži naredbu, radni direktorij, okruženje i dopuštenja. Ta dopuštenja obuhvaćaju pristup datotečnom sustavu i mreži te resursima sustava Windows kao što su radna površina i međuspremnik.
Codex za nekoliko kontrola upotrebljava fiksne postavke kako bi uravnotežio kompatibilnost i sigurnost. Dopušta čitanje registra i zadržava pristup sustavu Win32k i radnoj površini koji je PowerShellu potreban pri pokretanju. Pristup međuspremniku, umetanje ulaza te kontrole radne površine i postavki sustava onemogućeni su. Naposljetku, MXC-u je onemogućeno da kao zamjensko rješenje mijenja dopuštenja datotečnog sustava glavnog računala.
Codex pretvara pravila za datotečni sustav i mrežu iz profila dopuštenja u konfiguraciju MXC-a. Uz ranije navedeni profil dev i sljedeće pretpostavke:
C:\,D:\iZ:\jedini su lokalni pogoni računala.Korijenski direktorij radnog prostora i radni direktorij nalaze se na putanji
C:\work\demo.Korisnikov je matični direktorij
D:\Users\dev, pa se~/build-cacherazrješava uD:\Users\dev\build-cache.Glob uzorak zabrane podudara se samo s putanjama
C:\work\demo\config\dev.enviC:\work\demo\config\prod.env.
Odgovarajuće postavke MXC-a uključivale bi:
Pravila datotečnog sustava u MXC-u prema zadanim postavkama zabranjuju pristup. Codex stoga dodaje dopuštenja samo za čitanje korijenskih direktorija lokalnih pogona kako bi omogućio opsežan pristup za čitanje koji taj profil dopušta. Ta se dopuštenja primjenjuju rekurzivno, u okviru postojećih korisnikovih dopuštenja u operacijskom sustavu.
Postoji jedna posebnost: dopuštenja za pisanje u korijenske direktorije pogona ne primjenjuju se rekurzivno, pa ih Codex proširuje na postojeće datoteke i direktorije neposredno ispod korijena pogona.
Preciznije putanje imaju prednost pred dopuštenjima nadređenih direktorija, pa C:\work\demo može dopuštati pisanje unutar direktorija C:\ koji dopušta samo čitanje, dok C:\work\demo\.git ostaje dostupan samo za čitanje.
Kad različiti zapisi putanje ili zamjenski nazivi putem simboličkih veza ili spojnih točaka upućuju na istu putanju, MXC primjenjuje strože dopuštenje: zabrana ima prednost pred pristupom samo za čitanje, koji ima prednost pred pristupom za čitanje i pisanje.
MXC prihvaća samo konkretne putanje zabrane, pa Codex prije pokretanja proširuje glob uzorke zabrane u odgovarajuće datoteke i direktorije. Nove putanje koje se podudaraju s glob uzorkom ne dodaju se automatski dok se naredba izvršava.
Pravila za domene kao što je *.openai.com provodi prethodno opisani zajednički mrežni proxy Codexa. Codex pokreće taj proxy izvan izoliranog okruženja i prosljeđuje njegove adrese naredbi putem istih standardnih varijabli okruženja *_PROXY koje smo već spomenuli. MXC blokira izravne vanjske veze, a dopušta veze s povratnim sučeljem glavnog računala, uključujući pristup proxyju. Ostali lokalni servisi ostaju dostupni.
Na sustavima macOS, Linux i Windows testni sklop upotrebljava isti API izoliranog okruženja za pokretanje naredbi uz profil dopuštenja. Implementacije specifične za platformu obavljaju postavljanje potrebno za primjenu tih ograničenja.
Pisanje i izvršavanje koda agentima pruža fleksibilan način rješavanja problema i izvan razvoja softvera. Izolirano okruženje za Codex omogućuje im da tu sposobnost upotrebljavaju u postojećem korisnikovu okruženju uz izričita ograničenja pristupa datotečnom sustavu i mreži. Ono je višekratno upotrebljiv osnovni element testnog sklopa, a naredba codex sandbox čini ga dostupnim i alatima koje sami izrađujete.
Kako agenti preuzimaju sve više zadataka, želimo omogućiti praktičnu primjenu izolacije u većem broju alata i okruženja. To znači olakšati konfiguriranje dopuštenja i iskoristiti bolje zaštite operacijskih sustava čim postanu dostupne. Naš je cilj proširiti mogućnosti agenata, a ljudima zadržati kontrolu nad time čemu agenti mogu pristupiti.


