OpenAI

18 nëntor 2026

Inxhinieria

Brenda mjedisit të izoluar të Codex

Si ekzekuton Codex komanda në kompjuterin tuaj me kufij që kontrolloni ju.

Nga Michael Bolin, anëtar i stafit teknik

Në OpenAI, ndjekim një qasje të mbrojtjes me shumë shtresa⁠(hapet në një dritare të re) për sigurinë e agjentëve. Ndonëse investimet tona në trajnim dhe përafrim janë thelbësore për këtë përpjekje, ne zbatojmë edhe veçori në strukturën tonë për agjentët, Codex⁠(hapet në një dritare të re), për të ofruar mbrojtje shtesë. Meqë një nga veprimet më të zakonshme (dhe potencialisht të rrezikshme) të Codex është ekzekutimi i komandave në kompjuterin tuaj, ndërtuam mjedisin e izoluar të Codex, që ai të punojë në mjedisin tuaj ekzistues brenda kufijve të sistemit të skedarëve dhe rrjetit që kontrolloni ju.

Një ⁠(hapet në një dritare të re)mjedis i izoluar⁠(hapet në një dritare të re) kufizon burimet ku mund të ketë qasje një program gjatë ekzekutimit. Për një detyrë organizimi fotosh, mund ta konfiguroni mjedisin e izoluar të Codex që t’i lejojë komandat të lexojnë dhe ndryshojnë skedarët në ~/Pictures, ndërsa bllokon qasjen në rrjet për të parandaluar ngarkimet. Për rishikimin e kodit, mund të lejoni qasjen në dokumentacionin në internet, duke i mbajtur skedarët burimorë vetëm për lexim. Përdoruesit e konfigurojnë mjedisin e izoluar të Codex përmes ⁠(hapet në një dritare të re)profileve të lejeve⁠(hapet në një dritare të re), që përcaktojnë kufizimet e sistemit të skedarëve dhe rrjetit për një seancë Codex.

Në këtë artikull do të fillojmë me kompromiset që qëndrojnë pas cilësimeve të parazgjedhura të izolimit në Codex, pastaj do të shpjegojmë projektimin e mjedisit të izoluar dhe si e përdor struktura për të ekzekutuar komanda. Do të tregojmë si mund t’i përshtatin lejet përdoruesit fundorë dhe ndërmarrjet sipas nevojave të tyre, si dhe si mund ta ripërdorin zhvilluesit mjedisin e izoluar në mjetet e tyre. Së fundi, do të shqyrtojmë si zbatohen këto kufizime në macOS, Linux dhe Windows.

Zgjedhja e kufijve të mjedisit të izoluar

Në Codex, filozofia jonë është të caktojmë cilësime të parazgjedhura të kujdesshme për mjedisin e izoluar, që gjithsesi mundësojnë punë të dobishme. Për shembull, kur një depo Git është rrënja e hapësirës së punës, profili i integruar i lejeve :workspace:

  • Lejon shkrimin brenda hapësirës së punës, ndërsa direktoritë si .git dhe .codex i mban vetëm për lexim. Kjo e lejon Codex të ndryshojë kodin burimor pa kërkuar leje për çdo ndryshim, ndërsa pengon ndryshimet e drejtpërdrejta në .codex/config.toml ose në skriptet hook të Git nën .git/hooks.

  • Lejon lexim të gjerë të sistemit të skedarëve, brenda kufijve të lejeve ekzistuese të përdoruesit në sistemin operativ. Përpiluesit, mjediset e ekzekutimit dhe mjetet e ndërtimit varen nga SDK-të, bibliotekat dhe konfigurimet jashtë depos. Kufizimi i leximit vetëm te hapësira e punës do të pengonte shumë rrjedha të zakonshme pune. Kompromisi është se edhe skedarët sensitivë diku tjetër në kompjuter mund të mbeten të lexueshëm (si skedarët e konfigurimit që përmbajnë çelësa API).

  • Çaktivizon qasjen në rrjet. Kjo bllokon ngarkimet e drejtpërdrejta në shërbime të jashtme, përfshirë përpjekjet për të nxjerrë pa leje të dhëna që komanda mund t’i lexojë. Gjithashtu pengon operacione legjitime si shkarkimi i varësive, të cilat kërkojnë qasje shtesë.

Këto kufizime parandalojnë shumë lloje sjelljesh të padëshiruara, por veprimet e dëmshme mbeten të mundshme. Për shembull, agjenti mund të injektojë kod keqdashës në një paketë të instaluar lokalisht si node_modules/prettier. Një ndryshim i tillë mund të mos shfaqet në git status, sepse node_modules shpesh shpërfillet nga Git. Nëse redaktuesi i përdoruesit e ekzekuton atë kopje të Prettier gjatë ruajtjes, vetëm ruajtja e një skedari mund ta ekzekutojë kodin keqdashës jashtë mjedisit të izoluar të Codex. Prandaj ndjekim një qasje mbrojtjeje me shumë shtresa: mjedisi i izoluar kufizon burimet ku mund të kenë qasje komandat, ndërsa trajnimi dhe përafrimi e ndihmojnë modelin ta përdorë këtë qasje sipas qëllimit të përdoruesit.

Për udhëzime mbi përshtatjen e lejeve të mjedisit të izoluar dhe kombinimin e tyre me mbrojtje të tjera në një mjedis ndërmarrjeje, shihni udhëzuesin praktik të sigurisë së Codex⁠(hapet në një dritare të re).

