OpenAI

18. новембар 2026.

Инжењеринг

Унутар изолованог окружења 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 скрипти за аутоматско реаговање у .git/hooks.

  • Дозвољава широк приступ систему датотека за читање, у оквиру постојећих корисничких дозвола у оперативном систему. Компајлери, извршна окружења и алати за изградњу зависе од развојних пакета (SDK), библиотека и конфигурације изван депоа. Ограничавање читања на радни простор онемогућило би многе уобичајене токове рада. Компромис је у томе што и осетљиве датотеке на другим местима на рачунару могу остати доступне за читање, попут конфигурационих датотека које садрже API кључеве.

  • Онемогућава приступ мрежи. Тиме се блокира директно отпремање на спољне сервисе, укључујући покушаје изношења података које команда може да чита. То спречава и легитимне операције попут преузимања зависности, за које је потребан додатни приступ.

Ова ограничења спречавају широк спектар нежељеног понашања, али су штетне радње и даље могуће. На пример, агент би могао да убаци злонамерни код у локално инсталиран пакет као што је node_modules/prettier. Таква измена се можда не би видела у излазу команде git status јер Git често игнорише node_modules. Ако кориснички уређивач покреће ту копију алата Prettier при чувању, само чување датотеке могло би да изврши злонамерни код изван изолованог окружења Codex-а. Зато примењујемо вишеслојну одбрану: изоловано окружење ограничава чему команде могу да приступе, док обучавање и усклађивање помажу моделу да тај приступ користи у складу са намером корисника.

Смернице за прилагођавање дозвола изолованог окружења и њихово комбиновање са другим мерама заштите у предузећу потражите у практичном водичу за безбедност Codex-а⁠(отвара се у новом прозору).

Дизајнирање изолованог окружења

Виртуелне машине и контејнери⁠(отвара се у новом прозору) су два популарна механизма изолације, али за изоловано окружење Codex-а користимо другачији приступ. Уместо да ради изолације премести извршавање у засебно окружење, Codex користи механизме изолације сваке платформе да ограничи команде које се извршавају у постојећем корисничком окружењу.

Многим програмерима лаптоп служи као развојно окружење по мери, које могу да мењају кад год пожеле. Пресликавање тог окружења у Docker контејнер може захтевати труд, а неки токови рада и даље зависе од алата који се извршавају на рачунару домаћину.

Узмимо, на пример, коришћење Codex-а за развој iOS апликације на Mac рачунару. Ако бисте одлучили да изолујете Codex покретањем у Docker-у, он не би могао да покрене ланац алата за изградњу iOS апликација, састављен од извршних датотека за Mac, нити да покрене iPhone симулатор ради извршавања кода. Ток рада заснован на Docker-у могао би да препусти изградњу и рад са симулатором Mac домаћину, али би се те операције извршавале изван изолованог окружења контејнера и захтевале би засебна ограничења. За Codex бирамо једноставнији приступ: много улажемо у изолацију прилагођену сваком оперативном систему, како би Codex могао да ради у окружењу које најбоље одговара конкретном задатку.

Агентско окружење пружа приступ овим механизмима изолације специфичним за оперативни систем кроз заједнички API за macOS, Windows и Linux. Овај API прима команду и профил дозвола. Ако профил дозвола допушта ограничен приступ мрежи, позивалац мора да обезбеди мрежни прокси који спроводи та ограничења:

Python

1
# This is a simplified version of the actual API.
2
def spawn_command_under_sandbox(
3
program_and_args: list[str],
4
cwd: Path,
5
env: dict[str, str],
6
permission_profile: PermissionProfile,
7
network_proxy: NetworkProxy | None,
8
) -> Child:

Ова функција покреће процес у изолованом окружењу и враћа ручицу Child коју агентско окружење може да користи да сачека његов завршетак. Сваки подређени процес наслеђује ограничења изолованог окружења свог родитеља. Зато та ограничења важе у целом стаблу процеса покренутом командом, чак и за потомке који настављају да раде након завршетка почетног процеса.

Следећи дијаграм показује како су ови делови повезани, од конфигурације до извршавања команде у изолованом окружењу. Одељци у наставку објашњавају сваку фазу.

Дијаграм тока: конфигурација и централно управљани захтеви дефинишу профил дозвола сесије; Codex окружење покреће команде уз ограничења изолованог окружења специфична за macOS, Linux или Windows. Подређени процеси наслеђују та ограничења, а опциони мрежни прокси спроводи правила за домене.

