OpenAI

18. nóvember 2026

Verkfræði

Inni í sandkassa Codex

Hvernig Codex keyrir skipanir á tölvunni þinni innan marka sem þú ákveður.

Eftir Michael Bolin, starfsmann tækniteymis

Hjá OpenAI notum við marglaga varnir⁠(opnast í nýjum glugga) til að tryggja öryggi fulltrúa. Þótt fjárfesting okkar í þjálfun og samræmingu sé grundvallaratriði í þessu starfi innleiðum við einnig eiginleika í fulltrúakerfið okkar, Codex⁠(opnast í nýjum glugga), til að veita aukna vernd. Eitt af því algengasta sem Codex gerir, og getur haft áhættu í för með sér, er að keyra skipanir á tölvunni þinni. Þess vegna bjuggum við til sandkassa Codex svo Codex geti unnið í núverandi umhverfi þínu innan þeirra marka sem þú setur skráakerfis- og netaðgangi.

Sandkassi⁠(opnast í nýjum glugga) ⁠(opnast í nýjum glugga)takmarkar að hverju forrit hefur aðgang meðan það keyrir. Við flokkun ljósmynda gætirðu stillt sandkassa Codex þannig að skipanir megi lesa og breyta skrám í ~/Pictures, en lokað á netaðgang til að hindra upphleðslu. Við kóðayfirferð gætirðu leyft aðgang að leiðbeiningum á netinu en haft frumkóðaskrár skrifvarðar. Notendur stilla sandkassa Codex með ⁠(opnast í nýjum glugga)heimildasniðum⁠(opnast í nýjum glugga), sem skilgreina takmarkanir á skráakerfis- og netaðgangi í Codex-lotu.

Í þessari grein fjöllum við fyrst um málamiðlanirnar að baki sjálfgefnum stillingum sandkassa Codex. Síðan útskýrum við hönnun hans og hvernig kerfið notar hann til að keyra skipanir. Við sýnum hvernig notendur og fyrirtæki geta lagað heimildir hans að þörfum sínum og hvernig forritarar geta endurnýtt sandkassann í eigin verkfærum. Að lokum skoðum við hvernig þessum takmörkunum er framfylgt í macOS, Linux og Windows.

Mörk sandkassans valin

Í Codex er markmið okkar að velja varfærnar sjálfgefnar stillingar fyrir sandkassann sem leyfa þó gagnlega vinnu. Ef Git-geymsla er til dæmis rót vinnusvæðisins gerir innbyggða heimildasniðið :workspace eftirfarandi:

  • Leyfir skrif innan vinnusvæðisins en heldur möppum á borð við .git og .codex skrifvörðum. Þannig getur Codex breytt frumkóða án þess að leita leyfis fyrir hverri breytingu, en ekki breytt .codex/config.toml eða Git-krókum undir .git/hooks beint.

  • Leyfir víðtækan lestur úr skráakerfinu, með fyrirvara um réttindi notandans í stýrikerfinu. Þýðendur, keyrsluumhverfi og smíðaverkfæri reiða sig á þróunarpakka, forritasöfn og stillingar utan geymslunnar. Ef lestur væri takmarkaður við vinnusvæðið myndu mörg algeng verkferli ekki virka. Á móti kemur að viðkvæmar skrár annars staðar á vélinni gætu einnig verið læsilegar, svo sem stillingaskrár sem innihalda API-lykla.

  • Lokar á netaðgang. Þetta hindrar beina upphleðslu til ytri þjónusta, þar á meðal tilraunir til að leka gögnum sem skipunin getur lesið. Það hindrar einnig lögmætar aðgerðir á borð við niðurhal á ósjálfstæðum pökkum, sem krefjast aukins aðgangs.

Þessar takmarkanir koma í veg fyrir margs konar óæskilega hegðun, en skaðlegar aðgerðir eru samt mögulegar. Fulltrúinn gæti til dæmis komið skaðlegum kóða fyrir í staðbundnum pakka á borð við node_modules/prettier. Slík breyting gæti farið fram hjá git status því Git hunsar oft node_modules. Ef ritill notandans keyrir þetta eintak af Prettier við vistun gæti það eitt að vista skrá keyrt skaðlega kóðann utan sandkassa Codex. Þess vegna notum við marglaga varnir: sandkassinn takmarkar aðgang skipana, en þjálfun og samræming hjálpa líkaninu að nota þann aðgang í samræmi við ásetning notandans.

Leiðbeiningar um hvernig laga má heimildir sandkassans að þörfum fyrirtækis og sameina þær öðrum vörnum er að finna í öryggishandbók Codex⁠(opnast í nýjum glugga).

Hönnun sandkassans

