Manuale d'uso di PersonalSOC

Qui si spiega come usare l'app che raccoglie, in sola lettura e con un solo pulsante, i log e lo stato delle difese di questo dispositivo in un rapporto comprensibile a colpo d'occhio. Prima si descrivono le operazioni a schermo, mentre la riga di comando è raccolta in un capitolo successivo.

1. Che cos'è PersonalSOC

PersonalSOC è un'app che raccoglie i log e lo stato delle difese di questo dispositivo e li riassume in risultati e rapporto. È pensata perché una persona senza personale di sicurezza dedicato possa vedere, con prove alla mano, che cosa accade sul proprio dispositivo e decidere cosa fare dopo.

È in sola lettura, quindi non modifica le impostazioni, non cancella file e non blocca il traffico. L'analisi dei log è fatta da analizzatori a procedura fissa che non usano né un LLM né la rete. L'integrazione LLM è facoltativa e all'inizio è disattivata.

Cosa non fa

• È uno strumento per il solo dispositivo su cui gira. Non c'è alcuna funzione per vedere più dispositivi insieme.
• Non innalza mai i propri privilegi. Un log leggibile solo da root viene mostrato come «non leggibile» e sudo non viene usato.
• «Nessun rilevamento» non è una prova di sicurezza. Anche il rischio complessivo è solo una stima da 0 a 100, non una probabilità.
• Legge solo un insieme fisso di fonti. Dalla schermata non si possono indicare file o comandi da leggere.

2. Installazione e avvio

PersonalSOC è un'app separata da RoamSwitch. Ha una propria icona ed è distribuita insieme a RoamSwitch. Nei menu di RoamSwitch non c'è un accesso: la si apre come app a sé.

3. Prima verifica dello stato

Legge le fonti fisse solo quando premi «Controlla lo stato». Le fonti che non vuoi far leggere puoi disattivarle nelle impostazioni.

Procedura

1. Apri l'app e premi «Impostazioni» in alto a destra.
2. Sotto compaiono le fonti lette su questo sistema operativo. Togli la spunta a quelle che non vuoi far leggere.
3. Premi «Salva», poi «← Indietro» per tornare alla schermata iniziale.
4. Premi «Verifica lo stato». Compare una barra di avanzamento e, al termine, le schede dei risultati.

Al termine compaiono i conteggi, ad esempio «Verifica completata. 3 rilevamento/i / 2 IOC». Le schede sono spiegate nel capitolo successivo.

4. Come leggere i risultati

5. Impostazioni ed esecuzione periodica

«Impostazioni», in alto a destra nella schermata iniziale, è diviso in schede per funzione. Dopo una modifica premi «Salva», poi «← Indietro» per tornare all'inizio.

Lingua di visualizzazione Oltre a «Automatico (segui il sistema)», puoi scegliere giapponese, inglese, tedesco, spagnolo, francese, italiano, coreano, portoghese (Portogallo), cinese semplificato o cinese tradizionale, ciascuno mostrato con il proprio nome.

Esecuzione periodica (facoltativa)

Spunta «Verifica automatica a intervalli regolari» e salva: su Mac viene registrato come agente utente launchd, su Linux come timer utente systemd. L'intervallo si sceglie fra 7 livelli da 15 minuti a 24 ore e all'inizio è di 1 ora.

Viene eseguito solo personalsoc scan --notify, senza root. Notifica solo quando c'è un rilevamento assente l'ultima volta e il messaggio contiene solo conteggi (su Linux serve notify-send). Puoi anche disattivare la notifica con «Notifica solo se c'è un rilevamento assente l'ultima volta».

Deseleziona la casella e salva: la registrazione viene rimossa.

6. Integrazione LLM (facoltativa)

L'integrazione LLM è facoltativa e all'inizio è disattivata. Una volta attivata, dopo la verifica dello stato il comando del LLM scelto compie un'indagine aggiuntiva e scrive un rapporto come auditor. I comandi utilizzabili sono opencode, claude, codex e agy.

Procedura

1. Spunta «Attiva l'integrazione LLM».
2. Scegli il «LLM da usare». Uno indicato come «(non installato)» non ha il comando su questo dispositivo.
3. Se serve, cambia il modello e il timeout (secondi). Se lasci vuoto il modello, viene usato il predefinito di quel LLM.
4. Premi «Salva», torna all'inizio e premi «Verifica lo stato». Dopo la verifica parte subito l'indagine del LLM.

Cosa arriva al LLM

• Vengono passati il contenuto dei rilevamenti, le righe di log che fanno da prova, le stringhe restituite da MCP e le note sulle fonti. Sono passati perché la situazione venga indagata con precisione.
• Prima di passarli, i segreti come chiavi, token e password vengono mascherati e i caratteri invisibili rimossi.
• PersonalSOC non dà al LLM né una shell né file. Il LLM si limita a richiedere ciò che vuole indagare e PersonalSOC esegue gli strumenti in sola lettura che consente e restituisce i risultati. Ci sono al massimo 6 round di indagine.
• L'output del LLM non è considerato affidabile e nel rapporto è trattato come una citazione. Un LLM può leggere un rilevamento come più grave di quanto sia, quindi verifica sempre la conclusione nei «Risultati».

Sulla limitazione degli strumenti

• Nella colonna «Stato» della tabella nelle Impostazioni, opencode e claude mostrano «Strumenti bloccati». claude viene avviato con strumenti integrati, server MCP e skill disattivati e senza caricare le tue impostazioni. opencode viene avviato con tutti i permessi negati.
• codex e agy non si possono disattivare in questo modo, quindi mostrano «Strumenti non bloccabili».

7. Usare la riga di comando

Il comando è personalsoc. Su Linux si trova in /usr/bin/personalsoc, su Mac dentro PersonalSOC.app/Contents/MacOS/.

8. Dove vengono salvati i dati e aggiornamenti

Cosa viene salvato

PersonalSOC non salva in file i rapporti né i log raccolti. Per conservarli usa «Copia Markdown» a schermo o l'output della riga di comando. Per aggiungere un LLM, modifica a mano profiles nel file delle impostazioni; non si può cambiare dalla schermata.

Aggiornamenti

Su Mac si aggiorna da «Aggiornamenti» nelle Impostazioni. L'app si collega a lafine.net solo quando premi «Verifica aggiornamenti» e riceve le informazioni sull'ultima versione (un JSON pubblico). Non viene inviato nulla su questo dispositivo né sui suoi log. Se esiste una versione più recente, premi «Scarica e installa». La firma del file scaricato viene verificata con la chiave pubblica incorporata nell'app e, se fallisce, non viene installato nulla. Al termine l'app si riavvia.

Su Mac, aggiornare RoamSwitch stesso non aggiorna PersonalSOC. Su Linux non c'è una funzione di aggiornamento e PersonalSOC è incluso negli aggiornamenti dei pacchetti RoamSwitch.

9. Se qualcosa non va