Како агентско окружење користи изоловано окружење

Као што је објашњено у чланку Како функционише петља Codex агента, Codex окружење је задужено за извршавање позива алата које генерише модел. За програмерске задатке најчешће се користи алат љуске, који извршава команде слично као корисник у интерактивној љусци попут Bash-а. Овде ћемо размотрити једнократни ⁠(отвара се у новом прозору)алат љуске ⁠(отвара се у новом прозору)exec_command⁠(отвара се у новом прозору) да покажемо како агентско окружење користи изолацију за постизање жељене заштите.

Ово је поједностављени приказ начина на који би Codex окружење обрадило позив алата
exec_command без изолације:

Python

1
# Illustrative implementation of the exec_command tool call.
2

3
class ExecCommandToolCall:
4
cmd: str
5
workdir: str | None = None
6
shell: str | None = None
7
login: bool = True
8
timeout_ms: int = 10_000
9

10

11
def perform_exec_command(tool_call: ExecCommandToolCall):
12
program_and_args = [
13
tool_call.shell or os.environ.get("SHELL") or "/bin/sh",
14
"-lc" if tool_call.login else "-c",
15
tool_call.cmd,
16
]
17
child = subprocess.Popen(
18
program_and_args,
19
# workdir defaults to the turn's cwd, assumed here to be the process cwd.
20
cwd=Path(tool_call.workdir or ".").absolute(),
21
stdout=subprocess.PIPE,
22
stderr=subprocess.STDOUT,
23
)
24
output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)
25
return {"output": output, "exit_code": exit_code}

Да би изоловало команду, агентско окружење замењује позив subprocess.Popen() позивом spawn_command_under_sandbox(). Агентско окружење обезбеђује профил дозвола и, када је потребно, мрежни прокси:

Python

1
# Honoring the exec_command tool call while enforcing sandbox constraints.
2

3
def perform_exec_command_with_sandboxing(
4
tool_call: ExecCommandToolCall,
5
permission_profile: PermissionProfile,
6
network_proxy: NetworkProxy | None,
7
):
8
# ...build program_and_args as in the previous example...
9
child = spawn_command_under_sandbox(
10
program_and_args=program_and_args,
11
cwd=Path(tool_call.workdir or ".").absolute(),
12
env=os.environ.copy(),
13
permission_profile=permission_profile,
14
network_proxy=network_proxy,
15
)
16
output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)
17
return {"output": output, "exit_code": exit_code}

Алат exec_command омогућава моделу и да затражи другачије дозволе за појединачну команду, али агентско окружење одлучује да ли ће захтев одобрити:

Python

1
class ExecCommandToolCall:
2
# ...command-related fields...
3

4
# Per-command sandbox override. Defaults to "use_default".
5
sandbox_permissions: Literal[
6
"use_default",
7
"with_additional_permissions",
8
"require_escalated",
9
] = "use_default"
10

11
# User-facing approval question; only for "require_escalated".
12
justification: str | None = None
13

14
# Expand network or filesystem access; only for "with_additional_permissions".
15
# AdditionalPermissions supports fine-grained options.
16
additional_permissions: AdditionalPermissions | None = None

Када је наведено 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 омогућава вам да у сопствене алате уградите извршавање команди у изолованом окружењу, као што ћемо видети касније. У наставку ћемо погледати како се дефинишу профили дозвола.

Подешавање изолованог окружења

Именовани профил дозвола омогућава вам да иста ограничења приступа систему датотека и мрежи користите у више пројеката. Сопствене профиле можете дефинисати у одељку [permissions] датотеке config.toml. На пример, следећа конфигурација дефинише профил dev који проширује⁠(отвара се у новом прозору) уграђени профил :workspace:

TOML

1
# Use the dev profile by default.
2
default_permissions = "dev"
3

4
[permissions.dev]
5
# This is displayed when /permissions is run in the Codex CLI.
6
description = "Development with extra read-only protections."
7

8
# A profile can be derived from an existing profile.
9
# Profiles starting with ":" are provided by Codex.
10
extends = ":workspace"
11

12
[permissions.dev.filesystem]
13
"~/build-cache" = "write"
14