Sýndarvélar og gámar⁠(opnast í nýjum glugga) eru tvær algengar leiðir til að útfæra sandkassa, en við förum aðra leið með sandkassa Codex. Í stað þess að flytja vinnslu í sérstakt umhverfi til að einangra hana notar Codex sandkassabúnað hvers stýrikerfis til að takmarka skipanir sem keyra í núverandi umhverfi notandans.

Hjá mörgum forriturum er fartölvan sérsniðið þróunarumhverfi sem þeir geta breytt að vild. Það getur verið talsverð vinna að endurskapa það umhverfi í Docker-gámi og sum verkferli reiða sig enn á verkfæri sem keyra á hýslinum.

Hugsum okkur til dæmis að Codex sé notað til að þróa iOS-forrit á Mac. Ef þú einangraðir Codex með því að keyra það í Docker gæti það hvorki keyrt iOS-smíðaverkfærakeðjuna, sem samanstendur af Mac-keyrsluskrám, né ræst iPhone-herminn til að keyra kóðann. Verkferli byggt á Docker gæti falið Mac-hýslinum að sjá um smíði og aðgerðir í herminum, en þær aðgerðir færu fram utan sandkassa gámsins og þyrftu eigin takmarkanir. Fyrir Codex kjósum við að halda hlutunum einföldum með því að leggja mikla vinnu í sandkassalausnir fyrir hvert stýrikerfi. Þannig getur Codex keyrt í því umhverfi sem hentar verkefninu best.

Kerfið býður aðgang að þessum stýrikerfissértæku sandkassalausnum gegnum sameiginlegt API fyrir macOS, Windows og Linux. Þetta API tekur við skipun og heimildasniði. Ef heimildasniðið leyfir takmarkaðan netaðgang verður sá sem kallar á API-ið að útvega netmilliþjón sem framfylgir þeim takmörkunum:

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:

Þetta fall ræsir ferlið í sandkassa og skilar Child-handfangi sem kerfið getur notað til að bíða eftir að því ljúki. Hvert undirferli erfir sandkassatakmarkanir yfirferlisins. Þær gilda því um allt ferlatréð sem skipunin kemur af stað, jafnvel um afkomendur sem lifa lengur en upphaflega ferlið.

Eftirfarandi skýringarmynd sýnir hvernig þessir þættir tengjast, frá stillingum til keyrslu skipunar í sandkassa. Í næstu köflum er hvert stig útskýrt.

Flæðirit: Stillingar og miðstýrðar kröfur skilgreina heimildasnið lotu. Codex-kerfið ræsir skipanir undir stýrikerfissértækum sandkassatakmörkunum í macOS, Linux eða Windows. Undirferli erfa þessar takmarkanir og valfrjáls netmilliþjónn framfylgir lénsreglum.

Hvernig kerfið nýtir sandkassann

Eins og útskýrt er í Vinnslulykkja Codex-fulltrúans skoðuð sér Codex-kerfið um að framkvæma verkfæraköll sem líkanið býr til. Við forritunarverkefni er algengasta verkfærið skeljarverkfæri, sem keyrir skipanir svipað og notandi myndi gera í gagnvirkri skel á borð við Bash. Hér skoðum við ein-skots ⁠(opnast í nýjum glugga)skeljarverkfærið ⁠(opnast í nýjum glugga)exec_command⁠(opnast í nýjum glugga) til að sýna hvernig kerfið notar sandkassann til að veita þá vernd sem óskað er eftir.

Þetta er einfölduð útgáfa af því hvernig Codex-kerfið myndi framkvæma verkfærakallið
exec_command án sandkassa:

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}

Til að keyra skipunina í sandkassa skiptir kerfið kallinu á subprocess.Popen() út fyrir spawn_command_under_sandbox(). Kerfið leggur til heimildasniðið og netmilliþjóninn þegar hans er þörf:

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}

Verkfærið exec_command leyfir líkaninu einnig að óska eftir öðrum heimildum fyrir einstaka skipun, en kerfið ákveður hvort beiðnin sé samþykkt:

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

Þegar use_default er tilgreint notar kerfið sjálfgefnar sandkassastillingar fyrir umferðina. with_additional_permissions óskar eftir auknum aðgangi innan sandkassans, en require_escalated óskar eftir keyrslu utan hans. Kerfið metur beiðnina út frá kjörstillingum notandans áður en skipunin er keyrð. (Codex getur til dæmis spurt notandann beint eða sent beiðnina í sjálfvirka yfirferð⁠(opnast í nýjum glugga).) Ef keyrsla er heimiluð sendir Codex viðeigandi permission_profile og network_proxy til perform_exec_command_with_sandboxing() ásamt skipunarviðföngunum úr upprunalega ExecCommandToolCall.

