Codexi liivakasti sees
Kuidas Codex käivitab sinu arvutis käske sinu määratud piirangutega.
OpenAI rakendab agentide turvamisel süvakaitse(avaneb uues aknas) põhimõtet. Kuigi selle töö aluseks on meie investeeringud treenimisse ja joondamisse, lisame täiendavaid kaitsemeetmeid ka oma agentide täitmiskeskkonda Codex(avaneb uues aknas). Kuna üks Codexi sagedasemaid ja potentsiaalselt riskantseid tegevusi on käskude käivitamine sinu arvutis, lõime Codexi liivakasti. Nii saab Codex töötada sinu olemasolevas keskkonnas sinu määratud failisüsteemi- ja võrgupiirangute piires.
Liivakast(avaneb uues aknas) (avaneb uues aknas)piirab seda, millele programm töötamise ajal ligi pääseb. Fotode korrastamiseks võid seadistada Codexi liivakasti nii, et käsud tohivad lugeda ja muuta faile kataloogis ~/Pictures, kuid ligipääs võrgule on üleslaadimise vältimiseks keelatud. Koodi ülevaatuseks võid lubada ligipääsu veebidokumentatsioonile, jättes lähtefailid kirjutuskaitstuks. Kasutajad seadistavad Codexi liivakasti (avaneb uues aknas)õiguste profiilide(avaneb uues aknas) kaudu, mis määravad Codexi seansi failisüsteemi- ja võrgupiirangud.
Selles artiklis alustame Codexi liivakasti vaikesätete aluseks olevatest kompromissidest ning selgitame seejärel liivakasti ülesehitust ja seda, kuidas täitmiskeskkond seda käskude käivitamiseks kasutab. Näitame, kuidas lõppkasutajad ja ettevõtted saavad õigusi oma vajaduste järgi kohandada ning kuidas arendajad saavad liivakasti oma tööriistades taaskasutada. Lõpuks vaatame, kuidas neid piiranguid macOS-is, Linuxis ja Windowsis jõustatakse.
Codexis lähtume põhimõttest, et liivakasti vaikesätted peavad olema ettevaatlikud, kuid võimaldama siiski sisulist tööd. Näiteks kui tööruumi juurkataloog on Giti varamu, toimib sisseehitatud õiguste profiil :workspace järgmiselt:
Lubab tööruumis kirjutada, kuid jätab kataloogid nagu
.gitja.codexkirjutuskaitstuks. See lubab Codexil lähtekoodi muuta iga muudatuse jaoks eraldi luba küsimata, kuid takistab faili.codex/config.tomlvõi kataloogis.git/hooksasuvate Giti haakide otsest muutmist.Lubab failisüsteemi ulatuslikult lugeda kasutaja olemasolevate operatsioonisüsteemiõiguste piires. Kompilaatorid, käituskeskkonnad ja ehitustööriistad sõltuvad SDK-dest, teekidest ja seadistustest, mis asuvad väljaspool varamut. Lugemisõiguse piiramine tööruumiga takistaks paljusid tavapäraseid töövooge. Selle kompromissi tõttu võivad aga loetavaks jääda ka mujal arvutis asuvad tundlikud failid, näiteks API-võtmeid sisaldavad seadistusfailid.
Keelab ligipääsu võrgule. See blokeerib otsese üleslaadimise välistesse teenustesse, sealhulgas katsed välja viia andmeid, mida käsk saab lugeda. See takistab ka õiguspäraseid toiminguid, näiteks sõltuvuste allalaadimist, milleks on vaja lisaõigusi.
Need piirangud väldivad suurt osa soovimatust käitumisest, kuid kahjulikud tegevused on siiski võimalikud. Näiteks võib agent lisada pahatahtlikku koodi kohalikult paigaldatud paketti, nagu node_modules/prettier. Selline muudatus ei pruugi käsu git status väljundis ilmuda, sest Git eirab sageli kataloogi node_modules. Kui kasutaja redaktor käivitab salvestamisel selle Prettieri eksemplari, võib pelgalt faili salvestamine käivitada pahatahtliku koodi väljaspool Codexi liivakasti. Seepärast rakendame süvakaitset: liivakast piirab käskude ligipääsu, treenimine ja joondamine aga aitavad mudelil kasutada seda ligipääsu kasutaja kavatsuste kohaselt.
Juhiseid liivakasti õiguste kohandamiseks ja nende ühendamiseks teiste kaitsemeetmetega ettevõttes leiad Codexi praktilisest turvajuhendist(avaneb uues aknas).
Virtuaalmasinad ja konteinerid(avaneb uues aknas) on kaks levinud liivakastimehhanismi, kuid Codexi liivakasti puhul kasutame teistsugust lähenemist. Selle asemel et viia arvutused isoleerimiseks eraldi keskkonda, kasutab Codex iga platvormi liivakastivõimalusi, et piirata kasutaja olemasolevas keskkonnas töötavaid käske.
Paljude arendajate sülearvuti on neile kohandatud arenduskeskkond, mida nad saavad soovi korral kohe muuta. Selle keskkonna taasloomine Dockeri konteineris võib nõuda vaeva ning osa töövooge sõltub endiselt hostis töötavatest tööriistadest.
Vaatame näiteks Codexi kasutamist Macis iOS-i rakenduse arendamiseks. Kui otsustaksid isoleerida Codexi Dockeri abil, ei saaks Codex käivitada Maci omavormingus täitmisfailidest koosnevat iOS-i ehitustööriistaahelat ega avada koodi käitamiseks iPhone'i simulaatorit. Dockeri-põhine töövoog võiks delegeerida ehitamise ja simulaatoritoimingud Maci hostile, kuid need toimingud toimuksid väljaspool konteineri liivakasti ning vajaksid eraldi piiranguid. Codexi puhul eelistame lihtsamat lahendust: panustame palju operatsioonisüsteemipõhisesse isoleerimisse, et Codex saaks töötada käsiloleva ülesande jaoks kõige sobivamas keskkonnas.
Täitmiskeskkond teeb need operatsioonisüsteemipõhised liivakastimehhanismid kättesaadavaks macOS-i, Windowsi ja Linuxi ühise API kaudu. API võtab sisendiks käsu ja õiguste profiili. Kui õiguste profiil lubab piiratud ligipääsu võrgule, peab väljakutsuja andma ette võrgupuhverserveri, mis neid piiranguid jõustab:
See funktsioon käivitab protsessi liivakastis ja tagastab Child-pideme, mille abil täitmiskeskkond saab protsessi lõppu oodata. Iga alamprotsess pärib ülemprotsessi liivakastipiirangud, seega kehtivad need kogu käsu algatatud protsessipuus, ka järglasprotsessidele, mis töötavad algsest protsessist kauem.
Järgmine joonis näitab, kuidas need osad omavahel seostuvad, alates seadistusest kuni käsu käivitamiseni liivakastis. Järgnevates jaotistes selgitame iga etappi.