Projektimi i mjedisit të izoluar

Makinat virtuale dhe kontejnerët⁠(hapet në një dritare të re) janë dy mekanizma të përhapur për izolim, por për mjedisin e izoluar të Codex ndjekim një qasje tjetër. Në vend që ta zhvendosë përpunimin në një mjedis të veçantë për të siguruar izolim, Codex përdor mekanizmat e izolimit të çdo platforme për të kufizuar komandat që ekzekutohen në mjedisin ekzistues të përdoruesit.

Për shumë zhvillues, laptopi shërben si një mjedis zhvillimi i përshtatur posaçërisht, që mund ta ndryshojnë sa herë të duan. Rikrijimi i atij mjedisi në një kontejner Docker mund të kërkojë punë, dhe disa rrjedha pune ende varen nga mjete që ekzekutohen në sistemin pritës.

Për shembull, mendoni përdorimin e Codex për të zhvilluar një aplikacion iOS në një Mac. Nëse do të vendosnit ta izolonit Codex duke e ekzekutuar brenda Docker, ai nuk do të mund të ekzekutonte zinxhirin e mjeteve të ndërtimit për iOS, të përbërë nga programe të ekzekutueshme për Mac, dhe as të niste simulatorin iPhone për të ekzekutuar kodin. Një rrjedhë pune e bazuar në Docker mund t’ia delegonte ndërtimet dhe operacionet e simulatorit sistemit pritës Mac, por ato do të ekzekutoheshin jashtë mjedisit të izoluar të kontejnerit dhe do të kërkonin kufizime më vete. Për Codex, parapëlqejmë ta mbajmë zgjidhjen të thjeshtë duke investuar shumë në izolimin specifik për çdo sistem operativ, që Codex të ekzekutohet në mjedisin më të përshtatshëm për detyrën në fjalë.

Struktura i ofron këta mekanizma izolimi specifikë për sistemin operativ përmes një API-je të përbashkët për macOS, Windows dhe Linux. Kjo API merr një komandë dhe një profil lejesh. Nëse profili i lejeve lejon qasje të kufizuar në rrjet, thirrësi duhet të sigurojë një proxy rrjeti për t’i zbatuar ato kufij:

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:

Ky funksion e nis procesin në një mjedis të izoluar dhe kthen një referencë Child, të cilën struktura mund ta përdorë për të pritur përfundimin e tij. Çdo proces bijë trashëgon kufizimet e izolimit të prindit, ndaj ato zbatohen në të gjithë pemën e proceseve të nisur nga komanda, edhe te pasardhësit që vazhdojnë të punojnë pasi procesi fillestar ka përfunduar.

Diagrami i mëposhtëm tregon si lidhen këto pjesë, nga konfigurimi deri te ekzekutimi i një komande të izoluar. Seksionet në vijim shpjegojnë çdo fazë.

Diagram rrjedhe: konfigurimi dhe kërkesat e menaxhuara përcaktojnë profilin e lejeve të një seance; struktura e Codex nis komandat nën kufizime izolimi specifike për platformën në macOS, Linux ose Windows. Proceset bijë i trashëgojnë këto kufizime dhe një proxy opsional i rrjetit zbaton rregullat e domeneve.

Si e shfrytëzon struktura mjedisin e izoluar

Siç shpjegohet te Zbërthimi i ciklit të agjentit Codex, struktura e Codex është përgjegjëse për ekzekutimin e thirrjeve të mjeteve të gjeneruara nga modeli. Për detyrat e kodimit, mjeti më i përdorur është një mjet shell, që ekzekuton komanda pothuajse siç do të bënte një përdorues në një shell ndërveprues si Bash. Këtu do të shqyrtojmë ekzekutimin njëherësh të ⁠(hapet në një dritare të re)exec_command⁠(hapet në një dritare të re), mjetit shell⁠(hapet në një dritare të re), për të ilustruar si e përdor struktura mjedisin e izoluar për të arritur mbrojtjet e dëshiruara.

Ky është një version i thjeshtuar i mënyrës se si struktura e Codex do ta trajtonte thirrjen e mjetit
exec_command pa izolim:

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}

Për ta izoluar komandën, struktura zëvendëson thirrjen e subprocess.Popen() me spawn_command_under_sandbox(). Struktura siguron profilin e lejeve dhe, kur nevojitet, proxy-n e rrjetit:

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}

Mjeti exec_command i lejon gjithashtu modelit të kërkojë leje të ndryshme për një komandë të veçantë, por struktura vendos nëse do ta miratojë kërkesën:

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

Kur përcaktohet use_default, struktura përdor konfigurimin e parazgjedhur të izolimit për atë radhë ndërveprimi. with_additional_permissions kërkon qasje më të gjerë brenda mjedisit të izoluar, ndërsa require_escalated kërkon ekzekutim jashtë tij. Struktura e vlerëson kërkesën sipas preferencave të përdoruesit përpara se të ekzekutojë komandën. (Për shembull, Codex mund ta pyesë drejtpërdrejt përdoruesin ose ta dërgojë kërkesën për rishikim automatik⁠(hapet në një dritare të re).) Nëse ekzekutimi autorizohet, Codex do t’ia kalojë permission_profile dhe network_proxy përkatëse funksionit perform_exec_command_with_sandboxing(), bashkë me argumentet e komandës nga ExecCommandToolCall fillestare.

