Messa in sicurezza di un agente: sicurezza, permessi e cartelle attendibili
In questa pagina
Lezione riscritta il 2 novembre 2026. La versione precedente descriveva il campo
safetycome un livello di autorizzazione. La documentazione di Vibe è esplicita: si tratta di un indicatore visivo che colora il bordo dell’input; non impone alcun vincolo. La protezione reale deriva dagli elenchi di strumenti, dai permessi per singolo strumento e dalle cartelle attendibili. Fonti: Safety, approvals, and permissions · Configuration reference.
Cosa fa (e cosa non fa) safety
Il campo safety in un file di agente accetta cinque valori: safe, neutral (il predefinito), destructive, smart e yolo. Modifica il colore del bordo dell’area di input per offrirti un promemoria immediato su quale agente stai utilizzando. Non rimuove strumenti né attiva richieste di approvazione. Un agente contrassegnato come safe ma dotato di bash senza restrizioni può comunque eseguire comandi distruttivi.
C’è un’unica eccezione: quando un amministratore disabilita l’approvazione automatica (enable_auto_approve = false), Vibe nasconde tutti gli agenti contrassegnati come yolo. Altrimenti, safety è un’etichetta, non un lucchetto. Abbinalo sempre ai controlli reali descritti di seguito.
Prima leva: strumenti disponibili
enabled_tools (allowlist) e disabled_tools (denylist, applicata successivamente) decidono cosa l’agente può chiamare. Accettano nomi esatti, pattern glob ed espressioni regolari prefissate con re:.
# Agente di audit in sola lettura
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Se uno strumento non è nell’elenco, per quell’agente non esiste. Questa è la tua garanzia più forte.
Seconda leva: permessi per singolo strumento
Per gli strumenti disponibili, un blocco [tools.<tool>] definisce la regola: "always" (nessun prompt), "ask" (prompt ogni volta) o "never" (blocco).
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"]
Per bash, allowlist e denylist specificano prefissi di comando sempre consentiti o sempre negati. Vibe consente alcuni comandi in sola lettura per impostazione predefinita (ls, pwd, cat, git status, ecc.), ma qualsiasi elenco tu scriva sostituisce quello predefinito: includi eventuali comandi predefiniti che desideri mantenere. Per read_file, write_file ed edit, questi elenchi accettano pattern di percorsi assoluti. Una regola prudente: uno script eseguito tramite bash può costruire percorsi che Vibe non vede nel comando stesso; imposta bash su "ask" ogni volta che la posta in gioco lo giustifica.
Terza leva: ambito della directory di lavoro
Per impostazione predefinita, Vibe richiede una conferma prima che uno strumento di file o shell acceda a un percorso esterno alla directory di lavoro, anche tramite un collegamento simbolico, e prima di leggere o modificare i file .env e .envrc. Puoi rafforzare questo comportamento:
outside_workdir = "deny" # nega invece di chiedere; l'agente riceve un errore e continua
Quarta leva: cartelle attendibili
Un repository può includere la propria configurazione Vibe (agenti, competenze, server MCP, permessi) in una cartella .vibe/, oppure istruzioni in un file AGENTS.md. Poiché questa configurazione modifica il comportamento di Vibe, viene caricata solo da una cartella che hai esplicitamente approvato. Al primo avvio, Vibe elenca i file rilevati e offre le opzioni Trust folder, Trust full repo o Don’t trust; le tue scelte vengono salvate in ~/.vibe/trusted_folders.toml. La finestra di dialogo non analizza questi file: revisionali come qualsiasi altro codice nel repository, in particolare le definizioni dei server MCP e i permessi. In modalità programmatica, Vibe non mostra mai prompt: vibe --trust concede un’attendibilità temporanea per una singola esecuzione.
Rispondere a un prompt di approvazione
Quando Vibe mostra un prompt, sono possibili quattro risposte da tastiera: 1 o y consente una volta, 2 per il resto della sessione, 3 sempre, e 4, n o Escape nega. Il colore del bordo ti ricorda quale agente è attivo.
Scegliere il giusto equilibrio
| Necessità | Impostazione |
|---|---|
| Analizzare senza toccare nulla | enabled_tools = ["read_file", "grep"] |
| Refactoring con sicurezza | edit impostato su "always", bash su "ask" con un allowlist di comandi di test |
| Pulizia di un progetto | bash impostato su "ask" e un denylist di comandi irreversibili |
| Attività non presidiata in CI | Container effimero, vibe --prompt … --auto-approve, limiti --max-turns e --time-limit |
La regola d’oro rimane il minimo privilegio: dai a ogni agente il minimo necessario, inizia in modo restrittivo e apri solo se necessario.
Punti chiave
safety(safe,neutral,destructive,smart,yolo) colora il bordo; non impone permessi- Blocchi reali:
enabled_tools/disabled_tools, poi[tools.<tool>](always,ask,never) - Per
bash,allowlistedenylistsostituiscono gli elenchi predefiniti - Vibe chiede conferma prima di uscire dalla directory di lavoro o toccare file
.env - La configurazione del progetto viene caricata solo in una cartella attendibile; revisionala prima di approvare