15
[permissions.dev.filesystem.":workspace_roots"]
16
".devcontainer" = "read"
17
".vscode" = "read"
18
"**/*.env" = "deny"
19
"secrets" = "deny"

Профил dev додаје дозволу за упис у ~/build-cache и поставља додатна ограничења за датотеке у радном простору. Уноси за систем датотека могу да дозволе само читање (read), читање и упис (write) или потпуно блокирају приступ (deny).

Табела :workspace_roots омогућава дефинисање правила за путање релативне у односу на корене радног простора пројекта. Codex CLI подразумевано користи свој радни директоријум као једини корен радног простора, док ChatGPT апликација за рачунар користи фасцикле са изворним кодом пројекта. Codex примењује свако правило на сваки корен, па унос .vscode у профилу dev чини директоријум .vscode доступним само за читање у сваком корену.

Поред сопствених правила, dev наслеђује следеће мере заштите из профила :workspace:

TOML

1
[permissions.":workspace".filesystem.":workspace_roots"]
2
".agents" = "read"
3
".aws" = "read"
4
".codex" = "read"
5
".git" = "read"

Мрежне дозволе

За подешавање мреже у изолованом окружењу Codex-а постоје три основне опције:

  • Онемогућити сав приступ мрежи (подразумевано за профил :workspace)

  • Омогућити потпун, директан приступ мрежи (подразумевано за профил :danger-full-access)

  • Ограничити приступ мрежи на прокси, који на основу профила дозвола одлучује шта ће пропустити


Да бисте профилу
dev омогућили директан приступ мрежи, поставите permissions.dev.network.enabled = true на највишем нивоу датотеке config.toml. Тиме се даје потпун приступ мрежи када је мрежни прокси онемогућен.

Да бисте профил dev ограничили на скуп домена, омогућите мрежни прокси и подесите његова правила за домене:

TOML

1
[permissions.dev.network]
2
enabled = true
3

4
[permissions.dev.network.domains]
5
"*.openai.com" = "allow"
6
# Allow requests to local services by hostname or by IPv4/IPv6 loopback address.
7
"localhost" = "allow"
8
"127.0.0.1" = "allow"
9
"::1" = "allow"
10
"evil.example" = "deny"
11

12
[features]
13
# If neither local config nor managed requirements enable the proxy,
14
# this profile allows direct network access; domain rules are not enforced.
15
network_proxy = true

Правила за домене подржавају тачне називе и обрасце са џокер знаковима, при чему изричите забране имају предност над дозволама. Захтеви ка другим доменима захтевају одобрење или се блокирају, као што је описано у одељку Мрежни прокси у наставку.

Слојевита конфигурација и спровођење ограничења

Појединачни корисници могу да подесе подразумеване вредности које важе за све пројекте и да их замене за одређени поуздан пројекат. Администратори предузећа такође могу желети да подесе подразумеване вредности за кориснике и ограниче која подешавања они могу да мењају. Codex подржава оба приступа кроз слојевиту конфигурацију и централно управљане захтеве.

Као што је описано у одељку Приоритет конфигурације,⁠(отвара се у новом прозору) Codex обједињује подешавања из више датотека config.toml. Табеле се обједињују рекурзивно, а када се вредности сукобе, предност има извор вишег приоритета. Низови се замењују у целини.

Зато профили дозвола користе табеле за путање у систему датотека и мрежне домене. Тим може да додаје или замењује појединачне уносе у сопственој конфигурацији и аутоматски наслеђује измене свих осталих уноса у основној конфигурацији организације:

TOML

1
[permissions.dev.filesystem.":workspace_roots"]
2
".idea" = "read"
3

4
[permissions.dev.network.domains]
5
"example.com" = "allow"

Администратори могу да задају и централно управљане захтеве⁠(отвара се у новом прозору) путем датотеке requirements.toml како би ограничили избор конфигурације за кориснике. Ови захтеви могу потицати из више извора, укључујући системске датотеке и смернице из облака. Чест случај употребе је навођење allowed_permission_profiles ради ограничавања скупа профила дозвола које корисник у предузећу може да изабере. На пример, администратор би могао да зада следеће захтеве из облака:

TOML

1
default_permissions = ":read-only"
2

3
[allowed_permission_profiles]
4
":read-only" = true
5
":danger-full-access" = false