Mjeti shell është përdoruesi kryesor i spawn_command_under_sandbox(), dhe struktura e ripërdor infrastrukturën e vet të izolimit edhe për operacione si leximi dhe ndryshimi i skedarëve lokalë. Ky ripërdorim shkon përtej strukturës: komanda codex sandbox ju lejon të përfshini ekzekutimin e izoluar të komandave në mjetet tuaja, siç do të shohim më vonë. Më tej do të shohim si përcaktohen profilet e lejeve.

Konfigurimi i mjedisit të izoluar

Një profil lejesh me emër ju lejon të ripërdorni të njëjtat kufizime të sistemit të skedarëve dhe rrjetit në projekte të ndryshme. Mund t’i përcaktoni profilet tuaja nën [permissions] në config.toml. Për shembull, konfigurimi i mëposhtëm përcakton një profil me emrin dev që zgjeron⁠(hapet në një dritare të re) profilin e integruar :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"

Profili dev shton qasje për shkrim në ~/build-cache dhe vendos kufizime shtesë për skedarët në hapësirën e punës. Hyrjet e sistemit të skedarëve mund të japin qasje vetëm për lexim (read), qasje për lexim dhe shkrim (write) ose ta bllokojnë plotësisht qasjen (deny).

Tabela :workspace_roots ju lejon të përcaktoni rregulla për shtigje relative ndaj rrënjëve të hapësirës së punës së një projekti. Si parazgjedhje, CLI-ja e Codex përdor direktorinë e vet të punës si të vetmen rrënjë të hapësirës së punës, ndërsa aplikacioni ChatGPT për kompjuter përdor dosjet burimore të projektit. Codex e zbaton çdo rregull në çdo rrënjë, ndaj hyrja .vscode në dev e bën direktorinë .vscode vetëm për lexim nën secilën rrënjë.

Përveç rregullave të veta, dev trashëgon mbrojtjet e mëposhtme nga :workspace:

TOML

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

Lejet e rrjetit

Për konfigurimin e rrjetit të mjedisit të izoluar në Codex, në thelb ka tri mundësi:

  • Çaktivizimi i çdo qasjeje në rrjet (parazgjedhja për profilin :workspace)

  • Aktivizimi i qasjes së plotë dhe të drejtpërdrejtë në rrjet (parazgjedhja për profilin :danger-full-access)

  • Kufizimi i qasjes në rrjet përmes një proxy-je, që vendos çfarë të lejojë sipas profilit të lejeve


Për t’i dhënë
dev qasje të drejtpërdrejtë në rrjet, vendosni permissions.dev.network.enabled = true në nivelin kryesor të config.toml. Kjo jep qasje të plotë në rrjet kur proxy i rrjetit është i çaktivizuar.

Për ta kufizuar dev te një grup domenesh, aktivizoni proxy-n e rrjetit dhe konfiguroni rregullat e tij të domeneve:

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

Rregullat e domeneve mbështetin emra të saktë dhe modele me shenja zëvendësuese; rregullat e shprehura të ndalimit kanë përparësi ndaj atyre të lejimit. Kërkesat për domene të tjera kërkojnë miratim ose bllokohen, siç përshkruhet më poshtë te Proxy i rrjetit.

Konfigurimi me shtresa dhe zbatimi i kufijve

Përdoruesit individualë mund të konfigurojnë cilësime të parazgjedhura që vlejnë në të gjitha projektet dhe t’i mbivendosin ato për një projekt të caktuar të besuar. Edhe administratorët e ndërmarrjeve mund të duan të konfigurojnë parazgjedhje për përdoruesit e tyre dhe të kufizojnë cilat cilësime mund të ndryshojnë ata. Codex i mbështet të dyja përmes konfigurimit me shtresa dhe kërkesave të menaxhuara.

Siç përshkruhet te Përparësia e konfigurimit,⁠(hapet në një dritare të re) Codex bashkon cilësimet nga disa skedarë config.toml. Tabelat bashkohen në mënyrë rekursive; kur vlerat bien ndesh, mbizotëron burimi me përparësi më të lartë. Vargjet zëvendësohen tërësisht.

Kjo është arsyeja pse profilet e lejeve përdorin tabela për shtigjet e sistemit të skedarëve dhe domenet e rrjetit. Një ekip mund të shtojë ose të mbivendosë hyrje individuale në konfigurimin e vet dhe të trashëgojë automatikisht ndryshimet në të gjitha hyrjet e tjera të konfigurimit bazë të organizatës:

TOML

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

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

Administratorët mund të ofrojnë edhe kërkesa të menaxhuara⁠(hapet në një dritare të re) përmes requirements.toml, për të kufizuar zgjedhjet e konfigurimit të përdoruesve. Këto kërkesa mund të vijnë nga disa burime, përfshirë skedarët e sistemit dhe politikat e ofruara nga reja. Një përdorim i zakonshëm është përcaktimi i allowed_permission_profiles për të kufizuar grupin e profileve të lejeve që mund të zgjedhë një përdorues i ndërmarrjes. Për shembull, një administrator mund të përcaktojë këto kërkesa nga reja:

TOML

1
default_permissions = ":read-only"
2

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

