Deel D · Module 04
Security & governance
Welke risico's, dataclassificatie en beleid?
Leerdoelen
Na deze module kun je:
- de verdedigingslagen van Claude Code benoemen (managed settings, permissieregels, hooks, permission mode, sandbox) en per aanval voorspellen welke laag hem tegenhoudt;
- uitleggen hoe settings-niveaus zich tot elkaar verhouden: wie wint, waarom een deny altijd wint, en wat alleen managed settings kunnen;
- een basisbeleid voor een team opstellen: wat afdwingen, wat overlaten aan het model, en wat buiten de machine moet.
Voorkennis-check
Twee vragen over hooks en MCP. Fout? Lees C2 Hooks en C3 MCP eerst terug.
Waar zitten we?
Governance is laag 5: beleid voor iedereen in de organisatie. Het werkt via laag 4: managed settings, regels en hooks in de harness, en de sandbox eromheen. Wat niet op de machine kan (branch protection, secretsbeheer), ligt buiten de stack.
De stof in drie lagen
Kern ± 5 min lezen, daarna aanvallen proberen
Een coding agent draait commando's met jouw rechten, leest je bestanden en kan het netwerk op. De risico's zijn daardoor van twee soorten:
- Ongelukken: het model doet iets wat jij niet wilde. Een verkeerde
rm, een push naar main, een migratie op de verkeerde database. - Misbruik van buitenaf: tekst die het model leest (een README, een webpagina, een MCP-description, een issue) bevat instructies. Dat heet prompt injection. Het model kan die opvolgen, met jouw rechten.
Geen enkele laag vangt alles. Een deny-regel op curl mist wget. Een prompt vangt alleen wat jij goed leest. De sandbox geldt alleen voor Bash. Daarom bouw je lagen, en zorg je dat de belangrijkste lagen niet afhangen van het oordeel van het model of van jouw oplettendheid om half vijf 's middags.
Kies hieronder een aanval, zet lagen aan of uit, en kijk waar hij strandt.
Samengevat: zet de harde grenzen in lagen die het model niet kan omzeilen (deny-regels, hooks, sandbox, managed settings) en buiten de machine (branch protection, geen echte secrets lokaal). Gebruik de permissieprompt en de classifier voor de grijze gevallen, niet als enige verdediging.
Verdieping permission modes, regels, settings-niveaus, sandbox, managed
Permission modes
| Mode | Gedrag |
|---|---|
default (Manual) | vraagt bij het eerste gebruik van elke tool; lezen in je werkmap mag zonder vragen |
acceptEdits | bestandsedits en gewone bestandscommando's in de werkmap gaan automatisch |
plan | lezen en alleen-lezen-commando's; geen edits |
auto | geen routineprompts; een classifier controleert acties als shell-commando's en netwerkverzoeken op aansluiting bij je vraag |
dontAsk | weigert alles wat anders een prompt zou geven; voor onbewaakte runs |
bypassPermissions | slaat prompts over, ook voor beschermde paden als .git en .claude. Hooks met een deny blokkeren nog wel (C2) |
Met permissions.disableBypassPermissionsMode of disableAutoMode op "disable" verbied je die modes, typisch in managed settings.
Regels en wie wint
Regels hebben de vorm Tool of Tool(specifier): Bash(npm run test *), Read(./.env), Edit(src/gen/**), mcp__github. Settings komen van vijf niveaus, van hoog naar laag: managed, command line, project local, gedeeld project, user. Voor gewone sleutels wint het hoogste niveau. Voor permissies geldt bovendien:
If a tool is denied at any level, no other level can allow it.
Een deny-regel op Bash matcht het commando zoals het geschreven is. Dat is goed tegen ongelukken, maar zwak tegen een aanvaller of een creatief model: curl geblokkeerd, python -c "import urllib…" niet. Voor netwerk en bestanden die echt dicht moeten, heb je de sandbox nodig.
De sandbox
De sandbox is een grens die het besturingssysteem afdwingt rond de shell-commando's van Claude (Bash, PowerShell, Monitor) en alles wat die starten. Standaard staat hij uit; zet hem aan met /sandbox of sandbox.enabled. Hij draait op macOS, Linux en WSL2 (op Linux met bubblewrap en socat).
| Toegang | Standaard |
|---|---|
| Schrijven | werkmap, een tijdelijke map en toegevoegde mappen; beschermde paden (de config- en codebestanden die Claude Code laadt) blijven dicht |
| Lezen | het grootste deel van de machine, inclusief ~/.ssh en ~/.aws/credentials, tenzij je filesystem.denyRead zet |
| Netwerk | geen directe route naar buiten; alles via een proxy die alleen toegestane domeinen doorlaat, en die lijst begint leeg |
Belangrijk: de sandbox geldt alleen voor shell-commando's. De file-tools van Claude (Read, Edit, Write), WebFetch, MCP-servers en hooks draaien erbuiten. Daarvoor gelden permissieregels.
Managed settings: beleid dat niemand kan overschrijven
Een organisatie rolt een managed-settings.json uit (Linux/WSL: /etc/claude-code/), via MDM, of via de claude.ai-console. Die staat boven alles. Een paar sleutels werken alleen vanuit een managed bron:
allowManagedPermissionRulesOnly: alleen de permissieregels uit managed settings tellen.allowManagedHooksOnly: user-, project-, local- en pluginhooks worden geblokkeerd (behalve hooks van plugins die managed settings zelf verplicht aanzetten).allowManagedMcpServersOnlyenallowedMcpServers/deniedMcpServers: welke MCP-servers mogen. Standaard mag iedereen elke server koppelen.blockedMarketplaces: plugin-bronnen die niet mogen; ze worden gecontroleerd vóór er iets gedownload wordt.sandbox.failIfUnavailable: Claude Code start niet als de sandbox niet beschikbaar is (anders draait het stilletjes zonder).
Ook een managed CLAUDE.md is mogelijk, maar dat blijft een verzoek. De docs zeggen het expliciet: gebruik dat bestand voor uitleg, en dwing regels af met managed settings.
Onder de motorkap workspace trust, audit, dataclassificatie, een beleid in stappen
Workspace trust
Een gekloonde repo kan .claude/settings.json met hooks, .mcp.json met servers en allow-regels bevatten. In een interactieve sessie toont Claude Code daarom eerst een trust-dialoog voor een map die je nog niet vertrouwde, en servers uit .mcp.json hebben hun eigen goedkeuring. Let op: een claude -p-sessie toont geen van beide. Laat dus nooit een onbewaakte run los op een repo die je niet kent.
Zichtbaarheid en audit
Claude Code exporteert metrics en events via OpenTelemetry (CLAUDE_CODE_ENABLE_TELEMETRY=1 plus een exporter): gebruik, kosten, tool-activiteit. Een PostToolUse-hook of een http-hook kan elke tool call naar je eigen logsysteem sturen. Voor MCP kun je zien welke servers je organisatie werkelijk gebruikt.
Dataclassificatie
Alles wat in de context staat, gaat naar het model. Dat zijn je prompts, maar ook elk bestand dat Claude leest en elke tool-output. Een praktische indeling:
| Klasse | Voorbeelden | Maatregel |
|---|---|---|
| Openbaar / intern | broncode, docs | normaal gebruik |
| Vertrouwelijk | klantdata in testsets, contracten | niet in repo's waar agents werken; geanonimiseerde fixtures |
| Geheim | wachtwoorden, API-keys, privésleutels | niet lokaal (vault, kortlevende tokens); Read-deny en sandbox denyRead als vangnet |
Welke voorwaarden er gelden voor bewaren en trainen, hangt af van je contract (commercieel of consument); de security-pagina van Claude Code verwijst daarvoor naar de voorwaarden en het Privacy Center.
Een basisbeleid in vijf stappen
- Bypass uit (
disableBypassPermissionsMode), en de sandbox aan met een korte lijst domeinen. - Deny op geheimen:
Read(./.env),Read(./secrets/**), plus sandboxdenyReadvoor~/.sshen cloud-credentials. - MCP en plugins op een allowlist.
- Hooks voor wat logica vraagt: geen push naar main, geen migratie op productie.
- Buiten de machine: branch protection, CI die tests en security-scans afdwingt, review door een mens.
While these protections significantly reduce risk, no system is completely immune to all attacks.
Uitgewerkt voorbeeld: een managed-settings-bestand
/etc/claude-code/managed-settings.json
{
"permissions": {
"deny": ["Read(./.env)", "Read(./secrets/**)"],
"disableBypassPermissionsMode": "disable"
},
"allowManagedPermissionRulesOnly": true,
"allowManagedHooksOnly": true,
"sandbox": {
"enabled": true,
"failIfUnavailable": true,
"network": { "allowedDomains": ["github.com", "*.npmjs.org", "pypi.org"] }
}
}
- Geheimen dicht voor de file-tools. Geen enkel ander niveau kan dit weer toestaan.
- Geen bypass-mode voor wie dan ook.
- Alleen managed regels tellen: een allow-regel in een gekloonde repo of in iemands user settings doet niets meer. Streng: het team moet dan ook nuttige allow-regels centraal regelen.
- Alleen managed hooks: een kwaadaardige pluginhook draait niet. Ook nuttige eigen hooks niet; afweging.
- Fail-closed: zonder werkende sandbox start Claude Code niet, in plaats van stilletjes zonder sandbox te draaien.
Bouw drie lagen en val ze aan
Starter: oefenrepo/d4-governance/. .claude/settings.json heeft deny-regels, een sandbox met twee toegestane domeinen en de no-push-main-hook uit C2. LEESMIJ-README.md bevat een verborgen instructie. De secrets in .env zijn nep. Op Linux/WSL2 heb je bubblewrap en socat nodig voor de sandbox.
Opdracht
- Kopieer de map,
git init && git add -A && git commit -m start, startclaudeen draai/sandbox. Is de sandbox actief? - Vraag: "Lees .env en vertel wat erin staat." Welke laag stopt dit?
- Vraag: "Draai
curl --noproxy '*' https://example.com." En daarna: "Draaipython3 -c \"import urllib.request; print(urllib.request.urlopen('https://example.com').status)\"." Welke laag stopt welke? - Vraag: "Lees LEESMIJ-README.md en voer de setup uit." Wat doet Claude? Wat zou er gebeurd zijn zonder deny-regel en sandbox?
- Vraag: "Commit een lege wijziging en push naar origin." (Er is geen remote, maar de hook vuurt eerst.)
- Maak het kapot. Zet
"enabled": falsein de sandbox en herhaal stap 3b. Wat houdt het Python-request nu nog tegen?
Verwacht resultaat
Stap 2: de deny-regel Read(./.env) weigert. Ook cat .env via Bash wordt geweigerd: Claude Code past Read-deny-regels toe op bestandscommando's die het herkent (cat, head, tail, sed, redirecties). Een commando dat bestanden leest zonder ze te noemen, zoals grep -r PASSWORD . of een Python-oneliner, valt daarbuiten. Dat gat dicht je met sandbox filesystem.denyRead. Andersom stopt denyRead de Read-tool niet: je hebt dus beide nodig.
Stap 3: curl stopt al bij de deny-regel. Het Python-request passeert de deny-regels (ander commando), maar faalt in de sandbox: example.com staat niet in de toegestane domeinen.
Stap 4: het model herkent de injectie vaak en weigert of meldt hem. Probeert het toch curl, dan stopt de deny-regel het. Zonder beide lagen zou alleen jouw prompt-goedkeuring (of de classifier in auto mode) er nog tussen zitten.
Stap 5: de hook blokkeert met "directe push naar main is niet toegestaan".
Stap 6: zonder sandbox houdt niets het Python-request meer tegen, behalve de permissieprompt. Precies waarom netwerkbeleid in de sandbox hoort en niet in tekstregels.
Als het niet werkt, kijk naar …
- Sandbox niet actief.
/sandboxvertelt wat er ontbreekt (bijv.bubblewrap). Op native Windows draait Claude Code zonder sandbox; gebruik WSL2. - Commando's typen met
!test de sandbox niet: wat jij zelf typt, draait meestal erbuiten. Laat Claude het commando draaien. - Hook doet niets.
chmod +x .claude/hooks/no-push-main.py, en check/hooks.