Ieskats Codex smilškastē
Kā Codex izpilda komandas jūsu datorā, ievērojot jūsu noteiktos ierobežojumus.
Uzņēmumā OpenAI aģentu aizsardzībai izmantojam daudzslāņu aizsardzības(atveras jaunā logā) pieeju. Lai gan šī darba pamatā ir ieguldījumi apmācībā un saskaņošanā ar cilvēku nodomiem, mēs ieviešam arī funkcijas savā aģentu izpildes ietvarā Codex(atveras jaunā logā), lai nodrošinātu papildu aizsardzību. Viena no biežākajām un potenciāli riskantākajām Codex darbībām ir komandu izpilde jūsu datorā, tāpēc mēs izveidojām Codex smilškasti. Tā ļauj Codex strādāt jūsu esošajā vidē, ievērojot jūsu noteiktos failu sistēmas un tīkla ierobežojumus.
Smilškaste(atveras jaunā logā) (atveras jaunā logā)ierobežo to, kam programma var piekļūt izpildes laikā. Fotoattēlu kārtošanas uzdevumam varat konfigurēt Codex smilškasti tā, lai komandas varētu lasīt un mainīt failus direktorijā ~/Pictures, vienlaikus bloķējot piekļuvi tīklam, lai novērstu augšupielādi. Koda pārskatīšanai varat atļaut piekļuvi tiešsaistes dokumentācijai, vienlaikus saglabājot pirmkoda failus tikai lasāmus. Lietotāji konfigurē Codex smilškasti, izmantojot (atveras jaunā logā)atļauju profilus(atveras jaunā logā), kas nosaka failu sistēmas un tīkla ierobežojumus Codex sesijai.
Šajā rakstā vispirms aplūkosim kompromisus, uz kuriem balstīti Codex smilškastes noklusējuma iestatījumi, un pēc tam izskaidrosim smilškastes uzbūvi un to, kā izpildes ietvars to izmanto komandu palaišanai. Parādīsim, kā galalietotāji un uzņēmumi var pielāgot tās atļaujas savām vajadzībām un kā izstrādātāji var izmantot smilškasti savos rīkos. Visbeidzot aplūkosim, kā šo ierobežojumu ievērošana tiek nodrošināta macOS, Linux un Windows vidē.
Codex smilškastei izvēlamies piesardzīgus noklusējuma iestatījumus, kas tomēr ļauj paveikt jēgpilnu darbu. Piemēram, ja darbvietas sakne ir Git repozitorijs, iebūvētais :workspace atļauju profils:
Atļauj rakstīšanu darbvietā, bet tādus direktorijus kā
.gitun.codexsaglabā tikai lasāmus. Tas ļauj Codex rediģēt pirmkodu, neprasot atļauju katrai izmaiņai, vienlaikus liedzot tieši mainīt.codex/config.tomlvai Git āķus direktorijā.git/hooks.Atļauj plašu lasīšanas piekļuvi failu sistēmai, ievērojot lietotāja esošās OS atļaujas. Kompilatori, izpildvides un būvēšanas rīki ir atkarīgi no SDK, bibliotēkām un konfigurācijas ārpus repozitorija. Ja lasīšana būtu atļauta tikai darbvietā, daudzas ierastas darbplūsmas vairs nedarbotos. Kompromiss ir tāds, ka lasāmi var palikt arī sensitīvi faili citviet datorā, piemēram, konfigurācijas faili ar API atslēgām.
Atspējo piekļuvi tīklam. Tas bloķē tiešu augšupielādi ārējos pakalpojumos, tostarp mēģinājumus iznest datus, kurus komanda var nolasīt. Tas liedz arī leģitīmas darbības, piemēram, atkarību lejupielādi, kurām nepieciešama papildu piekļuve.
Šie ierobežojumi novērš plašu nevēlamu darbību klāstu, taču kaitīgas darbības joprojām ir iespējamas. Piemēram, aģents varētu ievietot ļaunprātīgu kodu lokāli instalētā pakotnē, piemēram, node_modules/prettier. Šāda izmaiņa varētu neparādīties git status izvadē, jo Git bieži ignorē node_modules. Ja lietotāja redaktors saglabāšanas laikā palaiž šo Prettier kopiju, vienkārša faila saglabāšana varētu izpildīt ļaunprātīgo kodu ārpus Codex smilškastes. Tāpēc mēs izmantojam daudzslāņu aizsardzību: smilškaste ierobežo komandu piekļuvi, savukārt apmācība un saskaņošana palīdz modelim izmantot šo piekļuvi atbilstoši lietotāja nodomam.
Norādījumus par smilškastes atļauju pielāgošanu un apvienošanu ar citiem aizsardzības līdzekļiem uzņēmuma vidē skatiet Codex drošības praktiskajā rokasgrāmatā(atveras jaunā logā).
Virtuālās mašīnas un konteineri(atveras jaunā logā) ir divi populāri smilškastes izolācijas mehānismi, taču Codex smilškastē mēs izmantojam citu pieeju. Tā vietā, lai izolācijas nodrošināšanai pārvietotu skaitļošanu uz atsevišķu vidi, Codex izmanto katras platformas smilškastes iespējas, lai ierobežotu komandas, kas darbojas lietotāja esošajā vidē.
Daudziem izstrādātājiem klēpjdators kalpo kā individuāli pielāgota izstrādes vide, kuru viņi var mainīt pēc saviem ieskatiem. Šādas vides atveidošana Docker konteinerā var prasīt pūles, un dažas darbplūsmas joprojām ir atkarīgas no rīkiem, kas darbojas resursdatorā.
Piemēram, iedomājieties, ka izmantojat Codex iOS lietotnes izstrādei Mac datorā. Ja izlemtu izolēt Codex, palaižot to Docker vidē, tas nevarētu palaist iOS būvēšanas rīku ķēdi, ko veido Mac videi paredzēti izpildfaili, nedz arī iPhone simulatoru koda izpildei. Uz Docker balstīta darbplūsma varētu deleģēt būvēšanu un simulatora darbības Mac resursdatoram, taču šīs darbības tiktu izpildītas ārpus konteinera smilškastes un tām būtu vajadzīgi atsevišķi ierobežojumi. Codex gadījumā dodam priekšroku vienkāršībai un daudz ieguldām katrai OS pielāgotā smilškastes izolācijā, lai Codex varētu darboties konkrētajam uzdevumam vispiemērotākajā vidē.
Izpildes ietvars nodrošina piekļuvi šiem OS specifiskajiem smilškastes mehānismiem ar vienotu API macOS, Windows un Linux vidē. Šis API pieņem komandu un atļauju profilu. Ja atļauju profils pieļauj ierobežotu piekļuvi tīklam, izsaucējam jānodrošina tīkla starpniekserveris, kas īsteno šos ierobežojumus:
Šī funkcija palaiž procesu smilškastē un atgriež Child turi, ko izpildes ietvars var izmantot, lai gaidītu procesa pabeigšanu. Katrs atvasinātais process manto sava vecākprocesa smilškastes ierobežojumus, tāpēc tie attiecas uz visu komandas aizsākto procesu koku — arī uz pēctečiem, kas turpina darboties pēc sākotnējā procesa beigām.
Tālāk redzamā diagramma parāda, kā šīs daļas savstarpēji darbojas — no konfigurēšanas līdz komandas izpildei smilškastē. Nākamajās sadaļās izskaidrots katrs posms.

