Ako funguje sandbox Codexu
Ako Codex spúšťa príkazy na vašom počítači s obmedzeniami, ktoré určujete vy.
V OpenAI pri zabezpečovaní agentov uplatňujeme prístup viacvrstvovej obrany(otvorí sa v novom okne). Hoci základom tohto úsilia sú naše investície do trénovania a zosúlaďovania, v našom agentnom harness-e Codex(otvorí sa v novom okne) implementujeme aj funkcie, ktoré poskytujú ďalšiu ochranu. Keďže jednou z najčastejších (a potenciálne rizikových) činností Codexu je spúšťanie príkazov na vašom počítači, vytvorili sme sandbox Codexu. Codex tak môže pracovať vo vašom existujúcom prostredí v medziach prístupu k súborovému systému a sieti, ktoré určujete vy.
Sandbox(otvorí sa v novom okne) (otvorí sa v novom okne)obmedzuje, k čomu má program počas behu prístup. Pri úlohe na usporiadanie fotografií môžete sandbox Codexu nastaviť tak, aby príkazy mohli čítať a upravovať súbory v ~/Pictures, ale nemali prístup k sieti, čím zabránite nahrávaniu súborov. Pri kontrole kódu môžete povoliť prístup k online dokumentácii, no zdrojové súbory ponechať iba na čítanie. Používatelia konfigurujú sandbox Codexu prostredníctvom (otvorí sa v novom okne)profilov oprávnení(otvorí sa v novom okne), ktoré definujú obmedzenia súborového systému a siete pre reláciu Codexu.
V tomto článku najprv prejdeme kompromisy, z ktorých vychádzajú predvolené nastavenia sandboxu Codexu. Potom vysvetlíme jeho návrh a to, ako ho harness využíva na spúšťanie príkazov. Ukážeme, ako si koncoví používatelia a podniky môžu prispôsobiť jeho oprávnenia a ako môžu vývojári sandbox opätovne použiť vo vlastných nástrojoch. Napokon sa pozrieme na to, ako sa tieto obmedzenia vynucujú v systémoch macOS, Linux a Windows.
Našou filozofiou v Codexe je nastaviť sandbox konzervatívne, no tak, aby stále umožňoval zmysluplnú prácu. Ak je napríklad koreňom pracovného priestoru repozitár Git, vstavaný profil oprávnení :workspace:
Povoľuje zápis v pracovnom priestore, no adresáre ako
.gita.codexponecháva iba na čítanie. Codex tak môže upravovať zdrojový kód bez žiadania o povolenie pri každej zmene, no nemôže priamo meniť.codex/config.tomlani hooky Gitu v.git/hooks.Povoľuje široký prístup na čítanie súborového systému v medziach existujúcich oprávnení používateľa v OS. Kompilátory, behové prostredia a nástroje na zostavovanie závisia od SDK, knižníc a konfigurácie mimo repozitára. Obmedzenie čítania na pracovný priestor by narušilo mnohé bežné pracovné postupy. Nevýhodou je, že čitateľné môžu zostať aj citlivé súbory inde v počítači (napríklad konfiguračné súbory obsahujúce kľúče API).
Zakazuje prístup k sieti. Tým blokuje priame nahrávanie do externých služieb vrátane pokusov o odcudzenie údajov, ktoré príkaz dokáže čítať. Zároveň však bráni aj legitímnym operáciám, napríklad sťahovaniu závislostí, ktoré vyžadujú dodatočný prístup.
Tieto obmedzenia bránia širokej škále nežiaduceho správania, no škodlivé činnosti sú stále možné. Agent by napríklad mohol vložiť škodlivý kód do lokálne nainštalovaného balíka, ako je node_modules/prettier. Takáto zmena sa nemusí zobraziť vo výstupe git status, pretože Git často ignoruje node_modules. Ak editor používateľa pri ukladaní spúšťa túto kópiu nástroja Prettier, samotné uloženie súboru by mohlo spustiť škodlivý kód mimo sandboxu Codexu. Preto uplatňujeme viacvrstvovú obranu: sandbox obmedzuje, k čomu majú príkazy prístup, zatiaľ čo trénovanie a zosúlaďovanie pomáhajú modelu využívať tento prístup v súlade so zámerom používateľa.
Pokyny na prispôsobenie oprávnení sandboxu a ich kombinovanie s ďalšími ochranami v podnikovom prostredí nájdete v bezpečnostnej príručke Codexu(otvorí sa v novom okne).
Virtuálne počítače a kontajnery(otvorí sa v novom okne) sú dva obľúbené mechanizmy na vytváranie izolovaných prostredí, no pri sandboxe Codexu volíme iný prístup. Namiesto presunu výpočtov do samostatného prostredia na zabezpečenie izolácie využíva Codex mechanizmy sandboxu jednotlivých platforiem na obmedzenie príkazov spustených v existujúcom prostredí používateľa.
Mnohým vývojárom slúži notebook ako vývojové prostredie na mieru, ktoré môžu kedykoľvek meniť podľa potreby. Reprodukovať takéto prostredie v kontajneri Docker môže byť prácne a niektoré pracovné postupy aj tak závisia od nástrojov spustených na hostiteľovi.
Predstavte si napríklad použitie Codexu na vývoj aplikácie pre iOS na Macu. Ak by ste sa rozhodli izolovať Codex spustením v Dockeri, nemohol by spustiť sadu nástrojov na zostavenie aplikácie pre iOS, ktorú tvoria natívne spustiteľné súbory pre Mac, ani simulátor iPhonu na spustenie kódu. Pracovný postup založený na Dockeri by mohol delegovať zostavovanie a operácie simulátora na hostiteľský Mac, no tieto operácie by prebiehali mimo sandboxu kontajnera a potrebovali by vlastné obmedzenia. V Codexe uprednostňujeme jednoduchosť, preto výrazne investujeme do sandboxov špecifických pre jednotlivé OS, aby Codex mohol bežať v prostredí najvhodnejšom pre danú úlohu.
Harness sprístupňuje tieto mechanizmy sandboxu špecifické pre OS prostredníctvom spoločného API pre macOS, Windows a Linux. Toto API prijíma príkaz a profil oprávnení. Ak profil oprávnení povoľuje obmedzený prístup k sieti, volajúci musí poskytnúť sieťový proxy server, ktorý tieto obmedzenia vynúti:
Táto funkcia spustí proces v sandboxe a vráti identifikátor Child, pomocou ktorého môže harness čakať na jeho dokončenie. Každý dcérsky proces dedí obmedzenia sandboxu svojho rodiča. Tieto obmedzenia preto platia v celom strome procesov spustenom príkazom, dokonca aj pre potomkov, ktorí bežia dlhšie než pôvodný proces.
Nasledujúci diagram ukazuje, ako tieto časti spolu súvisia, od konfigurácie až po spustenie príkazu v sandboxe. Nasledujúce časti vysvetľujú jednotlivé fázy.

