Turvallisuus ja pääsyn valvonta
Tällä sivulla
Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 perustuen sivuihin Agent approvals & security, Rules, Compliance API and audit events sekä Codex-käsikirjaan. Edellinen versio kuvasi olematonta
.codexignore-tiedostoa, väitti Codexin suorittavan vain AGENTS.md:ssä lueteltuja komentoja, viittasi valikkoon “Organization Settings → Audit Logs” ja mainitsi Codexin SOC 2 Type II -sertifioinnin ilman lähdettä. Lähteet: Agent approvals & security · Rules · Compliance API · Pricing.
Codexin näkyvyyden ja toimintavallan hallinta
Turvallisuudesta tulee kriittistä heti, kun tekoälyagentti pääsee käsiksi lähdekoodiisi. Codexissa on sisäänrakennetut suojaukset, mutta niiden konfigurointi on sinun vastuullasi: tuote tarjoaa eristyksen, mutta sinä määrittelet rajat. Jos yhdistät arkiston mukavuuden vuoksi myöhäisen yön kiireessä tai jätät salaisen avaimen unohdettuun asetustiedostoon, tekninen eristys ei suojaa sinua.
Codexin turvallisuusmalli
Kahta toisiaan täydentävää asetusta ohjaavat agentin toimintaa: hiekkalaatikko (sandbox), joka määrittelee, mihin se voi teknisesti koskea, ja hyväksymiskäytäntö, joka päättää, milloin sen on pysähdyttävä kysymään lupaa – esimerkiksi poistuessaan hiekkalaatikosta, käytettäessä verkkoa tai suoritettaessa komentoa sallitun joukon ulkopuolelta.
- Paikallisesti (CLI, laajennus, työpöytäsovellus) käyttöjärjestelmätason mekanismit valvovat hiekkalaatikkoa. Oletuksena verkkoyhteyttä ei ole, ja kirjoitusoperaatiot rajoittuvat aktiiviseen työtilaan. Yleisellä esiasetuksella
--sandbox workspace-write --ask-for-approval on-requestCodex lukee, muokkaa ja suorittaa vapaasti työhakemistossa, mutta kysyy lupaa ennen kirjoittamista muualle tai verkon käyttöä.read-only-tila (komento/permissions) antaa sinun keskustella ja suunnitella ilman muutosten tekemistä. - Pilvessä jokainen Codex Cloud -tehtävä suoritetaan omassa työtilassaan OpenAI:n hallinnoimassa ympäristössä; tunnistetiedot ja verkkoyhteys konfiguroidaan ympäristökohtaisesti, ja verkkosalaisuudet rajoitetaan valtuutettuihin HTTPS-palveluihin.
Toisin kuin tämän oppitunnin edellinen versio väitti, Codexia ei ole rajoitettu vain AGENTS.md:ssä lueteltuihin komentoihin: se voi suorittaa komentoja, joita rajoittaa hiekkalaatikon ja hyväksymiskäytännön yhdistelmä. Pidemmälle mentäessä säännöt ohjaavat sallittuja komentoja hiekkalaatikon ulkopuolella: etusääntö voi vaatia vahvistusta tai kieltää komennon kokonaan.
# .rules-tiedosto (Starlark-syntaksi)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "Kaikki lähtevät verkkopyynnöt on vahvistettava.",
)
Järjestelmänvalvojan valvomina nämä säännöt voivat vain vaatia vahvistusta tai kieltää toimintoja; ne eivät voi myöntää automaattista lupaa.
Piilota se, mitä ei pitäisi lukea
.codexignore-tiedostoa ei ole ole olemassa. Estääksesi Codexia lukemasta arkaluonteisia tiedostoja, vaikka ne olisivat versionhallinnassa, käytä oikeusprofiilia, jossa on deny-sääntöjä tarkkoja polkuja tai kuvioita varten:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Kun sääntö sijoitetaan kohtaan :workspace_roots, se koskee jokaista työtilan juurta: .env-tiedostot muuttuvat siellä lukukelvottomiksi estämättä normaaleja kirjoitusoperaatioita muualla. Tarkat polut toimivat hyvin vakaille sijainneille kuten ~/.ssh; kuviot sopivat tiedostoille, joiden sijainti vaihtelee. Järjestelmänvalvoja voi pakottaa nämä kiellot koko organisaation tasolla (permissions.filesystem.deny_read).
Dokumentaatio mainitsee kaksi rajoitusta. Linuxissa, WSL:ssä ja Windowsissa kuvioiden täsmäytys ratkaistaan jokaisen hiekkalaatikkoprosessin alussa: myöhemmin luotu täsmäävä tiedosto pysyy jo käynnissä olevan prosessin luettavissa. Lisäksi rajoittamaton **-kuvio vaatii glob_scan_max_depth-asetuksen. Turvallisin lähestymistapa on pitää salaisuudet kokonaan arkiston ulkopuolella.
Suhtaudu samaan varovaisuuteen myös AGENTS.md-tiedostoon, jonka Codex lukee jokaisella suorituskeralla. Älä koskaan sijoita siihen oikeita salaisuuksia: arvottomat arvot riittävät selittämään testikomentojesi odottaman muodon.
## Ympäristömuuttujat
Testikomennot käyttävät arvottomia muuttujia:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Jäljitys ja valvonta
Enterprise- ja Edu-suunnitelmissa tarkistuslokit ja käytön seuranta kulkevat Compliance API:n kautta. Se tukee turvallisuus-, laki- ja tutkintatarpeita, jotka vaativat varmennettavia tallenteita: tapahtumien vienti SIEM-järjestelmään tai data-altaaseen, omien säilytysaikojen ja oikeudellisten pidätysten soveltaminen sekä Codex-toiminnan korrelointi identiteettitietojesi kanssa. Admin API -dokumentaatio ohjaa katettuja tapahtumia, suodattimia ja säilytystä; testaa ingestointi ei-tuotantoympäristössä ennen jatkuvan keruun aikatauluttamista.
Tämä ei ole tuottavuusmittaristo: OpenAI neuvoo olemaan käyttämättä sitä koodin laadun tai yksilön suorituskyvyn arviointiin, vaan viittaa sen sijaan työtilan oivalluksiin ja Analytics API:hun käyttöönottomittareita varten. Jonkun on todella käytettävä näitä lokeja jälkikäteisten tapaustarkastelujen lisäksi: pidä ne agentin hallitseman ympäristön ulkopuolella ja hälytä toistuvista tunnistautumisvirheistä, epätavallisesta pääsystä ja konfiguraatiomuutoksista.
Vaatimustenmukaisuus ja sääntely
Jos koodisi käsittelee eurooppalaista henkilötietoa, neljä kohtaa kuuluvat sinun, eivät toimittajan, vastuullesi. Varmista, että OpenAI-sopimuksesi sisältää DPA:n (Data Processing Agreement); käytä tietojen säilytys- ja sijaintivalvontaa, kun suunnitelmasi sen tarjoaa (Enterprise ja Edu); dokumentoi Codexin käyttö käsittelytoimien rekisterissäsi; ja lopuksi, ilmoita tiimeille, että heidän koodiaan käsittelee kolmas osapuoli. Business-suunnitelmassa yrityksen dataa ei oletusarvoisesti käytetä koulutukseen.
SOC 2- tai ISO 27001 -tarkastusta varten luota OpenAI:n julkaisemiin dokumentteihin – mukaan lukien Codex Security Whitepaper sen luottamusportaalissa – ja varmista jokaisen vahvistuksen soveltamisala ja päivämäärä: vanhentunut vahvistus tai sellainen, joka ei kata käyttämääsi palvelua, ei paina mitään tarkastajan silmissä. Compliance API -viennit täyttävät jäljitettävyysvaatimukset, edellyttäen että niitä kerätään jatkuvasti ja tuotetaan pyydettäessä.
Turvallisuuden parhaat käytännöt
- - Kiellä arkaluonteisten tiedostojen lukeminen (`deny`-säännöt)
- - Kerää ja tarkista Compliance API -lokit
- - Rajoita yhdistetyt arkistot minimiin
- - Käytä SSO:ta ja MFA:ta
- - Tarkista Codexin PR:t ennen yhdistämistä
- - Yhdistä arkistoja, joissa on salaisuuksia koodissa
- - Laita oikeita tunnuksia AGENTS.md-tiedostoon
- - Yhdistä automaattisesti ilman tarkistusta
- - Ignoroi tarkistushälytyksiä
- - Jaa Codex-tiliä kehittäjien kesken
Tilin jakaminen, oikean sarakkeen viimeinen kohta, ansaitsee erityismaininnan: se mitätöi välittömästi koko tarkistuslokien arvon, sillä mitään toimintoa ei voi sitoa tunnistettavaan henkilöön.
Keskeiset asiat
- Hiekkalaatikko rajoittaa sitä, mihin Codex voi koskea (paikallisesti: ei verkkoa, kirjoitukset oletusarvoisesti rajoitettu työtilaan); hyväksymiskäytäntö määrittää, milloin se kysyy lupaa
- Säännöt ohjaavat komentoja hiekkalaatikon ulkopuolella (
prompttaiforbidden) .codexignore-tiedostoa ei ole: kiellä arkaluonteisten tiedostojen lukeminendeny-säännöillä oikeusprofiilissa- Tarkistuslokit kulkevat Compliance API:n kautta (Enterprise ja Edu)
- Varmista GDPR-vaatimustenmukaisuus, jos käsittelet eurooppalaista dataa
- Älä koskaan laita oikeita salaisuuksia AGENTS.md-tiedostoon