Kërkesat nga reja do të kishin përparësi ndaj skedarit të kërkesave të sistemit në /etc/codex/requirements.toml, ndaj një hyrje në atë skedar nuk mund të mbivendosë cilësimin e shprehur qartë më sipër, ":danger-full-access" = false. Duke e lënë :workspace të papërcaktuar, një shtresë tjetër kërkesash mund ta sigurojë atë hyrje. Profilet, hyrjet e të cilave janë false ose mungojnë në tabelën përfundimtare të bashkuar, nuk janë të disponueshme.

Kjo ndarje u lejon organizatave të zbatojnë kufij, ndërsa përdoruesit e përshtatin konfigurimin e tyre brenda këtyre kufijve. Profilet e lejeve që rezultojnë mund të përdoren nga struktura ose të zbatohen drejtpërdrejt te një komandë, siç do të shohim më tej.

Përdorimi i komandës codex sandbox

CLI-ja e Codex ofron komandën sandbox për të lehtësuar ekzekutimin e çdo komande sipas një profili lejesh të përcaktuar në konfigurimin e Codex. Kjo përdoret zakonisht për të provuar profilin dhe për t’u siguruar që mjedisi i izoluar pengon sjelljen që është projektuar të bllokojë.

Për shembull, komanda e mëposhtme përpiqet të konfigurojë VS Code që të ekzekutojë një formatues automatik keqdashës gjatë ruajtjes. Duke supozuar se .vscode ekziston tashmë, profili dev i përcaktuar më sipër duhet ta bllokojë këtë shkrim, sepse ajo direktori është vetëm për lexim (codex sandbox e trajton cwd si rrënjë të hapësirës së punës si parazgjedhje):

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

Në fakt, në macOS kjo dështon me mesazhin:

Tekst i thjeshtë

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

Komanda codex sandbox e bën mekanizmin e izolimit të Codex të disponueshëm edhe jashtë një seance agjenti. Mund të përdorni të njëjtën gjuhë konfigurimi dhe zbatim specifik për platformën për të kufizuar komandat që nisin mjetet tuaja.

Shembull: izolimi i një serveri MCP

Për një server MCP stdio të konfiguruar në config.toml, struktura e Codex nuk përpiqet ta izolojë komandën që përdoret për të nisur serverin. Codex nuk mund të përcaktojë me siguri cilët skedarë ose shërbime rrjeti i duhen atij serveri, ndaj zbatimi i një profili të parazgjedhur izolimi mund të pengonte funksionimin e një konfigurimi që përndryshe është i vlefshëm.

Për shembull, mënyra standarde për të konfiguruar serverin MCP @modelcontextprotocol/server-memory⁠(hapet në një dritare të re) për përdorim me Codex është si më poshtë:

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"

Meqë kjo komandë npx ekzekutohet pa izolim, ajo mund të shkruajë skedarë dhe të bëjë kërkesa rrjeti me të njëjtat leje si përdoruesi që ekzekuton Codex, çka i jep më shumë liri sesa duhet. Për ta kufizuar, mund të përcaktojmë një profil lejesh të quajtur memory-mcp dhe pastaj ta ekzekutojmë komandën fillestare npx përmes codex sandbox --permission-profile memory-mcp, që të kufizojmë ku mund të shkruajë serveri dhe t’i ndalojmë qasjen në rrjet:

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"

Përpara nisjes së serverit, krijoni direktorinë e tij të të dhënave dhe vendosni në cache-in e npm paketën me versionin e fiksuar. Kjo lejon që npx --offline ta nisë serverin nën një profil që çaktivizon qasjen në rrjet:

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

Pasi paketa të jetë në cache, Codex mund ta nisë serverin e kujtesës pa qasje në rrjet, me shkrimin të kufizuar te cache-i i npm dhe direktoria e të dhënave të serverit.

Zbatimi i mjedisit të izoluar të Codex

Zbatimi i mjedisit të izoluar e shndërron një profil lejesh në kufizime të zbatuara nga sistemi operativ. Logjika bazë e proxy-t të rrjetit për trajtimin e kërkesave dhe politikat është e përbashkët në të tre sistemet kryesore operative, ndërsa konfigurimi i proxy-t dhe integrimi me mjedisin e izoluar janë specifikë për secilin sistem. Fillimisht do të shqyrtojmë proxy-n e përbashkët, pastaj zbatimet për macOS, Linux dhe Windows.

Proxy i rrjetit

Për të zbatuar kufizimet e rrjetit të një profili lejesh, struktura nis një proxy rrjeti dhe konfiguron mjedisin e izoluar që të lejojë lidhjet me të, ndërsa bllokon lidhjet e drejtpërdrejta me sisteme të jashtme. Proxy kontrollon çdo kërkesë kundrejt rregullave të domeneve të profilit, për të përcaktuar nëse duhet ta përcjellë.

Në depon e Codex, proxy i rrjetit zbatohet në paketën codex-network-proxy⁠(hapet në një dritare të re), të cilën struktura e përdor si bibliotekë, ndonëse ajo mund të ndërtohet edhe si CLI e pavarur⁠(hapet në një dritare të re). Kur aktivizohet, codex-network-proxy nis si parazgjedhje si një proxy HTTP, ashtu edhe një proxy SOCKS5. Këto adresa proxy i kalohen procesit të nisur nga mjedisi i izoluar përmes variablave të mjedisit. Përveç variablave standarde të mjedisit si HTTP_PROXY, HTTPS_PROXY dhe ALL_PROXY, futen edhe disa variabla të njohura mjedisi specifike për aplikacione⁠(hapet në një dritare të re) (si PIP_PROXY). Megjithatë, jo të gjitha programet i respektojnë këto variabla mjedisi. Nëse një program përpiqet të lidhet drejtpërdrejt me një sistem të jashtëm, kufizimet e izolimit të sistemit operativ e bllokojnë, siç përshkruhet më poshtë në seksionet për secilën platformë.