Kā skaidrots rakstā Codex aģenta cikls soli pa solim, Codex izpildes ietvars ir atbildīgs par modeļa ģenerēto rīku izsaukumu izpildi. Programmēšanas uzdevumos visbiežāk izmanto čaulas rīku, kas izpilda komandas līdzīgi tam, kā lietotājs to darītu interaktīvā čaulā, piemēram, Bash. Šeit aplūkosim vienreizējas izpildes (atveras jaunā logā)exec_command(atveras jaunā logā) čaulas rīku(atveras jaunā logā), lai parādītu, kā izpildes ietvars izmanto smilškasti vajadzīgās aizsardzības nodrošināšanai.
Šī ir vienkāršota versija tam, kā Codex izpildes ietvars apstrādātu exec_command rīka izsaukumu bez smilškastes izolācijas:
Lai izolētu komandu smilškastē, izpildes ietvars aizstāj subprocess.Popen() izsaukumu ar spawn_command_under_sandbox(). Izpildes ietvars nodrošina atļauju profilu un, ja nepieciešams, tīkla starpniekserveri:
Rīks exec_command arī ļauj modelim pieprasīt citas atļaujas atsevišķai komandai, taču izpildes ietvars izlemj, vai pieprasījumu apmierināt:
Ja ir norādīts use_default, izpildes ietvars izmanto attiecīgajam sarunas solim paredzēto noklusējuma smilškastes konfigurāciju. with_additional_permissions pieprasa paplašinātu piekļuvi smilškastē, savukārt require_escalated pieprasa izpildi ārpus tās. Pirms komandas izpildes izpildes ietvars izvērtē pieprasījumu, balstoties uz lietotāja preferencēm. (Piemēram, Codex var jautāt lietotājam tieši vai nosūtīt pieprasījumu automātiskai pārskatīšanai(atveras jaunā logā).) Ja izpilde ir atļauta, Codex nodod atbilstošos permission_profile un network_proxy funkcijai perform_exec_command_with_sandboxing() kopā ar komandas argumentiem no sākotnējā ExecCommandToolCall.
Čaulas rīks ir galvenais spawn_command_under_sandbox() izmantotājs, un izpildes ietvars atkārtoti izmanto savu smilškastes infrastruktūru arī tādām darbībām kā lokālo failu lasīšana un mainīšana. Šī atkārtotā izmantošana sniedzas arī ārpus izpildes ietvara: komanda codex sandbox ļauj iekļaut komandu izpildi smilškastē jūsu pašu rīkos, kā redzēsim vēlāk. Tālāk aplūkosim, kā tiek definēti atļauju profili.
Nosaukts atļauju profils ļauj atkārtoti izmantot vienus un tos pašus failu sistēmas un tīkla ierobežojumus dažādos projektos. Savus profilus varat definēt faila config.toml sadaļā [permissions]. Piemēram, tālāk ir definēts profils dev, kas paplašina(atveras jaunā logā) iebūvēto :workspace profilu:
Profils dev pievieno rakstīšanas piekļuvi direktorijam ~/build-cache un nosaka papildu ierobežojumus failiem darbvietā. Failu sistēmas ieraksti var piešķirt tikai lasīšanas piekļuvi (read), lasīšanas un rakstīšanas piekļuvi (write) vai pilnībā bloķēt piekļuvi (deny).
Tabula :workspace_roots ļauj definēt noteikumus ceļiem attiecībā pret projekta darbvietas saknēm. Pēc noklusējuma Codex CLI izmanto savu darba direktoriju kā vienīgo darbvietas sakni, savukārt ChatGPT darbvirsmas lietotne izmanto projekta pirmkoda mapes. Codex piemēro katru noteikumu visām saknēm, tāpēc .vscode ieraksts profilā dev padara .vscode direktoriju tikai lasāmu zem katras saknes.
Papildus saviem noteikumiem dev no :workspace manto šādus aizsardzības līdzekļus:
Konfigurējot tīklu Codex smilškastei, ir trīs galvenās iespējas:
Atspējot jebkādu piekļuvi tīklam (profila
:workspacenoklusējuma iestatījums)Iespējot pilnu, tiešu piekļuvi tīklam (profila
:danger-full-accessnoklusējuma iestatījums)Atļaut piekļuvi tīklam tikai caur starpniekserveri, kas izlemj, ko laist cauri, balstoties uz atļauju profilu
Lai piešķirtu dev tiešu piekļuvi tīklam, faila config.toml augstākajā līmenī iestatiet permissions.dev.network.enabled = true. Tas piešķir pilnu piekļuvi tīklam, ja tīkla starpniekserveris ir atspējots.
Lai dev piekļuvi ierobežotu līdz noteiktam domēnu kopumam, iespējojiet tīkla starpniekserveri un konfigurējiet tā domēnu noteikumus:
Domēnu noteikumi atbalsta precīzus nosaukumus un aizstājzīmju paraugus; skaidri norādītiem aizlieguma noteikumiem ir prioritāte pār atļaujošiem noteikumiem. Pieprasījumiem uz citiem domēniem ir vajadzīgs apstiprinājums, vai arī tie tiek bloķēti, kā aprakstīts tālāk sadaļā Tīkla starpniekserveris.
Atsevišķi lietotāji var konfigurēt noklusējuma iestatījumus visiem projektiem un aizstāt tos konkrētam uzticamam projektam. Arī uzņēmumu administratori var vēlēties konfigurēt noklusējuma iestatījumus saviem lietotājiem un ierobežot, kurus iestatījumus viņi drīkst mainīt. Codex atbalsta abas iespējas, izmantojot slāņotu konfigurāciju un pārvaldītas prasības.
Kā aprakstīts sadaļā Konfigurācijas prioritāte,(atveras jaunā logā) Codex apvieno iestatījumus no vairākiem config.toml failiem. Tabulas tiek apvienotas rekursīvi; ja vērtības konfliktē, tiek izmantots avots ar augstāku prioritāti. Masīvi tiek aizstāti pilnībā.
Tāpēc atļauju profilos failu sistēmas ceļiem un tīkla domēniem izmanto tabulas. Komanda savā konfigurācijā var pievienot vai aizstāt atsevišķus ierakstus un automātiski mantot visu pārējo ierakstu izmaiņas organizācijas pamatkonfigurācijā:
Administratori var arī nodrošināt pārvaldītas prasības(atveras jaunā logā) failā requirements.toml, lai ierobežotu lietotāju konfigurācijas izvēles. Šīs prasības var nākt no vairākiem avotiem, tostarp sistēmas failiem un mākoņa nodrošinātas politikas. Biežs lietojums ir norādīt allowed_permission_profiles, lai ierobežotu atļauju profilus, kurus uzņēmuma lietotājs var izvēlēties. Piemēram, administrators varētu norādīt šādas mākoņa prasības:
Mākoņa prasībām būtu prioritāte pār sistēmas prasību failu /etc/codex/requirements.toml, tāpēc ieraksts šajā failā nevar aizstāt iepriekš skaidri norādīto ":danger-full-access" = false. Ja :workspace netiek norādīts, šo ierakstu var nodrošināt cits prasību slānis. Profili, kuru ierakstu vērtība ir false vai kuru nav galīgajā apvienotajā tabulā, nav pieejami.
Šāds nodalījums ļauj organizācijām noteikt obligātus ierobežojumus, bet lietotājiem — pielāgot konfigurāciju šo ierobežojumu ietvaros. Iegūtos atļauju profilus var izmantot izpildes ietvars, vai arī tos var piemērot tieši komandai, kā redzēsim tālāk.
Codex CLI nodrošina komandu sandbox, kas atvieglo patvaļīgas komandas izpildi atbilstoši Codex konfigurācijā definētam atļauju profilam. To parasti izmanto profila pārbaudei, lai pārliecinātos, ka smilškaste novērš darbības, kuru bloķēšanai tā paredzēta.
Piemēram, tālāk norādītā komanda mēģina konfigurēt VS Code tā, lai saglabāšanas laikā tiktu palaists ļaunprātīgs automātiskās formatēšanas rīks. Pieņemot, ka .vscode jau pastāv, iepriekš definētajam dev profilam vajadzētu bloķēt šo rakstīšanu, jo šis direktorijs ir tikai lasāms (codex sandbox pēc noklusējuma uzskata cwd par darbvietas sakni):
Patiešām, macOS vidē šī darbība neizdodas, un tiek parādīts:
Komanda codex sandbox ļauj izmantot Codex smilškastes mehānismu neatkarīgi no aģenta sesijas. Varat izmantot to pašu konfigurācijas valodu un platformai pielāgoto ierobežojumu īstenošanu, lai ierobežotu komandas, ko palaiž jūsu rīki.
Ja stdio MCP serveris ir konfigurēts failā config.toml, Codex izpildes ietvars nemēģina izolēt smilškastē komandu, ar kuru tiek palaists serveris. Codex nevar droši noteikt, kuri faili vai tīkla pakalpojumi šim serverim ir vajadzīgi, tāpēc noklusējuma smilškastes profila piemērošana varētu padarīt citādi derīgu konfigurāciju nederīgu.
Piemēram, standarta veids, kā konfigurēt @modelcontextprotocol/server-memory(atveras jaunā logā) MCP serveri izmantošanai ar Codex, ir šāds:
Tā kā šī npx komanda darbojas ārpus smilškastes, tā var rakstīt failus un sūtīt tīkla pieprasījumus ar tādām pašām atļaujām kā lietotājs, kas palaiž Codex. Tas piešķir pārmērīgi plašu piekļuvi. Lai ierobežotu piekļuvi, varam definēt atļauju profilu memory-mcp un pēc tam palaist sākotnējo npx komandu ar codex sandbox --permission-profile memory-mcp, tā ierobežojot servera rakstīšanas vietas un liedzot tam piekļuvi tīklam:
Pirms servera palaišanas izveidojiet tā datu direktoriju un ievietojiet npm kešatmiņā pakotni ar fiksēto versiju. Tas ļauj npx --offline palaist serveri ar profilu, kas atspējo piekļuvi tīklam:
Kad pakotne ir kešatmiņā, Codex var palaist atmiņas serveri bez piekļuves tīklam, atļaujot rakstīšanu tikai npm kešatmiņā un servera datu direktorijā.
Smilškastes realizācija pārveido atļauju profilu ierobežojumos, kuru ievērošanu nodrošina operētājsistēma. Tīkla starpniekservera pieprasījumu apstrādes un politikas pamatloģika ir kopīga visām trim galvenajām operētājsistēmām, savukārt tā iestatīšana un integrācija ar smilškasti ir pielāgota katrai OS. Vispirms aplūkosim kopīgo starpniekserveri un pēc tam realizācijas macOS, Linux un Windows vidē.
Lai īstenotu atļauju profila tīkla ierobežojumus, izpildes ietvars palaiž tīkla starpniekserveri un konfigurē smilškasti tā, lai atļautu savienojumus ar to, bet bloķētu tiešus savienojumus ar ārējiem resursdatoriem. Starpniekserveris pārbauda katru pieprasījumu atbilstoši profila domēnu noteikumiem, lai izlemtu, vai to pārsūtīt.
Codex repozitorijā tīkla starpniekserveris ir realizēts pakotnē codex-network-proxy(atveras jaunā logā), ko izpildes ietvars izmanto kā bibliotēku, lai gan to var būvēt arī kā atsevišķu CLI rīku(atveras jaunā logā). Kad codex-network-proxy ir iespējots, tas pēc noklusējuma palaiž gan HTTP, gan SOCKS5 starpniekserveri. Šo starpniekserveru adreses tiek nodotas smilškastē palaistajam procesam ar vides mainīgajiem. Papildus standarta vides mainīgajiem, piemēram, HTTP_PROXY, HTTPS_PROXY un ALL_PROXY, tiek ievietoti arī vairāki labi zināmi lietotnēm specifiski vides mainīgie(atveras jaunā logā), piemēram, PIP_PROXY. Jāatzīst, ka ne visas programmas ņem vērā šos vides mainīgos. Ja programma mēģina tieši savienoties ar ārēju resursdatoru, operētājsistēmas smilškastes ierobežojumi to bloķē, kā aprakstīts tālāk konkrētajām platformām veltītajās sadaļās.
Tīkla starpniekserveris ir atbildīgs par atļauju profilā noteikto tīkla ierobežojumu īstenošanu. Piemēram, iepriekš parādītais dev profils atļauj pieprasījumus uz *.openai.com un skaidri aizliedz pieprasījumus uz evil.example. Ja pieprasījuma mērķa domēns neatbilst nevienam atļaujošam vai aizliedzošam noteikumam, starpniekserveris var apturēt pieprasījumu un nodot lēmumu par tā apstiprināšanu izpildes ietvaram. Tāpat kā čaulas komandas piemērā, Codex var jautāt lietotājam tieši vai nosūtīt pieprasījumu automātiskai pārskatīšanai(atveras jaunā logā). Pēc lēmuma saņemšanas starpniekserveris vai nu ļauj pieprasījumam turpināties, vai noraida to ar kļūdas atbildi.
Šeit secībai ir nozīme, jo pat DNS uzmeklēšana var nopludināt resursdatora nosaukumā iekodētu informāciju. Tāpēc starpniekserveris nosaka pieprasītā resursdatora nosaukumam atbilstošo adresi tikai pēc tam, kad ir konstatēts, ka tas ir atļauts vai apstiprināts. Ņemiet vērā, ka plaši aizstājzīmju noteikumi vai piekļuve DNS pakalpojumiem joprojām var pieļaut datu iznešanu, izmantojot DNS.
MacOS vidē Codex izmanto Seatbelt(atveras jaunā logā) — Apple smilškastes mehānismu, kura ierobežojumus īsteno kodols. Seatbelt politikas tiek rakstītas Sandbox Profile Language (SBPL) — uz Scheme balstītā valodā smilškastes ierobežojumu aprakstīšanai. Codex izsauc Seatbelt ar macOS komandu /usr/bin/sandbox-exec. Tāpat kā codex sandbox, tā pieņem smilškasti aprakstošas opcijas, kam seko izpildāmā komanda:
PROFILE ir SBPL virkne ar ierakstiem, kas konfigurē smilškasti. Piemēram, tālāk redzamais SBPL fragments smilškastes politikā atļauj lasīt un rakstīt /dev/null un /dev/zero:
Ja smilškastes izsaukumā ir iespējots tīkla starpniekserveris, profilā tiek ievietoti tālāk redzamajiem līdzīgi noteikumi, lai atļautu savienojumus tikai ar attiecīgajiem lokālajiem portiem:
Codex pamatprofils sākas ar (deny default), tāpēc izejošie savienojumi paliek bloķēti, ja vien tie nav skaidri atļauti.
Visbeidzot, SBPL var ietvert vietturus, izmantojot (param):
Tie tiek aizpildīti ar -Dkey=value opcijām, kas nodotas sandbox-exec.
Lai realizētu savu smilškastes API, Codex izveido argumentu sarakstu(atveras jaunā logā) komandai sandbox-exec, sākot ar pamatpolitiku(atveras jaunā logā), un pēc tam izmanto permission_profile un citu kontekstu, lai to papildinātu un iegūtu pilnu Seatbelt profilu. Iegūtais profils un tam pievienotie -D argumenti konfigurē Seatbelt īstenotos ierobežojumus, savukārt tīkla starpniekserveris īsteno papildu tīkla noteikumus. Kad pilnais argumentu saraksts ir izveidots, sandbox-exec izsaukšana ir vienkārša.
Pareiza SBPL ģenerēšana ir sarežģīta, jo Apple nedokumentē šo valodu izmantošanai trešo pušu risinājumos. Turklāt man sandbox-exec norāda The sandbox-exec command is DEPRECATED (novecojusi ir arī bibliotēkas funkcija sandbox_init(), kas dokumentēta ar man 3 sandbox_init). Neraugoties uz brīdinājumu par novecošanu, macOS joprojām iekļauj Seatbelt profilus direktorijā /usr/share/sandbox, un trešo pušu programmatūra, tostarp Google Chrome un Chromium(atveras jaunā logā), turpina izmantot Seatbelt. Tāpēc pārskatāmā nākotnē plānojam turpināt izmantot Seatbelt.
Smilškastes izveidei Linux vidē Codex apvieno bubblewrap(atveras jaunā logā) (bwrap) — komandrindas rīku izolētu vižu veidošanai — ar seccomp-bpf(atveras jaunā logā), Linux kodola mehānismu sistēmizsaukumu filtrēšanai. Iestatīšanu koordinē iekšējs palīgrīks codex-linux-sandbox. Tāpat kā sandbox-exec macOS vidē, tas pieņem smilškastes konfigurāciju, kam seko izpildāmā komanda:
Ja nepieciešama failu sistēmas izolācija vai maršrutēšana caur starpniekserveri, codex-linux-sandbox izsauc bwrap, lai izveidotu sākotnējo smilškastes vidi. Pēc tam bwrap tajā palaiž codex-linux-sandbox --apply-seccomp-then-exec. Šis otrais izsaukums izmanto seccomp-bpf, lai pirms lietotāja komandas palaišanas piemērotu papildu ierobežojumus.
Lai izveidotu sākotnējo smilškastes vidi, Codex izmanto bubblewrap un atsevišķā montējumu vārdtelpā izveido failu sistēmas skatu, kas atspoguļo atļauju profila failu sistēmas noteikumus. Tā kā šis mehānisms ir smilškastes realizācijas pamatā, Codex iekļauj savu bwrap kopiju gadījumam, ja lietotājs to nav instalējis, taču, ja ir pieejama saderīga instalācija ceļā PATH, tas dod priekšroku šai (atveras jaunā logā)bwrap(atveras jaunā logā) instalācijai. Praksē ir novērots, ka daži Linux distributīvi pēc noklusējuma atspējo piekļuvi lietotāju vārdtelpām(atveras jaunā logā), bet sistēmas bwrap piešķir izņēmumu.
Tāpat kā sandbox-exec, arī bwrap pieņem smilškastes konfigurāciju, kam seko smilškastē izpildāmā komanda. Atšķirībā no īpašas konfigurācijas valodas, piemēram, SBPL, bwrap konfigurācijai izmanto atsevišķus karodziņus. Codex izmanto šādas opcijas failu sistēmas skata izveidei:
--bind, lai norādītu rakstāmu failu vai direktoriju--ro-bind, lai norādītu tikai lasāmu failu vai direktoriju--perms 000 --tmpfs DIR --remount-ro DIR, lai liegtu piekļuviDIR--perms 000 --ro-bind-data FD FILE, lai liegtu piekļuviFILE(kurFDir atvērts faila deskriptors, kas norāda uz/dev/null)
Lai ar šīm opcijām piemērotu aizlieguma aizstājzīmju paraugus, Codex pirms katras komandas palaišanas izvērš tos konkrētos ceļos. Jauni atbilstoši ceļi netiek automātiski pievienoti šīs komandas smilškastes ierobežojumiem.
Codex norāda arī tādas opcijas kā --unshare-ipc un --unshare-pid, lai smilškaste nevarētu piekļūt citu veidu resursiem resursdatorā, tāpēc bubblewrap ietekmē ne tikai failu redzamību.
Izmantojot bubblewrap, Codex nodod --unshare-net ikreiz, kad tīkls ir atspējots vai savienojumiem jāiet caur tīkla starpniekserveri. Tas izveido smilškastei jaunu tīkla vārdtelpu. Pēc tam mēs izmantojam seccomp-bpf, lai papildus ierobežotu komandai pieejamos tīkla sistēmizsaukumus un ligzdu saimes.
Konkrēti, mēs izmantojam seccompiler pakotni(atveras jaunā logā), lai dinamiski kompilētu BPF programmu atbilstoši vajadzīgajiem filtriem(atveras jaunā logā) un piemērotu to palaidēja procesam smilškastē, lai ierobežojumus mantotu viss procesu koks. Tāpēc bwrap nepalaiž lietotāja komandu, bet gan codex-linux-sandbox palaidēju ar tā konfigurācijas argumentiem, kam seko lietotāja komanda:
Lai piemērotu seccomp filtrus bez paaugstinātām tiesībām, palaidējs iestata Linux no_new_privs karodziņu(atveras jaunā logā). Šo karodziņu manto atvasinātie procesi, un tas liedz tiem iegūt papildu tiesības, izpildot citu programmu, piemēram, setuid izpildfailu.
Seccomp filtri ir atkarīgi no tīkla konfigurācijas. Ja piekļuve tīklam ir atspējota, mēs bloķējam vairākus ar tīklu saistītus sistēmizsaukumus, piemēram, connect(2) un bind(2). Savukārt, ja smilškastē ir iespējots tīkla starpniekserveris, mēs atļaujam IP ligzdas, lai būtu sasniedzams codex-linux-sandbox izveidotais TCP klausītājs, bet pēc noklusējuma bloķējam atsevišķu Unix domēna ligzdu izveidi, jo tās varētu netīši nodrošināt piekļuvi resursdatora resursiem.
Ja smilškastes konfigurācija paredz tīkla starpniekservera izmantošanu, Codex izpildes ietvars izveido vienu starpniekservera instanci, ko var atkārtoti izmantot vairākos codex-linux-sandbox izsaukumos vienā Codex sarunas pavedienā. Katrai smilškastei ir vajadzīgs veids, kā no savas izolētās tīkla vārdtelpas sasniegt šo koplietojamo starpniekserveri. Codex šajā vārdtelpā nodrošina atgriezeniskās cilpas TCP klausītāju un panāk, ka process ārpus smilškastes pieņem tā savienojumus un pārsūta tos uz starpniekserveri.
Tālāk redzamās diagrammas attēlo šo risinājumu vienam starpniekservera galapunktam; pēdējā diagrammā parādīts viens savienojums caur to. Pirms bubblewrap palaišanas codex-linux-sandbox izveido Unix ligzdu pāri vadības kanālam un atvasina jaunu procesu. Atvasinātais process izpilda run_host_bridge() un gaida, līdz pa šo kanālu saņems klausītāja faila deskriptoru:
Šajā piemērā vecākprocess izmanto exec, lai aizstātu savu programmas attēlu ar bwrap. Tas iestata smilškasti un tajā palaiž codex-linux-sandbox --apply-seccomp-then-exec, nododot arī vadības kanāla faila deskriptoru:
Smilškastes tīkla vārdtelpā otrais codex-linux-sandbox izsaukums izveido atgriezeniskās cilpas TCP klausītāju un caur ligzdu nodod tā faila deskriptoru. Klausītājs paliek saistīts ar smilškastes tīkla vārdtelpu. Tādējādi atvasinātais process, kas palicis ārpus smilškastes, var pieņemt savienojumus no programmām smilškastē, vienlaikus atverot savus savienojumus uz starpniekserveri resursdatora tīkla vārdtelpā. Pēc nodošanas abi procesi aizver savus vadības kanāla deskriptorus, bet process smilškastē aizver savu klausītāja kopiju.
Kad TCP klausītājs ir gatavs, process smilškastē iestata atbilstošu vērtību mainīgajam HTTP_PROXY(atveras jaunā logā) un saistītajiem vides mainīgajiem, lai tie norādītu uz šo klausītāju. Pēc tam tas piemēro seccomp, pirms izveido atvasinātu procesu un izpilda lietotāja komandu:
Process ārpus smilškastes uztur klausītāju atvērtu. Katram pieņemtajam savienojumam tas atver savienojumu ar konfigurēto starpniekserveri un pārsūta datus abos virzienos.
Šis papildu mehānisms nodrošina komandai savu tīkla vārdtelpu, tostarp atsevišķu atgriezeniskās cilpas saskarni. Operētājsistēmā macOS Seatbelt ļauj komandai tieši savienoties ar norādītajiem resursdatora atgriezeniskās cilpas saskarnes portiem. Savukārt Linux vidē komanda savienojas ar klausītāju savā izolētajā vārdtelpā, un process ārpus smilškastes pārsūta šos savienojumus uz konfigurēto starpniekserveri. Deskriptora nodošana padara šo savienojumu iespējamu, nedodot komandai piekļuvi resursdatora tīkla vārdtelpai.
Šī gada sākumā mēs ieviesām smilškasti Windows vidē un aprakstījām šajā jomā paveikto. Kopš tā laika Microsoft ir izlaidis bibliotēku MXC līdztekus jaunām procesu izolācijas iespējām operētājsistēmā Windows. Pašlaik mēs aizstājam esošo smilškasti ar tādu, kas izmanto MXC bibliotēku.
MXC (Microsoft eXecution Container) ir Microsoft izstrādāta koda izpildes sistēma smilškastē(atveras jaunā logā), kas atbalsta vairākas izolācijas aizmugursistēmas Windows, Linux un macOS vidē. Saderīgās Windows ierīcēs Codex atbalsta uz MXC balstītu smilškasti, izmantojot sistēmā iebūvēto procesu izolāciju, lai ierobežotu komandas lietotāja esošajā vidē.
Mēs pārejam uz MXC, lai uzlabotu drošību un lietojamību, vienlaikus novēršot vairākus esošās Windows smilškastes trūkumus:
Smilškastes iestatīšanai nepieciešamas paaugstinātas jeb administratora tiesības
ACL pārbaudes un iestatīšanas darbības ir resursietilpīgas un lēnas
Resursdatorā saglabājas smilškastes iestatījumu stāvoklis, tostarp:
ACL
Ugunsmūra noteikumi
Smilškastes lietotāji
Vadības slāņa faili
MXC nodrošina JSON konfigurācijas shēmu(atveras jaunā logā). Codex izmanto MXC SDK(atveras jaunā logā), lai izveidotu šai shēmai atbilstošu izpildes pieprasījumu, kurā ietverta komanda, darba direktorijs, vide un atļaujas. Šīs atļaujas aptver piekļuvi failu sistēmai un tīklam, kā arī Windows resursiem, piemēram, darbvirsmai un starpliktuvei.
Lai līdzsvarotu saderību un drošību, Codex vairākiem vadības mehānismiem izmanto fiksētus iestatījumus. Tas atļauj lasīt reģistru un saglabā piekļuvi Win32k un darbvirsmai, kas PowerShell nepieciešama palaišanas laikā. Piekļuve starpliktuvei, ievades injicēšana, kā arī darbvirsmas un sistēmas iestatījumu vadība ir atspējota. Visbeidzot, MXC ir liegts kā rezerves risinājumu izmantot resursdatora failu sistēmas atļauju maiņu.
Codex pārveido atļauju profila failu sistēmas un tīkla noteikumus MXC konfigurācijā. Izmantojot iepriekš aprakstīto dev profilu un pieņemot, ka:
C:\,D:\unZ:\ir vienīgie lokālie diski datorā.Darbvietas sakne un darba direktorijs ir
C:\work\demo.Lietotāja mājas direktorijs ir
D:\Users\dev, tāpēc~/build-cachetiek izvērsts parD:\Users\dev\build-cache.Aizlieguma aizstājzīmju paraugam atbilst tikai
C:\work\demo\config\dev.envunC:\work\demo\config\prod.env.
Atbilstošie MXC iestatījumi ietvertu:
MXC failu sistēmas politika pēc noklusējuma liedz piekļuvi. Tāpēc Codex pievieno tikai lasīšanas atļaujas lokālo disku saknēm, lai nodrošinātu šajā profilā atļauto plašo lasīšanas piekļuvi. Šīs atļaujas tiek piemērotas rekursīvi, ievērojot lietotāja esošās OS atļaujas.
Viena nianse: disku saknēm piešķirtās rakstīšanas atļaujas netiek piemērotas rekursīvi, tāpēc Codex tās izvērš, iekļaujot saknē esošos tiešos failus un direktorijus.
Konkrētākiem ceļiem noteiktās atļaujas aizstāj augstāka līmeņa direktoriju atļaujas, tāpēc C:\work\demo var būt rakstāms zem tikai lasāmā C:\, savukārt C:\work\demo\.git paliek tikai lasāms.
Ja dažādi ceļa pieraksti vai simbolisko saišu un savienojuma punktu aizstājvārdi norāda uz vienu un to pašu ceļu, MXC piemēro stingrāko atļauju: aizliegumam ir prioritāte pār tikai lasīšanas atļauju, bet tai — pār lasīšanas un rakstīšanas atļauju.
MXC pieņem tikai konkrētus aizliegtos ceļus, tāpēc Codex pirms palaišanas izvērš aizlieguma aizstājzīmju paraugus atbilstošajos failos un direktorijos. Komandas izpildes laikā jauni ceļi, kas atbilst aizstājzīmju paraugam, netiek automātiski pievienoti.
Domēnu noteikumus, piemēram, *.openai.com, īsteno iepriekš aprakstītais kopīgais Codex tīkla starpniekserveris. Codex palaiž šo starpniekserveri ārpus smilškastes un nodod tā adreses komandai, izmantojot tos pašus iepriekš minētos standarta *_PROXY vides mainīgos. MXC bloķē tiešus ārējos savienojumus, bet atļauj savienojumus ar resursdatora atgriezenisko cilpu, tostarp piekļuvi starpniekserverim. Citi lokālie pakalpojumi paliek sasniedzami.
MacOS, Linux un Windows vidē izpildes ietvars izmanto vienu un to pašu smilškastes API, lai palaistu komandas atbilstoši atļauju profilam. Platformām pielāgotās realizācijas veic iestatīšanu, kas nepieciešama šo ierobežojumu piemērošanai.
Koda rakstīšana un izpilde sniedz aģentiem elastīgu veidu, kā risināt problēmas arī ārpus programmatūras izstrādes. Codex smilškaste ļauj izmantot šo spēju lietotāja esošajā vidē ar skaidri noteiktiem failu sistēmas un tīkla piekļuves ierobežojumiem. Tā ir atkārtoti izmantojama pamatkomponente izpildes ietvarā, un komanda codex sandbox padara to pieejamu arī jūsu pašu veidotajiem rīkiem.
Aģentiem uzņemoties arvien vairāk uzdevumu, vēlamies padarīt smilškastes izolāciju praktiski izmantojamu plašākam rīku un vižu lokam. Tas nozīmē vienkāršot atļauju konfigurēšanu un izmantot labākus operētājsistēmu aizsardzības līdzekļus, tiklīdz tie kļūst pieejami. Mūsu mērķis ir paplašināt aģentu iespējas, vienlaikus saglabājot cilvēku kontroli pār to, kam aģenti var piekļūt.


