Agentin suojaaminen: turvallisuus, käyttöoikeudet ja luotetut kansiot
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Edellinen versio kuvasi
safety-kentän käyttöoikeustasoksi. Viben dokumentaatio on kuitenkin yksiselitteinen: se on vain visuaalinen indikaattori, joka värittää syöttökentän reunan; se ei pakota mitään. Todellinen suojaus perustuu työkalulistaan, työkalukohtaisiin käyttöoikeuksiin ja luotettuihin kansioihin. Lähteet: Safety, approvals, and permissions · Configuration reference.
Mitä safety tekee (ja mitä se ei tee)
Agenttitiedoston safety-kenttä hyväksyy viisi arvoa: safe, neutral (oletus), destructive, smart ja yolo. Se muuttaa syöttöalueen reunaviivan väriä antaakseen sinulle nopean muistutuksen siitä, mitä agenttia käytät. Se ei poista työkaluja käytöstä eikä käynnistä hyväksyntäkehotteita. Agentti, joka on merkitty arvolla safe, mutta jolla on rajoittamaton bash-työkalu, voi silti suorittaa tuhoisia komentoja.
On yksi poikkeus: kun järjestelmänvalvoja ottaa automaattisen hyväksynnän pois käytöstä (enable_auto_approve = false), Vibe piilottaa kaikki agentit, jotka on merkitty arvolla yolo. Muulloin safety on vain etiketti, ei lukko. Yhdistä se aina alla oleviin todellisiin hallintakeinoihin.
Ensimmäinen vipu: käytettävissä olevat työkalut
enabled_tools (sallittujen lista) ja disabled_tools (kiellettyjen lista, jota sovelletaan jälkikäteen) päättävät, mitä agentti voi kutsua. Ne hyväksyvät tarkkoja nimiä, glob-malleja ja säännöllisiä lausekkeita, jotka on merkitty etuliitteellä re:.
# Vain luku -tilassa toimiva tarkistusagentti
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Jos työkalua ei ole listalla, sitä ei ole olemassa kyseiselle agentille. Tämä on vahvin takuusi.
Toinen vipu: työkalukohtaiset käyttöoikeudet
Käytettävissä oleville työkaluille [tools.<tool>]-lohko määrittää säännön: "always" (ei kehotetta), "ask" (kehote joka kerta) tai "never" (esto).
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"]
bash-työkalun kohdalla allowlist ja denylist määrittävät komentoetuliitteet, jotka ovat aina sallittuja tai aina kiellettyjä. Vibe sallii oletuksena muutaman vain luku -komennon (ls, pwd, cat, git status jne.), mutta kirjoittamasi lista korvaa oletuslistan: sisällytä listaan kaikki oletuskomennot, jotka haluat pitää voimassa. read_file, write_file ja edit -työkalujen kohdalla nämä listat hyväksyvät absoluuttisia polkumalleja. Yksi varovainen sääntö: bash-komennon kautta suoritettava skripti voi muodostaa polkuja, joita Vibe ei näe itse komennossa; pidä bash asetuksella "ask" aina, kun panokset sitä vaativat.
Kolmas vipu: työhakemiston laajuus
Oletuksena Vibe kehottaa sinua ennen kuin tiedosto- tai kuori-työkalu käyttää polkua työhakemiston ulkopuolella, jopa symbolisen linkin kautta, ja ennen .env- ja .envrc-tiedostojen lukemista tai muokkaamista. Voit tiukentaa tätä toimintaa:
outside_workdir = "deny" # kiellä kehotteen sijaan; agentti saa virheen ja jatkaa
Neljäs vipu: luotetut kansiot
Repositorio voi bundlata oman Vibe-konfiguraationsa (agentit, taidot, MCP-palvelimet, käyttöoikeudet) .vibe/-kansioon tai ohjeet AGENTS.md-tiedostoon. Koska tämä konfiguraatio muuttaa Viben toimintaa, se latautuu vain kansiosta, jonka olet nimenomaisesti hyväksynyt. Ensimmäisen käynnistyksen yhteydessä Vibe listaa havaitut tiedostot ja tarjoaa vaihtoehdot Trust folder, Trust full repo tai Don’t trust; valintasi tallennetaan tiedostoon ~/.vibe/trusted_folders.toml. Valintaikkuna ei analysoi näitä tiedostoja: tarkista ne kuten mikä tahansa muu repositorion koodi, erityisesti MCP-palvelinten määritelmät ja käyttöoikeudet. Ohjelmallisessa tilassa Vibe ei koskaan kehottele: vibe --trust myöntää väliaikaisen luottamuksen yhtä suoritus kertaa varten.
Vastaaminen hyväksyntäkehotteeseen
Kun Vibe esittää kehotteen, käytettävissä on neljä näppäinvastetta: 1 tai y sallii kerran, 2 loppuistunnoksi, 3 aina, ja 4, n tai Escape kieltää. Reunaviivan väri muistuttaa sinua siitä, mikä agentti on aktiivinen.
Oikean tasapainon löytäminen
| Tarve | Asetus |
|---|---|
| Analysoi koskematta mihinkään | enabled_tools = ["read_file", "grep"] |
| Refaktoroi luottavaisin mielin | edit asetettu arvoon "always", bash asetettu arvoon "ask" ja allowlist testikomennoille |
| Siivoa projekti | bash asetettu arvoon "ask" ja denylist peruuttamattomille komennoille |
| Valvomaton tehtävä CI-ympäristössä | Efeemerä kontti, vibe --prompt … --auto-approve, rajat --max-turns ja --time-limit |
Kultainen sääntö on edelleen vähäisin oikeuksin: anna jokaiselle agentille vain tarvittava minimi, aloita rajoittavasti ja avaa oikeuksia vain tarpeen vaatiessa.
Keskeiset asiat
safety(safe,neutral,destructive,smart,yolo) värittää reunan; se ei pakota käyttöoikeuksia- Todelliset lukot:
enabled_tools/disabled_tools, sitten[tools.<tool>](always,ask,never) bash-työkalulleallowlistjadenylistkorvaavat oletuslistat- Vibe kehottaa ennen työhakemistosta poistumista tai
.env-tiedostojen käsittelyä - Projektikonfiguraatio latautuu vain luotetussa kansiossa; tarkista se ennen hyväksymistä