Skeljarverkfærið er helsti notandi spawn_command_under_sandbox(), en kerfið endurnýtir einnig sandkassainnviði sína fyrir aðgerðir á borð við lestur og breytingar á staðbundnum skrám. Þessi endurnýting nær út fyrir kerfið: skipunin codex sandbox gerir þér kleift að bæta keyrslu skipana í sandkassa við eigin verkfæri, eins og við sjáum síðar. Næst skoðum við hvernig heimildasnið eru skilgreind.

Stilling sandkassans

Nafngreint heimildasnið gerir þér kleift að endurnýta sömu takmarkanir á skráakerfis- og netaðgangi í mörgum verkefnum. Þú getur skilgreint eigin snið undir [permissions] í config.toml. Eftirfarandi skilgreinir til dæmis snið sem heitir dev og útvíkkar⁠(opnast í nýjum glugga) innbyggða sniðið :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"

Sniðið dev bætir við skrifaðgangi að ~/build-cache og setur frekari takmarkanir á skrár á vinnusvæðinu. Skráakerfisfærslur geta veitt lesaðgang (read), veitt les- og skrifaðgang (write) eða bannað allan aðgang (deny).

Taflan :workspace_roots gerir þér kleift að skilgreina reglur fyrir slóðir miðað við rætur vinnusvæðis verkefnis. Skipanalínuviðmót Codex notar sjálfgefið vinnumöppuna sína sem einu rót vinnusvæðisins, en ChatGPT‑skjáborðsforritið notar frumkóðamöppur verkefnisins. Codex beitir hverri reglu á allar rætur. Því gerir .vscode-færslan í dev möppuna .vscode skrifvarða undir hverri rót.

Auk eigin reglna erfir dev eftirfarandi varnir frá :workspace:

TOML

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

Netheimildir

Við netstillingu sandkassans í Codex eru í grófum dráttum þrjár leiðir í boði:

  • Loka fyrir allan netaðgang (sjálfgefið fyrir :workspace-sniðið)

  • Leyfa fullan, beinan netaðgang (sjálfgefið fyrir :danger-full-access-sniðið)

  • Takmarka netaðgang við milliþjón sem ákveður hvað má fara í gegn út frá heimildasniðinu


Til að veita
dev beinan netaðgang skaltu setja permissions.dev.network.enabled = true á efsta stigi í config.toml. Þetta veitir fullan netaðgang þegar netmilliþjónninn er óvirkur.

Til að takmarka dev við tiltekin lén skaltu virkja netmilliþjóninn og stilla lénsreglur hans:

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

Lénsreglur styðja nákvæm heiti og mynstur með algildistáknum. Skýrar bannreglur ganga framar leyfisreglum. Beiðnir til annarra léna krefjast samþykkis eða eru stöðvaðar, eins og lýst er í kaflanum Netmilliþjónn hér að neðan.

Stillingar í lögum og framfylgd takmarkana

Einstakir notendur geta skilgreint sjálfgefnar stillingar sem gilda fyrir öll verkefni og yfirskrifað þær fyrir tiltekið traust verkefni. Stjórnendur fyrirtækja gætu einnig viljað skilgreina sjálfgefnar stillingar fyrir notendur sína og takmarka hvaða stillingum þeir mega breyta. Codex styður hvort tveggja með lagskiptum stillingum og miðstýrðum kröfum.

Eins og lýst er í Forgangsröðun stillinga⁠(opnast í nýjum glugga) sameinar Codex stillingar úr mörgum config.toml-skrám. Töflur eru sameinaðar niður öll stig og gildið frá þeim uppruna sem hefur meiri forgang ræður þegar gildi stangast á. Fylkjum er skipt út í heild.

Þess vegna nota heimildasnið töflur fyrir skráakerfisslóðir og netlén. Teymi getur bætt við eða yfirskrifað einstakar færslur í eigin stillingum og erft sjálfkrafa breytingar á öllum öðrum færslum í grunnstillingum fyrirtækisins:

TOML

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

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

Stjórnendur geta einnig sett fram miðstýrðar kröfur⁠(opnast í nýjum glugga) í requirements.toml til að takmarka stillingaval notenda. Þessar kröfur geta komið úr mörgum áttum, þar á meðal úr kerfisskrám og reglum úr skýinu. Algengt er að tilgreina allowed_permission_profiles til að takmarka hvaða heimildasnið notandi í fyrirtæki getur valið. Stjórnandi gæti til dæmis skilgreint eftirfarandi kröfur í skýinu:

TOML

1
default_permissions = ":read-only"
2

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

Kröfurnar úr skýinu ganga framar kerfiskröfuskránni á /etc/codex/requirements.toml. Færsla í þeirri skrá getur því ekki yfirskrifað skýru stillinguna ":danger-full-access" = false hér að ofan. Ef :workspace er ekki tilgreint getur annað kröfulag lagt þá færslu til. Snið sem hafa gildið false eða vantar í endanlegu sameinuðu töfluna eru ekki tiltæk.