Захтеви из облака имали би предност над системском датотеком захтева на /etc/codex/requirements.toml, па унос у тој датотеци не може да поништи изричито подешавање ":danger-full-access" = false наведено изнад. Ако :workspace није наведен, други слој захтева може да обезбеди тај унос. Профили чији уноси имају вредност false или недостају у коначној обједињеној табели нису доступни.

Ово раздвајање омогућава организацијама да спроводе ограничења, а корисницима да унутар њих прилагођавају своју конфигурацију. Добијене профиле дозвола може да користи агентско окружење или се могу применити директно на команду, као што ћемо видети у наставку.

Коришћење команде codex sandbox

Codex CLI пружа команду sandbox за лакше извршавање произвољне команде под профилом дозвола дефинисаним у Codex конфигурацији. Она се често користи за тестирање профила, како би се проверило да изоловано окружење заиста спречава понашање које треба да блокира.

На пример, следећа команда покушава да подеси VS Code да при чувању покреће злонамерни аутоматски форматер. Ако .vscode већ постоји, претходно дефинисани профил dev требало би да блокира овај упис јер је тај директоријум само за читање (codex sandbox подразумевано третира cwd као корен радног простора):

Bash

1
codex sandbox --permission-profile dev -- \
2
bash -c 'cat > .vscode/settings.json' <<'JSON'
3
{
4
"prettier.prettierPath": "./node_modules/evil-prettier",
5
"[typescript]": {
6
"editor.defaultFormatter": "esbenp.prettier-vscode",
7
"editor.formatOnSave": true
8
}
9
}
10
JSON

Заиста, на систему macOS ово не успева и даје следећу поруку:

Обичан текст

1
bash: .vscode/settings.json: Operation not permitted

Команда codex sandbox чини механизам изолације Codex-а доступним независно од агентске сесије. Исти конфигурациони језик и механизме спровођења ограничења за сваку платформу можете користити да ограничите команде које покрећу ваши алати.

Пример: изолација MCP сервера

За stdio MCP сервер подешен у config.toml, Codex окружење не покушава да изолује команду којом се сервер покреће. Codex не може поуздано да закључи које датотеке или мрежни сервиси су том серверу потребни, па би примена подразумеваног профила изолације могла да онемогући рад иначе исправне конфигурације.

На пример, стандардни начин подешавања MCP сервера @modelcontextprotocol/server-memory⁠(отвара се у новом прозору) за коришћење са Codex-ом је следећи:

TOML

1
[mcp_servers.memory]
2
command = "npx"
3
args = [
4
"-y",
5
"@modelcontextprotocol/server-memory@1.0.0"
6
]
7

8
[mcp_servers.memory.env]
9
MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"

Пошто се ова команда npx извршава без изолације, може да уписује датотеке и шаље мрежне захтеве са истим дозволама као корисник који покреће Codex, што јој даје превише слободе. Да бисмо је ограничили, можемо дефинисати профил дозвола memory-mcp, а затим оригиналну команду npx покренути преко codex sandbox --permission-profile memory-mcp. Тако ограничавамо где сервер може да уписује податке и спречавамо приступ мрежи:

TOML

1
[permissions.memory-mcp.filesystem]
2
# Allow broad reads for Node.js/npm dependencies and configuration.
3
":root" = "read"
4
"~/.npm" = "write"
5
"~/mcp-data" = "write"
6

7
[permissions.memory-mcp.network]
8
enabled = false
9

10
[mcp_servers.memory]
11
command = "codex"
12
args = [
13
"sandbox",
14
"--permission-profile",
15
"memory-mcp",
16
"--",
17
"npx",
18
"--offline",
19
"@modelcontextprotocol/server-memory@1.0.0"
20
]
21

22
[mcp_servers.memory.env]
23
MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"

Пре покретања сервера направите његов директоријум за податке и у npm кеш сместите пакет са фиксираном верзијом. То омогућава команди npx --offline да покрене сервер под профилом који онемогућава приступ мрежи:

Bash

1
# The sandbox can write to this folder, but it cannot create it.
2
mkdir -p ~/mcp-data
3

4
# Installing the MCP server requires network access.
5
npx -y --package=@modelcontextprotocol/server-memory@1.0.0 -c true

Када је пакет у кешу, Codex може да покрене сервер за меморију без приступа мрежи, уз упис ограничен на npm кеш и серверски директоријум за податке.

