Turvalisus ja juurdepääsu auditeerimine
Sellel lehel
Õppetund kirjutati ümber 3. novembril 2026, tuginedes lehtedele Agent approvals & security, Rules, Compliance API and audit events ja Codexi käsiraamatule. Eelmine versioon kirjeldas olematut
.codexignorefaili, väitis, et Codex käivitab ainult AGENTS.md loetletud käske, viitas menüüle “Organization Settings → Audit Logs” ja mainis Codexi SOC 2 Type II sertifikaati ilma allikata. Allikad: Agent approvals & security · Rules · Compliance API · Pricing.
Codexi nähtavuse ja tegevuse kontrollimine
Turvalisus muutub kriitiliseks hetkel, kui tehisintellekti agent pääseb ligi sinu lähtekoodile. Codex sisaldab sisseehitatud kaitsemeetmeid, kuid nende seadistamine on sinu vastutusel: toode pakub isolatsiooni, sina määratled perimeetri. Kui ühendad hoidla mugavuse huvides hilisõhtuse kiirustamise ajal või jätad salajase võtme ununenud konfiguratsioonifaili, ei kaitse sind tehniline isolatsioon.
Codexi turvamudel
Kahe täiendava seadistuse abil määratakse, mida agent teha võib: liivakast (sandbox), mis defineerib, mida ta tehniliselt puudutada tohib, ja kinnituspoliitika, mis määrab, millal ta peab peatuma ja loa küsima – näiteks liivakastist lahkumisel, võrku kasutades või lubatud hulgast väljaspool käsku käivitades.
- Lokaalselt (CLI, laiendus, töölauarakendus) jõustavad liivakasti operatsioonisüsteemi tasandi mehhanismid. Vaikimisi puudub võrguühendus ja kirjutamistegevused on piiratud aktiivse tööruumiga. Levinud eelseadistusega
--sandbox workspace-write --ask-for-approval on-requestloeb, muudab ja käivitab Codex vabalt töökataloogis, kuid küsib enne mujale kirjutamist või võrgu kasutamist luba. Režiimread-only(käsu/permissionskaudu) võimaldab arutada ja planeerida ilma muudatusi tegemata. - Pilves käib iga Codex Cloudi ülesanne oma tööruumis OpenAI hallatavas keskkonnas; mandaadid ja võrguühendus konfigureeritakse keskkonniti, kusjuures võrgusalaamid on piiratud volitatud HTTPS-teenustega.
Erinevalt selle õppetunni eelmises versioonis väidetust ei ole Codex piiratud ainult AGENTS.md loetletud käskudega: ta saab käskude käivitada, mida piirab liivakasti ja kinnituspoliitika paar. Edasiseks reguleerivad reeglid lubatud käske väljaspool liivakasti: prefiksi reegel võib nõuda kinnitust või keelata käsu täielikult.
# .rules fail (Starlark süntaks)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "Kõik väljuvad võrgupäringud tuleb kinnitada.",
)
Administraatori poolt jõustatud reeglid saavad ainult nõuda kinnitust või keelata tegevusi; need ei saa anda automaatset luba.
Peitmiseks, mida lugeda ei tohiks
.codexignore faili ei eksisteeri. Et takistada Codexil tundlike failide lugemist isegi siis, kui need on versioonitud, kasuta õiguste profiili koos deny reeglitega täpsetele radadele või mustritele:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Paigutatuna võtme :workspace_roots alla, kehtib reegel iga tööruumi juure kohta: .env failid muutuvad seal loetamatuks, blokeerimata seejuures tavalist kirjutamist mujal. Täspsed rajad sobivad hästi stabiilsete asukohtade jaoks nagu ~/.ssh; mustrid sobivad muutliku asukohaga failidele. Administraator saab need keelud jõustada kogu organisatsiooni ulatuses (permissions.filesystem.deny_read).
Dokumentatsioon toob välja kaks piirangut. Linuxis, WSL-is ja Windowsis lahendatakse mustri vasted iga liivakasti protsessi käivitumisel: pärast seda loodud vastav fail jääb juba käimas olevale protsessile loetavaks. Samuti nõuab piiramata ** muster parameetrit glob_scan_max_depth. Ohutuim lähenemine on hoida salaandmed hoidlast täielikult eemal.
Rakenda sama ettevaatust faili AGENTS.md suhtes, mida Codex iga käivituse korral loeb. Ära kunagi pane sinna päris salaandmeid: formaadi selgitamiseks sinu testkäskudele piisavad näivväärtused.
## Keskkonnamuutujad
Testkäskud kasutavad näivmuutujaid:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Jälitamine ja monitooring
Ettevõtte (Enterprise) ja haridus (Edu) plaanides liiguvad auditi logid ja kasutuse jälgimine läbi Compliance API. See toetab turbe-, juriidilisi ja uurimise eesmärke, mis nõuavad kontrollitavaid kirjeid: sündmuste eksport SIEM-i või andmelattu, oma säilitusperioodide ja juriidiliste hoidmiste rakendamine ning Codexi tegevuse korrelatsioon sinu identiteediandmetega. Admin API dokumentatsioon reguleerit hõlmatud sündmusi, filtreid ja säilitamist; enne pideva kogumise planeerimist testi andmete vastuvõttu mitte-tootmiskeskkonnas.
See ei ole tootlikkuse armatuurlaud: OpenAI soovitab seda mitte kasutada koodi kvaliteedi või üksikisiku jõudluse hindamiseks, viidates selle asemel tööruumi ülevaadetele ja Analytics API-le kasutuselevõtu mõõdikute jaoks. Keegi peab neid loge tegelikult kasutama ka pärast intsidentide analüüsi: hoia neid agendi kontrollitavast keskkonnast väljaspool ja seadista hoiatused korduvate autentimisvigade, ebatavalise juurdepääsu ja konfiguratsioonimuudatuste korral.
Vastavus ja regulatsioonid
Kui sinu kood töötleb Euroopa isikuandmeid, langeb neli punkti sinu, mitte teenusepakkuja vastutusele. Veendu, et sinu OpenAI leping sisaldab DPA-d (andmetöötluse leping); kasuta andmete säilitamise ja asukoha kontrolle, kui sinu plaan neid pakub (Enterprise ja Edu); dokumenteeri Codexi kasutus oma töötlustegevuste registris; ja lõpuks teavita meeskondi, et nende koodi töötleb kolmas osapool. Äriplaanis (Business) ei kasutata ettevõtte andmeid vaikimisi treenimiseks.
SOC 2 või ISO 27001 auditi jaoks tugine OpenAI avaldatud dokumentidele – sealhulgas Codexi turbe valgele raamatule selle usaldusportaalis – ja kontrolli iga kinnituse ulatust ja kuupäeva: aegunud kinnitus või selline, mis ei hõlma sinu kasutatavat teenust, ei kaalu auditi jaoks midagi. Compliance API ekspordid vastavad jälgitavusnõuetele, eeldusel et neid kogutakse pidevalt ja esitatakse nõudmisel.
Turvalisuse parimad tavad
- - Keela tundlike failide lugemine (`deny` reeglid)
- - Kogu ja auditeeri Compliance API logisid
- - Piira ühendatud hoidlad miinimumini
- - Kasuta SSO-d koos MFA-ga
- - Vaata Codexi PR-id enne ühendamist üle
- - Ühenda hoidlaid, mille koodis on salaandmed
- - Pane päris tokenid faili AGENTS.md
- - Ühenda automaatselt ilma ülevaatuseta
- - Eira auditi hoiatusi
- - Jaga Codexi kontot arendajate vahel
Konto jagamine, viimane punkt paremas veerus, väärib erilist mainimist: see tühistab koheselt kogu auditi logide väärtuse, kuna ühtegi tegevust ei saa seostada konkreetse isikuga.
Peamised punktid
- Liivakast piirab seda, mida Codex puudutada saab (lokaalselt: vaikimisi puudub võrk, kirjutamine piiratud tööruumiga); kinnituspoliitika määrab, millal ta küsib
- Reeglid reguleerivad käske väljaspool liivakasti (
promptvõiforbidden) .codexignoreei eksisteeri: keela tundlike failide lugeminedenyreeglitega õiguste profiilis- Auditi logid liiguvad läbi Compliance API (Enterprise ja Edu)
- Kontrolli GDPR-i vastavust, kui töötlead Euroopa andmeid
- Ära kunagi pane päris salaandmeid faili AGENTS.md