Þessi aðskilnaður gerir fyrirtækjum kleift að framfylgja takmörkunum á meðan notendur laga stillingar sínar að þörfum sínum innan þeirra marka. Kerfið getur notað heimildasniðin sem verða til, eða þeim má beita beint á skipun, eins og við sjáum næst.

Notkun skipunarinnar codex sandbox

Skipanalínuviðmót Codex býður upp á skipunina sandbox sem auðveldar keyrslu hvaða skipunar sem er undir heimildasniði sem er skilgreint í Codex-stillingunum. Þetta er oft notað til að prófa sniðið og ganga úr skugga um að sandkassinn hindri þá hegðun sem honum er ætlað að stöðva.

Eftirfarandi skipun reynir til dæmis að stilla VS Code þannig að það keyri skaðlegt sjálfvirkt sniðverkfæri við vistun. Að því gefnu að .vscode sé þegar til ætti dev-sniðið hér að ofan að hindra þessi skrif því mappan er skrifvarin (codex sandbox lítur sjálfgefið á cwd sem rót vinnusvæðis):

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 mistekst þetta einmitt með eftirfarandi skilaboðum:

Ósniðinn texti

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

Skipunin codex sandbox gerir sandkassabúnað Codex aðgengilegan óháð lotu með fulltrúa. Þú getur notað sama stillingamál og stýrikerfissértæka framfylgd til að takmarka skipanir sem eigin verkfæri ræsa.

Dæmi: MCP-þjónn í sandkassa

Þegar stdio MCP-þjónn er skilgreindur í config.toml reynir Codex-kerfið ekki að keyra ræsiskipun þjónsins í sandkassa. Codex getur ekki ályktað með áreiðanlegum hætti hvaða skrár eða netþjónustur þjónninn þarf. Sjálfgefið sandkassasnið gæti því komið í veg fyrir að annars gild uppsetning virki.

Hefðbundin leið til að stilla MCP-þjóninn @modelcontextprotocol/server-memory⁠(opnast í nýjum glugga) fyrir notkun með Codex er til dæmis þessi:

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"

Þar sem þessi npx-skipun keyrir utan sandkassa getur hún skrifað skrár og sent netbeiðnir með sömu heimildum og notandinn sem keyrir Codex. Það veitir of víðtækan aðgang. Til að þrengja aðganginn getum við skilgreint heimildasnið sem heitir memory-mcp og keyrt upprunalegu npx-skipunina í gegnum codex sandbox --permission-profile memory-mcp. Þannig takmörkum við hvar þjónninn má skrifa og lokum á netaðgang hans:

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"

Áður en þjónninn er ræstur skaltu búa til gagnamöppuna hans og setja pakkann í tilgreindri útgáfu í npm-skyndiminnið. Þá getur npx --offline ræst þjóninn undir sniði sem lokar á netaðgang:

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

Þegar pakkinn er kominn í skyndiminnið getur Codex ræst minnisþjóninn án netaðgangs og takmarkað skrif við npm-skyndiminnið og gagnamöppu þjónsins.

Útfærsla sandkassa Codex

Útfærsla sandkassans breytir heimildasniði í takmarkanir sem stýrikerfið framfylgir. Kjarnavirkni netmilliþjónsins við meðhöndlun beiðna og framfylgd reglna er sameiginleg öllum þremur helstu stýrikerfunum. Uppsetning milliþjónsins og samþætting við sandkassann er hins vegar sértæk fyrir hvert stýrikerfi. Við skoðum fyrst sameiginlega milliþjóninn og síðan útfærslurnar fyrir macOS, Linux og Windows.

Netmilliþjónn

Til að framfylgja nettakmörkunum heimildasniðs ræsir kerfið netmilliþjón og stillir sandkassann þannig að hann leyfi tengingar við milliþjóninn en hindri beinar tengingar við ytri hýsla. Milliþjónninn ber hverja beiðni saman við lénsreglur sniðsins til að ákveða hvort hann eigi að áframsenda hana.

Í Codex-geymslunni er netmilliþjónninn útfærður í pakkanum codex-network-proxy⁠(opnast í nýjum glugga), sem kerfið notar sem forritasafn. Einnig má þó smíða hann sem sjálfstætt skipanalínuforrit⁠(opnast í nýjum glugga). Þegar codex-network-proxy er virkjað ræsir það sjálfgefið bæði HTTP-milliþjón og SOCKS5-milliþjón. Vistföng þessara milliþjóna eru send til ferlisins sem sandkassinn ræsir með umhverfisbreytum. Auk staðlaðra umhverfisbreyta á borð við HTTP_PROXY, HTTPS_PROXY og ALL_PROXY er bætt við ýmsum þekktum forritssértækum umhverfisbreytum⁠(opnast í nýjum glugga), svo sem PIP_PROXY. Ekki fara þó öll forrit eftir þessum umhverfisbreytum. Ef forrit reynir að tengjast ytri hýsli beint hindra sandkassatakmarkanir stýrikerfisins það, eins og lýst er í köflunum um einstök stýrikerfi hér að neðan.