Имплементација изолованог окружења Codex-а

Имплементација изолованог окружења претвара профил дозвола у ограничења која спроводи оперативни систем. Основна логика мрежног проксија за обраду захтева и примену смерница заједничка је за сва три главна оперативна система, док су подешавање проксија и интеграција са изолованим окружењем специфични за сваки систем. Најпре ћемо размотрити заједнички прокси, а затим имплементације за macOS, Linux и Windows.

Мрежни прокси

Да би спровело мрежна ограничења профила дозвола, агентско окружење покреће мрежни прокси и подешава изоловано окружење тако да дозволи везе са њим, а блокира директне везе са спољним рачунарима. Прокси проверава сваки захтев према правилима профила за домене како би одлучио да ли да га проследи.

У Codex депоу, мрежни прокси је имплементиран у пакету codex-network-proxy⁠(отвара се у новом прозору), који агентско окружење користи као библиотеку, мада се може изградити и као самостални алат командне линије⁠(отвара се у новом прозору). Када је омогућен, codex-network-proxy подразумевано покреће и HTTP прокси и SOCKS5 прокси. Адресе ових проксија прослеђују се процесу покренутом у изолованом окружењу путем променљивих окружења. Поред стандардних променљивих окружења као што су HTTP_PROXY, HTTPS_PROXY и ALL_PROXY, додаје се и низ познатих променљивих окружења специфичних за апликације⁠(отвара се у новом прозору), попут PIP_PROXY. Додуше, не поштују сви програми ове променљиве окружења. Ако програм покуша директно да се повеже са спољним рачунаром, ограничења изолованог окружења која спроводи оперативни систем блокирају ту везу, као што је описано у одељцима за појединачне платформе у наставку.

Мрежни прокси је задужен за спровођење мрежних ограничења дефинисаних у профилу дозвола. На пример, раније приказани профил dev дозвољава захтеве ка *.openai.com и изричито забрањује захтеве ка evil.example. Када је захтев упућен домену који не одговара ниједном правилу дозволе или забране, прокси може да га стави на чекање и затражи одобрење од агентског окружења. Као и у примеру команде љуске, Codex може директно да затражи одобрење од корисника или да захтев упути на аутоматску проверу⁠(отвара се у новом прозору). Када добије одлуку, прокси или дозвољава наставак захтева или га одбија одговором о грешци.

Редослед је овде важан јер чак и DNS упит може да открије информације кодиране у имену хоста. Зато прокси разрешава тражено име хоста тек пошто утврди да је дозвољено или одобрено. Имајте у виду да широка правила са џокер знаковима или приступ DNS сервисима и даље могу омогућити изношење података путем DNS-а.

macOS

На систему macOS, Codex користи Seatbelt⁠(отвара се у новом прозору), Apple-ов механизам изолације који спроводи језгро система. Seatbelt смернице пишу се на језику Sandbox Profile Language (SBPL), заснованом на језику Scheme, који служи за изражавање ограничења изолованог окружења. Codex позива Seatbelt преко macOS команде /usr/bin/sandbox-exec. Као и codex sandbox, она прима опције које описују изоловано окружење, а затим команду за извршавање:

Bash

1
sandbox-exec -p PROFILE [-Dkey=value]* -- PROG ARGS...

PROFILE је SBPL ниска која садржи уносе за подешавање изолованог окружења. На пример, следећи SBPL исечак дозвољава читање и упис у /dev/null и /dev/zero према смерницама изолованог окружења:

Scheme

1
(allow file-read* file-test-existence file-write-data
2
(literal "/dev/null")
3
(literal "/dev/zero"))

Када се при покретању изолованог окружења омогући мрежни прокси, у профил се додају правила попут следећих како би се везе ограничиле на одговарајуће локалне портове:

Scheme

1
; local HTTP proxy launched by Codex
2
(allow network-outbound (remote ip "localhost:3128"))
3

4
; local SOCKS proxy launched by Codex
5
(allow network-outbound (remote ip "localhost:8081"))


Основни профил Codex-а почиње са
(deny default), па одлазне везе остају блокиране ако нису изричито дозвољене.

На крају, SBPL може да садржи места за уметање вредности помоћу (param):

Scheme

1
; Pass -DWRITABLE_ROOT_0=/path/to/dir to specify a folder that cannot be removed.
2
(deny file-write-unlink
3
(require-all
4
(literal (param "WRITABLE_ROOT_0"))
5
(vnode-type DIRECTORY)))

