Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Beveiliging en toegangscontrole

Les 17 van 20 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Beperken wat Codex mag zien en doen
  2. Het Codex-beveiligingsmodel
  3. Verbergen wat niet gelezen mag worden
  4. Traceren en monitoren
  5. Naleving en regelgeving
  6. Best practices voor beveiliging
  7. Belangrijkste punten

Les herschreven op 3 november 2026 op basis van de pagina’s Agent approvals & security, Rules, Compliance API and audit events en de Codex-handleiding. De vorige versie beschreef een niet-bestaand .codexignore-bestand, beweerde dat Codex alleen opdrachten uit AGENTS.md uitvoert, verwees naar een menu “Organization Settings → Audit Logs” en noemde een Codex SOC 2 Type II-certificering zonder bronvermelding. Bronnen: Agent approvals & security · Rules · Compliance API · Pricing.

Beperken wat Codex mag zien en doen

Beveiliging wordt cruciaal zodra een AI-agent toegang krijgt tot uw broncode. Codex bevat ingebouwde beveiligingsmechanismen, maar het configureren ervan is uw verantwoordelijkheid: het product biedt isolatie, terwijl u de perimeter definieert. Als u een repository koppelt voor gemak tijdens een nachtelijke spoedklus of een geheim vergeet in een vergeten configuratiebestand, biedt technische isolatie geen bescherming.

Het Codex-beveiligingsmodel

Twee complementaire instellingen bepalen wat de agent mag doen: de sandbox, die definieert wat hij technisch mag aanraken, en het goedkeuringsbeleid, dat bepaalt wanneer hij moet stoppen en om toestemming moet vragen—bijvoorbeeld bij het verlaten van de sandbox, het gebruik van het netwerk of het uitvoeren van een opdracht buiten de toegestane set.

  • Lokaal (CLI, extensie, desktop-app) worden sandbox-beperkingen afgedwongen via mechanismen op besturingssysteemniveau. Standaard is er geen netwerktoegang en zijn schrijfbewerkingen beperkt tot de actieve werkruimte. Met de veelgebruikte preset --sandbox workspace-write --ask-for-approval on-request leest, wijzigt en voert Codex vrijuit binnen de werkmap, maar vraagt hij om toestemming voordat hij elders schrijft of het netwerk gebruikt. De modus read-only (via de opdracht /permissions) stelt u in staat om te discussiëren en te plannen zonder wijzigingen aan te brengen.
  • In de cloud draait elke Codex Cloud-taak in zijn eigen werkruimte binnen een door OpenAI beheerde omgeving; referenties en netwerktoegang worden per omgeving geconfigureerd, waarbij netwerkgeheimen beperkt blijven tot geautoriseerde HTTPS-services.

In tegenstelling tot wat de vorige versie van deze les beweerde, is Codex niet beperkt tot opdrachten die in AGENTS.md staan vermeld: het kan opdrachten uitvoeren, gebonden door het paar sandbox/goedkeuring. Om verder te gaan, regelen regels welke opdrachten buiten de sandbox zijn toegestaan: een prefix-regel kan bevestiging vereisen of een opdracht volledig verbieden.

# .rules bestand (Starlark-syntax)
prefix_rule(
    pattern = ["curl"],
    decision = "prompt",
    justification = "Alle uitgaande netwerkaanvragen moeten worden bevestigd.",
)

Deze regels worden afgedwongen door de beheerder en kunnen alleen bevestiging vereisen of acties verbieden; ze kunnen geen automatische autorisatie verlenen.

Verbergen wat niet gelezen mag worden

Er bestaat geen .codexignore-bestand. Om te voorkomen dat Codex gevoelige bestanden leest, zelfs als ze onder versiebeheer vallen, gebruikt u een machtigingsprofiel met deny-regels voor exacte paden of patronen:

# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3