Netmilliþjónninn sér um að framfylgja þeim nettakmörkunum sem skilgreindar eru í heimildasniði. Til dæmis leyfir dev-sniðið hér að framan beiðnir til *.openai.com en bannar sérstaklega beiðnir til evil.example. Þegar beiðni beinist að léni sem samsvarar hvorki leyfis- né bannreglu getur milliþjónninn sett beiðnina í bið og leitað samþykkis hjá kerfinu. Líkt og í dæminu um skeljarskipunina getur Codex spurt notandann beint eða sent beiðnina í sjálfvirka yfirferð⁠(opnast í nýjum glugga). Þegar ákvörðun liggur fyrir leyfir milliþjónninn beiðninni annaðhvort að halda áfram eða hafnar henni með villusvari.

Röðin skiptir máli hér því jafnvel DNS-uppfletting getur lekið upplýsingum sem eru kóðaðar í hýsilheiti. Milliþjónninn flettir því ekki upp vistfangi umbeðins hýsilheitis fyrr en staðfest hefur verið að það sé leyft eða samþykkt. Athugaðu að víðtækar reglur með algildistáknum eða aðgangur að DNS-þjónustum geta enn gert gagnaleka um DNS mögulegan.

macOS

Í macOS notar Codex Seatbelt⁠(opnast í nýjum glugga), sandkassabúnað Apple sem kjarninn framfylgir. Seatbelt-reglur eru skrifaðar í Sandbox Profile Language (SBPL), máli sem byggir á Scheme og lýsir takmörkunum sandkassa. Codex kallar á Seatbelt með macOS-skipuninni /usr/bin/sandbox-exec. Líkt og codex sandbox tekur hún við valkostum sem lýsa sandkassanum og síðan skipuninni sem á að keyra:

Bash

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

PROFILE er SBPL-strengur með færslum sem stilla sandkassann. Eftirfarandi SBPL-kóðabútur leyfir til dæmis lestur og skrif í /dev/null og /dev/zero samkvæmt reglum sandkassans:

Scheme

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

Þegar netmilliþjónninn er virkjaður við keyrslu sandkassa er reglum á borð við eftirfarandi bætt við sniðið til að takmarka tengingar við viðeigandi staðbundnar gáttir:

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


Grunnsnið Codex byrjar á
(deny default), svo tengingar út á við eru áfram bannaðar nema þær séu sérstaklega leyfðar.

Loks getur SBPL innihaldið staðgengla með (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)))

Gildi þeirra eru sett með -Dkey=value-valkostunum sem eru sendir til sandbox-exec.

Til að útfæra eigið sandkassa-API byggir Codex upp viðfangalistann⁠(opnast í nýjum glugga) fyrir sandbox-exec út frá grunnreglum⁠(opnast í nýjum glugga). Síðan notar það permission_profile og annað samhengi til að laga þær að og útbúa fullbúið Seatbelt-snið. Sniðið sem verður til og meðfylgjandi -D-viðföng stilla þær takmarkanir sem Seatbelt framfylgir, en netmilliþjónninn framfylgir viðbótarnetreglum. Þegar allur viðfangalistinn er tilbúinn er einfalt að kalla á sandbox-exec.

Það er vandasamt að búa til rétt SBPL því Apple birtir ekki skjöl um málið fyrir utanaðkomandi aðila. Í man sandbox-exec stendur raunar The sandbox-exec command is DEPRECATED (hið sama á við um safnfallið sandbox_init(), sem er skjalfest í man 3 sandbox_init). Þrátt fyrir viðvörunina um úreldingu fylgja Seatbelt-snið enn með macOS í /usr/share/sandbox og hugbúnaður frá þriðja aðila, þar á meðal Google Chrome og Chromium⁠(opnast í nýjum glugga), reiðir sig áfram á Seatbelt. Við ætlum því að halda áfram að nota Seatbelt um fyrirsjáanlega framtíð.

Linux

Til að búa til sandkassann í Linux notar Codex saman bubblewrap⁠(opnast í nýjum glugga) (bwrap), skipanalínuverkfæri til að útbúa einangruð umhverfi, og seccomp-bpf⁠(opnast í nýjum glugga), búnað í Linux-kjarnanum til að sía kerfisköll. Innra hjálparforrit sem heitir codex-linux-sandbox samhæfir uppsetninguna. Líkt og sandbox-exec í macOS tekur það við sandkassastillingum og síðan skipun sem á að keyra:

Bash

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