која се попуњавају опцијама -Dkey=value прослеђеним команди sandbox-exec.

Да би имплементирао сопствени 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

За креирање изолованог окружења на систему Linux, Codex комбинује bubblewrap⁠(отвара се у новом прозору) (bwrap), алат командне линије за изградњу изолованих окружења, и seccomp-bpf⁠(отвара се у новом прозору), механизам Linux језгра за филтрирање системских позива. Интерни помоћни програм codex-linux-sandbox координира подешавање. Као и sandbox-exec на систему macOS, прима конфигурацију изолованог окружења, а затим команду за извршавање:

Bash

1
codex-linux-sandbox SANDBOX_ARGS... -- PROG ARGS...

Када је потребна изолација система датотека или усмеравање преко проксија, 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)

Да би помоћу ових опција применио обрасце забране, Codex их пре покретања сваке команде развија у конкретне путање. Нове путање које одговарају обрасцима не додају се аутоматски у ограничења изолованог окружења те команде.

Codex задаје и опције попут --unshare-ipc и --unshare-pid да спречи приступ другим врстама ресурса домаћина из изолованог окружења, па bubblewrap утиче на више од саме видљивости датотека.

Када користи bubblewrap, Codex прослеђује --unshare-net кад год је мрежа онемогућена или везе морају ићи преко мрежног проксија. Тиме се за изоловано окружење прави нов мрежни именски простор. Затим користимо seccomp-bpf да додатно ограничимо мрежне системске позиве и породице сокета доступне команди.


Конкретно, користимо
пакет seccompiler⁠(отвара се у новом прозору) да динамички компајлирамо BPF програм на основу жељених филтера⁠(отвара се у новом прозору) и применимо га на покретачки процес у изолованом окружењу, тако да цело стабло процеса наследи ограничења. Зато bwrap не покреће корисничку команду, већ покретач codex-linux-sandbox са сопственим конфигурационим аргументима, иза којих следи корисничка команда:

Bash

1
bwrap BWRAP_ARGS... -- \
2
codex-linux-sandbox --apply-seccomp-then-exec CODEX_LINUX_SANDBOX_ARGS... -- \
3
PROG ARGS...

Да би применио seccomp филтере без повишених привилегија, покретач поставља Linux заставицу no_new_privs за забрану нових привилегија⁠(отвара се у новом прозору). Подређени процеси наслеђују ову заставицу, која их спречава да стекну додатне привилегије при извршавању другог програма, попут извршне датотеке са ознаком setuid.

seccomp филтери зависе од мрежне конфигурације. Када је приступ мрежи онемогућен, блокирамо низ мрежних системских позива, попут connect(2) и bind(2). Међутим, када је мрежни прокси омогућен у изолованом окружењу, дозвољавамо IP сокете како би TCP ослушкивач који креира codex-linux-sandbox био доступан. Подразумевано блокирамо креирање самосталних сокета Unix домена јер би они могли да омогуће ненамеран приступ ресурсима домаћина.

Повезивање са мрежним проксијем

Када конфигурација изолованог окружења захтева мрежни прокси, Codex окружење креира једну инстанцу проксија која се може поново користити у више позива codex-linux-sandbox у истој Codex нити. Сваком изолованом окружењу потребан је начин да из свог изолованог мрежног именског простора приступи том заједничком проксију. Codex у том именском простору обезбеђује TCP ослушкивач на интерфејсу повратне петље и подешава процес изван изолованог окружења да прихвата његове везе и прослеђује их проксију.

Следећи дијаграми приказују ово подешавање за једну крајњу тачку проксија, а последњи дијаграм приказује једну везу кроз њу. Пре покретања алата bubblewrap, codex-linux-sandbox креира пар Unix сокета као управљачки канал и грана се у два процеса. Подређени процес покреће run_host_bridge() и чека да преко тог канала прими дескриптор датотеке ослушкивача:

Дијаграм Codex окружења које покреће codex-linux-sandbox, а он гранањем ствара процес за прослеђивање повезан управљачким каналом преко Unix сокета.

У овом примеру, надређени процес користи exec да замени своју програмску слику програмом bwrap. Тиме се поставља изоловано окружење и у њему покреће codex-linux-sandbox --apply-seccomp-then-exec, уз прослеђивање дескриптора датотеке управљачког канала:

Дијаграм који приказује како bwrap креира мрежни именски простор изолованог окружења и у њему покреће codex-linux-sandbox, уз управљачки канал преко Unix сокета до процеса за прослеђивање изван изолованог окружења.

У мрежном именском простору изолованог окружења, други позив codex-linux-sandbox креира TCP ослушкивач на интерфејсу повратне петље и прослеђује његов дескриптор датотеке преко сокета. Ослушкивач остаје повезан са мрежним именским простором изолованог окружења. Тако подређени процес који је остао изван њега може да прихвата везе из изолованих програма, а своје везе ка проксију отвара у мрежном именском простору домаћина. Након предаје, оба процеса затварају своје дескрипторе управљачког канала, а процес у изолованом окружењу затвара своју копију ослушкивача.

Када TCP ослушкивач буде спреман, процес у изолованом окружењу подешава одговарајућу вредност за HTTP_PROXY⁠(отвара се у новом прозору) и повезане променљиве окружења тако да упућују на тај ослушкивач. Затим примењује seccomp пре гранања процеса и извршавања корисничке команде:

Дијаграм који приказује програм у изолованом окружењу повезан са TCP ослушкивачем на интерфејсу повратне петље, док спољни процес codex-linux-sandbox прослеђује саобраћај мрежном проксију Codex-а.

Процес изван изолованог окружења држи ослушкивач отвореним. За сваку прихваћену везу отвара везу са подешеним проксијем и преноси податке у оба смера.

Овај додатни механизам команди обезбеђује сопствени мрежни именски простор, укључујући засебан интерфејс повратне петље. На систему macOS, Seatbelt дозвољава команди да се директно повеже са наведеним портовима на интерфејсу повратне петље рачунара домаћина. На систему Linux, команда се уместо тога повезује са ослушкивачем у свом изолованом именском простору, а процес изван изолованог окружења прослеђује те везе подешеном проксију. Предаја дескриптора омогућава ову везу без излагања мрежног именског простора домаћина команди.

Windows

Почетком ове године имплементирали смо изоловано окружење на систему Windows и писали о том раду. У међувремену, Microsoft је објавио библиотеку MXC и нове могућности за изолацију процеса у оперативном систему Windows. Тренутно замењујемо постојеће изоловано окружење новим, које користи библиотеку MXC.

Шта је MXC?

MXC (Microsoft eXecution Container) је Microsoft-ов систем за извршавање кода у изолованом окружењу⁠(отвара се у новом прозору) који подржава више механизама изолације на системима Windows, Linux и macOS. Codex подржава изоловано окружење засновано на MXC-у на компатибилним Windows уређајима и користи уграђену изолацију процеса да ограничи команде у постојећем корисничком окружењу.

Прелазимо на MXC да бисмо побољшали безбедност и употребљивост и превазишли неколико ограничења нашег постојећег изолованог окружења за Windows:

  • Потреба за повишеним или администраторским привилегијама за постављање изолованог окружења

  • Захтевне и споре операције провере и подешавања листа контроле приступа (ACL)

  • Трајни остаци подешавања изолованог окружења на рачунару домаћину, укључујући

    • Листе контроле приступа (ACL)

    • Правила заштитног зида

    • Корисничке налоге изолованог окружења

    • Датотеке управљачког слоја

MXC пружа JSON шему конфигурације⁠(отвара се у новом прозору). Codex користи MXC SDK⁠(отвара се у новом прозору) за састављање захтева за извршавање који прати ту шему и садржи команду, радни директоријум, окружење и дозволе. Те дозволе обухватају приступ систему датотека и мрежи, као и Windows ресурсима попут радне површине и оставе.

Превођење смерница у MXC позив

Codex користи фиксна подешавања за неколико контрола како би уравнотежио компатибилност и безбедност. Дозвољава читање регистра и задржава приступ Win32k-у и радној површини који је PowerShell-у потребан при покретању. Приступ остави, убризгавање улазних догађаја и управљање радном површином и системским подешавањима су онемогућени. На крају, MXC-у је забрањено да као резервно решење мења дозволе система датотека домаћина.