[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"

Geplaatst onder :workspace_roots, geldt de regel voor elke werkruimte-root: .env-bestanden worden daar onleesbaar, zonder normale schrijfbewerkingen elders te blokkeren. Exacte paden werken goed voor stabiele locaties zoals ~/.ssh; patronen zijn geschikt voor bestanden met variabele locaties. Een beheerder kan deze weigeringen afdwingen voor de hele organisatie (permissions.filesystem.deny_read).

De documentatie noemt twee beperkingen. Op Linux, WSL en Windows worden patroonovereenkomsten opgelost bij de start van elk sandbox-proces: een overeenkomend bestand dat daarna wordt gemaakt, blijft leesbaar voor een reeds lopend proces. Bovendien vereist een onbegrensd **-patroon een glob_scan_max_depth. De veiligste aanpak blijft om geheimen volledig uit de repository te houden.

Pas dezelfde voorzichtigheid toe op AGENTS.md, dat Codex bij elke uitvoering leest. Plaats nooit echte geheimen hierin: dummy-waarden volstaan om het formaat uit te leggen dat uw testopdrachten verwachten.

## Omgevingsvariabelen
Testopdrachten gebruiken dummy-variabelen:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only

Traceren en monitoren

Bij Enterprise- en Edu-abonnementen lopen auditlogs en gebruikstracking via de Compliance API. Deze ondersteunt beveiligings-, juridische en onderzoeksdoeleinden die verifieerbare records vereisen: het exporteren van gebeurtenissen naar een SIEM of data lake, het toepassen van uw bewaartermijnen en juridische bevriezingen, en het correleren van Codex-activiteit met uw identiteitsgegevens. De Admin API-documentatie bepaalt welke gebeurtenissen worden gedekt, welke filters beschikbaar zijn en hoe lang gegevens worden bewaard; test de ingestie op een niet-productiesysteem voordat u continue verzameling inplant.

Dit is geen productiviteitsdashboard: OpenAI raadt af om het te gebruiken voor het beoordelen van codekwaliteit of individuele prestaties, en verwijst in plaats daarvan naar workspace-inzichten en de Analytics API voor adoptiemaatstaven. Iemand moet deze logs daadwerkelijk gebruiken beyond post-incident reviews: bewaar ze buiten de door de agent gecontroleerde omgeving en stel alerts in voor herhaalde authenticatiefouten, ongebruikelijke toegang en configuratiewijzigingen.

Naleving en regelgeving

Als uw code Europese persoonsgegevens verwerkt, vallen vier punten onder uw verantwoordelijkheid, niet die van de leverancier. Zorg ervoor dat uw OpenAI-contract een DPA (Data Processing Agreement) bevat; gebruik controles voor gegevensbewaring en -locatie wanneer uw abonnement deze biedt (Enterprise en Edu); documenteer het gebruik van Codex in uw register van verwerkingsactiviteiten; en informeer ten slotte teams dat hun code door een derde dienst wordt verwerkt. In het Business-abonnement worden bedrijfsgegevens standaard niet gebruikt voor training.

Voor een SOC 2- of ISO 27001-audit vertrouwt u op documenten die door OpenAI zijn gepubliceerd—including het Codex Security Whitepaper op zijn trust-portaal—en verifieert u de reikwijdte en datum van elke attestatie: een verlopen attestatie, of een attestatie die de door u gebruikte service niet dekt, heeft geen waarde voor een auditor. Exports via de Compliance API voldoen aan traceerbaarheidseisen, mits ze continu worden verzameld en op verzoek kunnen worden geproduceerd.

Best practices voor beveiliging

Doen
  • - Het lezen van gevoelige bestanden verbieden (`deny`-regels)
  • - Compliance API-logs verzamelen en auditen
  • - Het aantal gekoppelde repositories tot het minimum beperken
  • - SSO met MFA gebruiken
  • - Codex PR's beoordelen voordat ze worden samengevoegd
Niet doen
  • - Repositories koppelen met geheimen in de code
  • - Echte tokens in AGENTS.md plaatsen
  • - Automatisch samenvoegen zonder beoordeling
  • - Audit-alerts negeren
  • - Een Codex-account delen onder ontwikkelaars

Het delen van accounts, het laatste item in de rechterkolom, verdient speciale vermelding: het maakt direct de volledige waarde van auditlogs teniet, aangezien geen enkele actie aan een identificeerbaar persoon kan worden gekoppeld.

Belangrijkste punten

  • De sandbox begrenst wat Codex mag aanraken (lokaal: geen netwerk, schrijfbewerkingen standaard beperkt tot de werkruimte); het goedkeuringsbeleid bepaalt wanneer het om toestemming vraagt
  • Regels bepalen opdrachten buiten de sandbox (prompt of forbidden)
  • .codexignore bestaat niet: verbied het lezen van gevoelige bestanden via deny-regels in een machtigingsprofiel
  • Auditlogs lopen via de Compliance API (Enterprise en Edu)
  • Verifieer AVG-naleving bij het verwerken van Europese gegevens
  • Plaats nooit echte geheimen in AGENTS.md