Proxy i rrjetit është përgjegjës për zbatimin e kufizimeve të rrjetit të përcaktuara në një profil lejesh. Për shembull, profili dev i treguar më parë lejon kërkesat për *.openai.com dhe ndalon shprehimisht kërkesat për evil.example. Kur një kërkesë synon një domen që nuk përputhet me asnjë rregull lejimi ose ndalimi, proxy mund ta pezullojë kërkesën ndërsa ia kalon strukturës për miratim. Ashtu si në shembullin e komandës shell, Codex mund ta pyesë drejtpërdrejt përdoruesin ose ta dërgojë kërkesën për rishikim automatik⁠(hapet në një dritare të re). Pasi merr një vendim, proxy ose e lejon kërkesën të vazhdojë, ose e refuzon me një përgjigje gabimi.

Rendi ka rëndësi këtu, sepse edhe një kërkim DNS mund të rrjedhë informacion të koduar në një emër hosti. Prandaj proxy e zgjidh emrin e kërkuar të hostit vetëm pasi përcakton se ai është i lejuar ose i miratuar. Kini parasysh se rregullat e gjera me shenja zëvendësuese ose qasja në shërbimet DNS mund të lejojnë ende nxjerrjen e paautorizuar të të dhënave përmes DNS.

macOS

Në macOS, Codex përdor Seatbelt⁠(hapet në një dritare të re), mekanizmin e izolimit të Apple që zbatohet nga kerneli. Politikat e Seatbelt shkruhen në Sandbox Profile Language (SBPL), një gjuhë e bazuar në Scheme për të shprehur kufizimet e izolimit. Codex e thërret Seatbelt përmes komandës /usr/bin/sandbox-exec të macOS. Ashtu si codex sandbox, ajo merr opsione që përshkruajnë mjedisin e izoluar, të ndjekura nga komanda që do të ekzekutohet:

Bash

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

PROFILE është një varg teksti SBPL që përmban hyrje për konfigurimin e mjedisit të izoluar. Për shembull, fragmenti i mëposhtëm SBPL lejon leximin dhe shkrimin në /dev/null dhe /dev/zero sipas politikës së izolimit:

Scheme

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

Kur proxy i rrjetit aktivizohet gjatë një thirrjeje të mjedisit të izoluar, në profil futen rregulla si ato më poshtë për t’i kufizuar lidhjet te portat përkatëse lokale:

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"))


Profili bazë i Codex fillon me
(deny default), ndaj lidhjet dalëse mbeten të bllokuara nëse nuk lejohen shprehimisht.

Së fundi, SBPL mund të përmbajë vendmbajtëse duke përdorur (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)))

të cilat plotësohen nga opsionet -Dkey=value që i kalohen sandbox-exec.

Për të zbatuar API-në e vet të izolimit, Codex ndërton listën e argumenteve⁠(hapet në një dritare të re) për sandbox-exec duke nisur nga një politikë bazë⁠(hapet në një dritare të re), pastaj e përshtat me permission_profile dhe kontekst tjetër për të krijuar profilin e plotë Seatbelt. Profili që rezulton dhe argumentet shoqëruese -D konfigurojnë kufizimet që zbaton Seatbelt, ndërsa proxy i rrjetit zbaton rregulla shtesë të rrjetit. Pasi të jetë përgatitur lista e plotë e argumenteve, thirrja e sandbox-exec është e thjeshtë.

Gjenerimi i SBPL-së së saktë është sfidues, sepse Apple nuk e dokumenton gjuhën për përdorim nga palë të treta. Në fakt, man sandbox-exec thotë The sandbox-exec command is DEPRECATED (ashtu si edhe funksioni i bibliotekës sandbox_init(), i dokumentuar përmes man 3 sandbox_init). Pavarësisht paralajmërimit se përdorimi nuk rekomandohet më, macOS ende përfshin profile Seatbelt në /usr/share/sandbox, dhe softueri i palëve të treta, përfshirë Google Chrome dhe Chromium⁠(hapet në një dritare të re), vazhdon të mbështetet te Seatbelt. Prandaj, planifikojmë të vazhdojmë ta përdorim Seatbelt për të ardhmen e parashikueshme.

Linux

Për të krijuar mjedisin e izoluar në Linux, Codex kombinon bubblewrap⁠(hapet në një dritare të re) (bwrap), një mjet të rreshtit të komandave për ndërtimin e mjediseve të izoluara, me seccomp-bpf⁠(hapet në një dritare të re), një mekanizëm të kernelit Linux për filtrimin e thirrjeve të sistemit. Një program i brendshëm ndihmës i quajtur codex-linux-sandbox koordinon konfigurimin. Ashtu si sandbox-exec në macOS, ai merr një konfigurim izolimi, të ndjekur nga komanda që do të ekzekutohet:

Bash

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

