Egy ügynök biztosítása: biztonság, engedélyek és megbízható mappák
Ezen az oldalon
A leckét 2026. november 2-án írtuk át. Az előző verzió a
safetymezőt engedélyszintként írta le. A Vibe dokumentációja egyértelmű: ez csupán egy vizuális jelző, amely színezi a beviteli mező keretét; semmit sem kényszerít ki. A valódi védelmet az eszközlísták, az egyes eszközökre vonatkozó engedélyek és a megbízható mappák biztosítják. Források: Safety, approvals, and permissions · Configuration reference.
Mit csinál (és mit nem) a safety
Az ügynökfájlban található safety mező öt értéket fogad el: safe, neutral (az alapértelmezett), destructive, smart és yolo. Ezek megváltoztatják a beviteli terület keretének színét, hogy azonnal lásd, éppen melyik ügynököt használod. Nem távolít el eszközöket, és nem indít jóváhagyási kéréseket. Egy safe jelölésű ügynök, amelyhez korlátlan bash eszköz társul, továbbra is képes romboló parancsok futtatására.
Egy kivétel létezik: ha egy rendszergazda letiltja az automatikus jóváhagyást (enable_auto_approve = false), a Vibe elrejti az összes yolo jelölésű ügynököt. Egyéb esetekben a safety csupán egy címke, nem pedig egy zár. Mindig párosítsd a lentebb részletezett valódi vezérlőkkel.
Első eszköz: elérhető eszközök
Az enabled_tools (engedélyezési lista) és a disabled_tools (tiltólista, amely utólag alkalmazódik) dönti el, hogy az ügynök mit hívhat meg. Ezek pontos neveket, glob mintákat és re: előtaggal ellátott reguláris kifejezéseket fogadnak el.
# Csak olvasható audit ügynök
display_name = "Biztonsági audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Ha egy eszköz nincs rajta a listán, az az adott ügynök számára nem létezik. Ez a legerősebb garanciád.
Második eszköz: eszközönkénti engedélyek
A rendelkezésre álló eszközöknél egy [tools.<eszköz>] blokk állítja be a szabályt: "always" (nincs kérdezés), "ask" (mindig kérdezzen), vagy "never" (tiltsa le).
display_name = "Refaktorálás"
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"]
A bash esetén az allowlist és a denylist parancselőtagokat határoz meg, amelyek mindig engedélyezettek vagy mindig tiltottak. A Vibe alapértelmezés szerint enged néhány csak olvasható parancsot (ls, pwd, cat, git status stb.), de bármely általad megírt lista felülírja az alapértelmezettet: vedd fel a listába azokat az alapértelmezett parancsokat is, amelyeket meg szeretnél tartani. A read_file, write_file és edit eszközöknél ezek a listák abszolút útvonalmintákat fogadnak el. Egy óvatos szabály: a bash-on keresztül futtatott szkript olyan útvonalakat konstruálhat, amelyeket a Vibe nem lát magában a parancsban; tartsd a bash beállítását "ask" értéken, amikor a tét indokolttá teszi.
Harmadik eszköz: munkakönyvtár hatóköre
Alapértelmezés szerint a Vibe kérdez, mielőtt egy fájl- vagy héj eszköz hozzáférne a munkakönyvtáron kívüli útvonalhoz – még szimbolikus linken keresztül is –, valamint mielőtt a .env és .envrc fájlokat olvasná vagy módosítaná. Ezt a viselkedést tovább szigoríthatod:
outside_workdir = "deny" # kérdezés helyett tiltás; az ügynök hibát kap, és folytatja
Negyedik eszköz: megbízható mappák
Egy tároló saját Vibe konfigurációt (ügynökök, készségek, MCP szerverek, engedélyek) csomagolhat egy .vibe/ mappába, vagy utasításokat egy AGENTS.md fájlba. Mivel ez a konfiguráció megváltoztatja a Vibe viselkedését, csak olyan mappából töltődik be, amelyet kifejezetten jóváhagytál. Az első indításkor a Vibe listázza az észlelt fájlokat, és felajánlja a Mappa megbízása, Teljes tároló megbízása vagy Nem bízom benne lehetőségeket; a választásaid a ~/.vibe/trusted_folders.toml fájlban mentődnek. A párbeszédpanel nem elemzi ezeket a fájlokat: vizsgáld át őket úgy, mint a tároló bármely más kódját, különös tekintettel az MCP szerver definíciókra és az engedélyekre. Programozott módban a Vibe sosem kérdez: a vibe --trust parancs ideiglenes megbízást ad egy egyetlen végrehajtásra.
Válaszadás egy jóváhagyási kérésre
Amikor a Vibe kérdez, négy billentyűzetes válasz lehetséges: az 1 vagy y egyszeri engedélyezést ad, a 2 a munkamenet hátralévő részére, a 3 mindig, míg a 4, n vagy az Escape megtagadja a kérést. A keret színe emlékeztet arra, melyik ügynök aktív.
A megfelelő egyensúly megtalálása
| Szükséglet | Beállítás |
|---|---|
| Elemzés érintés nélkül | enabled_tools = ["read_file", "grep"] |
| Magabiztos refaktorálás | edit beállítva "always" értékre, bash beállítva "ask" értékre, tesztparancsok allowlistjével |
| Projekt tisztítása | bash beállítva "ask" értékre, és a visszafordíthatatlan parancsok denylistjével |
| Felügyelet nélküli feladat CI-ben | Ephemeral konténer, vibe --prompt … --auto-approve, korlátok: --max-turns és --time-limit |
Az aranyszabály továbbra is a legkisebb jogosultság elve: minden ügynöknek csak a legszükségesebbet add meg, kezdj szigorúan, és csak szükség szerint lazíts.
Főbb megállapítások
- A
safety(safe,neutral,destructive,smart,yolo) színezi a keretet; nem érvényesít engedélyeket - Valódi zárak:
enabled_tools/disabled_tools, majd[tools.<eszköz>](always,ask,never) - A
bashesetén azallowlistésdenylistfelülírja az alapértelmezett listákat - A Vibe kérdez, mielőtt kilépne a munkakönyvtárból vagy hozzányúlna a
.envfájlokhoz - A projekt konfiguráció csak megbízható mappában töltődik be; jóváhagyás előtt vizsgáld át