Þegar þörf er á einangrun skráakerfis eða beiningu um milliþjón kallar codex-linux-sandbox á bwrap til að setja upp upphaflegt sandkassaumhverfi. bwrap ræsir síðan codex-linux-sandbox --apply-seccomp-then-exec innan þess. Þessi seinni keyrsla notar seccomp-bpf til að beita viðbótartakmörkunum áður en skipun notandans er keyrð.

Til að setja upp þetta upphaflega sandkassaumhverfi notar Codex bubblewrap til að útbúa sýn á skráakerfið í sérstöku tengingarnafnarými sem endurspeglar skráakerfisreglur heimildasniðsins. Þar sem þetta er grundvallarþáttur í útfærslu sandkassans fylgir eigið eintak af bwrap með Codex, ef notandinn hefur ekki sett það upp sjálfur. Codex velur þó frekar samhæfa uppsetningu af ⁠(opnast í nýjum glugga)bwrap⁠(opnast í nýjum glugga) sem finnst á PATH, ef hún er tiltæk. Reynslan sýnir að sumar Linux-dreifingar loka sjálfgefið á aðgang að notandanafnarýmum⁠(opnast í nýjum glugga), en gera undantekningu fyrir bwrap kerfisins.

Líkt og sandbox-exec tekur bwrap við sandkassastillingum og síðan skipun sem á að keyra innan sandkassans. Í stað sérsniðins stillingamáls á borð við SBPL notar bwrap staka fána til stillinga. Codex notar eftirfarandi valkosti til að útbúa sýnina á skráakerfið:

  • --bind til að tilgreina skrá eða möppu sem má skrifa í

  • --ro-bind til að tilgreina skrifvarða skrá eða möppu

  • --perms 000 --tmpfs DIR --remount-ro DIR til að banna aðgang að DIR

  • --perms 000 --ro-bind-data FD FILE til að banna aðgang að FILE (þar sem FD er opinn skráarlýsir fyrir /dev/null)

Til að beita bannmynstrum með þessum valkostum leysir Codex þau upp í tilteknar slóðir áður en hver skipun er ræst. Nýjum slóðum sem samsvara mynstrunum er ekki sjálfkrafa bætt við takmarkanir sandkassa þeirrar skipunar.

Codex tilgreinir einnig valkosti á borð við --unshare-ipc og --unshare-pid til að hindra aðgang sandkassans að öðrum tegundum tilfanga á hýslinum. Áhrif bubblewrap ná því lengra en til þess hvaða skrár sjást.

Þegar bubblewrap er notað sendir Codex --unshare-net með ef netaðgangur er óvirkur eða tengingar verða að fara um netmilliþjóninn. Þá er búið til nýtt netnafnarými fyrir sandkassann. Síðan notum við seccomp-bpf til að takmarka enn frekar þau netkerfisköll og sökklafjölskyldur sem skipunin hefur aðgang að.


Nánar tiltekið notum við
seccompiler-pakkann⁠(opnast í nýjum glugga) til að þýða BPF-forrit við keyrslu út frá völdum síum⁠(opnast í nýjum glugga) og beita því á ræsiferli í sandkassanum svo takmarkanirnar erfist niður allt ferlatréð. Því keyrir bwrap ekki skipun notandans heldur ræsiforritið codex-linux-sandbox, með eigin stillingaviðföngum og síðan skipun notandans:

Bash

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

Til að beita seccomp-síum án aukinna réttinda stillir ræsiforritið no_new_privs fánann í Linux⁠(opnast í nýjum glugga). Undirferli erfa þennan fána, sem kemur í veg fyrir að þau öðlist aukin réttindi við keyrslu annars forrits, svo sem setuid-keyrsluskrár.

Seccomp-síurnar ráðast af netstillingunum. Þegar netaðgangur er óvirkur lokum við á ýmis nettengd kerfisköll, svo sem connect(2) og bind(2). Þegar netmilliþjónninn er virkur í sandkassanum leyfum við hins vegar IP-sökkla svo hægt sé að tengjast TCP-hlustaranum sem codex-linux-sandbox býr til. Við bönnum þó sjálfgefið stofnun sjálfstæðra Unix-lénssökkla, þar sem þeir gætu óviljandi veitt aðgang að tilföngum hýsilsins.

Tenging við netmilliþjóninn

Þegar stillingar sandkassans kalla á notkun netmilliþjóns býr Codex-kerfið til eitt tilvik hans sem hægt er að endurnýta við margar keyrslur codex-linux-sandbox innan sama Codex-þráðar. Hver sandkassi þarf leið til að ná í þennan sameiginlega milliþjón úr einangruðu netnafnarými sínu. Codex setur upp TCP-hlustara á bakrás innan þess nafnarýmis og sér til þess að ferli utan sandkassans taki við tengingum hans og miðli þeim til milliþjónsins.

