Biztonság és hozzáférés-ellenőrzés
Ezen az oldalon
A leckét 2026. november 3-án írtuk át az Agent approvals & security, Rules, Compliance API and audit events oldalak és a Codex kézikönyv alapján. A korábbi verzió egy nem létező
.codexignorefájlt említett, azt állította, hogy a Codex csak az AGENTS.md-ben felsorolt parancsokat futtatja, hivatkozott egy „Organization Settings → Audit Logs“ menüre, és forrás nélkül említette a Codex SOC 2 Type II tanúsítványát. Források: Agent approvals & security · Rules · Compliance API · Pricing.
A Codex látókörének és műveleteinek szabályozása
A biztonság akkor válik kritikussá, amikor egy AI-ügynök hozzáfér a forráskódodhoz. A Codex beépített védelmi mechanizmusokkal rendelkezik, de ezek konfigurálása a te felelősséged: a termék biztosítja az elszigetelést, míg te határozod meg a perimetert. Ha kényelemből egy éjszakai roham során csatlakoztatsz egy tárolót, vagy elfelejtesz egy titkos adatot egy régi konfigurációs fájlban, a technikai elszigetelés nem fog megvédeni.
A Codex biztonsági modellje
Két egymást kiegészítő beállítás szabályozza, mit tehet az ügynök: a sandbox (homokozó), amely meghatározza, mihez férhet hozzá technikailag, és a jóváhagyási házirend, amely eldönti, mikor kell megállnia és engedélyt kérnie – például amikor kilép a sandboxból, hálózatot használ, vagy a megengedett készleten kívüli parancsot futtat.
- Helyileg (CLI, bővítmény, asztali alkalmazás) operációsrendszer-szintű mechanizmusok érvényesítik a sandboxot. Alapértelmezetten nincs hálózati hozzáférés, és az írási műveletek az aktív munkaterületre korlátozódnak. A gyakori
--sandbox workspace-write --ask-for-approval on-requestelőbeállítással a Codex szabadon olvas, módosít és hajt végre parancsokat a munkakönyvtáron belül, de kérdez, mielőtt máshova írna vagy hálózatot használna. Aread-onlymód (a/permissionsparancson keresztül) lehetővé teszi, hogy változtatások nélkül beszélgethess és tervezz. - Felhőben minden Codex Cloud feladat saját munkaterületen fut egy OpenAI által kezelt környezetben; a hitelesítő adatokat és a hálózati hozzáférést környezetenként konfigurálják, a hálózati titkok pedig csak engedélyezett HTTPS szolgáltatásokra korlátozódnak.
Ellentétben azzal, amit a lecke előző verziója állított, a Codex nincs az AGENTS.md-ben felsorolt parancsokra korlátozva: parancsokat futtathat, amelyet a sandbox/jóváhagyás pár korlátoz. A továbblépéshez a szabályok (rules) irányítják a sandboxon kívüli engedélyezett parancsokat: egy előtag-szabály (prefix rule) megerősítést írhat elő, vagy teljesen megtilthat egy parancsot.
# .rules fájl (Starlark szintaxis)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "All outgoing network requests must be confirmed.",
)
Ezeket a szabályokat a rendszergazda érvényesíti, és csak megerősítést írhatnak elő vagy tiltanak le műveleteket; automatikus engedélyezést nem adhatnak.
Az olvasásra nem szánt adatok elrejtése
Nincs .codexignore fájl. Annak megakadályozására, hogy a Codex érzékeny fájlokat olvasson (még akkor is, ha verziókezelve vannak), használj egy engedélyezési profilt (permissions profile), amely deny (megtagadás) szabályokat tartalmaz pontos elérési utakra vagy mintákra:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
A :workspace_roots alá helyezve a szabály minden munkaterület-gyökérre vonatkozik: az .env fájlok ott olvashatatlanná válnak anélkül, hogy máshol blokkolnák a normál írást. A pontos elérési utak jól működnek stabil helyeknél, mint például a ~/.ssh; a minták változó helyen lévő fájlokhoz alkalmasak. Egy rendszergazda ezeket a megtagadásokat az egész szervezetre kényszerítheti ki (permissions.filesystem.deny_read).
A dokumentáció két korlátozást említ. Linuxon, WSL-en és Windowson a mintaillesztések minden sandbox-folyamat indításakor feloldódnak: egy ezután létrehozott, illeszkedő fájl olvasható marad a már futó folyamat számára. Emellett egy korlátlan ** minta megköveteli a glob_scan_max_depth beállítását. A legbiztonságosabb megközelítés továbbra is az, ha a titkos adatokat teljesen távol tartod a tárolótól.
Ugyanezt az óvatosságot alkalmazd az AGENTS.md fájlra is, amelyet a Codex minden futtatáskor beolvas. Soha ne helyezz el valódi titkos adatokat benne: a tesztparancsaid által elvárt formátum magyarázatához elegendőek a dummy (ál) értékek.
## Environment Variables
Test commands use dummy variables:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Nyomon követés és monitorozás
Enterprise és Edu csomagok esetén a naplózás és a használatkövetés a Compliance API-n keresztül történik. Ez támogatja azokat a biztonsági, jogi és vizsgálati célokat, amelyek ellenőrizhető rekordokat igényelnek: események exportálása SIEM-be vagy adat-tóba, saját megőrzési időszajok és jogi zárolások alkalmazása, valamint a Codex-tevékenység correlálása a saját identitásadataiddal. Az Admin API dokumentációja szabályozza a lefedett eseményeket, szűrőket és megőrzési időket; a folyamatos gyűjtés ütemezése előtt teszteld a bejövő adatokat egy nem éles rendszeren.
Ez nem egy termelékenységi irányítópult: az OpenAI óva int attól, hogy kódminőség vagy egyéni teljesítmény megítélésére használd; ehelyett a munkaterületi betekintésekre és az Analytics API-ra hivatkozik az elfogadottsági mutatókhoz. Valakinek ténylegesen használnia is kell ezeket a naplókat a baleset utáni elemzéseken túl: tartsd őket az ügynök által vezérelt környezeten kívül, és állíts be riasztást ismétlődő hitelesítési hibákra, szokatlan hozzáférésre és konfigurációs változtatásokra.
Megfelelés és szabályozás
Ha a kódod európai személyes adatokat kezel, négy pont a te felelősséged, nem a szállítóé. Győződj meg róla, hogy az OpenAI szerződésed tartalmaz DPA-t (Adatfeldolgozási megállapodás); használd az adattárolási és -elhelyezési vezérlőket, ha a csomagod lehetővé teszi (Enterprise és Edu); dokumentáld a Codex használatát az adatfeldolgozási tevékenységek nyilvántartásában; végül pedig tájékoztasd a csapatokat, hogy kódjukat harmadik fél szolgáltatása dolgozza fel. A Business csomagban a vállalati adatok alapértelmezetten nem kerülnek felhasználásra tanítási célokra.
SOC 2 vagy ISO 27001 audit esetén támaszkodj az OpenAI által közzétett dokumentumokra – beleértve a Codex Security Whitepaper címűt a bizalmi portálon –, és ellenőrizd minden igazolás hatókörét és dátumát: egy lejárt igazolás, vagy olyan, amely nem fedi le az általad használt szolgáltatást, semmilyen súllyal nem bír egy auditor előtt. A Compliance API exportok megfelelnek a nyomonkövethetőségi követelményeknek, feltéve, hogy azokat folyamatosan gyűjtik és kérésre előállítják.
Biztonsági legjobb gyakorlatok
- - Tiltasd meg az érzékeny fájlok olvasását (`deny` szabályok)
- - Gyűjtsd és auditáld a Compliance API naplókat
- - A csatlakoztatott tárolókat korlátozd a minimumra
- - Használj SSO-t MFA-val
- - Vonás előtt vizsgáld át a Codex PR-eket
- - Ne csatlakoztass olyan tárolót, ahol titkos adatok vannak a kódban
- - Ne helyezz el valódi tokeneket az AGENTS.md-ben
- - Ne végezz automatikus egyesítést (auto-merge) átvizsgálás nélkül
- - Ne hagyd figyelmen kívül az audit riasztásokat
- - Ne ossz meg egy Codex fiókot fejlesztők között
A fiókmegosztás, ami a jobb oldali oszlop utolsó tétele, külön említést érdemel: ez azonnal semmissé teszi az auditnaplók teljes értékét, mivel egyetlen művelet sem köthető egy azonosítható személyhez.
Főbb megállapítások
- A sandbox határolja, mihez férhet hozzá a Codex (helyileg: alapértelmezetten nincs hálózat, az írás a munkaterületre korlátozódik); a jóváhagyási házirend határozza meg, mikor kérdez
- A szabályok (rules) irányítják a sandboxon kívüli parancsokat (
promptvagyforbidden) - A
.codexignorenem létezik: az érzékeny fájlok olvasását egy engedélyezési profildenyszabályaival tiltsd le - Az auditnaplók a Compliance API-n keresztül érhetők el (Enterprise és Edu)
- Ha európai adatokat kezelsz, ellenőrizd a GDPR-megfelelést
- Soha ne helyezz el valódi titkos adatokat az AGENTS.md-ben