Registro dei comandi

Aggiornato il 10 novembre 2026

Ogni azione di una macchina CLI lascia una traccia nel suo registro: attivazione, elenco degli host, esecuzione, snippet, strumento MCP, conferma, rotazione, disconnessione, revoca. Si consulta in Impostazioni › Macchine CLI, aprendo la macchina, e su https://app.konsolity.com/cli-machines.

Inizio e fine

Per un'esecuzione, la CLI scrive una riga prima di avviare il comando, poi una seconda alla fine, con il codice di uscita e la durata. Se la scrittura dell'inizio non riesce (rete assente, server irraggiungibile), il comando non viene eseguito: nulla viene eseguito senza lasciare traccia.

Il server scrive a sua volta gli eventi che lo riguardano: attivazione, rotazione del token, revoca, conferme, rifiuti di ambito.

Contenuto di una riga

  • Quando: la data e l'ora;
  • Quale strumento: hosts, run, snippet, sessions, mcp:<tool>, serve:<tool>, login, rotate, logout;
  • Quale host: la sua etichetta;
  • Quale comando: il suo testo, limitato a 4.000 caratteri;
  • Decisione: consentito (con la regola che lo ha consentito), negato, confermato o rifiutato alla conferma;
  • Codice di uscita e durata dell'esecuzione;
  • la sessione CLI e, se pertinente, la richiesta di conferma.

Cosa non contiene il registro

Mai l'output del comando. Mai una password, una chiave, un token o una chiave della macchina.

Conservazione

Le righe sono cifrate a riposo e conservate per 90 giorni, poi eliminate. Revocare una macchina non elimina il suo registro: resta disponibile fino alla fine dei 90 giorni.

Filtri

Filtra per macchina (nella pagina delle macchine), per periodo (dal, al) e per decisione (consentita, rifiutata, confermata, non confermata): le righe più recenti compaiono per prime e «Righe precedenti» carica il resto. L'esportazione usa gli stessi filtri.

Esportazione

Esporta produce un file CSV (foglio di calcolo, intestazioni in inglese) o un file JSON (strumenti, archiviazione) per il periodo scelto. Conserva un'esportazione mensile se ti serve una traccia oltre i 90 giorni.

Buone pratiche

  • Consulta il registro dopo aver ampliato un ambito: i rifiuti mostrano cosa è stato tentato.
  • Il rifiuto ripetuto di un comando legittimo indica una regola da aggiungere; un rifiuto inatteso, una richiesta da approfondire.
  • Una riga di inizio senza riga di fine indica un comando interrotto (revoca, fine della sessione, guasto).