Ambito e regole
Una macchina CLI ha accesso solo a ciò che le hai concesso. L'ambito si sceglie all'approvazione e si può modificare in seguito in Impostazioni › Macchine CLI (o su app.konsolity.com/cli-machines, con la cassaforte aperta). Viene applicato due volte: dal server, che rifiuta qualsiasi chiamata fuori dall'ambito, e dalla macchina stessa, che applica regole cifrate che il server non può né leggere né modificare. Entrambi rifiutano ciò che non è consentito.
Domini
| Dominio | Cosa consente |
|---|---|
hosts |
Elencare gli host scelti; con l'accesso completo, eseguirvi comandi (konsolity run). |
snippets |
Elencare gli snippet scelti; con l'accesso completo e hosts, eseguirli (konsolity snippet run). |
sessions |
Vedere le sessioni CLI in corso sull'account e terminarle (konsolity sessions). |
mcp |
Fungere da strumenti per gli agenti Claude (konsolity mcp, konsolity serve). |
Predefinito: hosts e snippets.
Sola lettura o accesso completo
- Sola lettura: solo elenchi e stato. Non si può eseguire nessun comando, nemmeno tramite uno snippet. È l'accesso predefinito, e la scelta giusta per una dashboard o per il monitoraggio.
- Accesso completo: i comandi sono consentiti sugli host scelti, entro le regole dei comandi descritte sotto.
La cassaforte della macchina
La macchina non riceve mai la chiave della tua cassaforte. All'approvazione, il tuo dispositivo genera una chiave della macchina propria di questa macchina, gliela consegna sigillata, poi copia, cifrati con questa chiave, solo gli elementi consentiti dall'ambito:
- gli host scelti, con le loro identità, le loro chiavi SSH e le loro chiavi host fissate;
- gli snippet scelti;
- le regole della macchina.
Il server conserva queste copie come blob opachi. Un host fuori dall'ambito non ha alcuna copia: la sua chiave SSH non lascia mai la tua cassaforte. La macchina non ha accesso alla cassaforte dell'account.
- Aggiungere un host all'ambito: un dispositivo con la cassaforte aperta ne scrive la copia.
- Rimuovere un host: il server ne elimina subito la copia.
- Modificare un host nella cassaforte (indirizzo, chiave): i tuoi dispositivi aggiornano le copie delle macchine alla sincronizzazione successiva. Eliminare l'host elimina anche le sue copie.
Si possono usare solo gli host la cui chiave host è già fissata nella cassaforte: la CLI non accetta mai una chiave host sconosciuta (host_key_unknown). Connettiti una volta all'host dall'app per fissarla.
Regole dei comandi
Con l'accesso completo, konsolity run (e lo strumento run_command di Claude) è consentito solo se l'host è nell'ambito e il comando, senza gli spazi iniziali e finali, corrisponde a una regola. Tre modi di confronto:
| Tipo | Regola | Modello di esempio | Accetta | Rifiuta |
|---|---|---|---|---|
exact |
l'intero comando, identico | df -h |
df -h |
df -h / |
prefix |
il comando inizia con il modello | uptime |
uptime -p |
w |
glob |
* sta per una sequenza di caratteri |
systemctl status * |
systemctl status nginx |
systemctl restart nginx |
Cosa * non consente mai
In un modello glob, * non può contenere:
;&|(concatenazione e pipe);`e$((sostituzione di comando);>e<(redirezione);- un ritorno a capo.
Così systemctl status * non accetta né systemctl status nginx; rm -rf / né systemctl status x | sh. Un modello prefix accetta così com'è tutto ciò che segue il prefisso: riservalo ai comandi innocui.
Qualsiasi comando
L'opzione Qualsiasi comando consente qualsiasi testo sugli host scelti. Richiede una conferma esplicita sullo schermo ed è sconsigliata: la macchina diventa l'equivalente di un accesso shell completo. I comandi distruttivi restano soggetti a conferma (vedi sotto).
All'attivazione con accesso completo, nessuna regola è selezionata e «Qualsiasi comando» è disattivato: devi scrivere delle regole o selezionare esplicitamente «Qualsiasi comando», altrimenti ogni comando libero viene rifiutato. Gli snippet consentiti vengono eseguiti così come sono salvati.
Timeout massimo
Ogni comando viene interrotto oltre il timeout massimo: 60 secondi per impostazione predefinita, 1 ora al massimo. Il valore richiesto da --timeout o da Claude è sempre limitato da questo timeout.
Comandi distruttivi: sempre confermati
Alcuni comandi non vengono mai eseguiti senza la tua conferma esplicita nell'app o sulla console, qualunque sia l'ambito, anche con «Qualsiasi comando». Un comando (o il contenuto di uno snippet) è distruttivo se contiene, come parola a sé stante, ad esempio:
- eliminazione e cancellazione:
rm -r,rm -f,rmdir,shred,truncate,dd,mkfs,fdisk,parted,wipefs; - arresto:
shutdown,reboot,poweroff,halt,init 0,init 6,systemctl stop,disable,mask,kill,service ... stop,kill -9,killall,pkill; - account e permessi:
userdel,deluser,passwd,chmod -R,chown -R,crontab -r; - firewall:
iptables -F,ufw disable,ufw reset; - database:
DROP,TRUNCATE,DELETE FROM,ALTER TABLE ... DROP,migrate:fresh,migrate:reset,migrate:rollback; - repository e infrastruttura:
git push --force,git reset --hard,git clean -f,docker rm,docker rmi,docker system prune,docker volume rm,docker compose down -v,kubectl delete,terraform destroy; - una redirezione
>verso un disco (/dev/sd*,/dev/nvme*) o verso/etc/.
La stessa lista viene applicata dalla CLI e dal server: un comando distruttivo avviato senza una conferma approvata viene rifiutato da entrambe le parti. Il flusso è descritto in Conferme.
Modificare l'ambito
- Ampliarlo (aggiungere un dominio, passare dalla sola lettura all'accesso completo) richiede di nuovo il secondo fattore (TOTP o passkey).
- Restringerlo (rimuovere un dominio, tornare alla sola lettura, rimuovere un host) è immediato e non chiede nulla: le copie fuori dall'ambito vengono eliminate subito.
Le regole dei comandi e il timeout si possono modificare in qualsiasi momento, con la cassaforte aperta. Per vedere cosa applica davvero la macchina:
konsolity policy
Esempi
Monitoraggio (sola lettura, hosts + sessions): elenchi e stato, nessun comando.
Operazioni quotidiane (accesso completo, alcuni host):
glob systemctl status *
exact df -h
exact free -m
prefix uptime
glob journalctl -u * --since *
glob tail -n * /var/log/nginx/error.log
exact docker ps
più gli snippet «Riavvia nginx» e «Svuota la cache dell'applicazione».
Distribuzione dalla CI (token di lunga durata, accesso completo, hosts + snippets): un unico snippet «Distribuisci» sull'host di produzione, nessuna regola per comandi liberi.