Kur kërkohet izolimi i sistemit të skedarëve ose drejtimi përmes proxy-t, codex-linux-sandbox thërret bwrap për të krijuar mjedisin fillestar të izoluar. Më pas bwrap nis codex-linux-sandbox --apply-seccomp-then-exec brenda tij. Kjo thirrje e dytë përdor seccomp-bpf për të zbatuar kufizime shtesë përpara ekzekutimit të komandës së përdoruesit.

Për të ndërtuar atë mjedis fillestar të izoluar, Codex përdor bubblewrap për të krijuar një pamje të sistemit të skedarëve në një hapësirë të veçantë emrash për montimet, e cila pasqyron rregullat e profilit të lejeve për sistemin e skedarëve. Meqë kjo është thelbësore për zbatimin e izolimit, Codex përfshin kopjen e vet të bwrap në rast se përdoruesi nuk e ka instaluar, por parapëlqen një instalim të përputhshëm të ⁠(hapet në një dritare të re)bwrap⁠(hapet në një dritare të re) në PATH, kur është i disponueshëm. Në praktikë, disa shpërndarje Linux e çaktivizojnë si parazgjedhje qasjen në hapësirat e emrave të përdoruesit⁠(hapet në një dritare të re), por bëjnë përjashtim për bwrap të sistemit.

Ashtu si sandbox-exec, edhe bwrap merr një konfigurim izolimi, të ndjekur nga një komandë për t’u ekzekutuar brenda mjedisit të izoluar. Në vend të një gjuhe të posaçme konfigurimi si SBPL, bwrap përdor parametra individualë për konfigurimin. Codex përdor opsionet e mëposhtme për të krijuar pamjen e sistemit të skedarëve:

  • --bind për të përcaktuar një skedar ose direktori ku lejohet shkrimi

  • --ro-bind për të përcaktuar një skedar ose direktori vetëm për lexim

  • --perms 000 --tmpfs DIR --remount-ro DIR për të ndaluar qasjen në DIR

  • --perms 000 --ro-bind-data FD FILE për të ndaluar qasjen në FILE (ku FD është një përshkrues skedari i hapur për /dev/null)

Për të zbatuar modelet glob të ndalimit me këto opsione, Codex i shndërron ato në shtigje konkrete përpara nisjes së çdo komande. Shtigjet e reja që përputhen nuk u shtohen automatikisht kufizimeve të mjedisit të izoluar të asaj komande.

Codex përcakton edhe opsione si --unshare-ipc dhe --unshare-pid, që mjedisi i izoluar të mos ketë qasje në lloje të tjera burimesh të sistemit pritës. Pra, bubblewrap ndikon përtej dukshmërisë së skedarëve.

Kur përdor bubblewrap, Codex kalon --unshare-net sa herë që rrjeti është i çaktivizuar ose lidhjet duhet të kalojnë përmes proxy-t të rrjetit, duke krijuar një hapësirë të re emrash të rrjetit për mjedisin e izoluar. Më pas përdorim seccomp-bpf për të zbatuar kufizime shtesë mbi thirrjet e sistemit për rrjetin dhe familjet e soketeve që mund të përdorë komanda.


Konkretisht, përdorim
paketën seccompiler⁠(hapet në një dritare të re) për të përpiluar në mënyrë dinamike një program BPF sipas filtrave të dëshiruar⁠(hapet në një dritare të re) dhe për ta zbatuar te një proces nisës brenda mjedisit të izoluar, në mënyrë që kufizimet të trashëgohen nga e gjithë pema e proceseve. Prandaj, bwrap nuk ekzekuton komandën e përdoruesit, por nisësin codex-linux-sandbox me argumentet e veta të konfigurimit, të ndjekura nga komanda e përdoruesit:

Bash

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

Për të zbatuar filtrat seccomp pa privilegje të larta, nisësi aktivizon parametrin no_new_privs të Linux⁠(hapet në një dritare të re). Ky parametër trashëgohet nga proceset bijë dhe i pengon ato të fitojnë privilegje shtesë kur ekzekutojnë një program tjetër, si një program setuid.

Filtrat seccomp varen nga konfigurimi i rrjetit. Kur qasja në rrjet është e çaktivizuar, bllokojmë disa thirrje sistemi që lidhen me rrjetin, si connect(2) dhe bind(2). Por kur proxy i rrjetit është aktiv në mjedisin e izoluar, lejojmë soketet IP që të arrihet dëgjuesi TCP i krijuar nga codex-linux-sandbox. Ndërkohë, si parazgjedhje bllokojmë krijimin e soketeve të pavarura të domenit Unix, pasi ato mund të mundësojnë qasje të paqëllimshme në burimet e sistemit pritës.

Lidhja me proxy-n e rrjetit

Kur konfigurimi i izolimit kërkon përdorimin e proxy-t të rrjetit, struktura e Codex krijon një instancë të proxy-t që mund të ripërdoret në disa thirrje të codex-linux-sandbox brenda së njëjtës bisedë Codex. Çdo mjedisi të izoluar i duhet një mënyrë për të arritur atë proxy të përbashkët nga hapësira e vet e izoluar e emrave të rrjetit. Codex ofron një dëgjues TCP loopback brenda asaj hapësire emrash dhe cakton një proces jashtë mjedisit të izoluar që t’i pranojë lidhjet e tij e t’ia përcjellë proxy-t.

