Registro dei comandi
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).