MC Project Lab

Guida a LogArmor Suite

Istruzioni passo-passo per l'installazione e l'uso di LogArmor (Censura dati) e LogArmor Replay (Verifica crittografica).

Non hai Python

Prima installazione su Windows

  1. Apri Download Python per Windows.
  2. Scarica Python 3.10 o una versione successiva.
  3. Avvia l'installazione, seleziona Add Python to PATH e completa l'operazione.
  4. Apri il menu Start, cerca PowerShell e avvialo.
  5. Controlla Python con il primo comando, poi installa pipx con gli altri due:
PowerShell
py --version
py -m pip install --user pipx
py -m pipx ensurepath

Chiudi completamente PowerShell e riaprilo. Poi esegui pipx --version. Se compare un numero, passa a “Installa la Suite”.

Hai già Python

Controlla cosa è già presente

Apri PowerShell ed esegui:

PowerShell
py --version
pipx --version

Se Python è almeno alla versione 3.10 ma pipx non viene riconosciuto, esegui:

PowerShell
py -m pip install --user pipx
py -m pipx ensurepath

Chiudi completamente PowerShell e riaprilo prima di continuare.

Python e pipx sono pronti

Installa LogArmor Suite

PowerShell
logarmor --version
logarmor-replay --help

Il pacchetto logarmor distribuisce automaticamente entrambi i comandi nel sistema: logarmor (censura) e logarmor-replay (audit crittografico).

Uso di LogArmor (Censura)

  1. Avvia con il comando logarmor.
  2. Quando richiesto, premi Invio per esaminare la cartella corrente oppure inserisci un percorso specifico.
  3. Seleziona le estensioni da scansionare (Invio seleziona per default i file .log).
  4. Rivedi la lista dei file trovati e digita confermo.
  5. Scegli l'azione: [1] Censura dati o [2] Rimozione sicura.

Nota sulla rimozione sicura: La sovrascrittura scrive byte casuali e zeri sul file prima di eliminarlo, rendendo impossibile il recupero del log.

Uso di LogArmor Replay (Audit & Integrità)

  1. Al primo avvio, l'esecuzione genera una chiave privata master segreta in ~/.logarmor/replay.key. Questa chiave viene usata per firmare le catene.
  2. Per firmare/sigillare un log: Genera un file .chain crittografato.
    PowerShell
    logarmor-replay sign sessione.log
  3. Per verificare l'integrità del log: Controlla se il log è identico e non è stato alterato.
    PowerShell
    logarmor-replay verify sessione.log
  4. Per rigenerare la chiave master: Inizializza un nuovo segreto (invaliderà le catene precedenti).
    PowerShell
    logarmor-replay init

Funzionamento: Ogni riga del log viene registrata nella catena con timestamp, hash SHA-256 e legata al blocco precedente tramite firma HMAC. Qualsiasi modifica alle righe, inserimento o cancellazione romperà istantaneamente la catena crittografica durante la verifica.

Aggiornamento e disinstallazione

Gestione pacchetto

Per aggiornare la suite

PowerShell
pipx upgrade logarmor

Per disinstallare la suite

PowerShell
pipx uninstall logarmor

Troubleshooting e problemi comuni

  • Se py non risponde, prova a utilizzare python o python3 nei comandi.
  • Se ricevi errori di comando non riconosciuto dopo l'installazione, chiudi tutte le istanze aperte di PowerShell e aprine una nuova per forzare l'aggiornamento del PATH.
  • Se pipx continua ad avere problemi a trovare i binari, esegui py -m pipx ensurepath e riavvia la sessione di terminale.
Torna a LogArmor