Ing njero sandbox Codex
Carane Codex nglakokake prentah ing mesin panjenengan kanthi wates sing panjenengan atur.
Ing OpenAI, kita nggunakake pendekatan pertahanan berlapis(mbukak ing jendhela anyar) kanggo ngamanake agen. Senajan investasi ing pelatihan lan penyelarasan dadi dhasar upaya iki, kita uga ngetrapake fitur ing kerangka panglakon agen kita, Codex(mbukak ing jendhela anyar), kanggo menehi pangayoman tambahan. Amarga salah siji tumindak Codex sing paling kerep (lan bisa mbebayani) yaiku nglakokake prentah ing komputer panjenengan, kita nggawe sandbox Codex supaya Codex bisa makarya ing lingkungan sing wis ana kanthi wates sistem file lan jaringan sing panjenengan atur.
Sawijining (mbukak ing jendhela anyar)sandbox(mbukak ing jendhela anyar) matesi apa wae sing bisa diakses program nalika mlaku. Kanggo tugas nata foto, panjenengan bisa ngatur sandbox Codex supaya prentah bisa maca lan ngowahi file ing ~/Pictures nanging akses jaringan diblokir supaya ora bisa ngunggah. Kanggo mriksa kode, panjenengan bisa ngidini akses menyang dokumentasi online nanging file sumber tetep mung bisa diwaca. Pangguna ngatur sandbox Codex liwat (mbukak ing jendhela anyar)profil idin(mbukak ing jendhela anyar), sing nemtokake watesan sistem file lan jaringan kanggo sesi Codex.
Ing artikel iki, kita bakal miwiti saka tetimbangan ing setelan gawan sandbox Codex, banjur nerangake rancangane lan carane kerangka panglakon nggunakake sandbox kanggo nglakokake prentah. Kita bakal nuduhake carane pangguna pungkasan lan perusahaan nyetel idin miturut kabutuhane, lan carane pangembang nggunakake maneh sandbox ing pirantine dhewe. Pungkasan, kita bakal nliti carane watesan iki ditrapake ing macOS, Linux, lan Windows.
Ing Codex, prinsip kita yaiku nemtokake setelan gawan sandbox sing ngati-ati nanging isih ngidini pakaryan sing migunani. Contone, yen gudang kode Git dadi root ruang kerja, profil idin bawaan :workspace:
Ngidini nulis ing ruang kerja, nanging direktori kayata
.gitlan.codextetep mung bisa diwaca. Iki ngidini Codex nyunting kode sumber tanpa njaluk idin kanggo saben owah-owahan, nanging nyegah owah-owahan langsung ing.codex/config.tomlutawa hook Git ing.git/hooks.Ngidini akses maca sistem file sing amba, manut idin OS sing wis diduweni pangguna. Kompiler, runtime, lan piranti build gumantung marang SDK, pustaka, lan konfigurasi ing njaba gudang kode. Yen akses maca diwatesi mung ing ruang kerja, akeh alur kerja umum bakal ora bisa mlaku. Nanging, iki uga ateges file sensitif ing papan liya ing mesin bisa uga tetep diwaca (kayata file konfigurasi sing ngemot kunci API).
Mateni akses jaringan. Iki mblokir unggahan langsung menyang layanan eksternal, kalebu upaya nyolong data sing bisa diwaca prentah. Iki uga nyegah operasi sing sah kayata ngundhuh dependensi, sing mbutuhake akses tambahan.
Watesan iki nyegah akeh jinis tumindak ala, nanging tumindak sing mbebayani isih bisa kedadeyan. Contone, agen bisa nyisipake kode ala menyang paket sing diinstal sacara lokal kayata node_modules/prettier. Owah-owahan kaya mangkono bisa ora katon ing git status amarga node_modules kerep diabaikan dening Git. Yen editor pangguna nglakokake salinan Prettier kasebut nalika nyimpen, mung nyimpen file wae bisa nglakokake kode ala ing njaba sandbox Codex. Mula kita nggunakake pendekatan pertahanan berlapis: sandbox matesi apa sing bisa diakses prentah, dene pelatihan lan penyelarasan mbantu model nggunakake akses kasebut manut kekarepane pangguna.
Kanggo pandhuan nyetel idin sandbox lan nggabungake karo pangayoman liyane ing lingkungan perusahaan, delengen Pandhuan praktis keamanan Codex(mbukak ing jendhela anyar).
Mesin virtual lan kontainer(mbukak ing jendhela anyar) yaiku rong mekanisme populer kanggo sandboxing, nanging kita nggunakake pendekatan sing beda kanggo sandbox Codex. Tinimbang mindhah komputasi menyang lingkungan kapisah kanggo menehi isolasi, Codex nggunakake fasilitas sandboxing saben platform kanggo matesi prentah sing mlaku ing lingkungan pangguna sing wis ana.
Kanggo akeh pangembang, laptop dadi lingkungan pangembangan sing wis ditata dhewe lan bisa diowahi kapan wae. Nggawe maneh lingkungan kasebut ing kontainer Docker bisa mbutuhake upaya, lan sawetara alur kerja isih gumantung marang piranti sing mlaku ing host.
Contone, bayangna nggunakake Codex kanggo ngembangake aplikasi iOS ing Mac. Yen panjenengan milih ngisolasi Codex kanthi nglakokake ing Docker, Codex ora bisa nglakokake rangkaian piranti build iOS sing dumadi saka program eksekusi native Mac, utawa mbukak simulator iPhone kanggo nglakokake kode. Alur kerja adhedhasar Docker bisa masrahake build lan operasi simulator menyang host Mac, nanging operasi kasebut bakal mlaku ing njaba sandbox kontainer lan mbutuhake watesan dhewe. Kanggo Codex, kita luwih milih njaga kesederhanaan kanthi nandur modal gedhe ing sandboxing khusus OS, supaya Codex bisa mlaku ing lingkungan sing paling cocog kanggo tugas sing lagi ditangani.
Kerangka panglakon nyedhiyakake mekanisme sandboxing khusus OS iki liwat API sing padha ing macOS, Windows, lan Linux. API iki nampa prentah lan profil idin. Yen profil idin ngidini akses jaringan winates, pihak sing manggil kudu nyedhiyakake proksi jaringan kanggo ngetrapake watesan kasebut:
Fungsi iki miwiti proses ing sandbox lan mbalekake handle Child sing bisa digunakake kerangka panglakon kanggo ngenteni proses rampung. Saben proses anak marisi watesan sandbox saka induke, mula watesan kasebut ditrapake ing kabeh wit proses sing diwiwiti prentah, kalebu turunan sing isih mlaku sawise proses asli rampung.
Diagram ing ngisor iki nuduhake gegandhengan antarane komponen kasebut, wiwit konfigurasi nganti nglakokake prentah ing sandbox. Bagean sabanjure nerangake saben tahap.