Eftirfarandi skýringarmyndir sýna þessa uppsetningu fyrir einn endapunkt milliþjóns. Á síðustu myndinni sést ein tenging í gegnum hann. Áður en bubblewrap er ræst býr codex-linux-sandbox til Unix-sökklapar sem stjórnrás og stofnar afrit af sjálfu sér. Undirferlið keyrir run_host_bridge() og bíður eftir að fá skráarlýsi hlustarans um þá rás:

Skýringarmynd af Codex-kerfinu sem ræsir codex-linux-sandbox. Það stofnar miðlunarferli sem tengist um stjórnrás yfir Unix-sökkul.

Í þessu dæmi notar yfirferlið exec til að skipta eigin forritsmynd út fyrir bwrap. Það setur upp sandkassann og ræsir codex-linux-sandbox --apply-seccomp-then-exec innan hans og sendir skráarlýsi stjórnrásarinnar með:

Skýringarmynd sem sýnir bwrap búa til netnafnarými sandkassa og ræsa codex-linux-sandbox innan þess, með stjórnrás yfir Unix-sökkul til miðlunarferlisins utan sandkassans.

Innan netnafnarýmis sandkassans býr seinni keyrslan á codex-linux-sandbox til TCP-hlustara á bakrás og sendir skráarlýsi hans um sökkulinn. Hlustarinn helst tengdur netnafnarými sandkassans. Undirferlið sem varð eftir utan sandkassans getur því tekið við tengingum frá forritum innan hans, en opnað tengingar sínar áfram í netnafnarými hýsilsins. Eftir afhendinguna loka bæði ferlin lýsum sínum fyrir stjórnrásina og ferlið innan sandkassans lokar sínu eintaki af hlustaranum.

Þegar TCP-hlustarinn er tilbúinn stillir ferlið í sandkassanum viðeigandi gildi fyrir HTTP_PROXY⁠(opnast í nýjum glugga) og tengdar umhverfisbreytur þannig að þær vísi á hlustarann. Það beitir síðan seccomp áður en það stofnar afrit af sér og keyrir skipun notandans:

Skýringarmynd sem sýnir forrit í sandkassa tengjast TCP-hlustara á bakrás, á meðan codex-linux-sandbox-miðlunarferli utan sandkassans áframsendir umferð til netmilliþjóns Codex.

Ferlið utan sandkassans heldur hlustaranum opnum. Fyrir hverja tengingu sem það tekur við opnar það tengingu við tilgreindan milliþjón og miðlar gögnum í báðar áttir.

Þessi viðbótarbúnaður veitir skipuninni eigið netnafnarými, þar á meðal sérstakt bakrásarviðmót. Í macOS leyfir Seatbelt skipuninni að tengjast beint tilgreindum gáttum á bakrásarviðmóti hýsilsins. Í Linux tengist skipunin þess í stað hlustara innan einangraðs nafnarýmis síns og ferli utan sandkassans miðlar þeim tengingum til tilgreinds milliþjóns. Afhending lýsisins gerir þessa tengingu mögulega án þess að veita skipuninni aðgang að netnafnarými hýsilsins.

Windows

Fyrr á þessu ári innleiddum við sandkassa í Windows og skrifuðum um þá vinnu. Síðan þá hefur Microsoft gefið út forritasafn sem kallast MXC ásamt nýjum eiginleikum til að einangra ferli innan Windows-stýrikerfisins. Við erum nú að skipta út núverandi sandkassa fyrir annan sem nýtir MXC-forritasafnið.

Hvað er MXC?

MXC (Microsoft eXecution Container) er kerfi til að keyra kóða í sandkassa⁠(opnast í nýjum glugga) frá Microsoft sem styður ýmsar bakendalausnir fyrir einangrun í Windows, Linux og macOS. Codex styður sandkassa sem byggir á MXC í samhæfum Windows-tækjum og notar innbyggða ferlaeinangrun til að takmarka skipanir innan núverandi umhverfis notandans.

Við erum að færa okkur yfir í MXC til að auka öryggi og bæta notagildi, um leið og við bætum úr ýmsum annmörkum núverandi Windows-sandkassa:

  • Þörf fyrir aukin réttindi eða stjórnandaréttindi til að setja upp sandkassann

  • Frek og hæg vinnsla við að athuga og stilla aðgangsstýringarlista (ACL)

  • Uppsetning sandkassans skilur eftir varanlegar breytingar á hýsilvélinni, þar á meðal

    • aðgangsstýringarlista (ACL)

    • eldveggsreglur

    • notendur sandkassans

    • skrár stjórnkerfis

MXC býður upp á JSON-skema fyrir stillingar⁠(opnast í nýjum glugga). Codex notar MXC SDK⁠(opnast í nýjum glugga) til að útbúa keyrslubeiðni sem fylgir þessu skema og inniheldur skipunina, vinnumöppu, umhverfi og heimildir. Þessar heimildir ná yfir skráakerfis- og netaðgang, auk Windows-tilfanga á borð við skjáborð og klippispjald.