Nagu selgitatud artiklis „Codexi agenditsükli lahtiseletus“, vastutab Codexi täitmiskeskkond mudeli genereeritud tööriistakutsete täitmise eest. Programmeerimisülesannetes kasutatakse kõige sagedamini shellitööriista, mis käivitab käske sarnaselt kasutajaga interaktiivses shellis, näiteks Bashis. Siin vaatleme ühekordset (avaneb uues aknas)shellitööriista (avaneb uues aknas)exec_command(avaneb uues aknas), et näidata, kuidas täitmiskeskkond liivakasti abil soovitud kaitse tagab.
See on lihtsustatud näide sellest, kuidas Codexi täitmiskeskkond täidaks tööriistakutse exec_command ilma liivakastita:
Käsu liivakastis käivitamiseks asendab täitmiskeskkond kutse subprocess.Popen() kutsega spawn_command_under_sandbox(). Täitmiskeskkond annab ette õiguste profiili ja vajaduse korral võrgupuhverserveri:
Tööriist exec_command võimaldab mudelil taotleda üksikule käsule ka teistsuguseid õigusi, kuid taotluse rahuldamise otsustab täitmiskeskkond:
Kui määratud on use_default, kasutab täitmiskeskkond selle vooru liivakasti vaikeseadistust. with_additional_permissions taotleb laiendatud ligipääsu liivakastis, require_escalated aga käivitamist väljaspool liivakasti. Enne käsu käivitamist hindab täitmiskeskkond taotlust kasutaja eelistuste põhjal. (Näiteks võib Codex küsida luba otse kasutajalt või suunata taotluse automaatsele ülevaatusele(avaneb uues aknas).) Kui käivitamine lubatakse, edastab Codex sobivad väärtused permission_profile ja network_proxy funktsioonile perform_exec_command_with_sandboxing() koos algsest kutsest ExecCommandToolCall pärit käsuargumentidega.
Shellitööriist on funktsiooni spawn_command_under_sandbox() peamine kasutaja. Täitmiskeskkond taaskasutab liivakastitaristut ka näiteks kohalike failide lugemiseks ja muutmiseks. Taaskasutus ulatub ka täitmiskeskkonnast kaugemale: käsk codex sandbox võimaldab lisada liivakastis käskude käivitamise sinu enda tööriistadesse, nagu hiljem näeme. Järgmisena vaatame, kuidas õiguste profiile määratakse.
Nimega õiguste profiil võimaldab samu failisüsteemi- ja võrgupiiranguid eri projektides taaskasutada. Oma profiile saad määrata faili config.toml jaotises [permissions]. Näiteks määrab järgmine seadistus profiili nimega dev, mis laiendab(avaneb uues aknas) sisseehitatud profiili :workspace:
Profiil dev lisab kirjutamisõiguse kataloogile ~/build-cache ja seab tööruumi failidele lisapiiranguid. Failisüsteemikirjed võivad anda ainult lugemisõiguse (read), lugemis- ja kirjutamisõiguse (write) või ligipääsu täielikult keelata (deny).
Tabel :workspace_roots võimaldab määrata reegleid teedele projekti tööruumi juurkataloogide suhtes. Vaikimisi kasutab Codexi käsurealiides tööruumi ainsa juurkataloogina oma töökataloogi, ChatGPT töölauarakendus aga projekti lähtekaustu. Codex rakendab iga reeglit kõigile juurkataloogidele, seega muudab profiili dev kirje .vscode iga juurkataloogi all oleva kataloogi .vscode kirjutuskaitstuks.
Lisaks oma reeglitele pärib dev profiililt :workspace järgmised kaitsemeetmed:
Codexi liivakasti võrgu seadistamiseks on laias laastus kolm võimalust:
Keelata kogu ligipääs võrgule (profiili
:workspacevaikesäte)Lubada täielik otseligipääs võrgule (profiili
:danger-full-accessvaikesäte)Lubada ligipääs võrgule ainult puhverserveri kaudu, mis otsustab õiguste profiili põhjal, mida läbi lasta
Profiilile dev otseligipääsu andmiseks võrgule määra faili config.toml ülemisel tasemel permissions.dev.network.enabled = true. See annab täieliku ligipääsu võrgule, kui võrgupuhverserver on keelatud.
Profiili dev piiramiseks kindlate domeenidega luba võrgupuhverserver ja seadista selle domeenireeglid:
Domeenireeglid toetavad täpseid nimesid ja metamärgimustreid. Sõnaselged keelureeglid on lubamisreeglite suhtes ülimuslikud. Päringud teistele domeenidele nõuavad heakskiitu või blokeeritakse, nagu kirjeldatud allpool jaotises Võrgupuhverserver.
Kasutajad saavad määrata kõigile projektidele kehtivad vaikesätted ja need konkreetse usaldatud projekti jaoks üle kirjutada. Ettevõtte administraatorid võivad soovida määrata kasutajatele vaikesätteid ning piirata, milliseid sätteid kasutajad muuta saavad. Codex toetab mõlemat kihilise seadistuse ja hallatavate nõuete kaudu.
Nagu kirjeldatud jaotises „Seadistuste prioriteet“,(avaneb uues aknas) ühendab Codex mitme config.toml faili sätted. Tabelid ühendatakse rekursiivselt ning vastuoluliste väärtuste korral jääb peale kõrgema prioriteediga allikas. Massiivid asendatakse tervikuna.
Seepärast kasutavad õiguste profiilid failisüsteemi teede ja võrgudomeenide jaoks tabeleid. Meeskond saab oma seadistuses üksikuid kirjeid lisada või üle kirjutada ning pärida automaatselt kõik muud organisatsiooni põhiseadistuse kirjete muudatused:
Administraatorid saavad faili requirements.toml kaudu anda ka hallatavaid nõudeid(avaneb uues aknas), et piirata kasutajate seadistusvalikuid. Need nõuded võivad pärineda mitmest allikast, sealhulgas süsteemifailidest ja pilvest saadud reeglistikust. Levinud kasutusjuht on määrata allowed_permission_profiles, et piirata õiguste profiile, mille vahel ettevõtte kasutaja saab valida. Näiteks võib administraator määrata järgmised pilvenõuded:
Pilvenõuded on ülimuslikud süsteemi nõuetefaili /etc/codex/requirements.toml suhtes, seega ei saa selle faili kirje tühistada eespool sõnaselgelt määratud väärtust ":danger-full-access" = false. Kui :workspace jääb määramata, saab selle kirje anda mõni teine nõuete kiht. Profiilid, mille kirje väärtus on false või mis puuduvad lõplikust ühendatud tabelist, pole saadaval.
See eristus võimaldab organisatsioonidel piiranguid jõustada ja kasutajatel oma seadistust nende piiride sees kohandada. Saadud õiguste profiile saab kasutada täitmiskeskkonnas või rakendada otse käsule, nagu järgmisena näeme.
Codexi käsurealiides pakub käsku sandbox, millega saab käivitada suvalise käsu Codexi seadistuses määratud õiguste profiili alusel. Seda kasutatakse sageli profiili katsetamiseks, et veenduda, kas liivakast takistab käitumist, mille blokeerimiseks see on mõeldud.
Näiteks püüab järgmine käsk seadistada VS Code'i nii, et see käivitaks salvestamisel pahatahtliku automaatvormindaja. Eeldusel, et .vscode on juba olemas, peaks eespool määratud profiil dev selle kirjutamise blokeerima, sest kataloog on kirjutuskaitstud (codex sandbox käsitleb vaikimisi cwd väärtust tööruumi juurkataloogina):
macOS-is see tõepoolest nurjub järgmise teatega:
Käsk codex sandbox teeb Codexi liivakastimehhanismi kättesaadavaks agendiseansist sõltumatult. Sama seadistuskeelt ja platvormipõhist jõustamist saab kasutada sinu enda tööriistade käivitatud käskude piiramiseks.
Failis config.toml seadistatud stdio MCP-serveri puhul ei püüa Codexi täitmiskeskkond serveri käivituskäsku liivakasti paigutada. Codex ei saa usaldusväärselt järeldada, milliseid faile või võrguteenuseid server vajab, seega võib liivakasti vaikeprofiili rakendamine muidu kehtiva seadistuse töö rikkuda.
Näiteks seadistatakse MCP-server @modelcontextprotocol/server-memory(avaneb uues aknas) Codexiga kasutamiseks tavaliselt järgmiselt:
Kuna see npx käsk töötab väljaspool liivakasti, saab see kirjutada faile ja teha võrgupäringuid samade õigustega nagu Codexi käivitav kasutaja. See annab liiga laiad õigused. Õiguste piiramiseks saame määrata profiili nimega memory-mcp ja käivitada algse npx käsu käsuga codex sandbox --permission-profile memory-mcp. Nii piirame serveri kirjutuskohti ja keelame selle ligipääsu võrgule:
Enne serveri käivitamist loo selle andmekataloog ja lisa fikseeritud versiooniga pakett npm-i vahemällu. See võimaldab käsul npx --offline käivitada serveri profiiliga, mis keelab ligipääsu võrgule:
Kui pakett on vahemälus, saab Codex käivitada mäluserveri võrguühenduseta ning lubada kirjutamist ainult npm-i vahemällu ja serveri andmekataloogi.
Liivakasti teostus teisendab õiguste profiili operatsioonisüsteemi jõustatavateks piiranguteks. Võrgupuhverserveri põhiline päringutöötlus ja reeglistikuloogika on kõigis kolmes peamises operatsioonisüsteemis ühine, kuid puhverserveri seadistamine ja liivakastiga lõimimine on operatsioonisüsteemipõhine. Esmalt vaatleme ühist puhverserverit ning seejärel macOS-i, Linuxi ja Windowsi teostusi.
Õiguste profiili võrgupiirangute jõustamiseks käivitab täitmiskeskkond võrgupuhverserveri ja seadistab liivakasti nii, et ühendused sellega on lubatud, kuid otseühendused väliste hostidega blokeeritud. Puhverserver kontrollib iga päringut profiili domeenireeglite alusel, et otsustada, kas see edasi saata.
Codexi varamus on võrgupuhverserver teostatud paketis codex-network-proxy(avaneb uues aknas), mida täitmiskeskkond kasutab teegina, kuid mille saab ehitada ka eraldiseisvaks käsureatööriistaks(avaneb uues aknas). Kui codex-network-proxy on lubatud, käivitab see vaikimisi nii HTTP- kui ka SOCKS5-puhverserveri. Nende puhverserverite aadressid edastatakse liivakasti käivitatud protsessile keskkonnamuutujate kaudu. Lisaks standardsetele keskkonnamuutujatele, nagu HTTP_PROXY, HTTPS_PROXY ja ALL_PROXY, lisatakse ka mitu tuntud rakenduspõhist keskkonnamuutujat(avaneb uues aknas), näiteks PIP_PROXY. Tõsi, kõik programmid neid keskkonnamuutujaid ei järgi. Kui programm üritab luua otseühendust välise hostiga, blokeerivad selle operatsioonisüsteemi liivakastipiirangud, nagu allpool platvormipõhistes jaotistes kirjeldatud.
Võrgupuhverserver vastutab õiguste profiilis määratud võrgupiirangute rakendamise eest. Näiteks lubab eespool näidatud profiil dev päringud domeenidele *.openai.com ja keelab sõnaselgelt päringud domeenile evil.example. Kui päringu sihtdomeen ei vasta ühelegi lubamis- ega keelureeglile, võib puhverserver päringu peatada ja saata selle täitmiskeskkonnale heakskiitmiseks. Nagu shellikäsu näites, võib Codex küsida luba otse kasutajalt või suunata päringu automaatsele ülevaatusele(avaneb uues aknas). Pärast otsuse saamist laseb puhverserver päringul jätkuda või lükkab selle veavastusega tagasi.
Järjekord on siin oluline, sest isegi DNS-päring võib lekitada hostinimesse kodeeritud teavet. Seetõttu lahendab puhverserver päringus oleva hostinime alles pärast seda, kui on kindlaks teinud, et päring on lubatud või heaks kiidetud. Pane tähele, et laiad metamärgireeglid või ligipääs DNS-teenustele võivad siiski võimaldada andmete väljaviimist DNS-i kaudu.
macOS-is kasutab Codex Seatbelti(avaneb uues aknas), Apple'i liivakastimehhanismi, mille piiranguid jõustab tuum. Seatbelti reeglistikud kirjutatakse keeles Sandbox Profile Language (SBPL), mis on Scheme'il põhinev keel liivakastipiirangute väljendamiseks. Codex kutsub Seatbelti välja macOS-i käsuga /usr/bin/sandbox-exec. Nagu codex sandbox, võtab see sisendiks liivakasti kirjeldavad suvandid ja nende järel käivitatava käsu:
PROFILE on SBPL-string, mis sisaldab liivakasti seadistavaid kirjeid. Näiteks teeb järgmine SBPL-katkend failid /dev/null ja /dev/zero liivakasti reeglistiku alusel loetavaks ja kirjutatavaks:
Kui liivakasti käivitamisel lubatakse võrgupuhverserver, lisatakse profiili järgmistega sarnased reeglid, et piirata ühendusi sobivate kohalike portidega:
Codexi põhiprofiil algab kirjega (deny default), seega jäävad väljuvad ühendused blokeerituks, kui neid pole sõnaselgelt lubatud.
Lisaks võib SBPL sisaldada kohatäiteid kujul (param):
Need täidetakse käsule sandbox-exec edastatud suvanditega -Dkey=value.
Oma liivakasti API teostamiseks koostab Codex argumentide loendi(avaneb uues aknas) käsule sandbox-exec, lähtudes põhireeglistikust(avaneb uues aknas). Seejärel täiendab see loendit väärtuse permission_profile ja muu konteksti alusel, et luua täielik Seatbelti profiil. Saadud profiil ja kaasnevad -D argumendid määravad Seatbelti jõustatavad piirangud, võrgupuhverserver aga jõustab täiendavaid võrgureegleid. Kui täielik argumentide loend on koos, on käsu sandbox-exec väljakutsumine lihtne.
Korrektse SBPL-i genereerimine on keeruline, sest Apple ei dokumenteeri seda keelt kolmandate osapoolte jaoks. Tõepoolest, man sandbox-exec märgib The sandbox-exec command is DEPRECATED (samuti on aegunuks märgitud teegifunktsioon sandbox_init(), mida dokumenteerib man 3 sandbox_init). Hoolimata aegumishoiatusest sisaldab macOS endiselt Seatbelti profiile kataloogis /usr/share/sandbox ning kolmandate osapoolte tarkvara, sealhulgas Google Chrome ja Chromium(avaneb uues aknas), toetub jätkuvalt Seatbeltile. Seetõttu plaanime Seatbelti kasutamist lähitulevikus jätkata.
Linuxis liivakasti loomiseks ühendab Codex kaks vahendit: bubblewrap(avaneb uues aknas) (bwrap), käsureatööriist isoleeritud keskkondade loomiseks, ja seccomp-bpf(avaneb uues aknas), Linuxi tuuma mehhanism süsteemikutsete filtreerimiseks. Seadistamist koordineerib sisemine abiprogramm nimega codex-linux-sandbox. Nagu macOS-i sandbox-exec, võtab see sisendiks liivakasti seadistuse ja selle järel käivitatava käsu:
Kui on vaja failisüsteemi isoleerida või liiklust puhverserveri kaudu suunata, käivitab codex-linux-sandbox tööriista bwrap, et luua esialgne liivakastikeskkond. Seejärel käivitab bwrap selles käsu codex-linux-sandbox --apply-seccomp-then-exec. See teine väljakutse rakendab seccomp-bpf-i abil lisapiirangud enne kasutaja käsu käivitamist.
Esialgse liivakastikeskkonna loomiseks kasutab Codex bubblewrapi, mis loob eraldi haakimiste nimeruumis failisüsteemivaate, mis vastab õiguste profiili failisüsteemireeglitele. Kuna see on liivakasti teostuse alus, tarnib Codex tööriista bwrap oma koopiat juhuks, kui kasutaja pole seda paigaldanud. Võimaluse korral eelistab see siiski ühilduvat paigaldist tööriistast (avaneb uues aknas)bwrap(avaneb uues aknas), mis leidub muutujas PATH määratud teel. Praktikas keelavad mõned Linuxi distributsioonid vaikimisi ligipääsu kasutaja nimeruumidele(avaneb uues aknas), kuid teevad erandi süsteemi tööriistale bwrap.
Nagu sandbox-exec, võtab ka bwrap sisendiks liivakasti seadistuse ja selle järel liivakastis käivitatava käsu. Spetsiaalse seadistuskeele, näiteks SBPL-i asemel kasutab bwrap seadistamiseks eraldi lippe. Codex kasutab failisüsteemivaate loomiseks järgmisi suvandeid:
--bindkirjutatava faili või kataloogi määramiseks--ro-bindkirjutuskaitstud faili või kataloogi määramiseks--perms 000 --tmpfs DIR --remount-ro DIRkataloogileDIRligipääsu keelamiseks--perms 000 --ro-bind-data FD FILEfailileFILEligipääsu keelamiseks (FDon avatud failideskriptor, mis viitab failile/dev/null)
Keelumustrite rakendamiseks nende suvanditega laiendab Codex mustrid enne iga käsu käivitamist konkreetseteks teedeks. Uusi mustrile vastavaid teid selle käsu liivakastipiirangutesse automaatselt ei lisata.
Codex määrab ka suvandid nagu --unshare-ipc ja --unshare-pid, et takistada liivakasti ligipääsu hosti muud tüüpi ressurssidele. Seega mõjutab bubblewrap enamat kui failide nähtavust.
Bubblewrapi kasutades edastab Codex suvandi --unshare-net alati, kui võrk on keelatud või ühendused peavad käima võrgupuhverserveri kaudu. See loob liivakastile uue võrgu nimeruumi. Seejärel rakendame seccomp-bpf-i abil lisapiirangud käsule kättesaadavatele võrgu süsteemikutsetele ja sokliperedele.
Täpsemalt kasutame paketti seccompiler(avaneb uues aknas), et kompileerida soovitud filtrite põhjal dünaamiliselt BPF-programm(avaneb uues aknas) ja rakendada see liivakasti käivitusprotsessile, nii et piirangud päranduksid kogu protsessipuule. Seega ei käivita bwrap kasutaja käsku otse, vaid käivitusprogrammi codex-linux-sandbox, millele antakse selle seadistusargumendid ja nende järel kasutaja käsk:
Seccomp-filtrite rakendamiseks kõrgendatud õigusteta seab käivitusprogramm Linuxi no_new_privs lipu(avaneb uues aknas). See lipp pärandub alamprotsessidele ja takistab neil teise programmi, näiteks setuid-täitmisfaili käivitamisel lisaõigusi saada.
Seccomp-filtrid sõltuvad võrguseadistusest. Kui ligipääs võrgule on keelatud, blokeerime mitu võrguga seotud süsteemikutset, näiteks connect(2) ja bind(2). Kui liivakastis on võrgupuhverserver lubatud, lubame IP-sokleid, et pääseda ligi programmi codex-linux-sandbox loodud TCP-kuulajale. Eraldiseisvate Unixi domeeni soklite loomise blokeerime aga vaikimisi, sest need võivad tahtmatult anda ligipääsu hosti ressurssidele.
Kui liivakasti seadistus nõuab võrgupuhverserveri kasutamist, loob Codexi täitmiskeskkond ühe puhverserveri eksemplari, mida saab sama Codexi lõime piires taaskasutada mitmel codex-linux-sandbox väljakutsel. Iga liivakast vajab võimalust jõuda oma isoleeritud võrgu nimeruumist selle ühise puhverserverini. Codex loob nimeruumi tagasisideliidesel TCP-kuulaja ja korraldab ühenduste vastuvõtmise ning puhverserverisse vahendamise väljaspool liivakasti töötava protsessi abil.
Järgmised joonised illustreerivad seda lahendust ühe puhverserveri lõpp-punkti jaoks; viimasel joonisel on näidatud üks seda läbiv ühendus. Enne bubblewrapi käivitamist loob codex-linux-sandbox juhtkanaliks Unixi soklipaari ja haruneb alamprotsessiks. Alamprotsess käivitab funktsiooni run_host_bridge() ja jääb ootama kuulaja failideskriptori saabumist selle kanali kaudu:
Selles näites kasutab ülemprotsess kutset exec, et asendada oma programmikuva programmiga bwrap. See seadistab liivakasti ja käivitab selles käsu codex-linux-sandbox --apply-seccomp-then-exec, edastades juhtkanali failideskriptori:
Liivakasti võrgu nimeruumis loob programmi codex-linux-sandbox teine väljakutse tagasisideliidesel TCP-kuulaja ja edastab selle failideskriptori sokli kaudu. Kuulaja jääb seotuks liivakasti võrgu nimeruumiga. Nii saab liivakastist välja jäänud alamprotsess võtta vastu liivakastis töötavate programmide ühendusi ja avada samal ajal edasiühendused hosti võrgu nimeruumis. Pärast üleandmist sulgevad mõlemad protsessid oma juhtkanali deskriptorid ning liivakastis töötav protsess sulgeb oma kuulajakoopia.
Kui TCP-kuulaja on valmis, määrab liivakastis töötav protsess keskkonnamuutujale HTTP_PROXY(avaneb uues aknas) ja seotud muutujatele väärtused, mis osutavad sellele kuulajale. Seejärel rakendab see enne alamprotsessi loomist ja kasutaja käsu käivitamist seccomp-piirangud:
Väljaspool liivakasti töötav protsess hoiab kuulaja avatuna. Iga vastuvõetud ühenduse jaoks avab see ühenduse seadistatud puhverserveriga ja vahendab andmeid mõlemas suunas.
See lisamehhanism annab käsule oma võrgu nimeruumi koos eraldi tagasisideliidesega. macOS-is lubab Seatbelt käsul luua otseühendusi hosti tagasisideliidese määratud portidega. Linuxis loob käsk seevastu ühenduse oma isoleeritud nimeruumis asuva kuulajaga ning väljaspool liivakasti töötav protsess vahendab need ühendused seadistatud puhverserverile. Deskriptori üleandmine võimaldab seda ühendust, andmata käsule ligipääsu hosti võrgu nimeruumile.
Selle aasta alguses rakendasime Windowsis liivakastilahenduse ja kirjutasime sellest tööst. Sellest ajast alates on Microsoft välja andnud teegi nimega MXC ning uued võimalused protsesside isoleerimiseks Windowsi operatsioonisüsteemis. Praegu asendame oma senist liivakasti lahendusega, mis kasutab MXC teeki.
MXC (Microsoft eXecution Container) on Microsofti koodi liivakastis käivitamise süsteem(avaneb uues aknas), mis toetab mitut isoleerimise taustalahendust Windowsis, Linuxis ja macOS-is. Codex toetab ühilduvates Windowsi seadmetes MXC-põhist liivakasti, mis piirab käskude tegevust kasutaja olemasolevas keskkonnas operatsioonisüsteemi enda protsessiisolatsiooni abil.
Läheme üle MXC-le, et parandada turvalisust ja kasutatavust ning kõrvaldada mitu senise Windowsi liivakasti puudust:
Vajadus kõrgendatud või administraatoriõiguste järele liivakasti seadistamisel
Ressursimahukad ja aeglased ACL-ide kontrolli- ja seadistustoimingud
Hostarvutisse püsima jääv liivakasti seadistus, sealhulgas
ACL-id
Tulemüürireeglid
Liivakasti kasutajad
Juhtkihi failid
MXC pakub JSON-i konfiguratsiooniskeemi(avaneb uues aknas). Codex kasutab MXC SDK-d(avaneb uues aknas), et koostada sellele skeemile vastav täitmistaotlus, mis sisaldab käsku, töökataloogi, keskkonda ja õigusi. Need õigused hõlmavad ligipääsu failisüsteemile ja võrgule ning Windowsi ressurssidele, näiteks töölauale ja lõikelauale.
Ühilduvuse ja turvalisuse tasakaalustamiseks kasutab Codex mitme juhtparameetri puhul fikseeritud sätteid. See lubab registrit lugeda ning säilitab ligipääsu Win32k-le ja töölauale, mida PowerShell käivitumisel vajab. Ligipääs lõikelauale, sisendi süstimine ning töölaua ja süsteemisätete juhtimine on keelatud. Samuti on MXC-l keelatud kasutada varulahendusena hosti failisüsteemi õiguste muutmist.
Codex teisendab õiguste profiili failisüsteemi- ja võrgureeglid MXC seadistuseks. Võtame varem kirjeldatud profiili dev ja eeldame järgmist:
C:\,D:\jaZ:\on arvuti ainsad kohalikud kettad.Tööruumi juurkataloog ja töökataloog on
C:\work\demo.Kasutaja kodukataloog on
D:\Users\dev, seega viitab~/build-cacheteeleD:\Users\dev\build-cache.Keelumustrile vastavad ainult
C:\work\demo\config\dev.envjaC:\work\demo\config\prod.env.
Vastav MXC seadistus sisaldaks järgmist:
MXC failisüsteemireeglistik keelab ligipääsu vaikimisi. Seetõttu annab Codex kohalike ketaste juurkataloogidele lugemisõiguse, et võimaldada selle profiiliga lubatud ulatuslikku lugemist. Need õigused kehtivad rekursiivselt kasutaja olemasolevate operatsioonisüsteemiõiguste piires.
Üks erand: ketta juurkataloogi kirjutamisõigus ei kehti rekursiivselt, seega laiendab Codex selle ketta olemasolevatele vahetutele alamkirjetele.
Täpsemad teed tühistavad ülemkataloogide õigused, seega võib C:\work\demo olla kirjutatav kirjutuskaitstud juurkataloogi C:\ all, samas kui C:\work\demo\.git jääb kirjutuskaitstuks.
Kui tee eri kirjapildid, sümbollingid või ühenduspunktid viitavad samale teele, rakendab MXC rangemat õigust: keeld on ülimuslik lugemisõiguse suhtes ja lugemisõigus lugemis- ning kirjutamisõiguse suhtes.
MXC võtab vastu ainult konkreetseid keelatud teid, seega laiendab Codex keelumustrid enne käivitamist neile vastavateks failideks ja kataloogideks. Käsu töötamise ajal uusi mustrile vastavaid teid automaatselt ei lisata.
Domeenireegleid, näiteks *.openai.com, jõustab eespool kirjeldatud ühine Codexi võrgupuhverserver. Codex käivitab selle puhverserveri väljaspool liivakasti ja edastab selle aadressid käsule samade standardsete *_PROXY keskkonnamuutujate kaudu, mida eespool mainiti. MXC blokeerib otsesed välisühendused, kuid lubab ühendused hosti tagasisideliidesega, sealhulgas ligipääsu puhverserverile. Muud kohalikud teenused jäävad kättesaadavaks.
macOS-is, Linuxis ja Windowsis kasutab täitmiskeskkond õiguste profiili alusel käskude käivitamiseks sama liivakasti API-t. Platvormipõhised teostused teevad nende piirangute rakendamiseks vajaliku seadistuse.
Koodi kirjutamine ja käivitamine annab agentidele paindliku võimaluse lahendada probleeme ka väljaspool tarkvaraarendust. Codexi liivakast võimaldab neil seda võimekust kasutada kasutaja olemasolevas keskkonnas, kus ligipääs failisüsteemile ja võrgule on selgelt piiratud. See on täitmiskeskkonna taaskasutatav põhikomponent ning käsk codex sandbox teeb selle kättesaadavaks ka sinu enda loodud tööriistadele.
Kuna agendid võtavad enda kanda üha rohkem ülesandeid, soovime muuta liivakasti kasutamise praktiliseks rohkemates tööriistades ja keskkondades. Selleks peame lihtsustama õiguste seadistamist ja võtma kasutusele operatsioonisüsteemide paremaid kaitsemeetmeid niipea, kui need kättesaadavaks muutuvad. Meie eesmärk on laiendada agentide võimalusi, jättes inimestele kontrolli selle üle, millele agendid ligi pääsevad.