Diagramet e mëposhtme ilustrojnë këtë konfigurim për një pikë fundore të proxy-t; diagrami i fundit tregon një lidhje që kalon përmes saj. Përpara nisjes së bubblewrap, codex-linux-sandbox krijon një çift soketesh Unix si kanal kontrolli dhe degëzon veten. Procesi bijë ekzekuton run_host_bridge() dhe pret të marrë përshkruesin e skedarit të dëgjuesit përmes atij kanali:

Diagram i strukturës së Codex që nis codex-linux-sandbox, i cili degëzon një proces përcjellës të lidhur përmes një kanali kontrolli me soket Unix.

Në këtë shembull, procesi prind përdor exec për të zëvendësuar imazhin e programit të vet me bwrap. Kjo ngre mjedisin e izoluar dhe nis codex-linux-sandbox --apply-seccomp-then-exec brenda tij, duke i kaluar edhe FD-në e kanalit të kontrollit:

Diagram që tregon bwrap duke krijuar një hapësirë emrash të rrjetit për mjedisin e izoluar dhe duke nisur codex-linux-sandbox brenda saj, me një kanal kontrolli përmes soketit Unix drejt procesit përcjellës jashtë mjedisit të izoluar.

Brenda hapësirës së emrave të rrjetit të mjedisit të izoluar, thirrja e dytë e codex-linux-sandbox krijon një dëgjues TCP loopback dhe kalon përshkruesin e tij të skedarit përmes soketit. Dëgjuesi mbetet i lidhur me hapësirën e emrave të rrjetit të mjedisit të izoluar. Kjo i lejon procesit bijë që mbeti jashtë tij të pranojë lidhje nga programet e izoluara, ndërsa lidhjet drejt proxy-t i hap në hapësirën e emrave të rrjetit të sistemit pritës. Pas kalimit, të dy proceset mbyllin përshkruesit e kanalit të kontrollit, ndërsa procesi brenda mjedisit të izoluar mbyll kopjen e vet të dëgjuesit.

Pasi dëgjuesi TCP të jetë gati, procesi brenda mjedisit të izoluar cakton vlerën e duhur për HTTP_PROXY⁠(hapet në një dritare të re) dhe variablat përkatëse të mjedisit, që të drejtohen te ky dëgjues. Më pas zbaton seccomp përpara se të degëzojë procesin dhe të ekzekutojë komandën e përdoruesit:

Diagram që tregon një program të izoluar duke u lidhur me një dëgjues TCP loopback, ndërsa një proces përcjellës i jashtëm codex-linux-sandbox e drejton trafikun te proxy i rrjetit të Codex.

Procesi jashtë mjedisit të izoluar e mban dëgjuesin të hapur. Për çdo lidhje të pranuar, ai hap një lidhje me proxy-n e konfiguruar dhe përcjell të dhënat në të dyja drejtimet.

Ky mekanizëm shtesë i jep komandës hapësirën e vet të emrave të rrjetit, përfshirë një ndërfaqe loopback të veçantë. Në macOS, Seatbelt e lejon komandën të lidhet drejtpërdrejt me portat e përcaktuara në ndërfaqen loopback të sistemit pritës. Në Linux, komanda lidhet me një dëgjues brenda hapësirës së vet të izoluar të emrave, ndërsa një proces jashtë mjedisit të izoluar i përcjell këto lidhje te proxy i konfiguruar. Kalimi i përshkruesit e mundëson këtë lidhje pa i ekspozuar komandës hapësirën e emrave të rrjetit të sistemit pritës.

Windows

Në fillim të këtij viti, zbatuam dhe shkruam për përpjekjet tona për izolimin në Windows. Që atëherë, Microsoft ka publikuar një bibliotekë të quajtur MXC, bashkë me veçori të reja për izolimin e proceseve brenda sistemit operativ Windows. Aktualisht po e zëvendësojmë mjedisin tonë të izoluar me një tjetër që përdor bibliotekën MXC.

Çfarë është MXC?

MXC (Microsoft eXecution Container) është një sistem për ekzekutimin e kodit në mjedise të izoluara⁠(hapet në një dritare të re) nga Microsoft, që mbështet disa mekanizma izolimi në Windows, Linux dhe macOS. Codex mbështet një mjedis të izoluar të bazuar në MXC në pajisjet Windows të përputhshme, duke përdorur izolimin e integruar të proceseve për të kufizuar komandat brenda mjedisit ekzistues të përdoruesit.

Po kalojmë në MXC për të përmirësuar sigurinë dhe lehtësinë e përdorimit, duke zgjidhur njëkohësisht disa mangësi të mjedisit tonë ekzistues të izoluar në Windows:

  • Nevoja për privilegje të larta/administratori për të ngritur mjedisin e izoluar

  • Operacione të kushtueshme/të ngadalta për kontrollimin dhe caktimin e ACL-ve

  • Gjendja e konfigurimit të mjedisit të izoluar që mbetet në kompjuterin pritës, përfshirë

    • ACL-të

    • Rregullat e firewall-it

    • Përdoruesit e mjedisit të izoluar

    • Skedarët e shtresës së kontrollit

MXC ofron një skemë konfigurimi JSON⁠(hapet në një dritare të re). Codex përdor MXC SDK⁠(hapet në një dritare të re) për të ndërtuar një kërkesë ekzekutimi sipas kësaj skeme, që përmban komandën, direktorinë e punës, mjedisin dhe lejet. Këto leje mbulojnë qasjen në sistemin e skedarëve dhe në rrjet, si dhe burime të Windows si desktopi dhe kujtesa e fragmenteve.