Útfærsla aðgangsreglna í MXC-kalli

Codex notar fastar stillingar fyrir nokkrar stýringar til að gæta jafnvægis milli samhæfni og öryggis. Það leyfir lestur úr kerfisskránni og heldur þeim aðgangi að Win32k og skjáborðinu sem PowerShell þarf við ræsingu. Aðgangur að klippispjaldi, íspýting inntaks og stýring skjáborðs og kerfisstillinga eru óvirk. Loks er komið í veg fyrir að MXC grípi til þess að breyta skráakerfisheimildum hýsilsins.

Codex yfirfærir skráakerfis- og netreglur heimildasniðsins í stillingar MXC. Ef við notum dev-sniðið hér að framan og gerum ráð fyrir eftirfarandi:

  • C:\, D:\ og Z:\ eru einu staðbundnu drif vélarinnar.

  • Rót vinnusvæðisins og vinnumappan eru C:\work\demo.

  • Heimamappa notandans er D:\Users\dev, svo ~/build-cache vísar á D:\Users\dev\build-cache.

  • Bannmynstrið samsvarar aðeins C:\work\demo\config\dev.env og C:\work\demo\config\prod.env.

Þá myndu samsvarandi MXC-stillingar meðal annars innihalda:

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
}

Aðgangur að rótum drifa

Skráakerfisreglur MXC hafna sjálfgefið öllum aðgangi. Codex bætir því við lesheimildum fyrir rætur staðbundinna drifa til að veita þann víðtæka lesaðgang sem sniðið leyfir. Þessar heimildir gilda niður allt möpputréð, með fyrirvara um réttindi notandans í stýrikerfinu.

Ein undantekning er þó á þessu: skrifheimildir á rótum drifa gilda ekki niður allt möpputréð. Codex útvíkkar þær því þannig að þær nái til þeirra skráa og mappa sem eru beint undir rót drifsins.

Heimildir sem stangast á

Sértækari slóðir ganga framar heimildum ofar í möpputrénu. Því má leyfa skrif í C:\work\demo þótt aðeins sé lesaðgangur að C:\, á meðan C:\work\demo\.git helst skrifvarið.

Þegar mismunandi ritháttur slóða eða tákntenglar og möpputengingar vísa á sömu slóð beitir MXC strangari heimildinni: bann gengur framar lesaðgangi, sem gengur framar les- og skrifaðgangi.

Bannmynstur

MXC tekur aðeins við tilteknum slóðum sem á að banna. Codex leysir því bannmynstur upp í samsvarandi skrár og möppur áður en keyrsla hefst. Nýjum slóðum sem samsvara mynstrinu er ekki sjálfkrafa bætt við meðan skipunin keyrir.

Netaðgangur

Sameiginlegi netmilliþjónn Codex, sem lýst var hér að framan, framfylgir lénsreglum á borð við *.openai.com. Codex keyrir milliþjóninn utan sandkassans og sendir vistföng hans til skipunarinnar með sömu stöðluðu *_PROXY-umhverfisbreytum og áður var nefnt. MXC hindrar beinar ytri tengingar en leyfir tengingar við bakrás hýsilsins, þar á meðal aðgang að milliþjóninum. Aðrar staðbundnar þjónustur eru áfram aðgengilegar.

Í macOS, Linux og Windows notar kerfið sama sandkassa-API til að ræsa skipanir undir heimildasniði. Stýrikerfissértæku útfærslurnar sjá um þá uppsetningu sem þarf til að beita þessum takmörkunum.

Byggt á sandkassa Codex

Með því að skrifa og keyra kóða geta fulltrúar leyst fjölbreytt verkefni, ekki aðeins við hugbúnaðarþróun. Sandkassi Codex gerir þeim kleift að nýta þessa getu í núverandi umhverfi notandans með skýrum takmörkunum á skráakerfis- og netaðgangi. Hann er endurnýtanleg grunneining innan kerfisins og skipunin codex sandbox gerir hann aðgengilegan fyrir verkfæri sem þú smíðar sjálfur.

Eftir því sem fulltrúar taka að sér fleiri verkefni viljum við gera notkun sandkassa hagnýta fyrir fleiri verkfæri og umhverfi. Það felur í sér að auðvelda stillingu heimilda og nýta betri varnir stýrikerfa eftir því sem þær verða tiltækar. Markmið okkar er að auka getu fulltrúa en tryggja um leið að fólk ráði áfram að hverju þeir hafa aðgang.

Höfundur

OpenAI

Þakkir

Sérstakar þakkir fá David Wiesen, Charlie Weems, Viyat Bhalodia og Fotis Chantzis fyrir framlag sitt til þessarar greinar.