Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Agentin suojaaminen: turvallisuus, käyttöoikeudet ja luotetut kansiot

Oppitunti 3 / 14 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Mitä safety tekee (ja mitä se ei tee)
  2. Ensimmäinen vipu: käytettävissä olevat työkalut
  3. Toinen vipu: työkalukohtaiset käyttöoikeudet
  4. Kolmas vipu: työhakemiston laajuus
  5. Neljäs vipu: luotetut kansiot
  6. Vastaaminen hyväksyntäkehotteeseen
  7. Oikean tasapainon löytäminen
  8. Keskeiset asiat

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

TarveAsetus
Analysoi koskematta mihinkäänenabled_tools = ["read_file", "grep"]
Refaktoroi luottavaisin mielinedit asetettu arvoon "always", bash asetettu arvoon "ask" ja allowlist testikomennoille
Siivoa projektibash 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ökalulle allowlist ja denylist korvaavat oletuslistat
  • Vibe kehottaa ennen työhakemistosta poistumista tai .env-tiedostojen käsittelyä
  • Projektikonfiguraatio latautuu vain luotetussa kansiossa; tarkista se ennen hyväksymistä