Shndërrimi i politikës në një thirrje MXC

Codex përdor cilësime fikse për disa kontrolle, për të ruajtur ekuilibrin mes përputhshmërisë dhe sigurisë. Ai lejon leximin e regjistrit dhe ruan qasjen në Win32k dhe në desktop që i nevojitet PowerShell gjatë nisjes. Qasja në kujtesën e fragmenteve, injektimi i hyrjeve dhe kontrollet e desktopit dhe të cilësimeve të sistemit janë çaktivizuar. Së fundi, MXC nuk lejohet të përdorë si zgjidhje rezervë ndryshimin e lejeve të sistemit të skedarëve në sistemin pritës.

Codex i shndërron rregullat e profilit të lejeve për sistemin e skedarëve dhe rrjetin në konfigurimin e MXC. Duke përdorur profilin e mëparshëm dev dhe duke supozuar se:

  • C:\, D:\ dhe Z:\ janë të vetmet njësi lokale të kompjuterit.

  • Rrënja e hapësirës së punës dhe direktoria e punës janë C:\work\demo.

  • Direktoria bazë e përdoruesit është D:\Users\dev, ndaj ~/build-cache i referohet D:\Users\dev\build-cache.

  • Modeli glob i ndalimit përputhet vetëm me C:\work\demo\config\dev.env dhe C:\work\demo\config\prod.env.

Cilësimet përkatëse të MXC do të përfshinin:

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
}

Qasja në rrënjën e njësisë

Politika e sistemit të skedarëve në MXC e ndalon qasjen si parazgjedhje. Prandaj Codex shton leje vetëm për lexim për rrënjët e njësive lokale, për të mundësuar qasjen e gjerë për lexim që lejon ky profil. Këto leje zbatohen në mënyrë rekursive, brenda kufijve të lejeve ekzistuese të përdoruesit në sistemin operativ.

Ka një veçanti: lejet për shkrim në rrënjën e njësisë nuk zbatohen në mënyrë rekursive, ndaj Codex i zgjeron ato për të përfshirë elementet ekzistuese drejtpërdrejt nën rrënjën e njësisë.

Leje që bien ndesh

Shtigjet më specifike kanë përparësi ndaj lejeve të direktorive prind, kështu që C:\work\demo mund të lejojë shkrimin nën një C:\ vetëm për lexim, ndërsa C:\work\demo\.git mbetet vetëm për lexim.

Kur shkrime të ndryshme të një shtegu ose pseudonime përmes lidhjeve simbolike/junction i referohen të njëjtit shteg, MXC zbaton lejen më të rreptë: ndalimi ka përparësi ndaj leximit, i cili ka përparësi ndaj leximit dhe shkrimit.

Modelet glob të ndalimit

MXC pranon vetëm shtigje konkrete për ndalim, ndaj Codex i shndërron modelet glob të ndalimit në skedarët dhe direktoritë që përputhen, përpara nisjes. Shtigjet e reja që përputhen me modelin glob nuk shtohen automatikisht gjatë ekzekutimit të komandës.

Qasja në rrjet

Rregullat e domeneve si *.openai.com zbatohen nga proxy i përbashkët i rrjetit të Codex, i përshkruar më sipër. Codex e ekzekuton atë proxy jashtë mjedisit të izoluar dhe ia kalon adresat komandës përmes të njëjtave variabla standarde mjedisi *_PROXY të përmendura më parë. MXC bllokon lidhjet e drejtpërdrejta me jashtë, ndërsa lejon lidhjet loopback me sistemin pritës, përfshirë qasjen te proxy. Shërbimet e tjera lokale mbeten të arritshme.

Në macOS, Linux dhe Windows, struktura përdor të njëjtën API izolimi për të nisur komanda sipas një profili lejesh. Zbatimet specifike për platformën kryejnë konfigurimin e nevojshëm për t’i zbatuar ato kufizime.

Ndërtimi mbi mjedisin e izoluar të Codex

Shkrimi dhe ekzekutimi i kodit u jep agjentëve një mënyrë fleksibël për të zgjidhur probleme edhe përtej zhvillimit të softuerit. Mjedisi i izoluar i Codex u lejon ta përdorin këtë aftësi në mjedisin ekzistues të përdoruesit, me kufij të qartë për qasjen në sistemin e skedarëve dhe në rrjet. Ai është një përbërës bazë i ripërdorshëm brenda strukturës, dhe komanda codex sandbox e bën të disponueshëm për mjetet që ndërtoni vetë.

Ndërsa agjentët marrin përsipër më shumë detyra, duam ta bëjmë izolimin praktik për më shumë mjete dhe mjedise. Kjo do të thotë ta lehtësojmë konfigurimin e lejeve dhe të përfitojmë nga mbrojtjet më të mira të sistemeve operative, sapo të bëhen të disponueshme. Qëllimi ynë është të zgjerojmë aftësitë e agjentëve, duke u lënë njerëzve kontrollin mbi burimet ku ata mund të kenë qasje.

Autori

OpenAI

Falënderime

Falënderime të veçanta për David Wiesen, Charlie Weems, Viyat Bhalodia dhe Fotis Chantzis për kontributin në këtë artikull.