Ako vysvetľuje článok Podrobný pohľad na slučku agenta Codexu, harness Codexu zodpovedá za vykonávanie volaní nástrojov generovaných modelom. Pri programátorských úlohách sa najčastejšie používa nástroj shellu, ktorý spúšťa príkazy podobne ako používateľ v interaktívnom shelli, napríklad Bash. Tu sa pozrieme na jednorazový (otvorí sa v novom okne)nástroj shellu (otvorí sa v novom okne)exec_command(otvorí sa v novom okne), aby sme ukázali, ako harness využíva sandbox na zabezpečenie požadovanej ochrany.
Toto je zjednodušená verzia toho, ako by harness Codexu vykonal volanie nástroja exec_command bez sandboxu:
Aby harness izoloval príkaz v sandboxe, nahradí volanie subprocess.Popen() volaním spawn_command_under_sandbox(). Harness poskytne profil oprávnení a v prípade potreby aj sieťový proxy server:
Nástroj exec_command tiež umožňuje modelu požiadať o iné oprávnenia pre konkrétny príkaz, no o schválení požiadavky rozhoduje harness:
Ak je zadané use_default, harness použije predvolenú konfiguráciu sandboxu pre daný ťah. with_additional_permissions žiada o rozšírený prístup v rámci sandboxu, zatiaľ čo require_escalated žiada o vykonanie mimo neho. Harness pred vykonaním príkazu vyhodnotí požiadavku podľa preferencií používateľa. (Codex môže napríklad požiadať priamo používateľa alebo požiadavku presmerovať na automatické posúdenie(otvorí sa v novom okne).) Ak je vykonanie schválené, Codex odovzdá príslušné permission_profile a network_proxy funkcii perform_exec_command_with_sandboxing() spolu s argumentmi príkazu z pôvodného ExecCommandToolCall.
Funkciu spawn_command_under_sandbox() využíva predovšetkým nástroj shellu. Harness používa svoju infraštruktúru sandboxu aj pri operáciách, ako je čítanie a úprava lokálnych súborov. Toto opätovné využitie presahuje samotný harness: príkaz codex sandbox umožňuje začleniť spúšťanie príkazov v sandboxe do vlastných nástrojov, ako uvidíme neskôr. Ďalej sa pozrieme na to, ako sa definujú profily oprávnení.
Pomenovaný profil oprávnení umožňuje opakovane používať rovnaké obmedzenia súborového systému a siete v rôznych projektoch. Vlastné profily môžete definovať v sekcii [permissions] súboru config.toml. Nasledujúci príklad definuje profil s názvom dev, ktorý rozširuje(otvorí sa v novom okne) vstavaný profil :workspace:
Profil dev pridáva prístup na zápis do ~/build-cache a zavádza ďalšie obmedzenia pre súbory v pracovnom priestore. Položky súborového systému môžu udeliť prístup iba na čítanie (read), prístup na čítanie a zápis (write) alebo prístup úplne zablokovať (deny).
Tabuľka :workspace_roots umožňuje definovať pravidlá pre cesty relatívne ku koreňom pracovného priestoru projektu. Codex CLI predvolene používa svoj pracovný adresár ako jediný koreň pracovného priestoru, zatiaľ čo počítačová aplikácia ChatGPT používa zdrojové priečinky projektu. Codex uplatňuje každé pravidlo na každý koreň, takže položka .vscode v profile dev nastaví adresár .vscode pod každým koreňom iba na čítanie.
Okrem vlastných pravidiel dedí dev z profilu :workspace tieto ochrany:
Pri konfigurácii siete pre sandbox v Codexe máte v zásade tri možnosti:
Zakázať všetok prístup k sieti (predvolené pre profil
:workspace)Povoliť úplný priamy prístup k sieti (predvolené pre profil
:danger-full-access)Obmedziť prístup k sieti na proxy server, ktorý podľa profilu oprávnení rozhoduje, čo prepustí
Ak chcete profilu dev poskytnúť priamy prístup k sieti, na najvyššej úrovni súboru config.toml nastavte permissions.dev.network.enabled = true. Ak je sieťový proxy server vypnutý, týmto udelíte úplný prístup k sieti.
Ak chcete profil dev obmedziť na určitú množinu domén, zapnite sieťový proxy server a nakonfigurujte jeho pravidlá domén:
Pravidlá domén podporujú presné názvy aj vzory so zástupnými znakmi, pričom explicitné zakazujúce pravidlá majú prednosť pred povoľujúcimi. Požiadavky na iné domény vyžadujú schválenie alebo sa blokujú, ako opisuje časť Sieťový proxy server nižšie.
Jednotliví používatelia si môžu nakonfigurovať predvolené nastavenia platné naprieč projektmi a pre konkrétny dôveryhodný projekt ich prepísať. Podnikoví správcovia môžu tiež chcieť nakonfigurovať predvolené nastavenia pre svojich používateľov a obmedziť, ktoré nastavenia môžu používatelia meniť. Codex podporuje oboje prostredníctvom vrstvenej konfigurácie a spravovaných požiadaviek.
Ako je opísané v časti Priorita konfigurácie,(otvorí sa v novom okne) Codex zlučuje nastavenia z viacerých súborov config.toml. Tabuľky sa zlučujú rekurzívne a pri konflikte hodnôt má prednosť zdroj s vyššou prioritou. Polia sa nahrádzajú ako celok.
Preto profily oprávnení používajú tabuľky pre cesty súborového systému a sieťové domény. Tím môže vo vlastnej konfigurácii pridávať alebo prepisovať jednotlivé položky a automaticky dediť zmeny všetkých ostatných položiek zo základnej konfigurácie organizácie:
Správcovia môžu cez requirements.toml poskytnúť aj spravované požiadavky(otvorí sa v novom okne), ktoré obmedzia možnosti konfigurácie používateľov. Tieto požiadavky môžu pochádzať z viacerých zdrojov vrátane systémových súborov a politiky poskytovanej z cloudu. Bežným prípadom použitia je nastavenie allowed_permission_profiles na obmedzenie množiny profilov oprávnení, z ktorých si môže podnikový používateľ vybrať. Správca by napríklad mohol určiť tieto cloudové požiadavky:
Cloudové požiadavky by mali prednosť pred systémovým súborom požiadaviek /etc/codex/requirements.toml, takže položka v tomto súbore nemôže prepísať vyššie uvedené explicitné nastavenie ":danger-full-access" = false. Ak :workspace zostane neurčené, túto položku môže doplniť iná vrstva požiadaviek. Profily, ktorých položky majú hodnotu false alebo chýbajú vo výslednej zlúčenej tabuľke, nie sú dostupné.
Toto oddelenie umožňuje organizáciám vynucovať obmedzenia, zatiaľ čo používatelia si v ich medziach prispôsobujú konfiguráciu. Výsledné profily oprávnení môže používať harness alebo sa dajú uplatniť priamo na príkaz, ako uvidíme ďalej.
Codex CLI poskytuje príkaz sandbox, ktorý uľahčuje spustenie ľubovoľného príkazu s profilom oprávnení definovaným v konfigurácii Codexu. Bežne sa používa na otestovanie profilu a overenie, či sandbox zabraňuje správaniu, ktoré má blokovať.
Nasledujúci príkaz sa napríklad pokúša nastaviť VS Code tak, aby pri ukladaní spúšťal škodlivý automatický formátovač. Ak .vscode už existuje, vyššie definovaný profil dev by mal tento zápis zablokovať, pretože daný adresár je iba na čítanie (codex sandbox predvolene považuje cwd za koreň pracovného priestoru):
V systéme macOS to skutočne zlyhá s hlásením:
Príkaz codex sandbox sprístupňuje mechanizmus sandboxu Codexu nezávisle od relácie agenta. Rovnaký konfiguračný jazyk a vynucovanie špecifické pre platformu môžete použiť na obmedzenie príkazov spúšťaných vlastnými nástrojmi.
Pri serveri MCP používajúcom stdio, ktorý je nakonfigurovaný v config.toml, sa harness Codexu nepokúša izolovať príkaz na spustenie servera v sandboxe. Codex nedokáže spoľahlivo odvodiť, ktoré súbory alebo sieťové služby tento server potrebuje, takže uplatnenie predvoleného profilu sandboxu by mohlo narušiť inak platnú konfiguráciu.
Napríklad štandardný spôsob konfigurácie servera MCP @modelcontextprotocol/server-memory(otvorí sa v novom okne) na použitie s Codexom je takýto:
Keďže tento príkaz npx beží mimo sandboxu, môže zapisovať súbory a odosielať sieťové požiadavky s rovnakými oprávneniami ako používateľ, ktorý spúšťa Codex. Ide o príliš široké oprávnenia. Na ich obmedzenie môžeme definovať profil oprávnení s názvom memory-mcp a pôvodný príkaz npx spustiť cez codex sandbox --permission-profile memory-mcp. Tým obmedzíme, kam môže server zapisovať, a zabránime mu v prístupe k sieti:
Pred spustením servera vytvorte jeho dátový adresár a do vyrovnávacej pamäte npm uložte balík v pevne určenej verzii. Vďaka tomu môže npx --offline spustiť server s profilom, ktorý zakazuje prístup k sieti:
Keď je balík vo vyrovnávacej pamäti, Codex môže spustiť pamäťový server bez prístupu k sieti, pričom zápis je obmedzený na vyrovnávaciu pamäť npm a dátový adresár servera.
Implementácia sandboxu prevádza profil oprávnení na obmedzenia vynucované operačným systémom. Základná logika spracovania požiadaviek a uplatňovania politiky sieťového proxy servera je spoločná pre všetky tri hlavné operačné systémy. Nastavenie proxy servera a jeho integrácia so sandboxom sú však špecifické pre každý OS. Najprv sa pozrieme na spoločný proxy server a potom na implementácie pre macOS, Linux a Windows.
Na vynútenie sieťových obmedzení profilu oprávnení harness spustí sieťový proxy server a nakonfiguruje sandbox tak, aby povoľoval pripojenia k nemu, no blokoval priame pripojenia k externým hostiteľom. Proxy server porovná každú požiadavku s pravidlami domén v profile a rozhodne, či ju postúpi ďalej.
V repozitári Codexu je sieťový proxy server implementovaný v balíku codex-network-proxy(otvorí sa v novom okne), ktorý harness používa ako knižnicu. Dá sa však zostaviť aj ako samostatný nástroj CLI(otvorí sa v novom okne). Keď je codex-network-proxy zapnutý, predvolene spustí proxy server HTTP aj SOCKS5. Adresy týchto proxy serverov sa procesu spustenému sandboxom odovzdajú cez premenné prostredia. Okrem štandardných premenných prostredia, ako sú HTTP_PROXY, HTTPS_PROXY a ALL_PROXY, sa vkladá aj viacero známych premenných prostredia špecifických pre aplikácie(otvorí sa v novom okne) (napríklad PIP_PROXY). Nie všetky programy však tieto premenné prostredia rešpektujú. Ak sa program pokúsi o priame pripojenie k externému hostiteľovi, obmedzenia sandboxu v operačnom systéme ho zablokujú, ako je opísané nižšie v častiach venovaných jednotlivým platformám.
Sieťový proxy server zodpovedá za uplatňovanie sieťových obmedzení definovaných v profile oprávnení. Napríklad profil dev uvedený vyššie povoľuje požiadavky na *.openai.com a explicitne zakazuje požiadavky na evil.example. Keď požiadavka smeruje na doménu, ktorá nezodpovedá žiadnemu povoľujúcemu ani zakazujúcemu pravidlu, proxy server ju môže pozastaviť a odovzdať harness-u na schválenie. Podobne ako v príklade s príkazom shellu môže Codex požiadať priamo používateľa alebo požiadavku presmerovať na automatické posúdenie(otvorí sa v novom okne). Po prijatí rozhodnutia proxy server buď povolí pokračovanie požiadavky, alebo ju zamietne s chybovou odpoveďou.
Na poradí tu záleží, pretože aj samotné vyhľadanie v DNS môže prezradiť informácie zakódované v názve hostiteľa. Proxy server preto preloží požadovaný názov hostiteľa na adresu až po overení, že je povolený alebo schválený. Upozorňujeme, že široké pravidlá so zástupnými znakmi alebo prístup k službám DNS môžu stále umožniť odcudzenie údajov cez DNS.
V systéme macOS používa Codex Seatbelt(otvorí sa v novom okne), mechanizmus sandboxu od Apple, ktorého obmedzenia vynucuje jadro. Politiky Seatbelt sa zapisujú v jazyku Sandbox Profile Language (SBPL), ktorý vychádza zo Scheme a slúži na vyjadrenie obmedzení sandboxu. Codex vyvoláva Seatbelt prostredníctvom príkazu /usr/bin/sandbox-exec v systéme macOS. Podobne ako codex sandbox prijíma voľby opisujúce sandbox, po ktorých nasleduje príkaz na spustenie:
PROFILE je reťazec v jazyku SBPL obsahujúci položky, ktoré konfigurujú sandbox. Napríklad nasledujúci úryvok SBPL v rámci politiky sandboxu povoľuje čítanie aj zápis do /dev/null a /dev/zero:
Keď je pri spustení sandboxu zapnutý sieťový proxy server, do profilu sa vložia pravidlá podobné nasledujúcim, aby sa pripojenia obmedzili na príslušné lokálne porty:
Základný profil Codexu sa začína nastavením (deny default), takže odchádzajúce pripojenia zostávajú zablokované, pokiaľ nie sú explicitne povolené.
SBPL môže obsahovať aj zástupné symboly využívajúce (param):
Tie sa vyplnia pomocou volieb -Dkey=value odovzdaných príkazu sandbox-exec.
Pri implementácii vlastného API sandboxu Codex zostavuje zoznam argumentov(otvorí sa v novom okne) pre sandbox-exec zo základnej politiky(otvorí sa v novom okne). Následne ju upravuje pomocou permission_profile a ďalšieho kontextu, čím vytvorí úplný profil Seatbelt. Výsledný profil a sprievodné argumenty -D konfigurujú obmedzenia vynucované mechanizmom Seatbelt, zatiaľ čo sieťový proxy server vynucuje ďalšie sieťové pravidlá. Po zostavení úplného zoznamu argumentov je vyvolanie sandbox-exec jednoduché.
Generovanie správneho SBPL je náročné, pretože Apple neposkytuje dokumentáciu jazyka na použitie tretími stranami. V man sandbox-exec sa dokonca uvádza The sandbox-exec command is DEPRECATED (za zastaranú je označená aj knižničná funkcia sandbox_init() dokumentovaná v man 3 sandbox_init). Napriek upozorneniu na zastaranosť macOS stále dodáva profily Seatbelt v /usr/share/sandbox a softvér tretích strán vrátane Google Chrome a Chromium(otvorí sa v novom okne) sa na Seatbelt naďalej spolieha. Preto plánujeme Seatbelt používať aj v dohľadnej budúcnosti.
Na vytvorenie sandboxu v Linuxe používa Codex kombináciu bubblewrap(otvorí sa v novom okne) (bwrap), nástroja príkazového riadka na vytváranie izolovaných prostredí, a seccomp-bpf(otvorí sa v novom okne), mechanizmu jadra Linuxu na filtrovanie systémových volaní. Nastavenie koordinuje interný pomocný nástroj s názvom codex-linux-sandbox. Podobne ako sandbox-exec v macOS prijíma konfiguráciu sandboxu, po ktorej nasleduje príkaz na spustenie:
Keď je potrebná izolácia súborového systému alebo smerovanie cez proxy server, codex-linux-sandbox vyvolá bwrap na vytvorenie počiatočného prostredia sandboxu. bwrap v ňom potom spustí codex-linux-sandbox --apply-seccomp-then-exec. Toto druhé volanie pomocou seccomp-bpf uplatní ďalšie obmedzenia pred spustením príkazu používateľa.
Na vytvorenie počiatočného prostredia sandboxu Codex používa bubblewrap, ktorý v samostatnom mennom priestore pripojení vytvorí pohľad na súborový systém zodpovedajúci pravidlám súborového systému v profile oprávnení. Keďže ide o základ implementácie sandboxu, Codex dodáva vlastnú kópiu bwrap pre prípad, že používateľ nemá nainštalovanú svoju. Ak je však v PATH dostupná kompatibilná inštalácia, uprednostní ju(otvorí sa v novom okne) pri spúšťaní bwrap(otvorí sa v novom okne). Z praxe vieme, že niektoré distribúcie Linuxu predvolene zakazujú prístup k používateľským menným priestorom(otvorí sa v novom okne), no systémovému bwrap udeľujú výnimku.
Podobne ako sandbox-exec, aj bwrap prijíma konfiguráciu sandboxu, po ktorej nasleduje príkaz na spustenie v sandboxe. Namiesto vlastného konfiguračného jazyka, ako je SBPL, používa bwrap na konfiguráciu jednotlivé prepínače. Codex používa na vytvorenie pohľadu na súborový systém tieto voľby:
--bindna určenie súboru alebo adresára s povoleným zápisom--ro-bindna určenie súboru alebo adresára iba na čítanie--perms 000 --tmpfs DIR --remount-ro DIRna zákaz prístupu kDIR--perms 000 --ro-bind-data FD FILEna zákaz prístupu kFILE(kdeFDje otvorený deskriptor súboru/dev/null)
Aby Codex pomocou týchto volieb uplatnil zakazujúce vzory glob, pred spustením každého príkazu ich rozvinie na konkrétne cesty. Nové cesty zodpovedajúce vzoru sa do obmedzení sandboxu daného príkazu nepridávajú automaticky.
Codex určuje aj voľby ako --unshare-ipc a --unshare-pid, aby sandbox nemal prístup k iným typom prostriedkov na hostiteľovi. Bubblewrap teda ovplyvňuje viac než len viditeľnosť súborov.
Pri použití bubblewrap Codex odovzdáva --unshare-net vždy, keď je sieť zakázaná alebo pripojenia musia prechádzať cez sieťový proxy server. Tým sa pre sandbox vytvorí nový sieťový menný priestor. Potom pomocou seccomp-bpf uplatníme ďalšie obmedzenia na sieťové systémové volania a rodiny soketov dostupné príkazu.
Konkrétne používame balík seccompiler(otvorí sa v novom okne) na dynamickú kompiláciu programu BPF podľa požadovaných filtrov(otvorí sa v novom okne) a jeho uplatnenie na spúšťací proces v sandboxe, aby obmedzenia zdedil celý strom procesov. Preto bwrap nespúšťa príkaz používateľa, ale spúšťač codex-linux-sandbox s vlastnými konfiguračnými argumentmi, po ktorých nasleduje príkaz používateľa:
Aby bolo možné uplatniť filtre seccomp bez zvýšených oprávnení, spúšťač nastaví linuxový príznak no_new_privs.(otvorí sa v novom okne) Tento príznak dedia dcérske procesy a bráni im získať ďalšie oprávnenia pri spustení iného programu, napríklad spustiteľného súboru so setuid.
Filtre seccomp závisia od konfigurácie siete. Keď je prístup k sieti zakázaný, blokujeme viacero sieťových systémových volaní, napríklad connect(2) a bind(2). Ak je však v sandboxe povolený sieťový proxy server, povoľujeme IP sokety, aby bol dostupný počúvajúci soket TCP vytvorený cez codex-linux-sandbox. Vytváranie samostatných soketov domény Unix predvolene blokujeme, pretože by mohli nechtiac umožniť prístup k prostriedkom hostiteľa.
Keď si konfigurácia sandboxu vyžaduje sieťový proxy server, harness Codexu vytvorí jednu jeho inštanciu, ktorú možno opakovane použiť pri viacerých volaniach codex-linux-sandbox v rámci toho istého vlákna Codexu. Každý sandbox potrebuje spôsob, ako sa zo svojho izolovaného sieťového menného priestoru dostať k tomuto zdieľanému proxy serveru. Codex v tomto mennom priestore poskytne počúvajúci soket TCP na spätnej slučke a zabezpečí, aby proces mimo sandboxu prijímal jeho pripojenia a sprostredkúval ich proxy serveru.
Nasledujúce diagramy znázorňujú toto usporiadanie pre jeden koncový bod proxy servera. Posledný diagram zobrazuje jedno pripojenie, ktoré ním prechádza. Pred spustením bubblewrap vytvorí codex-linux-sandbox pár soketov Unix slúžiaci ako riadiaci kanál a rozvetví sa. Dcérsky proces spustí run_host_bridge() a čaká, kým cez tento kanál prijme deskriptor počúvajúceho soketu:
V tomto príklade rodičovský proces pomocou exec nahradí svoj programový obraz programom bwrap. Ten nastaví sandbox a spustí v ňom codex-linux-sandbox --apply-seccomp-then-exec, pričom mu odovzdá deskriptor riadiaceho kanála:
Druhé volanie codex-linux-sandbox vytvorí v sieťovom mennom priestore sandboxu počúvajúci soket TCP na spätnej slučke a cez soket odovzdá jeho deskriptor. Počúvajúci soket zostáva priradený k sieťovému mennému priestoru sandboxu. Dcérsky proces, ktorý zostal mimo sandboxu, tak môže prijímať pripojenia od programov v sandboxe a zároveň otvárať nadväzujúce pripojenia v sieťovom mennom priestore hostiteľa. Po odovzdaní oba procesy zatvoria svoje deskriptory riadiaceho kanála a proces v sandboxe zatvorí svoju kópiu počúvajúceho soketu.
Keď je počúvajúci soket TCP pripravený, proces v sandboxe nastaví príslušnú hodnotu pre HTTP_PROXY(otvorí sa v novom okne) a súvisiace premenné prostredia tak, aby odkazovali na tento soket. Potom pred rozvetvením procesu a vykonaním príkazu používateľa uplatní seccomp:
Proces mimo sandboxu udržiava počúvajúci soket otvorený. Pre každé prijaté pripojenie otvorí pripojenie k nakonfigurovanému proxy serveru a prenáša údaje oboma smermi.
Tento doplnkový mechanizmus poskytuje príkazu vlastný sieťový menný priestor vrátane samostatného rozhrania spätnej slučky. V systéme macOS umožňuje Seatbelt príkazu pripojiť sa priamo k určeným portom na rozhraní spätnej slučky hostiteľa. V Linuxe sa príkaz namiesto toho pripája k počúvajúcemu soketu vo svojom izolovanom mennom priestore a proces mimo sandboxu sprostredkúva tieto pripojenia nakonfigurovanému proxy serveru. Odovzdanie deskriptora umožňuje toto pripojenie bez toho, aby príkazu sprístupnilo sieťový menný priestor hostiteľa.
Začiatkom tohto roka sme implementovali sandbox pre Windows a napísali sme o našej práci na ňom. Odvtedy Microsoft vydal knižnicu s názvom MXC spolu s novými funkciami na izoláciu procesov v operačnom systéme Windows. V súčasnosti nahrádzame náš existujúci sandbox novým, ktorý využíva knižnicu MXC.
MXC (Microsoft eXecution Container) je systém na spúšťanie kódu v sandboxe(otvorí sa v novom okne) od Microsoftu, ktorý podporuje viaceré backendy izolácie v systémoch Windows, Linux a macOS. Codex na kompatibilných zariadeniach s Windows podporuje sandbox založený na MXC, ktorý pomocou natívnej izolácie procesov obmedzuje príkazy v existujúcom prostredí používateľa.
Na MXC prechádzame s cieľom zlepšiť bezpečnosť a použiteľnosť a zároveň odstrániť niekoľko nedostatkov nášho existujúceho sandboxu pre Windows:
Potreba zvýšených oprávnení alebo prístupu správcu na nastavenie sandboxu
Náročné a pomalé operácie kontroly a nastavovania ACL
Trvalé zmeny na hostiteľskom počítači po nastavení sandboxu vrátane
zoznamov ACL
pravidiel firewallu
používateľských účtov sandboxu
súborov riadiacej vrstvy
MXC poskytuje konfiguračnú schému JSON(otvorí sa v novom okne). Codex používa MXC SDK(otvorí sa v novom okne) na zostavenie požiadavky na spustenie podľa tejto schémy, ktorá obsahuje príkaz, pracovný adresár, prostredie a oprávnenia. Tieto oprávnenia pokrývajú prístup k súborovému systému a sieti, ako aj k prostriedkom Windows, napríklad k pracovnej ploche a schránke.
Codex pri viacerých ochranných mechanizmoch používa pevné nastavenia, aby vyvážil kompatibilitu a bezpečnosť. Povoľuje čítanie registra a zachováva prístup k Win32k a pracovnej ploche, ktorý PowerShell potrebuje pri spustení. Prístup k schránke, vkladanie vstupu a ovládanie pracovnej plochy a systémových nastavení sú zakázané. MXC navyše nemôže ako náhradné riešenie meniť oprávnenia súborového systému hostiteľa.
Codex prevádza pravidlá súborového systému a siete z profilu oprávnení do konfigurácie MXC. Pri použití predchádzajúceho profilu dev a za týchto predpokladov:
C:\,D:\aZ:\sú jediné lokálne disky počítača.Koreň pracovného priestoru aj pracovný adresár sú
C:\work\demo.Domovský adresár používateľa je
D:\Users\dev, takže~/build-cachesa vyhodnotí akoD:\Users\dev\build-cache.Zakazujúcemu vzoru glob zodpovedajú iba
C:\work\demo\config\dev.envaC:\work\demo\config\prod.env.
Zodpovedajúce nastavenia MXC by zahŕňali:
Politika súborového systému MXC predvolene zakazuje prístup. Codex preto pridáva oprávnenia iba na čítanie pre korene lokálnych diskov, aby zabezpečil široký prístup na čítanie povolený týmto profilom. Tieto oprávnenia platia rekurzívne v medziach existujúcich oprávnení používateľa v OS.
Je tu však jedna zvláštnosť: oprávnenia na zápis pre korene diskov neplatia rekurzívne, preto ich Codex rozširuje aj na existujúce položky priamo v koreni disku.
Konkrétnejšie cesty majú prednosť pred oprávneniami nadradených ciest, takže C:\work\demo môže povoľovať zápis pod C:\, ktorý je iba na čítanie, zatiaľ čo C:\work\demo\.git zostáva iba na čítanie.
Keď rôzne zápisy cesty alebo aliasy cez symbolické odkazy či spojenia adresárov odkazujú na tú istú cestu, MXC uplatní prísnejšie oprávnenie: zákaz má prednosť pred čítaním a čítanie má prednosť pred čítaním a zápisom.
MXC prijíma iba konkrétne zakázané cesty, preto Codex pred spustením rozvinie zakazujúce vzory glob na zodpovedajúce súbory a adresáre. Nové cesty zodpovedajúce vzoru glob sa počas behu príkazu nepridávajú automaticky.
Pravidlá domén, napríklad *.openai.com, vynucuje spoločný sieťový proxy server Codexu opísaný vyššie. Codex spúšťa tento proxy server mimo sandboxu a jeho adresy odovzdáva príkazu cez tie isté štandardné premenné prostredia *_PROXY, ktoré sme spomenuli vyššie. MXC blokuje priame externé pripojenia, no povoľuje pripojenia cez spätnú slučku hostiteľa vrátane prístupu k proxy serveru. Ostatné lokálne služby zostávajú dostupné.
V systémoch macOS, Linux a Windows používa harness rovnaké API sandboxu na spúšťanie príkazov s profilom oprávnení. Implementácie špecifické pre jednotlivé platformy zabezpečujú nastavenie potrebné na uplatnenie týchto obmedzení.
Písanie a spúšťanie kódu poskytuje agentom flexibilný spôsob riešenia problémov aj mimo vývoja softvéru. Sandbox Codexu im umožňuje využívať túto schopnosť v existujúcom prostredí používateľa s explicitnými obmedzeniami prístupu k súborovému systému a sieti. Je to opätovne použiteľný základný prvok harness-u a príkaz codex sandbox ho sprístupňuje nástrojom, ktoré si vytvoríte sami.
S tým, ako agenti preberajú viac úloh, chceme umožniť praktické využitie sandboxov vo viacerých nástrojoch a prostrediach. To znamená zjednodušovať konfiguráciu oprávnení a využívať lepšie ochranné mechanizmy operačných systémov hneď, ako budú dostupné. Naším cieľom je rozširovať možnosti agentov a zároveň ponechať ľuďom kontrolu nad tým, k čomu majú agenti prístup.


