Een agent beveiligen: veiligheid, machtigingen en vertrouwde mappen
Op deze pagina
Les herschreven op 2 november 2026. De vorige versie beschreef het veld
safetyals een machtigingsniveau. De documentatie van Vibe is expliciet: het is een visuele indicator die de randkleur van het invoerveld bepaalt; het forceert niets. Echte bescherming komt voort uit tool-lijsten, machtigingen per tool en vertrouwde mappen. Bronnen: Safety, approvals, and permissions · Configuration reference.
Wat safety wel (en niet) doet
Het veld safety in een agent-bestand accepteert vijf waarden: safe, neutral (de standaardwaarde), destructive, smart en yolo. Het verandert de randkleur van het invoergebied om u direct te laten zien welke agent u gebruikt. Het verwijdert geen tools en activeert geen goedkeuringsprompt. Een agent gemarkeerd als safe, maar uitgerust met onbeperkte bash, kan nog steeds destructieve opdrachten uitvoeren.
Er is één uitzondering: wanneer een beheerder automatische goedkeuring uitschakelt (enable_auto_approve = false), verbergt Vibe alle agents gemarkeerd als yolo. Voor het overige is safety een label, geen slot. Combineer het altijd met de onderstaande echte besturingselementen.
Eerste hefboom: beschikbare tools
enabled_tools (allowlist) en disabled_tools (denylist, daarna toegepast) bepalen wat de agent kan aanroepen. Ze accepteren exacte namen, glob-patronen en reguliere expressies voorafgegaan door re:.
# Alleen-lezen audit-agent
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Als een tool niet op de lijst staat, bestaat deze niet voor die agent. Dit is uw sterkste garantie.
Tweede hefboom: machtigingen per tool
Voor beschikbare tools stelt een blok [tools.<tool>] de regel in: "always" (geen prompt), "ask" (elke keer vragen) of "never" (blokkeren).
display_name = "Refactoring"
safety = "neutral"
enabled_tools = ["read_file", "grep", "edit", "write_file", "bash"]
[tools.edit]
permission = "always"
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pnpm test"]
denylist = ["rm -rf", "git push"]
Voor bash specificeren allowlist en denylist opdrachtprefixen die altijd zijn toegestaan of altijd worden geweigerd. Vibe staat standaard een paar alleen-lezen opdrachten toe (ls, pwd, cat, git status, enz.), maar elke lijst die u schrijft, vervangt de standaardlijst: neem alle standaardopdrachten op die u wilt behouden. Voor read_file, write_file en edit accepteren deze lijsten absolute padpatronen. Een verstandige regel: een script dat via bash wordt uitgevoerd, kan paden construeren die Vibe niet ziet in de opdracht zelf; houd bash ingesteld op "ask" wanneer de stakes dit rechtvaardigen.
Derde hefboom: bereik van de werkmap
Standaard vraagt Vibe om toestemming voordat een bestands- of shell-tool toegang krijgt tot een pad buiten de werkmap, zelfs via een symbolische link, en voordat .env- en .envrc-bestanden worden gelezen of gewijzigd. U kunt dit gedrag verharden:
outside_workdir = "deny" # weigeren in plaats van vragen; de agent ontvangt een foutmelding en gaat door
Vierde hefboom: vertrouwde mappen
Een repository kan zijn eigen Vibe-configuratie (agents, vaardigheden, MCP-servers, machtigingen) bundelen in een .vibe/-map, of instructies in een AGENTS.md-bestand. Omdat deze configuratie het gedrag van Vibe verandert, wordt deze alleen geladen vanuit een map die u expliciet heeft goedgekeurd. Bij de eerste start toont Vibe gedetecteerde bestanden en biedt de opties Map vertrouwen, Hele repo vertrouwen of Niet vertrouwen; uw keuzes worden opgeslagen in ~/.vibe/trusted_folders.toml. Het dialoogvenster analyseert deze bestanden niet: bekijk ze zoals elke andere code in de repo, vooral definities van MCP-servers en machtigingen. In programmatische modus vraagt Vibe nooit: vibe --trust verleent tijdelijk vertrouwen voor een enkele uitvoering.
Reageren op een goedkeuringsprompt
Wanneer Vibe om toestemming vraagt, zijn vier toetsenbordreacties mogelijk: 1 of y staat eenmalig toe, 2 voor de rest van de sessie, 3 altijd, en 4, n of Escape weigert. De randkleur herinnert u eraan welke agent actief is.
De juiste balans kiezen
| Behoefte | Instelling |
|---|---|
| Analyseren zonder iets aan te raken | enabled_tools = ["read_file", "grep"] |
| Met vertrouwen refactoren | edit ingesteld op "always", bash ingesteld op "ask" met een allowlist van testopdrachten |
| Een project opschonen | bash ingesteld op "ask" en een denylist van onomkeerbare opdrachten |
| Onbeheerde taak in CI | Ephemere container, vibe --prompt … --auto-approve, limieten --max-turns en --time-limit |
De gouden regel blijft minste privilege: geef elke agent het minimum dat nodig is, begin restrictief en breid alleen uit waar nodig.
Belangrijkste punten
safety(safe,neutral,destructive,smart,yolo) kleurt de rand; het handhaaft geen machtigingen- Echte sloten:
enabled_tools/disabled_tools, vervolgens[tools.<tool>](always,ask,never) - Voor
bashvervangenallowlistendenylistde standaardlijsten - Vibe vraagt om toestemming voordat het de werkmap verlaat of
.env-bestanden aanraakt - Projectconfiguratie wordt alleen geladen in een vertrouwde map; bekijk deze voordat u goedkeurt