Sicurezza e audit degli accessi
In questa pagina
Lezione riscritta il 3 novembre 2026 sulla base delle pagine Agent approvals & security, Rules, Compliance API and audit events e del manuale Codex. La versione precedente descriveva un file
.codexignoreinesistente, affermava che Codex esegue solo i comandi elencati in AGENTS.md, citava un menu “Organization Settings → Audit Logs” e menzionava una certificazione SOC 2 Type II di Codex senza fonti. Fonti: Agent approvals & security · Rules · Compliance API · Pricing.
Controllare cosa Codex può vedere e fare
La sicurezza diventa critica nel momento in cui un agente AI accede al tuo codice sorgente. Codex include protezioni integrate, ma configurarle è tua responsabilità: il prodotto fornisce l’isolamento, mentre tu definisci il perimetro. Se colleghi un repository per comodità durante una corsa notturna o lasci un segreto in un file di configurazione dimenticato, l’isolamento tecnico non ti proteggerà.
Il modello di sicurezza di Codex
Due impostazioni complementari governano ciò che l’agente può fare: la sandbox, che definisce cosa può tecnicamente toccare, e la policy di approvazione, che determina quando deve fermarsi e chiedere il permesso, ad esempio quando esce dalla sandbox, usa la rete o esegue un comando al di fuori dell’insieme consentito.
- Localmente (CLI, estensione, app desktop), meccanismi a livello di sistema operativo applicano la sandbox. Per impostazione predefinita, non c’è accesso alla rete e le operazioni di scrittura sono limitate allo spazio di lavoro attivo. Con il preset comune
--sandbox workspace-write --ask-for-approval on-request, Codex legge, modifica ed esegue liberamente all’interno della directory di lavoro, ma chiede prima di scrivere altrove o usare la rete. La modalitàread-only(tramite il comando/permissions) ti permette di discutere e pianificare senza apportare modifiche. - Nel cloud, ogni attività di Codex Cloud viene eseguita nel proprio spazio di lavoro all’interno di un ambiente gestito da OpenAI; le credenziali e l’accesso alla rete sono configurati per ambiente, con i segreti di rete limitati ai servizi HTTPS autorizzati.
Contrariamente a quanto affermato dalla versione precedente di questa lezione, Codex non è limitato ai comandi elencati in AGENTS.md: può eseguire comandi, vincolato dalla coppia sandbox/approvazione. Per andare oltre, le regole governano i comandi consentiti fuori dalla sandbox: una regola di prefisso può richiedere una conferma o vietare completamente un comando.
# file .rules (sintassi Starlark)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "Tutte le richieste di rete in uscita devono essere confermate.",
)
Applicate dall’amministratore, queste regole possono solo richiedere una conferma o vietare azioni; non possono concedere autorizzazioni automatiche.
Nascondere ciò che non dovrebbe essere letto
Non esiste alcun file .codexignore. Per impedire a Codex di leggere file sensibili, anche se versionati, usa un profilo di permessi con regole deny su percorsi esatti o pattern:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Posizionata sotto :workspace_roots, la regola si applica a ogni radice dello spazio di lavoro: i file .env diventano illeggibili lì, senza bloccare le scritture normali altrove. I percorsi esatti funzionano bene per posizioni stabili come ~/.ssh; i pattern sono adatti a file con posizioni variabili. Un amministratore può applicare questi divieti a tutta l’organizzazione (permissions.filesystem.deny_read).
La documentazione nota due limitazioni. Su Linux, WSL e Windows, le corrispondenze dei pattern vengono risolte all’avvio di ogni processo sandbox: un file corrispondente creato successivamente rimane leggibile per un processo già in esecuzione. Inoltre, un pattern ** illimitato richiede glob_scan_max_depth. L’approccio più sicuro rimane tenere i segreti completamente fuori dal repository.
Applica la stessa cautela ad AGENTS.md, che Codex legge a ogni esecuzione. Non inserire mai segreti reali lì: valori fittizi bastano a spiegare il formato atteso dai tuoi comandi di test.
## Variabili d'ambiente
I comandi di test usano variabili fittizie:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Tracciamento e monitoraggio
Nei piani Enterprise ed Edu, i log di audit e il tracciamento dell’utilizzo passano attraverso le API di conformità (Compliance API). Supportano usi legati alla sicurezza, legali e investigativi che richiedono registri verificabili: esportazione di eventi in un SIEM o data lake, applicazione dei tuoi periodi di conservazione e blocchi legali, e correlazione dell’attività di Codex con i tuoi dati di identità. La documentazione delle API Admin governa gli eventi coperti, i filtri e la conservazione; testa l’ingestione su un sistema non di produzione prima di pianificare la raccolta continua.
Questa non è una dashboard di produttività: OpenAI sconsiglia di usarla per giudicare la qualità del codice o le prestazioni individuali, rimandando invece alle insight dello spazio di lavoro e alle API Analytics per le metriche di adozione. Qualcuno deve effettivamente usare questi log oltre le revisioni post-incidente: tienili fuori dall’ambiente controllato dall’agente e attiva avvisi per ripetuti fallimenti di autenticazione, accessi insoliti e modifiche alla configurazione.
Conformità e regolamentazione
Se il tuo codice gestisce dati personali europei, quattro punti ricadono sotto la tua responsabilità, non quella del fornitore. Assicurati che il tuo contratto con OpenAI includa un DPA (Accordo sul trattamento dei dati); usa i controlli di conservazione e residenza dei dati quando il tuo piano li offre (Enterprise ed Edu); documenta l’uso di Codex nel tuo registro delle attività di trattamento; e infine, informa i team che il loro codice è elaborato da un servizio di terze parti. Nel piano Business, i dati aziendali non vengono utilizzati per l’addestramento per impostazione predefinita.
Per un audit SOC 2 o ISO 27001, affidati ai documenti pubblicati da OpenAI, incluso il Codex Security Whitepaper sul suo portale di fiducia, e verifica l’ambito e la data di ogni attestazione: un’attestazione scaduta, o che non copre il servizio che usi, non ha alcun peso per un auditor. Le esportazioni delle API di conformità soddisfano i requisiti di tracciabilità, a condizione che siano raccolte continuamente e prodotte su richiesta.
Migliori pratiche di sicurezza
- - Vietare la lettura di file sensibili (regole `deny`)
- - Raccogliere e auditare i log delle API di conformità
- - Limitare i repository collegati al minimo indispensabile
- - Usare SSO con MFA
- - Revisionare le PR di Codex prima del merge
- - Collegare repository con segreti nel codice
- - Inserire token reali in AGENTS.md
- - Eseguire auto-merge senza revisione
- - Ignorare gli avvisi di audit
- - Condividere un account Codex tra sviluppatori
La condivisione dell’account, l’ultimo elemento nella colonna di destra, merita una menzione speciale: annulla istantaneamente l’intero valore dei log di audit, poiché nessuna azione può essere legata a una persona identificabile.
Punti chiave
- La sandbox delimita ciò che Codex può toccare (localmente: nessuna rete, scritture limitate allo spazio di lavoro per impostazione predefinita); la policy di approvazione stabilisce quando chiedere
- Le regole governano i comandi fuori dalla sandbox (
promptoforbidden) .codexignorenon esiste: vieta la lettura di file sensibili tramite regoledenyin un profilo di permessi- I log di audit passano attraverso le API di conformità (Enterprise ed Edu)
- Verifica la conformità al GDPR se gestisci dati europei
- Non inserire mai segreti reali in AGENTS.md