Codex преводи правила за систем датотека и мрежу из профила дозвола у MXC конфигурацију. За раније наведени профил dev, уз следеће претпоставке:

  • C:\, D:\ и Z:\ су једини локални дискови рачунара.

  • Корен радног простора и радни директоријум су C:\work\demo.

  • Кориснички матични директоријум је D:\Users\dev, па се ~/build-cache разрешава у D:\Users\dev\build-cache.

  • Образац забране одговара само датотекама C:\work\demo\config\dev.env и C:\work\demo\config\prod.env.

Одговарајућа MXC подешавања обухватала би:

JSON

1
{
2
...
3
"filesystem": {
4
"readwritePaths": [
5
"C:\\work\\demo",
6
"D:\\Users\\dev\\build-cache",
7
...
8
],
9
"readonlyPaths": [
10
"C:\\",
11
"D:\\",
12
"Z:\\",
13
"C:\\work\\demo\\.agents",
14
"C:\\work\\demo\\.aws",
15
"C:\\work\\demo\\.codex",
16
"C:\\work\\demo\\.devcontainer",
17
"C:\\work\\demo\\.git",
18
"C:\\work\\demo\\.vscode",
19
...
20
],
21
"deniedPaths": [
22
"C:\\work\\demo\\config\\dev.env",
23
"C:\\work\\demo\\config\\prod.env",
24
"C:\\work\\demo\\secrets"
25
]
26
},
27
"network": {
28
"egress": {
29
"default": "deny",
30
"allow": [{
31
"to": [
32
{"cidr": "127.0.0.0/8"},
33
{"cidr": "::1/128"}
34
]
35
}]
36
},
37
"ingress": {
38
"default": "deny",
39
"hostLoopback": "allow"
40
}
41
},
42
...
43
}

Приступ коренима дискова

MXC смернице за систем датотека подразумевано забрањују приступ. Codex зато додаје дозволе само за читање корена локалних дискова како би обезбедио широк приступ за читање који овај профил дозвољава. Ове дозволе се примењују рекурзивно, у оквиру постојећих корисничких дозвола у оперативном систему.

Постоји једна посебност: дозволе за упис у корен диска не примењују се рекурзивно, па их Codex проширује на постојеће ставке непосредно у корену диска.

Сукобљене дозволе

Прецизније путање имају предност над дозволама надређених путања, па C:\work\demo може дозвољавати упис унутар C:\ који је само за читање, док C:\work\demo\.git остаје само за читање.

Када различити записи путање или алијаси преко симболичких веза и спојева упућују на исту путању, MXC примењује строжу дозволу: забрана има предност над читањем, а читање над читањем и уписом.

Обрасци забране

MXC прихвата само конкретне путање за забрану, па Codex пре покретања развија обрасце забране у одговарајуће датотеке и директоријуме. Нове путање које одговарају обрасцу не додају се аутоматски док се команда извршава.

Приступ мрежи

Правила за домене попут *.openai.com спроводи раније описани заједнички мрежни прокси Codex-а. Codex покреће тај прокси изван изолованог окружења и прослеђује његове адресе команди кроз исте стандардне променљиве окружења *_PROXY које смо раније поменули. MXC блокира директне спољне везе, а дозвољава везе преко интерфејса повратне петље домаћина, укључујући приступ проксију. Остали локални сервиси остају доступни.

На системима macOS, Linux и Windows, агентско окружење користи исти API изолованог окружења за покретање команди под профилом дозвола. Имплементације за појединачне платформе обављају подешавања потребна за примену тих ограничења.

Даљи развој на темељу изолованог окружења Codex-а

Писање и извршавање кода пружају агентима флексибилан начин решавања проблема и изван развоја софтвера. Изоловано окружење Codex-а омогућава им да ту способност користе у постојећем корисничком окружењу, уз изричита ограничења приступа систему датотека и мрежи. То је основна компонента агентског окружења која се може поново користити, а команда codex sandbox чини је доступном и алатима које сами правите.

Како агенти преузимају све више задатака, желимо да изолација постане практична за више алата и окружења. То значи да треба олакшати подешавање дозвола и користити боље заштитне механизме оперативних система чим постану доступни. Наш циљ је да проширимо могућности агената, а да људи задрже контролу над тим чему они могу да приступе.

Аутор

OpenAI

Захвалнице

Посебно захваљујемо Дејвиду Визену, Чарлију Вимсу, Вијату Балодији и Фотису Чанцису на доприносу овом чланку.