Codex-ի մեկուսացված միջավայրի ներսում
Ինչպես է Codex-ը հրամաններ կատարում ձեր համակարգչում՝ ձեր վերահսկած սահմանափակումներով։
OpenAI-ում ագենտների պաշտպանության համար կիրառում ենք բազմաշերտ պաշտպանության(բացվում է նոր պատուհանում) մոտեցում։ Թեև այս աշխատանքի հիմքում ուսուցման և համահունչ վարքի ապահովման մեջ մեր ներդրումներն են, մենք նաև լրացուցիչ պաշտպանական հնարավորություններ ենք ներդնում մեր ագենտային հարնեսում՝ Codex-ում(բացվում է նոր պատուհանում)։ Քանի որ Codex-ի ամենատարածված (և հնարավոր ռիսկեր պարունակող) գործողություններից մեկը ձեր համակարգչում հրամաններ կատարելն է, մենք ստեղծել ենք Codex-ի մեկուսացված միջավայրը։ Դրա շնորհիվ Codex-ը կարող է աշխատել ձեր առկա միջավայրում՝ ֆայլային համակարգի և ցանցի՝ ձեր սահմանած սահմանափակումներով։
(բացվում է նոր պատուհանում)Մեկուսացված միջավայրը(բացվում է նոր պատուհանում) սահմանափակում է, թե ծրագիրն ինչի կարող է հասանելիություն ունենալ աշխատանքի ընթացքում։ Լուսանկարները դասավորելու համար կարող եք Codex-ի մեկուսացված միջավայրը կարգավորել այնպես, որ հրամանները կարողանան կարդալ և փոփոխել ~/Pictures-ի ֆայլերը, իսկ վերբեռնումները կանխելու համար արգելափակել ցանցի հասանելիությունը։ Կոդի վերանայման համար կարող եք թույլատրել առցանց փաստաթղթերի հասանելիությունը՝ սկզբնաղբյուրի ֆայլերը թողնելով միայն կարդալու համար։ Օգտատերերը Codex-ի մեկուսացված միջավայրը կարգավորում են (բացվում է նոր պատուհանում)թույլտվությունների պրոֆիլների(բացվում է նոր պատուհանում) միջոցով, որոնք սահմանում են Codex-ի աշխատաշրջանի ֆայլային համակարգի և ցանցի սահմանափակումները։
Այս հոդվածում նախ կքննարկենք Codex-ի մեկուսացման լռելյայն կարգավորումների հիմքում ընկած փոխզիջումները, ապա կբացատրենք միջավայրի կառուցվածքը և ինչպես է հարնեսն այն օգտագործում հրամաններ կատարելու համար։ Կներկայացնենք, թե ինչպես կարող են վերջնական օգտատերերն ու ձեռնարկությունները թույլտվությունները հարմարեցնել իրենց կարիքներին, իսկ ծրագրավորողները՝ մեկուսացված միջավայրը վերօգտագործել սեփական գործիքներում։ Վերջում կքննարկենք, թե ինչպես են այս սահմանափակումներն ապահովվում macOS-ում, Linux-ում և Windows-ում։
Codex-ում մեր մոտեցումն է մեկուսացված միջավայրի համար ընտրել զգուշավոր լռելյայն կարգավորումներ, որոնք, այնուամենայնիվ, թույլ են տալիս արդյունավետ աշխատել։ Օրինակ, երբ աշխատատարածքի արմատը Git պահոց է, ներկառուցված :workspace թույլտվությունների պրոֆիլը․
Թույլ է տալիս գրել աշխատատարածքում՝ այնպիսի պանակներ, ինչպիսիք են
.gitև.codex, թողնելով միայն կարդալու համար։ Սա թույլ է տալիս Codex-ին խմբագրել սկզբնաղբյուրի կոդը՝ առանց ամեն փոփոխության համար թույլտվություն խնդրելու, բայց կանխում է.codex/config.toml-ի կամ.git/hooks-ում գտնվող Git կեռիկների ուղղակի փոփոխությունները։Թույլ է տալիս լայնորեն կարդալ ֆայլային համակարգը՝ օգտատիրոջ՝ ՕՀ-ում ունեցած իրավունքների սահմաններում։ Կոմպիլյատորները, կատարման միջավայրերը և կառուցման գործիքները կախված են պահոցից դուրս գտնվող SDK-ներից, գրադարաններից և կարգավորումներից։ Ընթերցումն աշխատատարածքով սահմանափակելը կխաթարեր շատ սովորական աշխատանքային գործընթացներ։ Փոխզիջումն այն է, որ համակարգչի այլ մասերում գտնվող զգայուն ֆայլերը նույնպես կարող են ընթեռնելի մնալ (օրինակ՝ API բանալիներ պարունակող կարգավորման ֆայլերը)։
Անջատում է ցանցի հասանելիությունը։ Սա արգելափակում է արտաքին ծառայություններ ուղղակի վերբեռնումները, ներառյալ հրամանին ընթեռնելի տվյալների արտահոսքի փորձերը։ Այն նաև կանխում է օրինական գործողություններ, օրինակ՝ կախվածությունների ներբեռնումը, որոնց համար լրացուցիչ հասանելիություն է պահանջվում։
Այս սահմանափակումները կանխում են անցանկալի վարքագծի բազմաթիվ տեսակներ, սակայն վնասակար գործողությունները դեռ հնարավոր են։ Օրինակ՝ ագենտը կարող է վնասակար կոդ ներարկել տեղային տեղադրված փաթեթի մեջ, ինչպիսին է node_modules/prettier-ը։ Նման փոփոխությունը կարող է չերևալ git status-ում, քանի որ Git-ը հաճախ անտեսում է node_modules-ը։ Եթե օգտատիրոջ խմբագրիչը պահպանելիս գործարկում է Prettier-ի այդ օրինակը, ապա պարզապես ֆայլը պահպանելը կարող է վնասակար կոդը կատարել Codex-ի մեկուսացված միջավայրից դուրս։ Այդ պատճառով ենք կիրառում բազմաշերտ պաշտպանություն․ մեկուսացված միջավայրը սահմանափակում է հրամանների հասանելիությունը, իսկ ուսուցումն ու համահունչ վարքի ապահովումն օգնում են մոդելին այդ հասանելիությունն օգտագործել օգտատիրոջ մտադրությանը համապատասխան։
Ձեռնարկությունում մեկուսացման թույլտվությունները հարմարեցնելու և այլ պաշտպանական միջոցների հետ համադրելու ուղեցույցը տես Codex-ի անվտանգության գործնական ձեռնարկում(բացվում է նոր պատուհանում)։
Վիրտուալ մեքենաները և կոնտեյներները(բացվում է նոր պատուհանում) մեկուսացման երկու տարածված մեխանիզմներ են, սակայն Codex-ի մեկուսացված միջավայրի համար մենք այլ մոտեցում ենք կիրառում։ Մեկուսացում ապահովելու համար հաշվարկներն առանձին միջավայր տեղափոխելու փոխարեն Codex-ն օգտագործում է յուրաքանչյուր հարթակի մեկուսացման միջոցները՝ սահմանափակելու օգտատիրոջ առկա միջավայրում կատարվող հրամանները։
Շատ ծրագրավորողների համար նոութբուքն անհատապես հարմարեցված մշակման միջավայր է, որը կարող են փոխել ցանկացած պահի։ Այդ միջավայրը Docker կոնտեյներում վերարտադրելը կարող է ջանք պահանջել, իսկ որոշ աշխատանքային գործընթացներ միևնույն է կախված են հոսթում աշխատող գործիքներից։
Օրինակ՝ դիտարկենք Codex-ով Mac-ում iOS հավելվածի մշակումը։ Եթե որոշեք Codex-ը մեկուսացնել՝ գործարկելով Docker-ի ներսում, այն չի կարողանա գործարկել Mac-ի բնիկ գործարկելի ֆայլերից կազմված iOS-ի կառուցման գործիքաշարը կամ բացել iPhone սիմուլյատորը՝ կոդը կատարելու համար։ Docker-ի վրա հիմնված գործընթացը կարող է կառուցումն ու սիմուլյատորի գործողությունները պատվիրակել Mac հոսթին, բայց դրանք կկատարվեն կոնտեյների մեկուսացված միջավայրից դուրս և առանձին սահմանափակումների կարիք կունենան։ Codex-ի դեպքում նախընտրում ենք ամեն ինչ պարզ պահել՝ մեծ ներդրումներ կատարելով ՕՀ-ին հատուկ մեկուսացման մեջ, որպեսզի Codex-ն աշխատի տվյալ առաջադրանքին առավել հարմար միջավայրում։
Հարնեսը ՕՀ-ին հատուկ այս մեկուսացման մեխանիզմները հասանելի է դարձնում macOS-ի, Windows-ի և Linux-ի համար ընդհանուր API-ի միջոցով։ Այս API-ն ընդունում է հրաման և թույլտվությունների պրոֆիլ։ Եթե թույլտվությունների պրոֆիլը թույլ է տալիս սահմանափակ ցանցային հասանելիություն, կանչողը պետք է տրամադրի ցանցային պրոքսի՝ այդ սահմանափակումներն ապահովելու համար․
Այս ֆունկցիան պրոցեսը գործարկում է մեկուսացված միջավայրում և վերադարձնում Child հղիչ, որը հարնեսը կարող է օգտագործել՝ պրոցեսի ավարտին սպասելու համար։ Յուրաքանչյուր զավակ պրոցես ժառանգում է ծնողի մեկուսացման սահմանափակումները, ուստի դրանք կիրառվում են հրամանի նախաձեռնած պրոցեսների ամբողջ ծառում, նույնիսկ այն ժառանգների վրա, որոնք շարունակում են աշխատել սկզբնական պրոցեսի ավարտից հետո։
Հետևյալ գծապատկերը ցույց է տալիս, թե ինչպես են այս բաղադրիչները համատեղ աշխատում՝ կարգավորումից մինչև մեկուսացված հրամանի կատարումը։ Հաջորդ բաժինները բացատրում են յուրաքանչյուր փուլը։