Kaya sing diterangake ing Ngudhari Siklus Agen Codex, kerangka panglakon Codex tanggung jawab nglakokake panggilan piranti sing diasilake model. Kanggo tugas pangodean, piranti sing paling kerep digunakake yaiku piranti shell, sing nglakokake prentah kaya pangguna ing shell interaktif kayata Bash. Ing kene kita bakal nliti piranti shell sing dilakokake sepisan (mbukak ing jendhela anyar)exec_command(mbukak ing jendhela anyar) kanggo shell(mbukak ing jendhela anyar) kanggo nggambarake carane kerangka panglakon nggunakake sandbox supaya entuk pangayoman sing dikarepake.
Iki versi prasaja saka carane panggilan piranti exec_command ditindakake kerangka panglakon Codex tanpa sandboxing:
Kanggo ngisolasi prentah ing sandbox, kerangka panglakon ngganti panggilan subprocess.Popen() nganggo spawn_command_under_sandbox(). Kerangka panglakon nyedhiyakake profil idin lan, yen dibutuhake, proksi jaringan:
Piranti exec_command uga ngidini model njaluk idin sing beda kanggo prentah tartamtu, nanging kerangka panglakon sing nemtokake apa panjaluk kasebut dikabulake:
Nalika use_default ditemtokake, kerangka panglakon nggunakake konfigurasi sandbox gawan kanggo giliran kasebut. with_additional_permissions njaluk akses luwih amba ing sandbox, dene require_escalated njaluk eksekusi ing njabane. Kerangka panglakon ngevaluasi panjaluk adhedhasar preferensi pangguna sadurunge nglakokake prentah. (Contone, Codex bisa njaluk persetujuan langsung saka pangguna, utawa ngarahake panjaluk menyang pamriksan otomatis(mbukak ing jendhela anyar).) Yen eksekusi diidini, Codex bakal menehi permission_profile lan network_proxy sing cocog marang perform_exec_command_with_sandboxing(), bebarengan karo argumen prentah saka ExecCommandToolCall asli.
Piranti shell minangka pangguna utama spawn_command_under_sandbox(), lan kerangka panglakon uga nggunakake maneh infrastruktur sandboxing kanggo operasi kayata maca lan ngowahi file lokal. Panggunaan maneh iki ora mung ing kerangka panglakon: prentah codex sandbox ngidini panjenengan nggabungake eksekusi prentah ing sandbox menyang piranti panjenengan dhewe, kaya sing bakal kita deleng mengko. Sabanjure, kita bakal ndeleng carane profil idin ditemtokake.
Profil idin sing dijenengi ngidini panjenengan nggunakake maneh watesan sistem file lan jaringan sing padha ing pirang-pirang proyek. Panjenengan bisa nemtokake profil dhewe ing bagean [permissions] ing config.toml. Contone, konfigurasi ing ngisor iki nemtokake profil jenenge dev sing ngluwihi(mbukak ing jendhela anyar) profil bawaan :workspace:
Profil dev nambah akses nulis menyang ~/build-cache lan menehi watesan tambahan marang file ing ruang kerja. Entri sistem file bisa menehi akses mung maca (read), akses maca lan nulis (write), utawa mblokir akses sakabehe (deny).
Tabel :workspace_roots ngidini panjenengan nemtokake aturan kanggo path sing relatif marang root ruang kerja proyek. Kanthi gawan, Codex CLI nggunakake direktori kerjane minangka siji-sijine root ruang kerja, dene aplikasi desktop ChatGPT nggunakake folder sumber proyek. Codex ngetrapake saben aturan ing saben root, mula entri .vscode ing dev ndadekake direktori .vscode ing saben root mung bisa diwaca.
Saliyane aturane dhewe, dev marisi pangayoman ing ngisor iki saka :workspace:
Kanggo ngatur jaringan sandbox ing Codex, umume ana telung pilihan:
Mateni kabeh akses jaringan (gawan kanggo profil
:workspace)Ngaktifake akses jaringan langsung lan lengkap (gawan kanggo profil
:danger-full-access)Matesi akses jaringan liwat proksi, sing nemtokake apa sing kena liwat adhedhasar profil idin
Kanggo menehi akses jaringan langsung marang dev, setel permissions.dev.network.enabled = true ing tingkat paling ndhuwur config.toml. Iki menehi akses jaringan lengkap nalika proksi jaringan dipateni.
Kanggo matesi dev menyang kumpulan domain tartamtu, aktifake proksi jaringan lan atur aturan domaine:
Aturan domain ndhukung jeneng persis lan pola wildcard, kanthi aturan penolakan eksplisit luwih diutamakake tinimbang aturan sing ngidini. Panjaluk menyang domain liyane mbutuhake persetujuan utawa bakal diblokir, kaya sing diterangake ing Proksi jaringan ing ngisor iki.
Pangguna individu bisa ngatur setelan gawan kanggo kabeh proyek lan ngganti kanggo proyek tartamtu sing dipercaya. Administrator perusahaan uga bisa kepengin ngatur setelan gawan kanggo panggunane lan matesi setelan apa sing bisa diowahi. Codex ndhukung loro-lorone liwat konfigurasi berlapis lan syarat sing dikelola.
Kaya sing diterangake ing Urutan prioritas konfigurasi,(mbukak ing jendhela anyar) Codex nggabungake setelan saka pirang-pirang file config.toml. Tabel digabungake kanthi rekursif, lan sumber sing prioritas luwih dhuwur diutamakake yen ana nilai sing bentrok. Array diganti sakabehe.
Mula profil idin nggunakake tabel kanggo path sistem file lan domain jaringan. Tim bisa nambah utawa ngganti entri siji-siji ing konfigurasine dhewe lan otomatis marisi owah-owahan kabeh entri liyane saka konfigurasi dhasar organisasi:
Administrator uga bisa nyedhiyakake syarat sing dikelola(mbukak ing jendhela anyar) liwat requirements.toml kanggo matesi pilihan konfigurasi pangguna. Syarat iki bisa asale saka pirang-pirang sumber, kalebu file sistem lan kabijakan saka cloud. Salah siji panggunaan sing umum yaiku nemtokake allowed_permission_profiles kanggo matesi kumpulan profil idin sing bisa dipilih pangguna perusahaan. Contone, administrator bisa nemtokake syarat cloud iki:
Syarat saka cloud luwih diutamakake tinimbang file syarat sistem ing /etc/codex/requirements.toml, mula entri ing file kasebut ora bisa ngungkuli setelan eksplisit ":danger-full-access" = false ing ndhuwur. Yen :workspace ora ditemtokake, lapisan syarat liyane bisa nyedhiyakake entri kasebut. Profil sing entrine false utawa ora ana ing tabel gabungan pungkasan ora bisa digunakake.
Pamisahan iki ngidini organisasi ngetrapake watesan, dene pangguna bisa nyetel konfigurasine sajrone watesan kasebut. Profil idin sing diasilake bisa digunakake kerangka panglakon utawa ditrapake langsung marang prentah, kaya sing bakal kita deleng sabanjure.
Codex CLI nyedhiyakake prentah sandbox kanggo nggampangake nglakokake prentah apa wae kanthi profil idin sing ditemtokake ing konfigurasi Codex. Iki lumrah digunakake kanggo nguji profil, supaya bisa mesthekake yen sandbox nyegah tumindak sing pancen dirancang kanggo diblokir.
Contone, prentah ing ngisor iki nyoba ngatur VS Code supaya nglakokake pemformat otomatis sing ala nalika nyimpen. Yen .vscode wis ana, profil dev sing ditemtokake ing ndhuwur kudune mblokir panulisan iki amarga direktori kasebut mung bisa diwaca (kanthi gawan, codex sandbox nganggep cwd minangka root ruang kerja):
Pancen, ing macOS iki gagal kanthi pesen:
Prentah codex sandbox ndadekake mekanisme sandboxing Codex bisa digunakake tanpa gumantung marang sesi agen. Panjenengan bisa nggunakake basa konfigurasi sing padha lan panerapane ing saben platform kanggo matesi prentah sing dilakokake piranti panjenengan dhewe.
Kanggo server MCP stdio sing dikonfigurasi ing config.toml, kerangka panglakon Codex ora nyoba ngisolasi prentah sing digunakake kanggo miwiti server ing sandbox. Codex ora bisa mesthekake file utawa layanan jaringan apa sing dibutuhake server kasebut, mula ngetrapake profil sandbox gawan bisa ndadekake konfigurasi sing sakmesthine sah dadi ora bisa mlaku.
Contone, cara standar kanggo ngatur server MCP @modelcontextprotocol/server-memory(mbukak ing jendhela anyar) supaya bisa digunakake karo Codex yaiku kaya mangkene:
Amarga prentah npx iki mlaku tanpa sandbox, prentah bisa nulis file lan nggawe panjaluk jaringan kanthi idin sing padha karo pangguna sing nglakokake Codex, saengga aksese jembar banget. Kanggo matesi akses kasebut, kita bisa nemtokake profil idin jenenge memory-mcp, banjur mbungkus prentah npx asli nganggo codex sandbox --permission-profile memory-mcp kanggo matesi papan sing bisa ditulisi server lan nyegah akses jaringan:
Sadurunge miwiti server, gawe direktori datane lan isenana cache npm nganggo paket sing versine wis dipatok. Kanthi mangkono, npx --offline bisa nglakokake server nganggo profil sing mateni akses jaringan:
Sawise paket ana ing cache, Codex bisa miwiti server memori tanpa akses jaringan, kanthi panulisan diwatesi mung ing cache npm lan direktori data server.
Implementasi sandbox ngowahi profil idin dadi watesan sing ditrapake sistem operasi. Logika inti kanggo nangani panjaluk lan kabijakan proksi jaringan dienggo bareng ing telung sistem operasi utama, dene panyiapan proksi lan integrasine karo sandbox beda-beda miturut OS. Kita bakal nliti proksi bebarengan dhisik, banjur implementasi kanggo macOS, Linux, lan Windows.
Kanggo ngetrapake watesan jaringan ing profil idin, kerangka panglakon miwiti proksi jaringan lan ngatur sandbox supaya ngidini sambungan menyang proksi, nanging mblokir sambungan langsung menyang host eksternal. Proksi mriksa saben panjaluk adhedhasar aturan domain ing profil kanggo nemtokake apa panjaluk kasebut kena diterusake.
Ing gudang kode Codex, proksi jaringan diimplementasikake ing crate codex-network-proxy(mbukak ing jendhela anyar), sing digunakake kerangka panglakon minangka pustaka, nanging uga bisa dibangun dadi CLI mandiri(mbukak ing jendhela anyar). Nalika diaktifake, kanthi gawan codex-network-proxy miwiti proksi HTTP lan proksi SOCKS5. Alamat proksi iki dikirim menyang proses sing digawe sandbox liwat variabel lingkungan. Saliyane nyisipake variabel lingkungan standar kayata HTTP_PROXY, HTTPS_PROXY, lan ALL_PROXY, sawetara variabel lingkungan khusus aplikasi(mbukak ing jendhela anyar) sing umum dikenal (kayata PIP_PROXY) uga disisipake. Pancen, ora kabeh program manut variabel lingkungan iki. Yen program nyoba nyambung langsung menyang host eksternal, watesan sandbox sistem operasi bakal mblokir, kaya sing diterangake ing bagean khusus platform ing ngisor iki.
Proksi jaringan tanggung jawab ngetrapake watesan jaringan sing ditemtokake ing profil idin. Contone, profil dev sing dituduhake mau ngidini panjaluk menyang *.openai.com lan kanthi eksplisit nolak panjaluk menyang evil.example. Nalika panjaluk ditujokake menyang domain sing ora cocog karo aturan idin utawa penolakan, proksi bisa nundha panjaluk kasebut nalika masrahake menyang kerangka panglakon kanggo njaluk persetujuan. Kaya conto prentah shell, Codex bisa njaluk persetujuan langsung saka pangguna, utawa ngarahake panjaluk menyang pamriksan otomatis(mbukak ing jendhela anyar). Sawise nampa keputusan, proksi ngidini panjaluk diterusake utawa nolak kanthi respons kesalahan.
Urutane penting ing kene amarga nggoleki DNS wae bisa mbocorake informasi sing dikodeake ing jeneng host. Mula, proksi mung nggoleki alamat jeneng host sing dijaluk sawise mesthekake yen diidini utawa disetujoni. Elinga yen aturan wildcard sing amba utawa akses menyang layanan DNS isih bisa ngidini nyolong data liwat DNS.
Ing macOS, Codex nggunakake Seatbelt(mbukak ing jendhela anyar), mekanisme sandboxing Apple sing ditrapake dening kernel. Kabijakan Seatbelt ditulis nganggo Sandbox Profile Language (SBPL), basa adhedhasar Scheme kanggo nyatakake watesan sandbox. Codex manggil Seatbelt liwat prentah /usr/bin/sandbox-exec ing macOS. Kaya codex sandbox, prentah iki nampa opsi sing njlentrehake sandbox banjur prentah sing bakal dilakokake:
PROFILE yaiku string SBPL sing ngemot entri kanggo ngatur sandbox. Contone, cuplikan SBPL ing ngisor iki ndadekake /dev/null lan /dev/zero bisa diwaca lan ditulisi miturut kabijakan sandbox:
Nalika proksi jaringan diaktifake minangka bagean saka panggilan sandbox, aturan kaya ing ngisor iki disisipake menyang profil kanggo matesi sambungan mung menyang port lokal sing cocog:
Profil dhasar Codex diwiwiti nganggo (deny default), mula sambungan metu tetep diblokir kajaba diidini kanthi eksplisit.
Pungkasan, SBPL bisa ngemot placeholder nganggo (param):
sing diisi dening opsi -Dkey=value sing diwenehake marang sandbox-exec.
Kanggo ngetrapake API sandbox dhewe, Codex nyusun dhaptar argumen(mbukak ing jendhela anyar) kanggo sandbox-exec wiwit saka kabijakan dhasar(mbukak ing jendhela anyar), banjur nggunakake permission_profile lan konteks liyane kanggo ngowahi supaya ngasilake profil Seatbelt sing lengkap. Profil sing diasilake lan argumen -D sing ngiringi ngatur watesan sing ditrapake Seatbelt, dene proksi jaringan ngetrapake aturan jaringan tambahan. Sawise dhaptar argumen lengkap disusun, manggil sandbox-exec dadi prasaja.
Ngasilake SBPL sing bener iku nantang amarga Apple ora ndokumentasikake basa kasebut kanggo panggunaan pihak katelu. Pancen, man sandbox-exec nyatakake The sandbox-exec command is DEPRECATED (semono uga fungsi pustaka sandbox_init() sing didokumentasikake liwat man 3 sandbox_init). Sanajan ana bebaya yen panggunaane wis ora disaranake, macOS isih nyakup profil Seatbelt ing /usr/share/sandbox, lan piranti lunak pihak katelu, kalebu Google Chrome lan Chromium(mbukak ing jendhela anyar), isih gumantung marang Seatbelt. Mula, kita ngrancang tetep nggunakake Seatbelt ing mangsa ngarep sing bisa diprakirakake.
Kanggo nggawe sandbox ing Linux, Codex nggunakake gabungan bubblewrap(mbukak ing jendhela anyar) (bwrap), piranti baris prentah kanggo nggawe lingkungan sing diisolasi, lan seccomp-bpf(mbukak ing jendhela anyar), mekanisme kernel Linux kanggo nyaring panggilan sistem. Program pambantu internal jenenge codex-linux-sandbox ngoordinasi panyiapan kasebut. Kaya sandbox-exec ing macOS, program iki nampa konfigurasi sandbox banjur prentah sing bakal dilakokake:
Nalika isolasi sistem file utawa rute liwat proksi dibutuhake, codex-linux-sandbox manggil bwrap kanggo nggawe lingkungan sandbox wiwitan. Banjur bwrap nglakokake codex-linux-sandbox --apply-seccomp-then-exec ing njerone. Panggilan kapindho iki nggunakake seccomp-bpf kanggo ngetrapake watesan tambahan sadurunge nglakokake prentahe pangguna.
Kanggo nggawe lingkungan sandbox wiwitan kasebut, Codex nggunakake bubblewrap kanggo nggawe tampilan sistem file ing namespace mount sing kapisah, manut aturan sistem file ing profil idin. Amarga iki dadi dhasar implementasi sandbox, Codex nyakup salinan bwrap dhewe yen pangguna durung nginstal, nanging luwih ngutamakake instalasi sing kompatibel saka (mbukak ing jendhela anyar)bwrap(mbukak ing jendhela anyar) sing ditemokake ing PATH, yen ana. Ing praktik, sawetara distribusi Linux mateni akses menyang namespace pangguna kanthi gawan(mbukak ing jendhela anyar), nanging menehi pangecualian kanggo bwrap sistem.
Kaya sandbox-exec, bwrap uga nampa konfigurasi sandbox banjur prentah sing bakal dilakokake ing njero sandbox. Tinimbang nggunakake basa konfigurasi khusus kaya SBPL, bwrap nggunakake flag siji-siji kanggo konfigurasi. Codex nggunakake opsi ing ngisor iki kanggo nggawe tampilan sistem file:
--bindkanggo nemtokake file utawa direktori sing bisa ditulisi--ro-bindkanggo nemtokake file utawa direktori sing mung bisa diwaca--perms 000 --tmpfs DIR --remount-ro DIRkanggo nolak akses menyangDIR--perms 000 --ro-bind-data FD FILEkanggo nolak akses menyangFILE(ing keneFDyaiku deskriptor file sing mbukak menyang/dev/null)
Kanggo ngetrapake pola glob penolakan nganggo opsi iki, Codex njlentrehake pola kasebut dadi path nyata sadurunge nglakokake saben prentah. Path anyar sing cocog ora otomatis ditambahake menyang watesan sandbox prentah kasebut.
Codex uga nemtokake opsi kayata --unshare-ipc lan --unshare-pid kanggo nyegah sandbox ngakses jinis sumber daya liyane ing host, mula pengaruhe bubblewrap ora mung marang visibilitas file.
Nalika nggunakake bubblewrap, Codex menehi --unshare-net saben jaringan dipateni utawa sambungan kudu liwat proksi jaringan. Iki bakal nggawe namespace jaringan anyar kanggo sandbox. Banjur kita nggunakake seccomp-bpf kanggo ngetrapake watesan tambahan marang panggilan sistem jaringan lan kulawarga soket sing bisa digunakake prentah.
Khususe, kita nggunakake crate seccompiler(mbukak ing jendhela anyar) kanggo ngompilasi program BPF kanthi dinamis adhedhasar saringan sing dikarepake(mbukak ing jendhela anyar) lan ngetrapake ing proses peluncur ing sandbox supaya watesane diwarisake menyang kabeh wit proses. Mula, bwrap ora nglakokake prentahe pangguna langsung, nanging nglakokake peluncur codex-linux-sandbox kanthi argumen konfigurasine dhewe banjur prentahe pangguna:
Kanggo ngetrapake saringan seccomp tanpa hak akses luwih dhuwur, peluncur nyetel flag no_new_privs ing Linux(mbukak ing jendhela anyar). Flag iki diwarisake menyang proses anak lan nyegah proses kasebut entuk hak akses tambahan nalika nglakokake program liyane, kayata program eksekusi setuid.
Saringan seccomp gumantung marang konfigurasi jaringan. Nalika akses jaringan dipateni, kita mblokir sawetara syscall sing gegandhengan karo jaringan, kayata connect(2) lan bind(2). Nanging nalika proksi jaringan diaktifake ing sandbox, kita ngidini soket IP supaya listener TCP sing digawe codex-linux-sandbox bisa digayuh. Kanthi gawan, kita mblokir pembuatan soket domain Unix mandiri amarga bisa menehi akses ora sengaja menyang sumber daya host.
Nalika konfigurasi sandbox mbutuhake proksi jaringan, kerangka panglakon Codex nggawe siji instans proksi sing bisa digunakake maneh ing pirang-pirang panggilan codex-linux-sandbox sajrone utas Codex sing padha. Saben sandbox mbutuhake cara kanggo nggayuh proksi bebarengan kasebut saka namespace jaringane sing diisolasi. Codex nyedhiyakake listener TCP loopback ing namespace kasebut lan ngatur proses ing njaba sandbox supaya nampa sambungane lan nerusake menyang proksi.
Diagram ing ngisor iki nggambarake tatanan iki kanggo siji titik pungkasan proksi, kanthi siji sambungan sing ngliwati proksi dituduhake ing diagram pungkasan. Sadurunge nglakokake bubblewrap, codex-linux-sandbox nggawe pasangan soket Unix minangka saluran kontrol lan nggawe cabang proses saka awake dhewe. Proses anak nglakokake run_host_bridge() lan ngenteni deskriptor file listener dikirim liwat saluran kasebut:
Ing conto iki, proses induk nggunakake exec kanggo ngganti citra programe nganggo bwrap. Iki nyiyapake sandbox lan nglakokake codex-linux-sandbox --apply-seccomp-then-exec ing njerone, sarta ngirim FD kanggo saluran kontrol:
Ing njero namespace jaringan sandbox, panggilan kapindho codex-linux-sandbox nggawe listener TCP loopback lan ngirim deskriptor file liwat soket. Listener tetep kaiket karo namespace jaringan sandbox, saengga proses anak sing tetep ana ing njaba sandbox bisa nampa sambungan saka program ing sandbox, nalika mbukak sambungan upstream ing namespace jaringan host. Sawise panyerahan, loro proses nutup deskriptor saluran kontrol, lan proses ing njero sandbox nutup salinan listener duweke.
Sawise listener TCP siyap, proses ing njero sandbox nyetel nilai sing cocog kanggo HTTP_PROXY(mbukak ing jendhela anyar) lan variabel lingkungan sing gegandhengan supaya ngarah menyang listener kasebut. Banjur proses kasebut ngetrapake seccomp sadurunge nggawe cabang proses lan nglakokake prentahe pangguna:
Proses ing njaba sandbox njaga listener tetep mbukak. Kanggo saben sambungan sing ditampa, proses kasebut mbukak sambungan menyang proksi sing wis dikonfigurasi lan nerusake data ing loro arah.
Mekanisme tambahan iki menehi namespace jaringan dhewe marang prentah, kalebu antarmuka loopback sing kapisah. Ing macOS, Seatbelt ngidini prentah nyambung langsung menyang port sing ditemtokake ing antarmuka loopback host. Dene ing Linux, prentah nyambung menyang listener ing namespace sing diisolasi, lan proses ing njaba sandbox nerusake sambungan kasebut menyang proksi sing wis dikonfigurasi. Panyerahan deskriptor ndadekake sambungan iki bisa digawe tanpa menehi akses menyang namespace jaringan host marang prentah.
Ing wiwitan taun iki, kita ngetrapake lan nulis babagan upaya sandboxing kita ing Windows. Wiwit iku, Microsoft wis ngrilis pustaka sing diarani MXC bebarengan karo fitur anyar kanggo isolasi proses ing sistem operasi Windows. Saiki kita lagi ngganti sandbox sing wis ana nganggo sandbox sing nggunakake pustaka MXC.
MXC (Microsoft eXecution Container) yaiku sistem eksekusi kode ing sandbox(mbukak ing jendhela anyar) saka Microsoft sing ndhukung sawetara backend isolasi ing Windows, Linux, lan macOS. Codex ndhukung sandbox adhedhasar MXC ing piranti Windows sing kompatibel, nggunakake isolasi proses bawaan kanggo matesi prentah ing lingkungan pangguna sing wis ana.
Kita lagi pindhah menyang MXC kanggo ningkatake keamanan lan gampange panggunaan, uga ngatasi sawetara watesan sandbox Windows kita saiki:
Perlu akses luwih dhuwur/admin kanggo nyiyapake sandbox
Operasi mriksa lan nyetel ACL sing boros sumber daya/alon
Status panyiapan sandbox sing tetep kesimpen ing mesin host, kalebu
ACL
Aturan firewall
Pangguna sandbox
File bidang kontrol
MXC nyedhiyakake skema konfigurasi JSON(mbukak ing jendhela anyar). Codex nggunakake MXC SDK(mbukak ing jendhela anyar) kanggo nggawe panjaluk eksekusi sing manut skema kasebut lan ngemot prentah, direktori kerja, lingkungan, lan idin. Idin kasebut nyakup akses sistem file lan jaringan, uga sumber daya Windows kayata desktop lan clipboard.
Codex nggunakake setelan tetep kanggo sawetara kontrol supaya kompatibilitas lan keamanan imbang. Codex ngidini maca registry lan tetep menehi akses Win32k lan desktop sing dibutuhake PowerShell nalika diwiwiti. Akses clipboard, injeksi input, lan kontrol desktop sarta setelan sistem dipateni. Pungkasan, MXC dicegah supaya ora nggunakake cara cadangan kanthi ngowahi idin sistem file host.
Codex ngowahi aturan sistem file lan jaringan ing profil idin dadi konfigurasi MXC. Kanthi nggunakake profil dev mau, lan nganggep:
Mung
C:\,D:\lanZ:\sing dadi drive lokal mesin kasebut.Root ruang kerja lan direktori kerja yaiku
C:\work\demo.Direktori omahe pangguna yaiku
D:\Users\dev, mula~/build-cachenuduhakeD:\Users\dev\build-cache.Pola glob penolakan mung cocog karo
C:\work\demo\config\dev.envlanC:\work\demo\config\prod.env.
Setelan MXC sing cocog bakal kalebu:
Kanthi gawan, kabijakan sistem file MXC nolak akses. Mula, Codex nambah idin mung maca kanggo root drive lokal supaya akses maca sing amba ing profil iki bisa diwenehake. Idin iki ditrapake kanthi rekursif, manut idin OS sing wis diduweni pangguna.
Ana siji rincian: idin root drive sing bisa ditulisi ora ditrapake kanthi rekursif, mula Codex nggedhekake cakupane supaya kalebu file lan direktori sing wis ana langsung ing sangisore drive.
Path sing luwih spesifik ngungkuli idin saka direktori ing ndhuwure, mula C:\work\demo bisa ditulisi ing sangisore C:\ sing mung bisa diwaca, dene C:\work\demo\.git tetep mung bisa diwaca.
Nalika panulisan path sing beda utawa alias symlink/junction nuduhake path sing padha, MXC ngetrapake idin sing luwih ketat: nolak luwih diutamakake tinimbang mung maca, lan mung maca luwih diutamakake tinimbang maca-nulis.
MXC mung nampa path penolakan sing nyata, mula Codex njlentrehake pola glob penolakan dadi file lan direktori sing cocog sadurunge dilakokake. Path anyar sing cocog karo pola glob ora otomatis ditambahake nalika prentah lagi mlaku.
Aturan domain kayata *.openai.com ditrapake dening proksi jaringan Codex bebarengan sing wis diterangake mau. Codex nglakokake proksi kasebut ing njaba sandbox lan menehi alamate marang prentah liwat variabel lingkungan standar *_PROXY sing padha kaya sing wis kasebut sadurunge. MXC mblokir sambungan eksternal langsung nanging ngidini sambungan loopback host, kalebu akses menyang proksi. Layanan lokal liyane tetep bisa digayuh.
Ing macOS, Linux, lan Windows, kerangka panglakon nggunakake API sandbox sing padha kanggo nglakokake prentah nganggo profil idin. Implementasi khusus saben platform nangani panyiapan sing dibutuhake kanggo ngetrapake watesan kasebut.
Nulis lan nglakokake kode menehi cara sing luwes kanggo agen ngrampungake masalah ing njaba pangembangan piranti lunak. Sandbox Codex ngidini agen nggunakake kabisan kasebut ing lingkungan pangguna sing wis ana, kanthi wates sing cetha kanggo akses sistem file lan jaringan. Sandbox iki minangka komponen dhasar ing kerangka panglakon sing bisa digunakake maneh, lan prentah codex sandbox nyedhiyakake kanggo piranti sing panjenengan gawe dhewe.
Nalika agen nangani tugas saya akeh, kita kepengin nggawe sandboxing praktis kanggo luwih akeh piranti lan lingkungan. Iki ateges nggampangake konfigurasi idin lan nggunakake pangayoman sistem operasi sing luwih apik nalika wis kasedhiya. Tujuan kita yaiku nggedhekake kabisane agen, nanging wong tetep nyekel kendhali marang apa sing bisa diakses agen.