Ինչպես բացատրված է «Codex ագենտի աշխատանքի ցիկլը՝ քայլ առ քայլ» հոդվածում, Codex-ի հարնեսը պատասխանատու է մոդելի գեներացրած գործիքների կանչերը կատարելու համար։ Ծրագրավորման առաջադրանքներում ամենաշատ օգտագործվող գործիքը հրամանային թաղանթի գործիքն է․ այն հրամաններ է կատարում այնպես, ինչպես օգտատերը կաներ Bash-ի նման ինտերակտիվ թաղանթում։ Այստեղ կդիտարկենք մեկանգամյա (բացվում է նոր պատուհանում)exec_command(բացվում է նոր պատուհանում) թաղանթի գործիքը(բացվում է նոր պատուհանում)՝ ցույց տալու, թե ինչպես է հարնեսը մեկուսացումն օգտագործում անհրաժեշտ պաշտպանությունն ապահովելու համար։
Սա պարզեցված տարբերակն է այն բանի, թե Codex-ի հարնեսն ինչպես կկատարեր exec_command գործիքի կանչը առանց մեկուսացման․
Հրամանը մեկուսացնելու համար հարնեսը subprocess.Popen() կանչը փոխարինում է spawn_command_under_sandbox()-ով։ Հարնեսը տրամադրում է թույլտվությունների պրոֆիլը և, անհրաժեշտության դեպքում, ցանցային պրոքսին․
exec_command գործիքը նաև թույլ է տալիս մոդելին առանձին հրամանի համար այլ թույլտվություններ խնդրել, սակայն հարցումը բավարարելու որոշումը կայացնում է հարնեսը․
Երբ նշված է use_default, հարնեսն օգտագործում է տվյալ հերթի մեկուսացման լռելյայն կարգավորումը։ with_additional_permissions-ը խնդրում է ընդլայնված հասանելիություն մեկուսացված միջավայրի ներսում, իսկ require_escalated-ը՝ կատարում դրանից դուրս։ Հրամանը կատարելուց առաջ հարնեսը հարցումը գնահատում է՝ ելնելով օգտատիրոջ նախընտրություններից։ (Օրինակ՝ Codex-ը կարող է անմիջապես հարցնել օգտատիրոջը կամ հարցումն ուղարկել ավտոմատ վերանայման(բացվում է նոր պատուհանում)։) Եթե կատարումը թույլատրվի, Codex-ը համապատասխան permission_profile-ը և network_proxy-ն կփոխանցի perform_exec_command_with_sandboxing()-ին՝ սկզբնական ExecCommandToolCall-ի հրամանի արգումենտների հետ միասին։
Թաղանթի գործիքը spawn_command_under_sandbox()-ի հիմնական օգտագործողն է, իսկ հարնեսը մեկուսացման ենթակառուցվածքը վերօգտագործում է նաև տեղային ֆայլերը կարդալու և փոփոխելու նման գործողությունների համար։ Վերօգտագործումը չի սահմանափակվում հարնեսով․ codex sandbox հրամանը թույլ է տալիս մեկուսացված հրամանների կատարումը ներառել ձեր սեփական գործիքներում, ինչպես կտեսնենք ավելի ուշ։ Հաջորդիվ կտեսնենք, թե ինչպես են սահմանվում թույլտվությունների պրոֆիլները։
Անվանված թույլտվությունների պրոֆիլը թույլ է տալիս տարբեր նախագծերում վերօգտագործել ֆայլային համակարգի և ցանցի նույն սահմանափակումները։ Ձեր պրոֆիլները կարող եք սահմանել config.toml-ի [permissions] բաժնում։ Օրինակ՝ ստորև սահմանվում է dev անունով պրոֆիլ, որը ընդլայնում է(բացվում է նոր պատուհանում) ներկառուցված :workspace պրոֆիլը․
dev պրոֆիլն ավելացնում է ~/build-cache-ում գրելու թույլտվություն և լրացուցիչ սահմանափակումներ դնում աշխատատարածքի ֆայլերի վրա։ Ֆայլային համակարգի գրառումները կարող են թույլատրել միայն կարդալը (read), կարդալն ու գրելը (write) կամ ամբողջությամբ արգելել հասանելիությունը (deny)։
:workspace_roots աղյուսակը թույլ է տալիս կանոններ սահմանել նախագծի աշխատատարածքի արմատների նկատմամբ հարաբերական ուղիների համար։ Լռելյայն Codex CLI-ն որպես աշխատատարածքի միակ արմատ օգտագործում է իր աշխատանքային պանակը, իսկ ChatGPT‑ի համակարգչային հավելվածը՝ նախագծի սկզբնաղբյուրի պանակները։ Codex-ը յուրաքանչյուր կանոն կիրառում է բոլոր արմատների վրա, ուստի dev-ի .vscode գրառումը յուրաքանչյուր արմատի .vscode պանակը դարձնում է միայն կարդալու համար հասանելի։
Սեփական կանոններից բացի, dev-ը :workspace-ից ժառանգում է հետևյալ պաշտպանական միջոցները․
Codex-ի մեկուսացված միջավայրի ցանցը կարգավորելու համար հիմնականում երեք տարբերակ կա․
Անջատել ցանցի ամբողջ հասանելիությունը (լռելյայն՝
:workspaceպրոֆիլի համար)Միացնել ցանցի լիարժեք, ուղղակի հասանելիությունը (լռելյայն՝
:danger-full-accessպրոֆիլի համար)Ցանցի հասանելիությունը սահմանափակել պրոքսիով, որը թույլտվությունների պրոֆիլի հիման վրա որոշում է՝ ինչն անցկացնել
dev-ին ցանցի ուղղակի հասանելիություն տալու համար config.toml-ի վերին մակարդակում սահմանեք permissions.dev.network.enabled = true։ Սա տալիս է ցանցի լիարժեք հասանելիություն, երբ ցանցային պրոքսին անջատված է։
dev-ի հասանելիությունը որոշակի դոմեններով սահմանափակելու համար միացրեք ցանցային պրոքսին և կարգավորեք դրա դոմենային կանոնները․
Դոմենային կանոններն աջակցում են ճշգրիտ անունների և համընդհանուր նիշերով ձևանմուշների․ բացահայտ արգելող կանոնները գերակայում են թույլատրողներին։ Այլ դոմեններին ուղղված հարցումները հաստատում են պահանջում կամ արգելափակվում են, ինչպես նկարագրված է ստորև՝ Ցանցային պրոքսի բաժնում։
Անհատ օգտատերերը կարող են սահմանել բոլոր նախագծերին կիրառվող լռելյայն կարգավորումներ և վերագրել դրանք որոշակի վստահելի նախագծի համար։ Ձեռնարկության ադմինիստրատորները ևս կարող են ցանկանալ իրենց օգտատերերի համար սահմանել լռելյայն կարգավորումներ և սահմանափակել, թե որ կարգավորումները նրանք կարող են փոխել։ Codex-ն աջակցում է երկուսին էլ՝ շերտավորված կարգավորումների և կառավարվող պահանջների միջոցով։
Ինչպես նկարագրված է «Կարգավորումների առաջնահերթություն» բաժնում,(բացվում է նոր պատուհանում) Codex-ը միավորում է բազմաթիվ config.toml ֆայլերի կարգավորումները։ Աղյուսակները միավորվում են ռեկուրսիվ, իսկ հակասող արժեքների դեպքում գերակայում է ավելի բարձր առաջնահերթություն ունեցող աղբյուրը։ Զանգվածները փոխարինվում են ամբողջությամբ։
Այդ պատճառով թույլտվությունների պրոֆիլները ֆայլային համակարգի ուղիների և ցանցային դոմենների համար օգտագործում են աղյուսակներ։ Թիմը կարող է իր կարգավորումներում ավելացնել կամ վերագրել առանձին գրառումներ և ինքնաբերաբար ժառանգել կազմակերպության հիմնական կարգավորումների մնացած բոլոր գրառումների փոփոխությունները․
Ադմինիստրատորները կարող են նաև requirements.toml-ի միջոցով տրամադրել կառավարվող պահանջներ(բացվում է նոր պատուհանում)՝ սահմանափակելու օգտատերերի կարգավորման ընտրանքները։ Այս պահանջները կարող են գալ տարբեր աղբյուրներից, ներառյալ համակարգային ֆայլերը և ամպից տրամադրվող քաղաքականությունը։ Տարածված կիրառություն է allowed_permission_profiles-ի սահմանումը՝ սահմանափակելու ձեռնարկության օգտատիրոջ ընտրելիք թույլտվությունների պրոֆիլների շրջանակը։ Օրինակ՝ ադմինիստրատորը կարող է սահմանել հետևյալ ամպային պահանջները․
Ամպային պահանջները կգերակայեն /etc/codex/requirements.toml համակարգային պահանջների ֆայլին, ուստի այդ ֆայլի գրառումը չի կարող վերագրել վերևում բացահայտ նշված ":danger-full-access" = false-ը։ :workspace-ը չնշելը թույլ է տալիս պահանջների մեկ այլ շերտի տրամադրել այդ գրառումը։ Այն պրոֆիլները, որոնց գրառումները false են կամ բացակայում են վերջնական միավորված աղյուսակից, հասանելի չեն։
Այս բաժանումը կազմակերպություններին թույլ է տալիս սահմանափակումներ կիրառել, իսկ օգտատերերին՝ դրանց շրջանակում հարմարեցնել իրենց կարգավորումները։ Ստացված թույլտվությունների պրոֆիլները կարող է օգտագործել հարնեսը, կամ դրանք կարող են կիրառվել անմիջապես հրամանի վրա, ինչպես կտեսնենք հաջորդիվ։
Codex CLI-ն տրամադրում է sandbox հրամանը՝ կամայական հրաման Codex-ի կարգավորումներում սահմանված թույլտվությունների պրոֆիլով հեշտությամբ կատարելու համար։ Սա սովորաբար օգտագործվում է պրոֆիլը փորձարկելու և համոզվելու համար, որ մեկուսացված միջավայրը կանխում է այն վարքը, որն արգելափակելու համար նախագծվել է։
Օրինակ՝ հետևյալ հրամանը փորձում է VS Code-ը կարգավորել այնպես, որ պահպանելիս գործարկվի վնասակար ինքնաձևաչափիչ։ Եթե .vscode-ն արդեն գոյություն ունի, վերևում սահմանված dev պրոֆիլը պետք է արգելափակի այս գրառումը, քանի որ այդ պանակը միայն կարդալու համար է (codex sandbox-ը լռելյայն cwd-ն համարում է աշխատատարածքի արմատ)․
Իսկապես, macOS-ում այն ձախողվում է հետևյալ հաղորդագրությամբ․
codex sandbox հրամանը Codex-ի մեկուսացման մեխանիզմը հասանելի է դարձնում ագենտի աշխատաշրջանից անկախ։ Կարող եք օգտագործել նույն կարգավորման լեզուն և հարթակին հատուկ սահմանափակման միջոցները՝ ձեր գործիքների գործարկած հրամանները սահմանափակելու համար։
config.toml-ում կարգավորված stdio MCP սերվերի դեպքում Codex-ի հարնեսը չի փորձում մեկուսացնել սերվերը գործարկող հրամանը։ Codex-ը չի կարող հուսալիորեն որոշել, թե այդ սերվերին որ ֆայլերը կամ ցանցային ծառայություններն են անհրաժեշտ, ուստի լռելյայն մեկուսացման պրոֆիլի կիրառումը կարող է խաթարել այլապես ճիշտ կարգավորումը։
Օրինակ՝ @modelcontextprotocol/server-memory(բացվում է նոր պատուհանում) MCP սերվերը Codex-ի հետ օգտագործելու համար սովորաբար կարգավորում են այսպես․
Քանի որ այս npx հրամանն աշխատում է առանց մեկուսացման, այն կարող է ֆայլեր գրել և ցանցային հարցումներ կատարել Codex-ը գործարկող օգտատիրոջ իրավունքներով, ինչը չափազանց լայն թույլտվություն է։ Այն սահմանափակելու համար կարող ենք սահմանել memory-mcp անունով թույլտվությունների պրոֆիլ, ապա սկզբնական npx հրամանը գործարկել codex sandbox --permission-profile memory-mcp-ի միջոցով՝ սահմանափակելով գրելու վայրերը և արգելելով ցանցի հասանելիությունը․
Սերվերը գործարկելուց առաջ ստեղծեք դրա տվյալների պանակը և npm-ի քեշում տեղադրեք ամրագրված տարբերակի փաթեթը։ Սա թույլ է տալիս npx --offline-ին գործարկել սերվերը ցանցի հասանելիությունն անջատող պրոֆիլով․
Փաթեթը քեշավորվելուց հետո Codex-ը կարող է հիշողության սերվերը գործարկել առանց ցանցի հասանելիության՝ գրելը սահմանափակելով npm-ի քեշով և սերվերի տվյալների պանակով։
Մեկուսացման իրականացումը թույլտվությունների պրոֆիլը վերածում է օպերացիոն համակարգի կողմից ապահովվող սահմանափակումների։ Ցանցային պրոքսիի հարցումների մշակման և քաղաքականության հիմնական տրամաբանությունն ընդհանուր է երեք հիմնական օպերացիոն համակարգերի համար, իսկ պրոքսիի կարգավորումն ու մեկուսացված միջավայրի հետ ինտեգրումը հատուկ են յուրաքանչյուր ՕՀ-ին։ Նախ կքննարկենք ընդհանուր պրոքսին, ապա՝ macOS-ի, Linux-ի և Windows-ի իրականացումները։
Թույլտվությունների պրոֆիլի ցանցային սահմանափակումներն ապահովելու համար հարնեսը գործարկում է ցանցային պրոքսի և մեկուսացված միջավայրը կարգավորում այնպես, որ թույլատրվեն կապերը դրան, իսկ արտաքին հոսթերին ուղղակի կապերն արգելափակվեն։ Պրոքսին յուրաքանչյուր հարցում ստուգում է պրոֆիլի դոմենային կանոններով՝ որոշելու, թե արդյոք այն պետք է փոխանցվի։
Codex-ի պահոցում ցանցային պրոքսին իրականացված է codex-network-proxy(բացվում է նոր պատուհանում) փաթեթում։ Հարնեսն այն օգտագործում է որպես գրադարան, թեև այն կարելի է նաև կառուցել որպես ինքնուրույն CLI(բացվում է նոր պատուհանում)։ Միացված վիճակում codex-network-proxy-ն լռելյայն գործարկում է և՛ HTTP, և՛ SOCKS5 պրոքսի։ Այս պրոքսիների հասցեները մեկուսացված միջավայրի գործարկած պրոցեսին փոխանցվում են միջավայրի փոփոխականներով։ Բացի HTTP_PROXY, HTTPS_PROXY և ALL_PROXY ստանդարտ միջավայրի փոփոխականներից, ներմուծվում են նաև մի շարք հայտնի հավելվածներին հատուկ միջավայրի փոփոխականներ(բացվում է նոր պատուհանում) (օրինակ՝ PIP_PROXY)։ Իհարկե, ոչ բոլոր ծրագրերն են հաշվի առնում միջավայրի այս փոփոխականները։ Եթե ծրագիրը փորձում է ուղղակիորեն միանալ արտաքին հոսթին, օպերացիոն համակարգի մեկուսացման սահմանափակումներն արգելափակում են այն, ինչպես նկարագրված է ստորև՝ հարթակներին նվիրված բաժիններում։
Ցանցային պրոքսին պատասխանատու է թույլտվությունների պրոֆիլում սահմանված ցանցային սահմանափակումները կիրառելու համար։ Օրինակ՝ վերը ներկայացված dev պրոֆիլը թույլատրում է *.openai.com-ին ուղղված հարցումները և բացահայտ արգելում evil.example-ին ուղղվածները։ Երբ հարցումն ուղղված է որևէ թույլատրող կամ արգելող կանոնի չհամապատասխանող դոմենի, պրոքսին կարող է կասեցնել հարցումը՝ հաստատման որոշումը պատվիրակելով հարնեսին։ Ինչպես հրամանային թաղանթի օրինակում, Codex-ը կարող է անմիջապես հարցնել օգտատիրոջը կամ հարցումն ուղարկել ավտոմատ վերանայման(բացվում է նոր պատուհանում)։ Որոշումը ստանալուց հետո պրոքսին կամ թույլ է տալիս շարունակել հարցումը, կամ մերժում է այն՝ սխալի պատասխան տալով։
Այստեղ հերթականությունը կարևոր է, քանի որ նույնիսկ DNS որոնումը կարող է արտահոսքի ենթարկել հոսթի անվան մեջ կոդավորված տեղեկությունը։ Ուստի պրոքսին հայցված հոսթի անունը վերածում է հասցեի միայն այն բանից հետո, երբ պարզում է, որ այն թույլատրված կամ հաստատված է։ Նկատի ունեցեք, որ համընդհանուր նիշերով լայն կանոնները կամ DNS ծառայությունների հասանելիությունը դեռ կարող են թույլ տալ տվյալների արտահոսք DNS-ի միջոցով։
macOS-ում Codex-ն օգտագործում է Seatbelt-ը(բացվում է նոր պատուհանում)՝ Apple-ի մեկուսացման մեխանիզմը, որն ապահովվում է միջուկի մակարդակում։ Seatbelt-ի քաղաքականությունները գրվում են Sandbox Profile Language (SBPL) լեզվով՝ Scheme-ի վրա հիմնված լեզու, որն արտահայտում է մեկուսացման սահմանափակումները։ Codex-ը Seatbelt-ը կանչում է macOS-ի /usr/bin/sandbox-exec հրամանի միջոցով։ Ինչպես codex sandbox-ը, այն ընդունում է մեկուսացված միջավայրը նկարագրող ընտրանքներ, որոնց հաջորդում է կատարվելիք հրամանը․
PROFILE-ը SBPL տող է, որը պարունակում է մեկուսացված միջավայրը կարգավորող գրառումներ։ Օրինակ՝ հետևյալ SBPL հատվածը մեկուսացման քաղաքականությամբ /dev/null-ը և /dev/zero-ն հասանելի է դարձնում կարդալու և գրելու համար․
Երբ մեկուսացված գործարկման շրջանակում ցանցային պրոքսին միացված է, պրոֆիլում ավելացվում են ստորև բերվածի նման կանոններ՝ կապերը համապատասխան տեղային պորտերով սահմանափակելու համար․
Codex-ի հիմնական պրոֆիլը սկսվում է (deny default)-ով, ուստի ելքային կապերը մնում են արգելափակված, եթե բացահայտ թույլատրված չեն։
Վերջապես, SBPL-ը կարող է պարունակել տեղապահեր՝ օգտագործելով (param)-ը․
դրանք լրացվում են sandbox-exec-ին փոխանցվող -Dkey=value ընտրանքներով։
Մեկուսացման իր API-ն իրականացնելու համար Codex-ը կազմում է արգումենտների ցանկը(բացվում է նոր պատուհանում) sandbox-exec-ի համար՝ սկսելով հիմնական քաղաքականությունից(բացվում է նոր պատուհանում)։ Այնուհետև այն փոփոխում է permission_profile-ի և այլ համատեքստի հիման վրա՝ ստանալով Seatbelt-ի ամբողջական պրոֆիլը։ Ստացված պրոֆիլը և ուղեկցող -D արգումենտները կարգավորում են Seatbelt-ի ապահոված սահմանափակումները, իսկ ցանցային պրոքսին կիրառում է լրացուցիչ ցանցային կանոններ։ Արգումենտների ամբողջական ցանկը կազմելուց հետո sandbox-exec-ի կանչը պարզ է։
Ճիշտ SBPL ստեղծելը բարդ է, քանի որ Apple-ը լեզուն չի փաստաթղթավորում երրորդ կողմերի օգտագործման համար։ Իսկապես, man sandbox-exec-ում նշվում է The sandbox-exec command is DEPRECATED (նույնը վերաբերում է sandbox_init() գրադարանային ֆունկցիային, որը փաստաթղթավորված է man 3 sandbox_init-ում)։ Չնայած հնացման նախազգուշացմանը՝ macOS-ը դեռ տրամադրում է Seatbelt պրոֆիլներ /usr/share/sandbox-ում, իսկ երրորդ կողմերի ծրագրերը, այդ թվում՝ Google Chrome-ն ու Chromium-ը(բացվում է նոր պատուհանում), շարունակում են հիմնվել Seatbelt-ի վրա։ Ուստի նախատեսում ենք տեսանելի ապագայում շարունակել օգտագործել Seatbelt-ը։
Linux-ում մեկուսացված միջավայրը ստեղծելու համար Codex-ը համատեղ օգտագործում է bubblewrap-ը(բացվում է նոր պատուհանում) (bwrap)՝ մեկուսացված միջավայրեր ստեղծելու հրամանային տողի գործիք, և seccomp-bpf-ը(բացվում է նոր պատուհանում)՝ համակարգային կանչերը զտելու Linux միջուկի մեխանիզմը։ Կարգավորումը համակարգում է codex-linux-sandbox անունով ներքին օժանդակ գործիքը։ Ինչպես macOS-ի sandbox-exec-ը, այն ընդունում է մեկուսացման կարգավորում, որին հաջորդում է կատարվելիք հրամանը․
Երբ անհրաժեշտ է ֆայլային համակարգի մեկուսացում կամ երթուղավորում պրոքսիի միջոցով, codex-linux-sandbox-ը կանչում է bwrap-ը՝ սկզբնական մեկուսացված միջավայրը ստեղծելու համար։ Այնուհետև bwrap-ը դրա ներսում գործարկում է codex-linux-sandbox --apply-seccomp-then-exec-ը։ Այս երկրորդ կանչն օգտագործում է seccomp-bpf-ը՝ օգտատիրոջ հրամանը կատարելուց առաջ լրացուցիչ սահմանափակումներ կիրառելու համար։
Սկզբնական մեկուսացված միջավայրը կազմելու համար Codex-ն օգտագործում է bubblewrap-ը՝ մոնտաժման առանձին անվանատարածքում ստեղծելով ֆայլային համակարգի տեսք, որն արտացոլում է թույլտվությունների պրոֆիլի ֆայլային կանոնները։ Քանի որ սա մեկուսացման իրականացման հիմքն է, Codex-ը ներառում է bwrap-ի սեփական օրինակը, եթե օգտատերն այն չի տեղադրել։ Սակայն առկայության դեպքում այն նախընտրում է համատեղելի տեղադրված (բացվում է նոր պատուհանում)bwrap(բացվում է նոր պատուհանում)-ը՝ գտնված PATH-ում։ Փորձը ցույց է տալիս, որ Linux-ի որոշ բաշխումներ լռելյայն անջատում են օգտատերերի անվանատարածքների հասանելիությունը(բացվում է նոր պատուհանում), սակայն բացառություն են անում համակարգային bwrap-ի համար։
Ինչպես sandbox-exec-ը, bwrap-ը նույնպես ընդունում է մեկուսացման կարգավորում, որին հաջորդում է մեկուսացված միջավայրում կատարվելիք հրամանը։ SBPL-ի նման հատուկ կարգավորման լեզվի փոխարեն bwrap-ը կարգավորման համար օգտագործում է առանձին դրոշակներ։ Ֆայլային համակարգի տեսքը ստեղծելու համար Codex-ն օգտագործում է հետևյալ ընտրանքները․
--bind՝ գրելու համար հասանելի ֆայլ կամ պանակ նշելու համար--ro-bind՝ միայն կարդալու համար հասանելի ֆայլ կամ պանակ նշելու համար--perms 000 --tmpfs DIR --remount-ro DIR՝DIR-ի հասանելիությունն արգելելու համար--perms 000 --ro-bind-data FD FILE՝FILE-ի հասանելիությունն արգելելու համար (որտեղFD-ն/dev/null-ի բաց ֆայլային դեսկրիպտորն է)
Այս ընտրանքներով արգելման glob ձևանմուշները կիրառելու համար Codex-ը յուրաքանչյուր հրամանը գործարկելուց առաջ դրանք բացում է կոնկրետ ուղիների։ Նոր համապատասխանող ուղիներն ինքնաբերաբար չեն ավելացվում այդ հրամանի մեկուսացման սահմանափակումներին։
Codex-ը նաև նշում է --unshare-ipc-ի և --unshare-pid-ի նման ընտրանքներ՝ մեկուսացված միջավայրից հոսթի այլ ռեսուրսների հասանելիությունը կանխելու համար։ Այսպիսով, bubblewrap-ն ազդում է ոչ միայն ֆայլերի տեսանելիության վրա։
bubblewrap-ն օգտագործելիս Codex-ը փոխանցում է --unshare-net-ը, երբ ցանցն անջատված է կամ կապերը պետք է անցնեն ցանցային պրոքսիով։ Սա մեկուսացված միջավայրի համար ստեղծում է նոր ցանցային անվանատարածք։ Այնուհետև seccomp-bpf-ով լրացուցիչ սահմանափակումներ ենք դնում հրամանին հասանելի ցանցային համակարգային կանչերի և սոքեթների ընտանիքների վրա։
Մասնավորապես, օգտագործում ենք seccompiler փաթեթը(բացվում է նոր պատուհանում)՝ պահանջվող զտիչների հիման վրա BPF ծրագիր դինամիկ կոմպիլյացնելու(բացվում է նոր պատուհանում) և մեկուսացված միջավայրի գործարկիչ պրոցեսի վրա կիրառելու համար, որպեսզի սահմանափակումները ժառանգի պրոցեսների ամբողջ ծառը։ Հետևաբար, bwrap-ը կատարում է ոչ թե օգտատիրոջ հրամանը, այլ codex-linux-sandbox գործարկիչը՝ դրա կարգավորման արգումենտներով, որոնց հաջորդում է օգտատիրոջ հրամանը․
Առանց բարձրացված իրավունքների seccomp զտիչներ կիրառելու համար գործարկիչը սահմանում է Linux-ի no_new_privs դրոշակը(բացվում է նոր պատուհանում)։ Այս դրոշակը ժառանգվում է զավակ պրոցեսների կողմից և թույլ չի տալիս նրանց լրացուցիչ իրավունքներ ստանալ մեկ այլ ծրագիր, օրինակ՝ setuid գործարկելի ֆայլ կատարելիս։
seccomp զտիչները կախված են ցանցի կարգավորումից։ Երբ ցանցի հասանելիությունն անջատված է, արգելափակում ենք ցանցին առնչվող մի շարք համակարգային կանչեր, օրինակ՝ connect(2)-ը և bind(2)-ը։ Սակայն երբ մեկուսացված միջավայրում ցանցային պրոքսին միացված է, թույլատրում ենք IP սոքեթները, որպեսզի հասանելի լինի codex-linux-sandbox-ի ստեղծած TCP լսիչը։ Միաժամանակ լռելյայն արգելափակում ենք առանձին Unix դոմենային սոքեթների ստեղծումը, քանի որ դրանք կարող են ակամա հասանելի դարձնել հոսթի ռեսուրսները։
Երբ մեկուսացման կարգավորումը պահանջում է ցանցային պրոքսի, Codex-ի հարնեսը ստեղծում է պրոքսիի մեկ օրինակ, որը կարելի է վերօգտագործել Codex-ի նույն զրույցի շրջանակում codex-linux-sandbox-ի մի քանի կանչերի համար։ Յուրաքանչյուր մեկուսացված միջավայրի անհրաժեշտ է իր մեկուսացված ցանցային անվանատարածքից այդ ընդհանուր պրոքսիին հասնելու միջոց։ Codex-ն այդ անվանատարածքում տրամադրում է հետադարձ կապի TCP լսիչ և կազմակերպում, որ մեկուսացված միջավայրից դուրս գործող պրոցեսն ընդունի դրա կապերն ու փոխանցի պրոքսիին։
Հետևյալ գծապատկերները ներկայացնում են այս կառուցվածքը պրոքսիի մեկ վերջնակետի համար, իսկ վերջինը ցույց է տալիս դրա միջով անցնող մեկ կապ։ bubblewrap-ը գործարկելուց առաջ codex-linux-sandbox-ը ստեղծում է Unix սոքեթների զույգ՝ որպես կառավարման ալիք, և ճյուղավորվում է։ Զավակ պրոցեսը կատարում է run_host_bridge()-ը և սպասում այդ ալիքով լսիչի ֆայլային դեսկրիպտորը ստանալուն․
Այս օրինակում ծնող պրոցեսն օգտագործում է exec-ը՝ իր ծրագրային պատկերը bwrap-ով փոխարինելու համար։ Սա կարգավորում է մեկուսացված միջավայրը և դրա ներսում գործարկում codex-linux-sandbox --apply-seccomp-then-exec-ը՝ փոխանցելով նաև կառավարման ալիքի FD-ն․
Մեկուսացված միջավայրի ցանցային անվանատարածքում codex-linux-sandbox-ի երկրորդ կանչը ստեղծում է հետադարձ կապի TCP լսիչ և սոքեթի միջոցով փոխանցում դրա ֆայլային դեսկրիպտորը։ Լսիչը մնում է կապված մեկուսացված միջավայրի ցանցային անվանատարածքի հետ։ Սա թույլ է տալիս դրսում մնացած զավակ պրոցեսին ընդունել մեկուսացված ծրագրերի կապերը՝ միաժամանակ իր ելքային կապերը բացելով հոսթի ցանցային անվանատարածքում։ Փոխանցումից հետո երկու պրոցեսներն էլ փակում են կառավարման ալիքի իրենց դեսկրիպտորները, իսկ մեկուսացված միջավայրի ներսի պրոցեսը փակում է լսիչի իր օրինակը։
Երբ TCP լսիչը պատրաստ է, մեկուսացված միջավայրի ներսում գործող պրոցեսը համապատասխան արժեք է սահմանում HTTP_PROXY(բացվում է նոր պատուհանում) և հարակից միջավայրի փոփոխականների համար՝ դրանք ուղղելով դեպի այդ լսիչը։ Այնուհետև այն կիրառում է seccomp-ը՝ նախքան ճյուղավորումը և օգտատիրոջ հրամանի կատարումը․
Մեկուսացված միջավայրից դուրս գործող պրոցեսը լսիչը բաց է պահում։ Յուրաքանչյուր ընդունված կապի համար այն կապ է բացում կարգավորված պրոքսիի հետ և տվյալները փոխանցում երկու ուղղությամբ։
Այս լրացուցիչ մեխանիզմը հրամանին տալիս է սեփական ցանցային անվանատարածք՝ առանձին հետադարձ կապի միջերեսով։ macOS-ում Seatbelt-ը հրամանին թույլ է տալիս անմիջապես միանալ հոսթ համակարգի հետադարձ կապի միջերեսի նշված պորտերին։ Իսկ Linux-ում հրամանը միանում է իր մեկուսացված անվանատարածքի ներսում գտնվող լսիչին, և մեկուսացված միջավայրից դուրս գործող պրոցեսն այդ կապերը փոխանցում է կարգավորված պրոքսիին։ Դեսկրիպտորի փոխանցումը հնարավոր է դարձնում այս կապը՝ առանց հրամանին հոսթի ցանցային անվանատարածքը հասանելի դարձնելու։
Այս տարվա սկզբին մենք իրականացրինք և ներկայացրինք Windows-ում մեկուսացման ուղղությամբ մեր աշխատանքը։ Դրանից հետո Microsoft-ը թողարկեց MXC անունով գրադարան՝ Windows օպերացիոն համակարգում պրոցեսների մեկուսացման նոր հնարավորությունների հետ միասին։ Այժմ մենք մեր գործող մեկուսացված միջավայրը փոխարինում ենք MXC գրադարանն օգտագործող տարբերակով։
MXC-ն (Microsoft eXecution Container) Microsoft-ի մեկուսացված կոդի կատարման համակարգն(բացվում է նոր պատուհանում) է, որն աջակցում է մեկուսացման մի քանի ներքին մեխանիզմների՝ Windows-ում, Linux-ում և macOS-ում։ Համատեղելի Windows սարքերում Codex-ն աջակցում է MXC-ի վրա հիմնված մեկուսացված միջավայրի՝ համակարգի ներկառուցված պրոցեսների մեկուսացմամբ սահմանափակելով հրամաններն օգտատիրոջ առկա միջավայրում։
Մենք անցնում ենք MXC-ի՝ անվտանգությունն ու օգտագործման հարմարավետությունը բարելավելու և Windows-ի մեր առկա մեկուսացման մի շարք սահմանափակումները վերացնելու համար․
Մեկուսացված միջավայրը կարգավորելու համար բարձրացված կամ ադմինիստրատորի իրավունքների անհրաժեշտություն
ACL-ների ստուգման և սահմանման դանդաղ, ռեսուրսատար գործողություններ
Հոսթ համակարգչում պահպանվող մեկուսացման կարգավորումներ, այդ թվում՝
ACL-ներ
Ցանցային էկրանի կանոններ
Մեկուսացված միջավայրի օգտատերեր
Կառավարման շերտի ֆայլեր
MXC-ն տրամադրում է JSON կարգավորման սխեմա(բացվում է նոր պատուհանում)։ Codex-ն օգտագործում է MXC SDK-ն(բացվում է նոր պատուհանում)՝ այդ սխեմային համապատասխան կատարման հարցում կազմելու համար, որը պարունակում է հրամանը, աշխատանքային պանակը, միջավայրը և թույլտվությունները։ Այդ թույլտվությունները վերաբերում են ֆայլային համակարգի և ցանցի հասանելիությանը, ինչպես նաև Windows-ի ռեսուրսներին, օրինակ՝ աշխատասեղանին և փոխանակման բուֆերին։
Codex-ը մի շարք վերահսկման միջոցների համար օգտագործում է ֆիքսված կարգավորումներ՝ համատեղելիությունն ու անվտանգությունը հավասարակշռելու նպատակով։ Այն թույլ է տալիս կարդալ ռեեստրը և պահպանում է Win32k-ի ու աշխատասեղանի հասանելիությունը, որն անհրաժեշտ է PowerShell-ի գործարկման ժամանակ։ Փոխանակման բուֆերի հասանելիությունը, մուտքային իրադարձությունների ներարկումը, աշխատասեղանի և համակարգի կարգավորումների կառավարումն անջատված են։ Վերջապես, MXC-ին արգելվում է որպես պահուստային տարբերակ փոխել հոսթի ֆայլային համակարգի թույլտվությունները։
Codex-ը թույլտվությունների պրոֆիլի ֆայլային համակարգի և ցանցի կանոնները փոխակերպում է MXC-ի կարգավորումների։ Օգտագործենք վերը նշված dev պրոֆիլը և ենթադրենք, որ․
C:\,D:\ևZ:\սկավառակները համակարգչի միակ տեղային սկավառակներն են։Աշխատատարածքի արմատը և աշխատանքային պանակը
C:\work\demo-ն են։Օգտատիրոջ տնային պանակը
D:\Users\dev-ն է, ուստի~/build-cache-ը համապատասխանում էD:\Users\dev\build-cache-ին։Արգելման glob ձևանմուշին համապատասխանում են միայն
C:\work\demo\config\dev.envևC:\work\demo\config\prod.envֆայլերը։
MXC-ի համապատասխան կարգավորումները կներառեն հետևյալը․
MXC-ի ֆայլային համակարգի քաղաքականությունը լռելյայն արգելում է հասանելիությունը։ Ուստի Codex-ը տեղային սկավառակների արմատներին տալիս է միայն կարդալու թույլտվություններ՝ այս պրոֆիլով նախատեսված ընթերցման լայն հասանելիությունն ապահովելու համար։ Այս թույլտվությունները կիրառվում են ռեկուրսիվ՝ օգտատիրոջ՝ ՕՀ-ում ունեցած իրավունքների սահմաններում։
Մի նրբություն կա․ սկավառակի արմատում գրելու թույլտվությունները ռեկուրսիվ չեն կիրառվում, ուստի Codex-ը դրանք ընդլայնում է՝ ներառելով սկավառակի անմիջական ենթամակարդակի առկա տարրերը։
Ավելի կոնկրետ ուղիների թույլտվությունները գերակայում են վերադասների թույլտվություններին․ այսպես, C:\work\demo-ում կարելի է գրել միայն կարդալու համար նախատեսված C:\-ի ներսում, իսկ C:\work\demo\.git-ը մնում է միայն կարդալու համար։
Երբ ուղու տարբեր գրառումները կամ խորհրդանշական հղումների ու միացման կետերի այլանունները մատնանշում են նույն ուղին, MXC-ն կիրառում է ավելի խիստ թույլտվությունը․ արգելքն առաջնային է միայն կարդալու նկատմամբ, իսկ վերջինս՝ կարդալու և գրելու նկատմամբ։
MXC-ն ընդունում է միայն արգելման կոնկրետ ուղիներ, ուստի Codex-ը գործարկումից առաջ արգելման glob ձևանմուշները բացում է համապատասխանող ֆայլերի և պանակների։ Հրամանի կատարման ընթացքում glob ձևանմուշին համապատասխանող նոր ուղիներն ինքնաբերաբար չեն ավելացվում։
*.openai.com-ի նման դոմենային կանոններն ապահովում է վերը նկարագրված Codex-ի ընդհանուր ցանցային պրոքսին։ Codex-ն այդ պրոքսին գործարկում է մեկուսացված միջավայրից դուրս և դրա հասցեները հրամանին փոխանցում նախկինում նշված նույն ստանդարտ *_PROXY միջավայրի փոփոխականներով։ MXC-ն արգելափակում է ուղղակի արտաքին կապերը՝ թույլ տալով հոսթի հետադարձ կապի միջերեսով միացումները, այդ թվում՝ պրոքսիին։ Այլ տեղային ծառայությունները մնում են հասանելի։
macOS-ում, Linux-ում և Windows-ում հարնեսն օգտագործում է մեկուսացման նույն API-ն՝ թույլտվությունների պրոֆիլով հրամաններ գործարկելու համար։ Հարթակին հատուկ իրականացումներն ապահովում են այդ սահմանափակումները կիրառելու համար անհրաժեշտ կարգավորումը։
Կոդ գրելը և կատարելը ագենտներին խնդիրներ լուծելու ճկուն միջոց է տալիս նաև ծրագրային ապահովման մշակումից դուրս։ Codex-ի մեկուսացված միջավայրը նրանց թույլ է տալիս այդ հնարավորությունն օգտագործել օգտատիրոջ առկա միջավայրում՝ ֆայլային համակարգի և ցանցի հասանելիության հստակ սահմանափակումներով։ Այն հարնեսի վերօգտագործելի հիմնատարր է, իսկ codex sandbox հրամանն այն հասանելի է դարձնում ձեր իսկ ստեղծած գործիքներին։
Քանի որ ագենտներն ավելի շատ առաջադրանքներ են ստանձնում, ցանկանում ենք մեկուսացումը գործնական դարձնել ավելի շատ գործիքների և միջավայրերի համար։ Դա նշանակում է հեշտացնել թույլտվությունների կարգավորումը և օգտվել օպերացիոն համակարգերի ավելի լավ պաշտպանական միջոցներից՝ դրանց հասանելի դառնալուն պես։ Մեր նպատակն է ընդլայնել ագենտների հնարավորությունները՝ միաժամանակ մարդկանց վերահսկողության տակ պահելով այն, ինչին ագենտները կարող են հասանելիություն ունենալ։


