Lafine Systems Design · Documento tecnico

Libro bianco sull'architettura e la sicurezza di RoamSwitch

Questo è un documento tecnico che spiega con quali privilegi viene eseguito RoamSwitch e cosa fa a quei confini. Non usa espressioni promozionali, e tutto ciò che è riportato può essere verificato dal binario dell’app distribuita e dal suo comportamento reale.

Versione v1.6 Ambito RoamSwitch 1.17.26 (build 205) Requisiti macOS 13.0+ / Apple Silicon Pubblicato 2026-10-22 Team ID GV76B6G4YU

§1

RoamSwitch è un’app per Mac residente nella barra dei menu. In base al grado di fiducia nella rete a cui si è connessi, passa automaticamente da una configurazione all’altra del firewall di macOS, dei servizi di condivisione, di AirDrop e del DNS. Inoltre monitora lo spoofing ARP, le porte aperte verso l’esterno, i dispositivi di archiviazione USB e la cifratura tipica dei ransomware e, quando rileva un pericolo, arriva fino all’isolamento di emergenza (Air-Gap), che blocca il traffico con il filtro di pacchetti (pf).

In altre parole, RoamSwitch mantiene residente un demone con privilegi di root e, se volesse, potrebbe bloccare tutto il traffico del Mac. Lo sviluppatore è un privato, e le sole parole «fidatevi di noi» non possono giustificare questo privilegio. Per questo il documento spiega il progetto in una forma verificabile.

Per chi è questo

  • Gli ingegneri decidono se installarlo
  • Ricercatori e giornalisti di sicurezza che vogliono comprendere i dettagli prima di una recensione o di un articolo
  • Il personale addetto alla sicurezza presso le aziende partner sta valutando un'implementazione interna o un raggruppamento OEM

Cosa non copre questo documento

Non riguarda l'ottimizzazione della soglia di rilevamento, le statistiche sui falsi positivi o le procedure dettagliate dell'interfaccia utente. Ciò che spiega sono quattro cose: privilegi, limiti del processo, flusso di dati e crittografia. Le specifiche delle funzionalità stesse si trovano nella risorsa MCP in bundle roamswitch://docs/features e nella guida in-app.

Cosa viene divulgato e in che misura (politica di divulgazione)

Questo documento è scritto partendo dal presupposto che un utente malintenzionato abbia già il file binario distribuito. Ogni URL, identificatore, percorso file, protocollo XPC e chiave pubblica incorporata dell'endpoint visualizzato qui può essere estratto dalla spedizione RoamSwitch.app in pochi minuti con strings, codesign -d o un proxy di traffico. Scriveteli qui dunque non dà nulla di nuovo all'attaccante. L'unica cosa che avanza è la comprensione del revisore.

Non viene invece descritta l’implementazione lato server che non è ricavabile dal binario. Rientrano in questa categoria le soglie di limitazione della frequenza, le chiavi, gli endpoint di amministrazione, lo schema del DB e la configurazione del progetto Firebase. Anche la progettazione delle integrazioni con OEM e partner è fuori dall’ambito di questo documento e viene trattata in un altro documento interno. «Ciò che si può conoscere osservando il client» è il confine di divulgazione di questo documento.

Nota aggiuntiva

Questo documento corrisponde alla fonte della versione indicata in alto. Dove il comportamento cambia in una versione successiva, il documento viene rivisto e il numero di versione e la build di destinazione vengono aggiornati. Se trovi una discrepanza tra il testo e il codice, faccelo sapere a lafine.net/contact.html.

§2

RoamSwitch.app è composto da tre eseguibili. Solo uno di essi è privilegiato; il gli altri due vengono eseguiti con diritti di utente di accesso. Tutti e tre vengono forniti con Hardened Runtime abilitato, ID sviluppatore firmato e autenticato.

Diagramma dei componenti di RoamSwitch e dei confini di fiducia Client MCP Claude Desktop / Code MCPServer Privilegio utente Quasi solo lettura RoamSwitch.app Privilegio utente Barra dei menu / Monitoraggio / UI Helper root / LaunchDaemon SMAppService.daemon Binari di sistema pfctl / socketfilterfw … stdio (JSON-RPC) Sola lettura * XPC mach service Autorizzato tramite firma del codice Esecuzione del processo
* MCPServer non si connette all'app stessa; legge direttamente il dominio delle preferenze condivise e i moduli di monitoraggio (§8).
Privilegi e ruolo di ciascun componente
EseguibilePrivilegioPuò fareNon posso farlo
RoamSwitch
.app
Utente di accesso Monitora lo stato della rete, esegui la diagnostica, disegna l'interfaccia utente, chiama l'helper su XPC, modifica AirDrop tramite defaults, avvia ClamAV (opzionale) Gestisci direttamente il firewall, pf o i demoni di sistema (tutto questo passa attraverso l'helper)
RoamSwitch
Aiuto
root Solo le operazioni elencate in HelperProtocol (tabella §3): firewall/stealth, caricamento/scaricamento dei demoni di condivisione, applicazione del ruleset pf, modifica DNS, invio segnali ai processi Tutto il resto. Non esiste un'interfaccia per eseguire comandi arbitrari. Non è dichiarato alcun entitlement di invio in rete, ma poiché non è sottoposto a sandbox, ciò di per sé non vieta le comunicazioni (la misurazione del traffico in uscita è nel §7)
RoamSwitch
MCPServer
Utente di accesso Leggere e formattare i valori diagnostici, effettuare ricerche nella knowledge base locale; i risultati vengono restituiti al client tramite stdio Modificare le impostazioni, attivare/disattivare il blocco, isolare una porta, espellere un dispositivo. Per impostazione predefinita non apre socket e non invia nulla in rete (le uniche eccezioni sono la verifica delle firme npm, disattivata per impostazione predefinita, e la diagnosi delle vulnerabilità rivolta a questo stesso Mac, 127.0.0.1; vedi §8). Non è dichiarato alcun entitlement di invio in rete, ma poiché non è sottoposto a sandbox, ciò di per sé non vieta le comunicazioni

Diritti e firma

  • Tutti e tre gli obiettivi hanno ENABLE_HARDENED_RUNTIME = true.
  • La sandbox dell'app è disabilitata (com.apple.security.app-sandbox = false). I diritti dell'helper e di MCPServer sono dizionari vuoti.
  • La build di distribuzione è firmata con Developer ID Application, notarizzata da Apple e sottoposta a staple (§10).
Compromesso di design

L'app Sandbox non viene utilizzata. RoamSwitch deve leggere l'UUID hardware da IOKit, utilizzare CoreWLAN e DiskArbitration, enumerare i socket di ascolto di altri processi (lsof), aprire un XPC connessione a un LaunchDaemon e generare file binari di sistema. Niente di tutto questo è possibile all'interno del sandbox, quindi viene lasciato disabilitato.

Quattro cose lo compensano. Innanzitutto, runtime rafforzato. In secondo luogo, firma dell'ID sviluppatore e notarile. In terzo luogo, solo un eseguibile viene eseguito come root, l'helper, e cosa può fare quell'helper è fissa ed enumerata (tabella §3). In quarto luogo, le connessioni con l'helper sono limitate dal codice firma (§3).

§3

Come viene registrato

L’helper viene registrato come LaunchDaemon con SMAppService.daemon(plistName:). Il plist dichiara solo Label, BundleProgram, una voce MachServices e AssociatedBundleIdentifiers. Non può essere registrato se non si trova in /Applications, e la prima volta richiede l’approvazione manuale in Impostazioni di Sistema.

Di quali connessioni accetta (ClientValidator)

L'aiutante controlla il processo di connessione in NSXPCListener shouldAcceptNewConnection e distribuisce HelperProtocol solo a quelli che passare. L'ispezione utilizza audit_token anziché il PID evitare il riutilizzo del PID e il TOCTOU.

# Requisiti di firma del codice richiesti dalla build Release ai client che si connettono
identifier "com.tetsuharu.RoamSwitch"
  and anchor apple generic
  and certificate leaf[subject.OU] = "GV76B6G4YU"

Questo requisito viene verificato con SecCodeCopyGuestWithAttributes e SecStaticCodeCheckValidity e la connessione viene interrotta se non passa. Solo Le build DEBUG rilasciano il pin ID squadra, per comodità di sviluppo. Ciò che effettivamente viene spedito è sempre a Rilascia la build.

Punti chiave del confine

La sicurezza dell'aiutante si basa su questo unico requisito di firma del codice. Tutto ciò che lo soddisfa (a firmato correttamente RoamSwitch.app) può chiamare ogni operazione nella tabella seguente. C'è nessun canale per dargli comandi arbitrari, ma le operazioni in quella tabella non sono deboli stessi. Se lo stesso RoamSwitch.app viene rilevato, queste operazioni passano al attaccante.

Cosa può fare l'aiutante (l'elenco completo)

Le operazioni privilegiate definite in Shared/HelperProtocol.swift sono tutte. Non esiste alcuna API privilegiata che non sia elencata qui.

HelperProtocol: tutto ciò che viene eseguito come root
MetodoCosa faBinario/API richiamata
impostaBloccaTutto(_:) Attiva o disattiva il firewall dell'applicazione e la modalità invisibile /usr/libexec/ApplicationFirewall/socketfilterfw
--setblockall / --setstealthmode
getBlockAllStatus(...) Legge i valori attuali di cui sopra socketfilterfw --getblockall
setSharingServicesAbilitato(_:) scaricare/caricare i demoni SSH/SMB/Condivisione schermo. Quando si ferma, registra solo "quelli che erano in esecuzione" e ripristina solo quelli /bin/launchctl list / unload -w / load -w
(fisso su tre: ssh.plist / com.apple.smbd.plist / com.apple.screensharing.plist)
abilitaNetworkAirGap(...)
disableNetworkAirGap(...)
Applica e rimuove il blocco completo di emergenza (block drop all). Passa per PFRulesetCoordinator (§4) /sbin/pfctl -f / -e / -sr
setGuardedDevServerPorts(_:) Utilizza pf per bloccare solo le connessioni external alle porte del server di sviluppo specificate (passa l'host locale). Passare un array vuoto li solleva tutti /sbin/pfctl (anche tramite il Coordinatore)
setSecureDNSServers(_:)
restoreOriginalDNSServers(...)
getCurrentDNSServers(...)
Cambia il DNS dei servizi di rete attivi in DNS che bloccano il malware (Quad9 9.9.9.9 / Cloudflare 1.1.1.2), eseguendo il backup delle impostazioni originali e ripristinandole /usr/sbin/networksetup
-listallnetworkservices / -getdnsservers / -setdnsservers
setLinkGuardSinkhole(_:) Protezione del collegamento (§5). Scrive i domini di phishing/truffa specificati in una sezione gestita delimitata di /etc/hosts come 0.0.0.0, quindi svuota la cache DNS. Un array vuoto rimuove la sezione. I domini vengono normalizzati e deduplicati; IP e spazzatura vengono eliminati; limitato a 60.000; scritto tramite un file temporaneo + sostituzione atomica riscrive /etc/hosts (FileManager.replaceItemAt)
/usr/bin/dscacheutil -flushcache
/usr/bin/killall -HUP mDNSResponder
lockGatewayARP(_:)
unlockGatewayARP(...)
getGatewayARPLockStatus(...)
Blocco preventivo ARP/NDP del gateway (§5). Blocca le mappature IP → MAC fornite (il gateway IPv4, il router predefinito IPv6, i risolutori DNS on-link) come voci permanent della cache dei vicini. I formati IP e MAC sono convalidati; un modello di riconciliazione (i pin non presenti nella richiesta vengono rimossi). Il set di pin viene mantenuto su gateway_arp_lock.json /usr/sbin/arp -s / -d
/usr/sbin/ndp -s / -d
wireGuardImport(_:)
wireGuardForget(...)
Tunnel VPN (§5). L'assistente salva/elimina il testo WireGuard .conf in 0600 sola scrittura del file
wireGuardUp(endpointIPv4:endpointIPv6:porta:)
wireGuardDown(...)
wireGuardStatus(...)
Porta il tunnel su/giù/leggi lo stato. Il nome host dell'endpoint è risolto dall'app e l'IP viene passato all'helper (il DNS dell'helper può essere interrotto dal kill switch) Homebrew wg-quick up/down, wg show (wireguard-tools; disabilitato se non installato)
terminateProcess(pid:forceKill:) Sospende (SIGSTOP) o chiude forzatamente (SIGKILL) un processo. Utilizzato per contenere processi simili a ransomware. Solo pid > 1 chiamata di sistema kill(2) (non un sottoprocesso)
getHelperVersion(...) Restituisce la stringa della versione dell'helper (utilizzata per i controlli di compatibilità dell'app) —
Compromesso di design

terminateProcess può inviare SIGKILL a qualsiasi processo, purché pid > 1. setSecureDNSServers accetta qualsiasi stringa del server DNS. Questo è la larghezza necessaria all'elemento, ma non è stretta. Giudicalo con la consapevolezza che il il controllo della firma del codice di fronte ad esso (ClientValidator) è l'unico cancello.

Stato all'interno dell'aiutante

  • HelperTool.shared è una singola istanza condivisa tra connessioni. In passato si trattava di un'istanza separata per connessione, quindi un contenimento di emergenza che apriva una nuova connessione poteva colpire una gara che aveva perso traccia di "quali servizi ripristinare".
  • Il servizio di condivisione e i backup DNS vengono modificati solo su una coda seriale (stateQueue).

Separazione dei privilegi nell’helper ed eccezione per la lettura del log SSH

Subito dopo l’avvio, l’helper applica a sé stesso una sandbox imposta dal kernel, ereditata dai processi figli. Blocca la sostituzione dei programmi di sistema, la registrazione di LaunchDaemon, la riscrittura delle impostazioni di sudoers, PAM e sshd e l’esecuzione di programmi da posizioni scrivibili. Non blocca le modifiche agli account tramite dscl né l’invio e la ricezione in rete.

Con questo limite, /usr/bin/log non viene eseguito. Il log di macOS 26 non funziona né dentro la sandbox né come nobody, quindi non può leggere il log unificato di sshd. Il rilevamento del brute force SSH ha bisogno di questo log, perciò nella separazione dei privilegi è prevista un’eccezione.

L’eccezione è un piccolo processo root che l’helper avvia con --ssh-log-reader prima di entrare nella sandbox. Riceve solo 1 byte per l’avvio e l’arresto e lancia /usr/bin/log con argomenti fissi. Non esiste alcun punto d’ingresso per specificare argomenti o comandi, e inoltra il log all’helper senza leggerne il contenuto.

Poiché il log contiene stringhe che un attaccante può scrivere, l’helper root non interpreta le righe. L’interpretazione è affidata a un worker di analisi che gira come nobody e a cui sono vietati rete e scrittura. Su un Mac con l’accesso remoto disattivato, log non viene avviato. Le operazioni SSH richiamabili via XPC sono 5 e non esiste alcun punto d’ingresso per passare un comando arbitrario.

§4

Quattro funzionalità toccano pf: l'air-gap di emergenza, la protezione della porta del server di sviluppo, il tunnel VPN Kill-switch WireGuard (§5, 1.7.6+) e il suo kill-switch Tailscale (§5, 1.8.0+ — solo il backend selezionato). Vanno sempre tutti attraverso un unico punto di ingresso, PFRulesetCoordinator, e non eseguire mai pfctl -f stessi.

Perché esiste un unico punto di ingresso

In precedenza due funzioni caricavano separatamente le regole con pfctl -f e si contendevano il set di regole principale di pf. Di conseguenza, a volte il Mac restava raggiungibile pur mostrando «isolamento in corso». Il problema è stato trovato in un test di attacco da un’altra macchina e corretto nella 1.4.3.

Come funziona adesso

  • Ricostruito completamente ogni volta. L'intero set di regole richiesto viene ricostruito dallo stato corrente e applicato in un colpo solo. Non viene mai applicato come diff.
  • Una coda seriale. Ogni modifica pf viene eseguita sullo stesso DispatchQueue, quindi, indipendentemente dal fatto che provenga da una connessione XPC, dall'avvio dell'helper o dal timer di failsafe, le modifiche vengono elaborate in ordine.
  • L'ordine di priorità è il seguente (quelli più in alto hanno la precedenza).
    1. Air-gap di emergenza → set skip on lo0 e block drop all (nient'altro viene considerato)
    2. Kill-switch VPN → block drop all più pass quick solo per: lo, l'interfaccia tunnel (utunN), l'handshake UDP agli IP dell'endpoint bloccato, DHCP e ICMP
    3. Guardia del server di sviluppo → block drop in quick proto tcp ... port { … }
    4. Nessuno → ricarica /etc/pf.conf e riporta pf al suo stato originale
  • Rileggi dopo l'applicazione. pfctl -sr rilegge le regole per confermare che block drop all, o la regola di ciascuna porta, è effettivamente caricata. Un caso in cui pfctl -f è stato silenziosamente ignorato non viene considerato un successo.
  • Il file temporaneo viene scritto in un percorso contenente UUID ed eliminato una volta applicato (la versione 1.4.5 ha abbandonato il percorso fisso a favore di uno difficile da indovinare). La directory dello stato è /Library/Application Support/RoamSwitch.
Comportamento dell'API

Le risposte XPC da enableNetworkAirGap e setGuardedDevServerPorts, (Bool, String?), segnala se l'operazione è passata completamente attraverso il rilettura. Il chiamante (come ARPSpoofContainmentManager) riprova in caso di errore e se continua a fallire e visualizza direttamente il messaggio sullo schermo: "Il traffico non è ancora stato fermato. Spegni Wi-Fi adesso."

§5

I tipi di blocco sono diversi

Tipi di blocco
GentileAmbitoInnescoloopback
Intercapedine d'emergenza Arresta tutto il traffico, in entrata e in uscita Quando viene rilevata un'attività di crittografia simile a un ransomware. Al rilevamento di ARP spoofing, si attiva immediatamente solo in modalità Lockdown; su reti bilanciate/attendibili, notifica invece (lo si attiva manualmente). Su un pattern di comando noto di tipo «ClickFix» nella cronologia della shell, come la decodifica base64 direttamente verso una shell o AppleScript (1.8.7+, Pro, disattivato di default). Non utilizzato per la protezione quotidiana fuori casa Superato con set skip on lo0
Kill switch VPN Tutto tranne il tunnel, il suo handshake, DHCP e ICMP Quando il tunnel VPN (§5, Pro, disattivato per impostazione predefinita) è attivo e ti colleghi a una rete non attendibile. Trattenuto finché il tunnel non viene stabilito (e mentre è giù) Superato con set skip on lo0
Protezione della porta del server di sviluppo Solo external connessioni TCP alle porte indicate Isolamento manuale con un clic o blocco automatico quando viene rilevata una porta di ascolto sconosciuta (Pro) Da localhost, invariato
Protezione quotidiana delle reti non affidabili Firewall e stealth, condivisione interrotta (§6). pf non è utilizzato Quando ti connetti a una rete non sei registrato —
Guardia dei collegamenti Solo risoluzione dei nomi di domini phishing/truffa (0.0.0.0 tramite /etc/hosts). pf non è utilizzato Una destinazione nel feed delle minacce o un omografo di un marchio. Attivo per impostazione predefinita (Pro) Non influenzato
Blocco preventivo ARP/NDP Solo il MAC del gateway, del router IPv6 e il DNS on-link (cache dei vicini). pf non è utilizzato Quando si accede a una rete non attendibile (Pro, disattivata per impostazione predefinita). Re-pinnato ad ogni modifica della rete Non influenzato

Come l'Air-Gap non si prolunga e non può essere aspettato

  • Il modo in cui termina dipende da ciò che lo ha attivato (da 1.9.52). Un'esca antiransomware manomessa, un rilevamento XProtect confermato e un isolamento manuale scelto da un avviso ARP sono di «alta affidabilità»; ClickFix, le anomalie di porta e simili sono di «bassa affidabilità». Un isolamento a bassa affidabilità si rimuove comunque da solo al massimo dopo 10 minuti. Uno ad alta affidabilità non si rimuove a 10 minuti: una rimozione completa basata solo sul tempo permetterebbe a un attaccante di limitarsi ad aspettare.
  • Un isolamento ad alta affidabilità resta completamente chiuso fino a un limite (1 ora per impostazione predefinita, da 5 minuti a 24 ore nelle impostazioni) e lì verifica la causa. Nel caso del ransomware considera la causa scomparsa solo se il processo sospetto è stato identificato ed è terminato e le esche non sono cambiate dal rilevamento. Se non è possibile confermarlo, passa alla «modalità ridotta»: le nuove connessioni restano bloccate (tranne loopback e DHCP) e viene ripristinata solo la radio Wi-Fi, così da poter vedere cosa accade. Non si apre mai per il solo trascorrere del tempo. Si apre solo se lo rimuovi tu o se la causa è confermata scomparsa.
  • All'inizio di un isolamento vengono interrotte anche le connessioni in uscita già aperte. La tabella degli stati di pf viene svuotata (pfctl -F states), fermando il traffico iniziato prima dell'isolamento. Lo stesso avviene al passaggio alla modalità ridotta.
  • Un isolamento causato da ARP spoofing viene rimosso automaticamente solo quando si conferma, senza alcun traffico, che la causa è scomparsa. Il controllo legge soltanto la cache ARP (non invia pacchetti) e considera la causa scomparsa quando il MAC attendibile del gateway viene visto in 3 controlli consecutivi che coprono almeno 60 secondi. Durante l'isolamento, però, la voce ARP del gateway può scomparire dalla tabella dei vicini (confermato su un Mac reale) e allora la causa non può essere confermata. In quel caso resta in modalità ridotta finché non lo rimuovi tu.
  • Anche se l'helper si blocca, il controllo di rimozione non si ferma. Un LaunchDaemon dedicato senza alcun KeepAlive (AirGapFailsafe) si avvia da solo ogni 3 minuti e prende la stessa decisione dell'helper (bassa affidabilità: rimozione a 10 minuti; alta affidabilità: verifica della causa al limite, poi modalità ridotta). Se l'helper stesso si blocca e perde il proprio timer di rimozione, questa rete di sicurezza non ne risente (da 1.8.6; la decisione in base all'affidabilità da 1.9.52).
  • Questo daemon dedicato non tocca mai la configurazione di avvio dell'helper interattivo stesso. Un tentativo precedente (1.8.5) usava il KeepAlive.PathState proprio dell'helper per questo ripristino, ma a volte interferiva con una normale chiusura dell'app causando un riavvio indesiderato, per cui è stato annullato a favore dell'attuale daemon completamente indipendente.
  • Il controllo del timestamp utilizza una combinazione ibrida di tempo di attività monotono (ProcessInfo.systemUptime) e ora dell'orologio. Normalmente privilegia il tempo di attività monotono, così le correzioni NTP e i cambi manuali dell'ora non hanno effetto. Ricorre all'ora dell'orologio solo quando il tempo di attività non è affidabile — subito dopo un riavvio, rilevato quando il valore attuale è inferiore a quello memorizzato.
  • Viene riapplicato dopo un riavvio o la ricreazione del demone. All'avvio l'helper legge lo stato dal disco con reapplyFromDisk() e ripristina da sé Air-Gap, protezione delle porte e impostazioni di sistema predefinite, in quest'ordine. Riprende anche lo stato dell'isolamento (affidabilità, completo o ridotto) e il tempo trascorso; il conteggio prosegue dalla prima attivazione (confermato su un Mac reale riavviando l'helper).
  • Un sollevamento fallito viene trattato come un fallimento. Se block drop all non può essere effettivamente rimosso, il timestamp viene riscritto in modo che il timer di failsafe e il nuovo tentativo abbiano qualcosa su cui convergere. Lo schermo non mostra mai erroneamente "sollevato".
  • Puoi riprendere il controllo in qualsiasi momento: con «Rimuovi isolamento Air-Gap» nella barra dei menu, con il pulsante di rimozione nella finestra modale, o semplicemente spegnendo il Wi-Fi. La rimozione non richiede Pro (funziona anche se Pro scade nel mezzo di un isolamento).

Come viene recuperato un falso positivo Port-Guard

Il blocco automatico delle porte sconosciute (Pro, attivo per impostazione predefinita una volta abilitato) può fermare app di ricezione legittime come LocalSend e Syncthing. Si può rimuovere con «Consenti» nella notifica o dalla schermata «Porte esposte all’esterno», e un eseguibile consentito non viene più bloccato in seguito. Gli interpreti generici come Python vengono identificati da «percorso di esecuzione + numero di porta», e i demoni standard che soddisfano anchor apple non vengono monitorati.

Esca canary ransomware autoriparante e soppressione del contenimento

Dopo che l’Air-Gap di emergenza è stato attivato perché un file canarino (esca) è stato manomesso o rinominato, quando si conferma che la situazione è sicura e si rimuove l’isolamento, i file canarino danneggiati o scomparsi vengono rigenerati automaticamente dai modelli autentici dell’app e anche i relativi hash vengono ripristinati. Il monitoraggio in tempo reale con kqueue non viene interrotto e riprende subito (i dati alterati da un attaccante non vengono mai scambiati per la nuova base di riferimento). Mentre l’isolamento di emergenza è attivo (mentre viene mostrata la finestra modale), le attivazioni multiple e le notifiche duplicate causate dal polling periodico dell’integrità vengono soppresse automaticamente, così da non ostacolare la verifica o la reazione dell’utente.

Rilevamento generico del ransomware basato sull'entropia — 1.10.0, Pro, attivo per impostazione predefinita

Monitora Documents, Desktop, Downloads e Pictures con FSEvents e, quando si susseguono 20 o più scritture con entropia superiore alla soglia (7,92) entro 5 secondi, interrompe automaticamente la rete. Poiché non dipende da file esca, rileva anche la cifratura in luoghi privi di esche. Il processo viene identificato con lsof e confrontato con una lista di elementi consentiti come cp e Time Machine.

Conta anche i file (da 16 KiB in su) il cui inizio (fino a 8 MiB), suddiviso in finestre da 4 KiB, ha due o più finestre pari o superiori a 7,9, così da rilevare la cifratura parziale. Non si applica agli artefatti di build, e la cifratura in blocchi inferiori a 4 KiB non è visibile. Nelle misurazioni, su 3.531 file questo controllo non ha aggiunto alcun rilevamento (0), e in una simulazione con 150 file reali il rilevamento è salito dallo 0–35% al 100%. Non è una verifica con ransomware reali.

L'edizione Linux può tracciare i burst per processo perché fanotify associa un PID a ogni evento di scrittura. macOS non dispone né di fanotify né (per scelta) di EndpointSecurity, quindi questa implementazione legge solo il percorso tramite FSEvents e conta il burst globalmente, indipendentemente dal processo. Limite: quando più processi legittimi scrivono contemporaneamente grandi quantità di file ad alta entropia (ad esempio lavori di compressione o cifratura concorrenti), qui è più probabile un falso positivo rispetto all'edizione Linux.

Snapshot precedenti al danno per il recupero da ransomware (Mac)

Poiché lo snapshot preso al momento del rilevamento contiene già file cifrati, vengono presi periodicamente anche snapshot locali APFS, separatamente dal rilevamento (predefinito ogni 6 ore; a scelta tra disattivato, 1, 3, 6, 12 o 24 ore). Al rilevamento, la creazione e la pulizia degli snapshot si fermano per un massimo di 7 giorni, proteggendo l'ultimo snapshot preventivo.

Il ripristino è manuale: solo i file necessari vengono estratti in ~/RoamSwitch-Recovered/, i file attuali non vengono sovrascritti e l'intero volume non viene ripristinato. macOS può eliminare gli snapshot automaticamente e non c'è garanzia che restino oltre circa 24 ore. La finestra di ripristino è una funzione della versione Pro, mentre gli snapshot preventivi vengono presi anche nella versione gratuita.

Pacchetto di prove forensi — 1.10.0

Quando parte un Air-Gap di emergenza, una coda in background che non rallenta l’isolamento salva l’elenco dei processi (ps), le connessioni (lsof -i), i file modificati negli ultimi 5 minuti e altro in ~/Library/Application Support/RoamSwitch/incident-evidence/<timestamp>/manifest.json, e registra lo SHA-256 di ogni prova. L’hash del manifest viene scritto, insieme all’hash della riga precedente, anche in chain.log fuori dal bundle.

Lo strumento MCP get_forensic_evidence_bundles restituisce, per ogni bundle, se è stato manomesso, oltre alle interruzioni della catena e ai bundle scomparsi. Si tratta di rilevamento, non di prevenzione: chi può riscrivere entrambi può creare una cronologia coerente. Limite: poiché non usa EndpointSecurity o simili, non acquisisce pacchetti né snapshot della memoria.

Quando un contenimento dovuto al rilevamento di ransomware (file esca, entropia) o al collegamento con XProtect salva un pacchetto di prove, quel salvataggio viene aggiunto come registrazione sotto la registrazione del rilevamento. Nel registro attività di sicurezza, i dettagli dell'elenco mostrano «Originato da» e il nome del pacchetto di prove. Nello strumento MCP get_incident_timeline per i client IA, parentEventID, rootEventID ed evidenceRefs compaiono solo nelle registrazioni che hanno un collegamento (al massimo 8 riferimenti, che contengono solo il nome del pacchetto, il nome del file e lo SHA-256, mai il contenuto). Il manifest del pacchetto di prove riporta anche l'id della registrazione che lo ha originato. Un collegamento si crea solo se l'id della registrazione che lo ha originato è noto, mai solo perché gli orari sono vicini. Il contenimento in caso di ARP spoofing non crea alcun pacchetto di prove, quindi non ha registrazioni collegate.

Registrazione delle esecuzioni dei processi (Mac, Pro, disattivata per impostazione predefinita)

L'helper privilegiato avvia lo standard /usr/bin/eslogger di macOS e registra l'avvio dei processi solo all'interno di questo Mac. Non richiede l'entitlement EndpointSecurity ed è necessario concedere l'accesso completo al disco. Finché non è concesso, mostra «Non disponibile» e ricontrolla ogni 60 secondi. Solo notifica; non blocca l'esecuzione, non interrompe le comunicazioni e non isola.

Notifica i seguenti 14 comportamenti.

Avvio di una shell da browser, Office o posta / esecuzione di binari non firmati da posizioni come le cartelle temporanee / comandi di una riga che scaricano e passano a una shell / osascript che usa base64 o eval / esecuzione subito dopo la rimozione dell'attributo di quarantena / avvio di un binario non firmato da una nuova voce di avvio automatico / recupero di segreti del portachiavi da parte di un genitore con firma non Apple / esecuzioni di una riga di python3, perl e simili che decodificano e chiamano curl o simili in una riga (dalla 1.10.0) / avvii con DYLD_INSERT_LIBRARIES (dalla 1.10.0; è l'unica variabile d'ambiente letta) / esecuzione che indica direttamente i file di credenziali falsi di RoamSwitch / eliminazione o riduzione di snapshot locali da parte di qualcosa diverso dal sistema operativo e da RoamSwitch / ricerca di 8 o più tipi di strumenti di attacco entro 30 secondi / avvio di 3 o più tipi di strumenti di attacco entro 2 minuti da parte di un ambiente di esecuzione di script o di un agente IA / righe di comando a forma di reverse shell o bind shell.

Ogni rilevamento riporta un ID di tecnica MITRE ATT&CK.

Viene segnalata l'esecuzione di programmi non firmati (o con firma ad hoc) avviati da /tmp, /var/tmp, /Users/Shared o da /var/folders/…/T/ (il TMPDIR). Sono esclusi gli eseguibili che strumenti di sviluppo come Xcode, Go, Swift e Cargo creano in cartelle temporanee.

Valuta anche le regole Sigma collocate in ~/Library/Application Support/RoamSwitch/sigma.d (una parte di category: process_creation). Le regole non supportate non vengono caricate e il motivo è mostrato nella schermata dei registri. Non scarica regole. Una corrispondenza produce solo una notifica e una voce nella timeline; non blocca nulla e non modifica le impostazioni.

Solo i rilevamenti di gravità alta diventano banner, e quelli dello stesso tipo sono raggruppati in uno ogni 10 minuti (ogni evento resta nel registro). Gli strumenti di sviluppo come Claude Code e la CLI di GitHub che leggono le proprie credenziali non vengono notificati per impostazione predefinita. Se le legge un altro programma, l'azione «Consenti questo programma» della notifica consente solo quella voce (per Team ID se è firmato, altrimenti per nome dell'eseguibile, abbinato al nome della voce).

I registri sono leggibili solo da root (directory 0700, file 0600) e per impostazione predefinita si conservano 200 MB e 14 giorni. Le variabili d'ambiente non vengono salvate, ma gli argomenti possono contenere segreti. Una catena di hash permette di rilevare riscritture, lacune e rimozione dei sigilli. Tuttavia si tratta di rilevamento, non di prevenzione, e l'eliminazione o il ripristino a uno stato precedente dell'ultimo segmento non può essere rilevato.

Limiti: le esecuzioni prima dell'avvio dell'helper o prima dell'attivazione della registrazione non vengono registrate. eslogger osserva a posteriori e non può bloccare. Con carichi come migliaia di avvii di processo al secondo, alcuni eventi vanno persi (il conteggio è mostrato a schermo e il funzionamento continua). Questa registrazione non sostituisce un EDR (rilevamento e risposta sugli endpoint).

Honeytoken delle credenziali — 1.10.0, Pro, attivi per impostazione predefinita

Colloca falsi file di credenziali contenenti marcatori in ~/.aws/credentials, ~/.ssh/id_rsa_backup e ~/.docker/config.json. Un file reale già esistente non viene mai sovrascritto. Gli accessi vengono rilevati con kqueue e un controllo dell’ora di accesso ogni 30 secondi, e viene solo inviata una notifica, senza bloccare né isolare.

I nomi sono scelti in modo da non compromettere il normale funzionamento di ssh, AWS e Docker (0600 dalla 1.10.3). Li colloca anche in ~/.pypirc e ~/.env.backup. ~/.npmrc e le credenziali GCP non vengono usati come esca perché comprometterebbero il funzionamento legittimo. In caso di accesso, aggiunge una sola esca correlata e la catena si ferma a un passaggio.

La lettura di file di credenziali reali non può essere rilevata sul Mac. Il motivo è che non usa EndpointSecurity e non può vedere con certezza quale processo li ha aperti. Non colloca file falsi in posizioni come ~/.claude, che gli strumenti leggono ogni volta. In alternativa, la diagnosi complessiva agent_credential_files verifica i permessi e la posizione dei file di accesso degli agenti IA usando solo gli attributi. Non ne legge il contenuto.

La notifica mostra il percorso del file esca, il programma che lo ha letto (percorso e PID), il suo processo padre e il comando (i valori segreti sono mascherati). Se il processo che lo ha letto è già terminato e non è identificabile, lo dice. Con la registrazione dell'esecuzione dei processi attiva, elenca anche i comandi avviati intorno all'ora dell'accesso: un comando che nomina il file esca è un indizio forte, uno avviato solo alla stessa ora non lo ha necessariamente letto.

Monitoraggio dell'accesso alle credenziali del browser — 1.10.0, opt-in anche in Pro, disattivato per impostazione predefinita

Controlla tramite FSEvents le scritture nei database di password e cookie di Chrome, Firefox, Arc e altri, e rileva i processi diversi dal browser stesso e dai backup (identificati con lsof). Per Safari viene coperto solo il file dei cookie, e solo con l'accesso completo al disco. A differenza delle altre nuove protezioni, non si attiva automaticamente quando abiliti Pro. I falsi positivi causati da estensioni e software simili sono inevitabili.

Rilevamento continuo delle reverse shell e controllo delle impostazioni di rete (1.13.0, Pro, attivi per impostazione predefinita)

Con libproc legge ogni 4 secondi i processi dell'utente connesso e i loro descrittori di file aperti. Non usa comandi esterni e non legge il contenuto delle comunicazioni. Se vede per due volte di seguito che l'input/output di una shell, di nc o simili è la stessa connessione TCP in uscita, invia una notifica. Non termina né blocca nulla, e per la stessa coppia notifica al massimo una volta ogni 15 minuti. Sono coperte solo le connessioni verso indirizzi pubblici; i processi root non vengono esaminati.

A ogni cambiamento della configurazione di rete legge i server DNS e il router e li confronta con quanto visto in precedenza nella stessa rete. Non usa comandi esterni né comunicazioni. Notifica un server DNS mai visto, un PAC o un WPAD appena attivato, e notifica con maggiore enfasi quando router e DNS sono nuovi nello stesso momento. Non modifica le impostazioni e non blocca nulla; una modifica legittima si aggiunge manualmente alla baseline dal menu.

Limiti Entrambe le guardie funzionano solo con una licenza Pro e si disattivano se la licenza viene persa. Un server DHCP falso in sé non si vede. Solo la differenza nel risultato è un indizio. Un server falso che distribuisce gli stessi DNS e router di prima non viene trovato. I tunnel come una VPN, i DNS impostati a mano o con un profilo di configurazione e i profili DNS-over-HTTPS non vengono confrontati.

Comunicazione con il Sensor (TLS e firme)

Si collega a un RoamSwitch Sensor (un prodotto separato) della stessa LAN tramite TLS 1.3 con impronta (SHA-256) fissata (Sensor 0.3.9 o successivo). Il valore viene inserito dall'utente dalla schermata del Sensor e non viene ottenuto tramite la rete. Se TLS fallisce, non si passa al testo in chiaro, e le firme delle richieste includono data e ora e un nonce. Solo il vecchio formato senza impronta si collega in chiaro, con un avviso.

Se il certificato cambia, la connessione viene rifiutata. Il pin non viene aggiornato automaticamente; viene salvato solo quando l'utente inserisce e conferma un nuovo valore e una sonda firmata riesce effettivamente in un'andata e ritorno TLS. Limite: questa sonda non verifica con una chiave che quel Sensor sia lo stesso abbinato in precedenza. Presuppone che l'utente inserisca il valore confermato nella schermata del Sensor.

Rilevamento multilivello dei download (firme statiche + ClamAV) — livello di firme statiche aggiunto nella 1.8.7

I file appena collocati in Download, Scrivania e Documenti vengono prima confrontati con firme statiche (primi 4 MB, solo semplice corrispondenza di sequenze di byte). Funziona anche senza ClamAV. Sono coperte la firma di test EICAR, la cui accuratezza si può garantire senza campione, e 5 reverse shell di una riga classiche tratte da spiegazioni pubbliche (/dev/tcp/ in bash/sh, nc -e, Python pty.spawn, Perl Socket, PHP fsockopen). Non scriviamo come firme sequenze di byte di specifiche famiglie di malware senza un campione.

Solo i file giudicati «puliti» dalle firme statiche vengono poi analizzati con ClamAV. Vengono analizzati subito, indipendentemente dall'estensione .tmp o dalla presenza dell'attributo com.apple.quarantine. Le firme di test come EICAR vengono solo registrate nella cronologia delle notifiche; non vengono messe in quarantena né bloccate. Anche se esiste un file con lo stesso nome, la quarantena avviene in modo affidabile con un altro nome.

Rilevamento di web shell nelle cartelle web di sviluppo (Web Rules)

Controlla i file PHP, JavaScript e altri nelle cartelle locali di sviluppo web (~/Sites, MAMP, ecc.) con le stesse 20 regole della versione Linux. Le regole descrivono solo tecniche pubblicamente note e non contengono firme di campioni.

Le regole personalizzate si mettono in ~/Library/Application Support/RoamSwitch/rules.d (vengono letti solo i file di proprietà di root o dell'utente e non scrivibili da altri). L'aggiornamento avviene una volta al giorno, in sola ricezione. Le cartelle di sviluppo vengono controllate una volta al giorno e manualmente. Il rilevamento è solo a posteriori; nulla viene bloccato prima dell'esecuzione. Nella cartella delle sessioni PHP vengono letti solo i file sess_.

L'isolamento automatico riguarda per impostazione predefinita solo critical; per high si invia una notifica senza toccare il file. L'hook post-rilevamento esegue solo i file di proprietà di root o dell'utente e non scrivibili, con interruzione dopo 30 secondi. L'azione sull'account (disattivata per impostazione predefinita, l'attivazione richiede la password di amministratore) disattiva la login shell del proprietario, ma non fa nulla per root, per gli UID inferiori a 501 né per gli utenti connessi. Il percorso di conferma della password di amministratore non è ancora stato verificato su una macchina reale. Rilevamenti su 114.501 file delle cartelle di sviluppo: 0.

Monitoraggio di nuova persistenza di avvio (LaunchAgent/LaunchDaemon) — 1.8.7

Rileva tramite FSEvents i nuovi .plist in ~/Library/LaunchAgents, /Library/LaunchAgents e /Library/LaunchDaemons. La scrittura in sé non può essere fermata; viene notata subito dopo (entro pochi secondi) e se ne valuta il contenuto.

Il cardine del giudizio non è la firma dell'eseguibile, ma ciò che avvia direttamente. Una tecnica segnalata nel 2026 mette la malvagità nello script stesso e richiama /bin/bash o /usr/bin/osascript, legittimamente firmati. Perciò, quando un nuovo LaunchAgent/LaunchDaemon avvia direttamente un interprete come bash o python3, avvisa anche se la firma è valida, e sottopone alle firme anche gli argomenti. Per le registrazioni BundleProgram si fa solo la verifica con codesign --verify --strict.

Legge ed esamina ogni 5 secondi anche le posizioni di esecuzione automatica diverse da LaunchAgent. Sono i file di avvio della shell (come ~/.zshrc), ~/.ssh/rc, gli script periodici, gli hook git, gli hook di login/logout e gli script di azioni cartella. Il confronto avviene tramite lo SHA-256 del contenuto, e il primo passaggio si limita a registrare.

Notifica le righe a forma di reverse shell, di decifratura ed esecuzione, di download ed esecuzione, o di esecuzione di un programma da una cartella temporanea, e gli hook di login/logout configurati. Per i file di avvio, l'rc di SSH e gli hook git, si esaminano solo le righe appena aggiunte. Le scritture non possono essere fermate; si tratta solo di rilevamento.

Rilevamento di ClickFix e blocco di emergenza — 1.8.7, disattivato di default

«ClickFix» è una tecnica di ingegneria sociale in cui una falsa schermata CAPTCHA o di errore invita ad aprire il Terminale e a incollare un comando «per la verifica». Le rilevazioni sono aumentate di oltre il 500% dal 2024 al 2025, e entro il 2026 è considerata uno dei vettori di attacco macOS più diffusi. Poiché è la shell legittima dell'utente stesso a eseguire esattamente ciò che è stato digitato, elude completamente la verifica della firma di Gatekeeper.

Barra dei menu → «Protezione da malware» → protezione ClickFix (Pro, disattivata per impostazione predefinita). Monitora le righe aggiunte dopo l'avvio a ~/.zsh_history e ~/.bash_history, e rileva solo i comandi di una riga di reverse shell e le forme che decodificano Base64 e lo passano a una shell o a osascript. curl | bash da solo è escluso, perché non si distingue dalle istruzioni di installazione ufficiali. Al rilevamento attiva un Air-Gap di emergenza, che può fermare download aggiuntivi o l'invio di credenziali in corso (rilascio automatico dopo al massimo 10 minuti).

Limite noto. Poiché il rilevamento presuppone la cronologia della shell, non può gestire le varianti fileless che richiamano Script Editor tramite un URL applescript:// senza passare da Terminal. Anche l'esame del registro unificato (log show/log stream) su una macchina reale non ha dato alcun segnale utilizzabile per il giudizio. Lo dichiariamo come limite invece di affermare falsamente di supportarlo.

Rilevamento rischi Docker — 1.8.9, Pro, disattivato per impostazione predefinita

Barra dei menu → «Protezione da malware» → «Rileva container Docker privilegiati e mount di docker.sock» (DockerEventGuard). Ogni 20 secondi ottiene gli ID dei container con docker ps -q ed esamina solo quelli appena avviati con docker inspect --format. Con le stesse condizioni della versione Linux, rileva un avvio con --privileged o un bind mount di /var/run/docker.sock.

Anche quando rileva, non blocca automaticamente. I container privilegiati e i mount di docker.sock sono impostazioni pericolose, ma non confermano una compromissione e hanno usi legittimi. Poiché pochi utenti ne hanno bisogno, è disattivata per impostazione predefinita anche in Pro. Non usa l'entitlement EndpointSecurity. È stata provata con 3 schemi su un Docker Desktop reale (29.7.2), verificando l'assenza di falsi positivi e di rilevamenti mancati.

Controllo fughe di segreti/chiavi API — aggiunto in 1.8.4, scansione cartelle aggiunta in 1.8.9

Barra dei menu → «Protezione da malware» → «Audit delle fughe di segreti e chiavi API». Cerca chiavi API e token trapelati nel testo incollato o in una cartella scelta (dalla 1.8.9, ricorsivo), e mostra numeri di riga, stringhe mascherate e azioni consigliate. Salta .git, node_modules e simili, oltre ai file superiori a 2 MB e ai binari. Completamente locale; non viene inviato nulla all'esterno.

Link Guard (blocco delle connessioni di phishing) — 1.7.2 e versioni successive, rafforzato in 1.8.0

Barra dei menu → "Protezione malware" → "Link Guard" (Pro). Blocca le connessioni a siti di phishing/truffa sul dispositivo, su ogni browser e app. Esistono due punti di applicazione, utilizzati insieme in ordine di priorità.

  • ① Estensione di sistema come filtro dei contenuti (dalla 1.8.0; ha la precedenza dopo l'approvazione). È un'estensione NEFilterDataProvider e non richiede alcuna richiesta ad Apple. Vede i flussi TCP in uscita dopo la risoluzione dei nomi. Il nome di destinazione deriva dal nome risolto dal sistema operativo o dal SNI del TLS ClientHello, quindi può bloccare anche quando il browser usa DoH/DoT. Non riscrive /etc/hosts. QUIC (UDP/443) viene scartato in modalità block, costringendo il ritorno a TCP. L'approvazione serve solo la prima volta.
  • ② /etc/hosts sinkhole (fallback, mentre l'estensione non è approvata/rifiutata). L'helper privilegiato scrive i domini di destinazione in una sezione gestita delimitata di /etc/hosts come 0.0.0.0 e svuota la cache. Limite massimo a 60.000. Una volta attiva l'estensione, questa sezione verrà rimossa.
  • Tre modalità. "Off" lo disabilita. "Chiedi prima (blocca senza risposta)" mette in pausa la connessione corrispondente, chiede all'utente e la blocca senza risposta (vedi Real warn di seguito). "Blocco automatico dei siti truffa evidenti (consigliato)" viene eliminato immediatamente. L'impostazione predefinita è blocco a partire dalla versione 1.7.2.
  • warn reale (dalla 1.8.0, solo estensione). Con .pause(), il flusso corrispondente viene trattenuto e l'app mostra una notifica «Consenti/Blocca». Quando arriva il risultato scelto (l'estensione controlla ogni 1,5 secondi), il flusso viene lasciato passare o scartato; se non c'è risposta per 25 secondi, viene lasciato passare. La decisione viene ricordata per host (consenti 5 minuti / blocca 1 ora). Il «Consenti questa volta (5 minuti)» di block termina dopo 5 minuti anche se l'app viene riavviata.
  • Solo i casi chiari vengono bloccati. Un elenco nel feed delle minacce o un omografo Unicode di un marchio: tutto il resto (TLD ad alto rischio, impersonificazione di sottodomini, ...) è un avvertimento. Il motore del verdetto è condiviso con l'edizione Linux e non invia URL da nessuna parte.
  • Le comunicazioni verso server esterni di diagnostica (OAST) generano solo una notifica. Notifica quando la destinazione è un server OAST come interact.sh o oast.pro, o un suo sottodominio. Sono destinazioni che gli strumenti di diagnostica SSRF e RCE usano per confermare l'esito e a cui le normali app si collegano raramente. La comunicazione non viene fermata né trattenuta, nemmeno in modalità avviso. Le notifiche per lo stesso host sono limitate a una all'ora. Non notifica quando manca l'estensione di sistema e quando la protezione dei link è disattivata.
  • Recupero da un blocco sbagliato. Consenti un dominio dalla notifica o dal menu (5 minuti o permanente). L'elenco consentito viene sottratto quando la sezione viene rigenerata.
  • Pro-gate. L'applicazione (applyMode()) avviene solo su una licenza Pro valida. Senza Pro la modalità viene memorizzata ma /etc/hosts non viene mai toccata. L'attivazione o la decadenza di una licenza ha effetto a metà sessione.
  • Feed e seed in bundle. L'elenco dei blocchi proviene dal feed delle minacce firmato (§7, verificato con una chiave dedicata al feed). Funziona sul seed in bundle dell'app (~ 60.000 voci) anche prima del primo recupero e la disattivazione dell'"Aggiornamento automatico" significa assenza di traffico in uscita.

Blocco preventivo ARP/NDP del gateway: 1.7.5 e versioni successive

Barra dei menu → "Monitoraggio porta e dispositivo" → "Aggiungi ARP/NDP del gateway su reti non attendibili (preventivo)" (Pro, disattivato per impostazione predefinita).

  • Come funziona. Quando ci si connette a una rete non attendibile, raccoglie i MAC del gateway IPv4, del router IPv6 e del resolver DNS sullo stesso link, e l'helper li fissa come voci permanent con arp -s / ndp -s (TOFU: ci si fida del primo MAC visto). Da quel momento le risposte ARP/NDP falsificate vengono ignorate e gli attacchi man-in-the-middle sono prevenuti in anticipo.
  • Scope. Vengono bloccati solo questi tre tipi di voce. Le reti affidabili (aperte) non vengono mai bloccate. Ad ogni modifica della rete si sblocca una volta e si ricollega. I risolutori pubblici off-link (8.8.8.8, …) non hanno alcuna voce ARP on-link e sono automaticamente esclusi.
  • arp -s è preventivo; l'air-gap è successivo al fatto. Questo pin esiste quindi uno spoofing non può avere successo; Il rilevamento dello spoofing ARP (ARPSpoofContainmentManager) e l'air-gap di emergenza esistono per "tagliare più velocemente di un essere umano" una volta che ne viene visto uno. Corrono in modo indipendente.
  • Persistenza. Il set di pin viene salvato in /Library/Application Support/RoamSwitch/gateway_arp_lock.json in modo che possa essere sbloccato tramite una riconnessione XPC o un riavvio dell'assistente.

Il tunnel VPN (WireGuard/Tailscale) e il suo kill switch — 1.7.6 e versioni successive, backend selezionabile nella 1.8.0

Barra dei menu → "Monitor porta e dispositivo" → "Tunnel VPN" (Pro, disattivato per impostazione predefinita). Questa è la difesa primary anti-MITM: non dipende dall'integrità di L2 (ARP/NDP). Il backend è selezionabile (sottomenu → "Backend") tra "WireGuard (file di configurazione)" e "Tailscale (Nodo di uscita)". RoamSwitch non implementa alcuna crittografia stessa; solo il backend scelto è armato.

  • (A) Backend WireGuard. Non usa Network Extension e richiama wireguard-tools di Homebrew. L'helper salva la configurazione importata (.conf) con 0600. Il kill switch è il block drop all di pf, che lascia passare solo loopback, il tunnel, UDP verso l'endpoint, DHCP e ICMP. Avvisa per le configurazioni che non sono full-tunnel.
  • (B) Backend Tailscale (da 1.8.0). RoamSwitch non esegue il login e non installa nulla. Legge soltanto tailscale status --json ed esegue tailscale set --exit-node=<nodo>. Si consiglia la versione Standalone con integrazione CLI. Con la versione App Store, l'Exit Node si sceglie nell'app Tailscale. L'Exit Node è obbligatorio e, se non è raggiungibile, viene rimosso automaticamente.
  • ⚠️ La versione Homebrew (brew install tailscale) è sconsigliata. Ha un bug noto che le impedisce di modificare correttamente il routing di macOS (tailscale/tailscale#21395, #21216): il traffico può uscire anche quando viene indicato «successo», e la connessione può cadere alla rimozione. RoamSwitch verifica il routing effettivo e avvisa, ma con la versione Standalone il problema non si presenta.
  • Riconfigurazione della rete alla disconnessione. Il macOS autonomo tailscaled non ripristina in modo pulito il routing + DNS quando un nodo di uscita viene cancellato, quindi RoamSwitch rimbalza i servizi di rete attivi (lo stesso che attivare manualmente il Wi-Fi; solo servizi con un indirizzo IPv4, sicuro per multi-NIC e IP statico). Il traffico diminuisce per circa 5-10 secondi e il livello di protezione non viene abbassato durante tale periodo.
  • Il kill switch di Tailscale è disattivato per impostazione predefinita (opt-in). Il nodo di uscita esegue già il tunneling di tutto; il pf block drop all (consente solo CGNAT/MagicDNS/STUN/DERP/DHCP/ICMP/DNS) è per utenti avanzati ed è "resistente alle perdite, non a prova di perdite" (il DNS è consentito, quindi tailscaled sopravvive).
  • Automatico / in caso di perdita della licenza. Si attiva su reti non attendibili, diminuisce su quelle attendibili; revocato alla scadenza della licenza Pro.

§6

Quando ti connetti a una rete che non hai registrato, l'interruttore del "livello di protezione" non viene utilizzato pf. Modifica semplicemente le impostazioni standard del sistema operativo in un modo che può essere invertito in seguito.

Operazioni per livello di protezione
OperazioneAttuazionePrivilegioCome viene ripristinato
Firewall + modalità invisibile attiva socketfilterfw --setblockall attivo / --setstealthmode attivo radice (aiutante) off quando ritorni su una rete sicura
Interrompi SSH/SMB/Condivisione schermo launchctl scarica -w radice (aiutante) Registra solo quelli che erano in esecuzione al momento dell'arresto e load -w al ritorno (con SSH accoppiato anche a /usr/sbin/systemsetup -setremotelogin on per un ripristino macOS moderno garantito)
Disabilita AirDrop le impostazioni predefinite scrivono com.apple.sharingd DiscoverableMode Utente (l'app stessa) Salva il valore precedente e lo riscrive al ritorno

Niente di tutto questo è un nuovo meccanismo di blocco aggiunto da RoamSwitch: si tratta semplicemente di attivare/disattivare le impostazioni del sistema operativo. Se elimini l'app, l'unica cosa che si ferma è la commutazione dipendente dalla rete; l'ultimo sistema operativo le impostazioni applicate rimangono invariate. Niente viene lasciato bloccato, ma se vuoi sbagliare sul per sicurezza, reimpostarlo su "Aperto" su una rete attendibile prima di disinstallarlo.

§7

Cosa rimane sul Mac

Dati archiviati su disco
DatiPosizioneContenuto
Token di licenzaPortachiavi
com.tetsuharu.RoamSwitch.license
Un token firmato Ed25519. kSecAttrAccessibleAfterFirstUnlock
Impostazioni app/attivazione/disattivazione protezioneUserDefaults suite
com.tetsuharu.RoamSwitch
Registrazioni di reti attendibili, criteri di protezione, elenchi di esclusione e così via
stato pf/Libreria/Supporto applicazioni/RoamSwitch/Il timestamp dell'air gap, il JSON delle porte protette, lo stato del kill switch della VPN, il file temporaneo per il set di regole applicato
Feed delle minacce di Link Guard~/Library/Application Support/RoamSwitch/threatfeed/feed.txtL'elenco dei domini di phishing/truffa scaricati (o il seed in bundle dell'app se non ancora recuperato). La versione del feed è in UserDefaults
Sezione gestita Link Guard/etc/hostsUna sezione delimitata da # BEGIN RoamSwitch link guard … # END, annullando i domini bloccati a 0.0.0.0. Rimosso quando la modalità è "Off" (§5)
Perni di bloccaggio ARP/NDP/Libreria/Supporto applicazioni/RoamSwitch/gateway_arp_lock.jsonL'insieme IP → MAC effettuato permanent dal blocco preventivo (§5). Eliminato quando sbloccato
Configurazione WireGuard/Libreria/Supporto applicazioni/RoamSwitch/ (area assistenza, 0600)Il .conf importato dall'utente. Anche il nome host dell'endpoint è nascosto in UserDefaults (l'app lo risolve)
UUID di fallback del dispositivoUserDefaultsUn valore casuale, generato solo quando IOKit non restituisce un UUID (§9)
Registrios.Logger/NSLogRegistrazione unificata. Nulla viene inviato all'esterno

Traffico in uscita dalla macchina (l'elenco completo)

Non esiste alcun codice che raccolga e invii risultati diagnostici, informazioni sulle porte, URL o log. Non è incluso alcun SDK di analisi né di segnalazione dei crash. L'unica libreria esterna è Sparkle (aggiornamenti). Il traffico di rete in uscita si limita ai 9 percorsi della tabella seguente, alle funzioni avviate dall'utente, alle funzioni disattivate per impostazione predefinita e alla protezione DNS dalle minacce descritte sotto la tabella (il 6° solo se l'utente ha configurato una VPN, il 7° solo se è attivo l'abbinamento di RoamSwitch Sensor, il 9° solo se è attivo l'inoltro degli eventi e si è inserita una destinazione).

Connessioni in uscita effettuate da RoamSwitch
ConnessioneDestinazioneQuando succedeCosa viene inviato
Attivazione/disattivazione della licenza lafine.net
/api/v1/license/*
Solo quando l'utente inserisce una chiave di licenza o disattiva Pro Chiave di licenza, hash del dispositivo, nome del dispositivo (il «Nome» in Impostazioni di Sistema) e versione dell'app. Al rilascio, solo chiave e hash. Le informazioni personali sono gestite da Stripe all'acquisto; l'app non le gestisce
Controllo degli aggiornamenti lafine.net
/updates/appcast.xml
Sparkle controlla ogni 24 ore (e anche all'avvio se dall'ultimo controllo sono trascorse 24 ore o più). Sempre attivo per impostazione predefinita; non vengono inviate informazioni di sistema Una richiesta HTTP (un UA e una versione standard). L'elemento scaricato è verificato dalla firma EdDSA (§10)
Feed delle minacce di Link Guard lafine.net
/updates/v1/{manifest, feed/.txt}
Nella versione Pro, quando l'«Aggiornamento automatico» della protezione dei link è attivo (impostazione predefinita): ogni 24 ore (e all'avvio). Disattivando l'«Aggiornamento automatico» questo percorso scompare Solo GET. Nessuna stringa di query, nessun cookie, nulla che identifichi il dispositivo (lo User-Agent standard include nome e versione dell'app e la versione di macOS). Un file statico firmato di sola ricezione; il manifest e il corpo del feed sono verificati con Ed25519. La chiave di firma è dedicata al feed ed è una chiave distinta dalla SUPublicEDKey degli aggiornamenti dell'app (così una fuga resta limitata a «una blocklist errata»)
Dati di aggiornamento della verifica CVE dei pacchetti / della verifica attiva delle vulnerabilità lafine.net
/updates/v1/manifest
La verifica avviene ogni 24 ore e il recupero effettivo una volta a settimana (anche all'avvio dell'app se sono trascorsi almeno 7 giorni dall'ultimo recupero). L'elenco KEV, invece, viene recuperato ogni giorno. I dati di aggiornamento per la corrispondenza CVE dei pacchetti vengono sempre recuperati. Sono dati in sola ricezione, usati solo per la corrispondenza locale; non esiste un'impostazione per disattivarli e valgono per tutti gli utenti, compresa l'edizione Free. La mappa CVE della diagnosi di vulnerabilità basata su prove viene recuperata solo se è attiva «Diagnosi di vulnerabilità basata su prove (verifica attiva della raggiungibilità)» Solo GET. Non ci sono stringhe di query, cookie né informazioni che identifichino il dispositivo (lo User-Agent standard include nome dell'app, versione e versione di macOS). Sono file statici firmati in sola ricezione; il manifest e il feed stesso sono verificati con Ed25519. Chiave e manifest sono in comune con il feed delle minacce della protezione dei link, ma i feed recuperati sono file distinti (mappe CVE note per Homebrew/npm/PyPI/crates.io/RubyGems/Packagist/Go/Maven, la mappa CVE della diagnosi di vulnerabilità basata su prove e un elenco di nomi di pacchetti npm popolari per il rilevamento del typosquatting)
Aggiornamento della definizione del virus ClamAV Specchi ufficiali ClamAV Quando l'utente ha installato ClamAV. Nella versione Pro avvia freshclam automaticamente all'avvio, ogni 24 ore e durante i giri di controllo autonomi; nella versione Free solo quando si preme «Aggiorna definizioni dei virus» nel menu Il normale recupero delle definizioni di ClamAV. Non contiene informazioni provenienti da RoamSwitch (possono essere incluse le informazioni identificative standard di ClamAV stesso)
Tunnel VPN (§5, WireGuard / Tailscale) L'endpoint WireGuard configurato dall'utente, oppure il control plane di Tailscale (Tailscale, Inc.) Solo quando è configurato un tunnel VPN (Pro, disattivato per impostazione predefinita) e ci si connette a una rete non attendibile. Con WireGuard, il nome host dell'endpoint viene risolto via DNS una volta prima dell'avvio del tunnel. Con Tailscale, il traffico del piano di controllo proviene dal tailscaled che l'utente ha installato e a cui ha effettuato l'accesso; RoamSwitch stesso si limita a leggere tailscale status --json ed eseguire tailscale set --exit-node= Con WireGuard: l'handshake WireGuard (UDP) e il traffico all'interno del tunnel. La destinazione è il server VPN dell'utente e i contenuti sono il traffico dell'utente. Con Tailscale: traffico tra l'account Tailscale dell'utente e il control plane di Tailscale, Inc. (registrazione del dispositivo, relay DERP, ecc., regolato dall'informativa sulla privacy di Tailscale). In entrambi i casi RoamSwitch non aggiunge alcun identificatore né dati diagnostici
Associazione e collegamento di audit di RoamSwitch Sensor RoamSwitch Sensor sulla stessa LAN (hardware configurato dall'utente stesso, in esecuzione con un IP fisso) Solo quando è attivata «Associazione RoamSwitch Sensor» (Pro, disattivata per impostazione predefinita) e si inserisce l'indirizzo IP e il codice di abbinamento di Sensor per associarsi (uno scambio una tantum). Dopo l'associazione, si riconnette allo stesso IP fisso solo quando si preme «Richiedi controllo al Sensor», e durante il recupero automatico del risultato (a partire da 5 minuti dopo la richiesta, poi ogni 5 minuti, fino a 5 tentativi) L'associazione invia il nome host e la chiave pubblica Ed25519 di questo endpoint, e riceve la chiave pubblica rilasciata da Sensor. Le richieste di controllo e il recupero dei risultati sono autenticati con una firma Ed25519 — vengono inviate solo richieste firmate. I risultati diagnostici e le informazioni sulla porta vengono ricevuti solo come risposta di Sensor; il contenuto dei file non viene mai inviato. L'unica destinazione è l'indirizzo IP fisso del Sensor configurato dall'utente stesso — non raggiunge mai alcun server esterno, incluso lafine.net. La fiducia reciproca si stabilisce solo tramite lo scambio esplicito del codice di abbinamento
Pagina di pagamento Pagamento a strisce Solo quando l'utente preme il pulsante Acquista (si apre nel browser) — (una navigazione nel browser)
Inoltro degli eventi (SIEM, syslog, webhook) Il server syslog o l'indirizzo del webhook inserito dall'utente, oppure un file scelto dall'utente Solo quando «Inoltro degli eventi» (Pro, disattivato per impostazione predefinita) è attivo e una destinazione è stata inserita. Altrimenti questo percorso non ha né thread né socket Degli incidenti e delle notifiche registrati da RoamSwitch, solo questi campi: nome host, ID evento, ora, tipo, gravità, regola, azione eseguita, ID e nome del processo e un riepilogo (fino a 1024 byte). Non include contenuto di file, schermo né testo digitato. La destinazione è sotto il controllo dell'utente e nulla raggiunge i server dello sviluppatore, lafine.net compreso. TLS verifica la catena di certificati e il nome host e non invia nulla se non è possibile verificarli. L'indirizzo del webhook e la chiave HMAC sono nel portachiavi e passati a curl dallo standard input, non come argomenti
Ambito di "Zero Telemetry"

«Zero Telemetry» significa che non c'è telemetria che raccolga e invii dati d'uso o risultati diagnostici. Non significa che non ci sia alcuna comunicazione. I 9 percorsi della tabella precedente e le funzioni descritte sotto la tabella esistono davvero. Ognuno è una comunicazione avviata da un'azione dell'utente, un recupero in sola ricezione con verifica della firma, oppure una comunicazione con un servizio esterno scelto dall'utente (l'origine di distribuzione di ClamAV, il provider DNS protettivo, l'URL da verificare e così via). I risultati diagnostici, le porte e il contenuto dei file del Mac non vengono mai inviati allo sviluppatore.

Il feed delle minacce della protezione dei link (riga 3) aggiunge un «aggiornamento in sola ricezione» alla politica «non inviare nulla». Anche il white paper Linux §1.1 distingue «Zero Telemetry» dagli «aggiornamenti in sola ricezione». Se si disattiva «Aggiornamento automatico», la protezione dei link funziona solo con i dati inclusi (circa 60.000 domini di phishing/truffa) e il rilevamento degli omografi offline, e questo percorso non si verifica.

Il tunnel VPN (riga 6) avviene solo se l'utente configura il proprio server WireGuard, oppure sceglie il backend Tailscale ed è già connesso a tailscaled con il proprio account Tailscale; la destinazione e i contenuti sono sotto il controllo dell'utente. RoamSwitch si limita ad attivare il tunnel, mantenere il kill switch, o leggere lo stato di Tailscale per cambiare il nodo di uscita — non aggiunge alcun identificatore né dati di utilizzo. Senza una VPN configurata, questo percorso non esiste.

L'associazione RoamSwitch Sensor (riga 7) è una funzione esclusiva Pro, disattivata per impostazione predefinita; questo percorso non esiste a meno che tu non lo attivi. L'associazione stessa si stabilisce solo tramite un'azione esplicita: l'inserimento del codice di abbinamento rilasciato dall'operatore del Sensor insieme all'indirizzo IP fisso del Sensor. Ogni comunicazione successiva (richieste di controllo, recupero dei risultati) è indirizzata anch'essa a quello stesso IP fisso di proprietà dell'utente ed è autenticata con una firma Ed25519. Non raggiunge mai alcun server esterno, incluso lafine.net. I risultati diagnostici o il contenuto dei file non vengono mai inviati, se non come risposta dello stesso Sensor.

L'inoltro degli eventi (riga 9) è una funzione solo Pro e disattivata per impostazione predefinita; finché non è attivata e non è inserita una destinazione, questo percorso non esiste. Vengono inviati solo i campi elencati nella colonna «contenuto inviato» della riga, verso un SIEM, un server syslog, un webhook o un file controllato dall'utente. Nulla raggiunge i server dello sviluppatore. Un incidente include il nome e l'ID del processo coinvolto, che quindi l'amministratore della destinazione può vedere. Se non è desiderato, lascia la funzione disattivata. Gli eventi non inviati vengono conservati, solo per TCP, TLS e webhook, in una coda sul disco di questo Mac (0600) e reinviati con intervalli crescenti.

Ci sono 5 comunicazioni che non compaiono nella tabella, e nessuna invia risultati diagnostici o contenuto dei file allo sviluppatore. (1) Mentre la protezione DNS dalle minacce di Pro è attiva (per impostazione predefinita fuori casa o su Wi-Fi non attendibili), le richieste arrivano a uno tra Quad9, Cloudflare, AdGuard e CleanBrowsing. (2) La verifica delle firme npm di Pro interroga ogni volta il registro npm. (3) La diagnosi di vulnerabilità basata su prove riguarda solo 127.0.0.1. (4) L'HEAD della diagnosi di sicurezza dei link è descritto nel paragrafo seguente. (5) Il «controllo dei domini», solo quando lo si preme, interroga i domini inseriti (fino a 20) presso un resolver DNS, il server RDAP del TLD e, se c'è un MX, l'host mta-sts.

Il foglio «Diagnosi di sicurezza dei link» dell'app invia una richiesta HEAD all'URL di destinazione per verificare dove porta un URL abbreviato (il seguimento verso indirizzi privati o locali è stato interrotto dalla protezione SSRF della v1.4.5). L'audit_url_safety di MCP, invece, è un'analisi offline che si conclude sul posto e non invia l'URL da nessuna parte (§8).

Misurato (2026-08-29), esito PASS

Il 2026-08-29 ho verificato la versione 1.4.7 in esecuzione per circa 2 ore con tcpdump, nettop / lsof e LuLu (blocco massimo, controllo appcast forzato). Risultato: il solo traffico in uscita dei 3 processi di RoamSwitch era il controllo appcast verso lafine.net. I socket del server MCP erano solo su localhost. Il dump degli entitlements era vuoto. I percorsi aggiunti da allora sono nella tabella precedente; è prevista una nuova misurazione della versione attuale.

Descrizione completa e uno script che chiunque può eseguire per riprodurlo: audit/RESULTS-2026-08-29.md

Da allora sono stati aggiunti il feed delle minacce (1.7.2, riga 3 della tabella precedente), il tunnel VPN (1.7.6, riga 6), i dati di aggiornamento per la corrispondenza CVE dei pacchetti (riga 4), l'abbinamento di Sensor (riga 7) e altro. Nella versione attuale si vedono GET in sola ricezione verso lafine.net e, con una VPN configurata, UDP verso il proprio server WireGuard. Il feed delle minacce scompare con «Aggiornamento automatico: disattivato» e la VPN con «VPN non configurata», ma l'appcast e i dati di aggiornamento non si possono disattivare.

§8

RoamSwitchMCPServer è uno strumento da riga di comando autonomo incluso in RoamSwitch.app/Contents/MacOS/. Un client MCP come Claude Desktop lo avvia come sottoprocesso e comunica tramite stdio (JSON-RPC 2.0 delimitato da a capo).

Ciò che il design vincola

  • Non c'è nemmeno uno strumento che modifichi impostazioni, difese, porte o dispositivi. Si scrive solo quando 3 strumenti aggiornano i propri registri (cronologia diagnostica, valori di riferimento dei log e cronologia delle notifiche, cache e log propri di npm). Perché un LLM non possa modificare le difese, le API per cambiare livello, isolare porte ed espellere dispositivi non sono state volutamente previste.
  • Non apre alcun socket in ascolto. Non registra alcun servizio e non si mette in ascolto. Legge una riga da stdin, restituisce una riga su stdout e poi il client termina il processo.
  • Non viene inviata alcuna telemetria. L'unica comunicazione verso l'esterno è run_npm_audit_signatures (registro npm), opzionale (su Mac solo Pro). Nella Server Edition per Linux, solo per i domini che l'operatore ha scritto in domain_check_domains, la diagnosi interroga il resolver DNS e il server RDAP del TLD e, se c'è un MX, legge anche il file di policy MTA-STS. run_active_vuln_scan (disattivato per impostazione predefinita), get_exposed_ports su Mac (un HTTP GET per porta) e il controllo web della Server Edition vanno a 127.0.0.1. I 4 strumenti diagnostici del Mac possono inviare un ping, di solito 1 (al massimo 3), per verificare il MAC del gateway. Su Linux, solo get_guard_status può inviarne 1.
  • Le impostazioni vengono lette da un altro dominio. Il dominio dell'app viene specificato esplicitamente con UserDefaults(suiteName: "com.tetsuharu.RoamSwitch") e da lì si legge (il dominio del proprio bundle ID è vuoto). Si limita a leggere e non scrive mai.

Gli strumenti che espone

I principali strumenti restituiti da tools/list e i dati che restituiscono (l'elenco completo è in Configurazione MCP)
StrumentoCosa restituisceTraffico
get_security_reportUn controllo a 23 voci (FileVault / SIP / Gatekeeper / aggiornamento automatico / XProtect / firewall / crittografia Wi-Fi / ARP / pinning ARP del gateway / audit configurazione SSH / audit sudo NOPASSWD / porte esposte / rilevamento automatico del proxy / file di credenziali degli agenti IA / backup / vulnerabilità probabilmente sfruttate / configurazione delle guardie, e altro) con un punteggio e consigli di correzione per voce. Ogni voce riporta anche gli ID dei controlli NIST CSF 2.0 e CIS Controls v8 corrispondenti (da 1.10.0).Solo locale (può essere inviato un ping al gateway della LAN per ricavarne il MAC; get_security_report e verify_security_findings su Linux non ne inviano)
verify_security_findingsRivaluta le voci di get_security_report in base allo stato attuale e restituisce stillPresent, resolved o inconclusive, con il motivo. Serve a confermare che una correzione abbia avuto effetto. Le voci non misurabili non sono mai considerate sicure e diventano inconclusive. Senza checkIds vengono valutate tutte le voci (fino a 50 su Mac e 64 su Linux). Alcune voci di Mac dipendono da valori delle impostazioni dell'app. È di sola lettura e non esegue riparazioni né modifiche alle impostazioni. Il risultato include verificationStatus e rationale e, se la voce è ancora presente, counterEvidence e severityChangesIf.Solo locale (può essere inviato un ping al gateway della LAN per ricavarne il MAC; get_security_report e verify_security_findings su Linux non ne inviano)
audit_mcp_configsLegge i file di configurazione MCP dei client IA (Claude Desktop, Cursor e altri, oltre a .mcp.json nelle cartelle registrate) e segnala l'approvazione automatica senza conferma, http:// in chiaro, versioni di npx non fissate e simili. È di sola lettura e non invia nulla. Non restituisce valori né segreti, solo elementi come i nomi dei server. I file che non possono essere analizzati sono elencati in unreadableFiles.Nessuno
audit_agent_setupLegge i file di istruzioni, le skill e le impostazioni degli agenti IA (Claude Code, Codex e altri), oltre alle attività di VS Code e alle GitHub Actions nelle cartelle registrate, e segnala testo nascosto con caratteri invisibili, istruzioni che scaricano ed eseguono così com'è, permessi troppo ampi e simili. Una corrispondenza è un punto da verificare, non un giudizio di malevolenza. È di sola lettura, non invia nulla e non restituisce il testo né segreti. Con format=sarif restituisce SARIF 2.1.0.
get_detection_coveragePer ogni tecnica MITRE ATT&CK usata per indebolire le difese, cancellare le tracce o persistere, restituisce se è rilevabile (detects / partial / none), la parte non visibile (blindSpot) e lo stato della protezione (liveState). Non esegue nulla e non invia nulla. none non significa che non ci sia stato un attacco, e liveState non è una prova del funzionamento. Con format=navigator restituisce un livello ATT&CK Navigator (4.5).Nessuno
get_porte_esposteElenco delle porte TCP in ascolto. Per ogni porta esposta oltre localhost, viene confrontata con un DB di servizi pericolosi noti e viene inviato un solo HTTP GET a 127.0.0.1:port (locale, chiuso) per controllare CORS e intestazioni.La sonda su 127.0.0.1 e un ping al gateway (Mac)
get_guard_statusLo stato di attivazione/disattivazione delle protezioni di risposta automatica Pro (anomalia porta/ARP/USB/Bluetooth/download Web+Mail/protezione dalle minacce DNS), il livello di protezione corrente e lo stato della rete attendibileSolo locale (può essere inviato un ping al gateway della LAN per ricavarne il MAC; get_security_report e verify_security_findings su Linux non ne inviano)
audit_url_sicurezzaValuta gli URL per phishing, omografi (inganno Unicode), imitazione di marchi tramite sottodomini, TLD ad alto rischio e HTTP in chiaro. È sincrono e completamente offline (analyzeURL; i reindirizzamenti non vengono seguiti). Le grafie neutralizzate dei report sulle minacce (come hxxps://evil[.]example/login) vengono riportate all'indirizzo originale prima della valutazione.Nessuno
get_app_helpUna ricerca nel testo completo della knowledge base in bundle (specifiche delle funzionalità/impostazioni/risoluzione dei problemi/spiegazioni dei messaggi di notifica)Nessuno
audit_secretsRileva la fuga di chiavi API e chiavi private in testo, file e directory (i valori rilevati vengono mostrati mascherati). Per le directory, impostando a true l'argomento facoltativo include_build_output (booleano) si leggono anche le cartelle del front-end pubblicato, come dist e build, che la scansione ricorsiva salta (al risultato si aggiunge buildOutput).Nessuno
audit_security_logsAggrega i log di sicurezza recenti (autenticazioni Sudo non riuscite, forza bruta SSH, blocchi del firewall e così via; su Mac anche Gatekeeper e XProtect, su Linux anche AppArmor e ClamAV) e li restituisce con i segreti, come chiavi API e token, oscurati. Include anche i risultati del rilevamento di nuovi pattern e di anomalie di frequenza (picchi statistici). Su Linux, se non è stato possibile leggere il journal, non considera 0 elementi come «non è successo nulla»; imposta journalReadComplete su false e inserisce il motivo in journalError.Solo locale
run_active_vuln_scanUna verifica delle vulnerabilità non distruttiva che ha come bersaglio solo 127.0.0.1. Poiché è uno strumento che invia richieste di rete, è disattivato per impostazione predefinita. Su Mac riporta anche gli effetti collaterali di ciascun controllo (sideEffects in probesRun, per esempio più di 5 richieste a una porta). I riscontri distinguono ciò che è stato confermato (confirmed) dai casi in cui solo la versione rientra nell'intervallo interessato (version_range_match).Solo 127.0.0.1 (disattivato per impostazione predefinita)
run_package_cve_scanConfronta i pacchetti installati (Homebrew / dpkg, dnf e così via) con la mappa CVE locale. Non effettua alcuna comunicazione di rete. Se non si riesce a ottenere l'elenco, imposta complete su false. Per Ubuntu (da 20.04 a 26.04) confronta solo i CVSS 7.0 e superiori per cui esiste una versione corretta, quindi «nessuna corrispondenza» non significa che non ci siano CVE. Su Mac l'ordine è gravità e poi EPSS (epss). Per i rilevamenti accettati da una persona restituisce il conteggio (acceptance); l'accettazione non è possibile tramite MCP.Nessuno
run_package_cve_scan_languagesConfronta i lockfile delle dipendenze di npm, PyPI, crates.io e altri con la stessa mappa CVE locale. Non effettua alcuna comunicazione di rete.Nessuno
run_package_lifecycle_script_scanUn inventario degli script nei file package.json di node_modules che vengono eseguiti a ogni npm install (preinstall, install, postinstall, prepare). Le forme come curl | sh, eval e base64 -d ricevono isDangerPattern, e ciò che viene aggiunto dopo lo stato confermato compare in drift. Le cartelle registrate vengono controllate automaticamente quando cambiano i lockfile o simili, subito dopo l'avvio e una volta al giorno, e vengono esaminate anche le dipendenze con nomi simili (non si invia né si esegue nulla). Solo una persona, dalla schermata, può contrassegnare uno stato come confermato. È una funzione Pro ed è attiva per impostazione predefinita.Nessuno
run_dependency_source_scanSegnala le impostazioni che consentono la dependency confusion (un attacco in cui un pacchetto pubblico con lo stesso nome viene installato al posto di uno interno). Riguarda extra-index-url di pip (requirements*.txt, pip.conf, pyproject.toml, uv.toml) e i lockfile npm in cui .npmrc non fissa l'origine di un @scope. Anche l'assenza di un'impostazione che eviti le versioni appena pubblicate è indicata come «Bassa» (è la segnalazione che manca la difesa). Legge soltanto i file, non esegue nulla e non interroga il registry. Solo nella versione Pro.Nessuno
get_quarantine_statusRestituisce il contenuto del vault di quarantena: percorso originale, nome della minaccia rilevata, data e dimensione.Solo locale
get_canary_statusRestituisce lo stato dei file esca anti-ransomware (canary) e fino ai 50 incidenti rilevati più recenti.Solo locale
get_ransomware_recovery_snapshotsRestituisce gli snapshot APFS di recupero (precedenti al danno, di rilevamento, manuali), quello consigliato per il ripristino, lo stato della modalità di conservazione e l'intervallo degli snapshot. Uno snapshot di rilevamento può contenere già file cifrati. Solo Pro.Solo locale
search_exec_eventsCerca nel registro delle esecuzioni dei processi (eslogger) per percorso, argomenti o ID di firma e restituisce lo stato del registratore e se il registro è leggibile. Solo Pro.Solo locale
get_process_treeRicostruisce antenati e discendenti di un processo dal registro delle esecuzioni. Solo Pro.Solo locale
get_notification_historyRestituisce la cronologia delle notifiche inviate da RoamSwitch (anomalie di controllo dei log di sicurezza, rilevamenti ClickFix e altro) degli ultimi 7 giorni, le più recenti per prime.Solo locale
get_port_anomaly_incidentsRestituisce lo stato di acquisizione della baseline della guardia di anomalie delle porte, le porte attualmente bloccate in automatico e fino agli ultimi 50 incidenti. Le porte bloccate in automatico sono uno stato attuale privo di orario e sono distinte dalla cronologia degli incidenti con orario. Questa distinzione è scritta nel campo di annotazione della risposta.Solo locale
get_ssh_guard_incidentsRestituisce lo stato e le registrazioni della guardia contro la forza bruta SSH. Include se arriva fino al divieto o si limita al rilevamento, le origini attualmente bloccate con il tempo rimanente e le registrazioni più recenti (fino a 200). I nomi utente tentati non vengono memorizzati su Linux e vengono solo contati; su Mac vengono sanificati e restituiti fino a 5. È di sola lettura e non esiste alcuno strumento MCP per revocare un divieto. Disponibile su Linux con la Server Edition e con la Client Edition quando sshd è in esecuzione, e su Mac con la versione Pro.Solo locale
get_runtime_threat_statusRestituisce se si è verificato un isolamento Air-Gap causato dal rilevamento di malware di XProtect e l'incidente che lo ha innescato. Quando si indaga sul motivo di un Air-Gap, si usa per primo questo strumento.Solo locale
get_ransomware_entropy_guard_statusRestituisce se il rilevamento generico di ransomware basato sull'entropia è abilitato e gli incidenti di rilevamento a raffica più recenti (su Linux, gli ultimi 50: ora, pid, nome del processo, file interessati, entropia media e se lo scrittore è stato congelato). Se il file salvato non è leggibile, incidentsReadable è false, e un elenco vuoto non significa «nessun rilevamento». I percorsi delle home di altri utenti sono mostrati solo a root e agli amministratori. Non comunica.Solo locale
get_honeytoken_statusRestituisce se gli honeytoken di credenziali sono abilitati e gli eventi di rilevamento accessi più recenti. Su Linux restituisce anche dove sono collocate le esche, lo stato del processo di monitoraggio e gli ultimi 50 accessi alle esche (ora, tipo, percorso, processo sospetto). Se i registri non sono leggibili, eventsReadable è false, e un elenco vuoto non significa «nessun accesso». I percorsi delle home di altri utenti sono mostrati solo a root e agli amministratori. Non comunica.Solo locale
get_browser_credential_watch_statusRestituisce se il monitoraggio dell'accesso alle credenziali del browser è attivo e i suoi eventi recenti di rilevamento accessi.Solo locale
get_forensic_evidence_bundlesRestituisce l'elenco dei pacchetti di prove forensi (elenco processi, connessioni di rete, file modificati e simili) salvati quando è scattato un Air-Gap di emergenza. Restituisce anche, per ogni bundle, integrity (verified, manifest_altered, artifact_altered:nome, artifact_missing:nome o not_anchored), nel complesso chainOk e chainBrokenAt, e missingBundles per i bundle che sono nella catena ma sono scomparsi. Questo rileva la manomissione; non la impedisce.Solo locale
get_vulnerability_scan_historyRestituisce l'ultimo risultato registrato e i giorni trascorsi (pass_age) per ogni probe registrato da run_active_vuln_scan.Solo locale

Anche le instructions di initialize comunicano all'LLM «Cannot change security level, isolate ports, or eject devices». Le risorse MCP (roamswitch://docs/*) sono Markdown di sola lettura e, dalla 1.10.0, ci sono anche procedure di triage (roamswitch://skills/*, 4, solo in inglese). Nelle annotations, readOnlyHint è false solo per i 3 strumenti che scrivono nei file di registro, destructiveHint è false per tutti gli strumenti e openWorldHint è true solo per run_npm_audit_signatures.

Un'attribuzione errata scoperta — e corretta — durante un'esercitazione con un LLM locale

A settembre 2026 abbiamo fatto indagare su un incidente un LLM locale (Qwen 3.8 27B) tramite questo server MCP. Il modello ha letto male il risultato di get_port_anomaly_incidents e ha collegato un blocco di porta passato a un incidente in corso. La causa era che il server restituiva senza distinzione uno snapshot privo di orario e una cronologia con orario. Dopo aver aggiunto un'annotazione, lo stesso modello ha rifiutato di stabilire quel collegamento. L'abbiamo verificato con un test di regressione e una nuova esecuzione su una macchina reale.

Punto chiave: il codice sorgente è pubblico

Il sorgente di questo server e della logica di rilevamento, come il monitoraggio ARP, la diagnosi delle porte e il controllo di integrità a 23 voci, è pubblicato su github.com/lafine1211/roamswitch-mcp (MIT, mirror del codice distribuito, con un tag per ogni release). Nel codice si può verificare che non c'è alcuno strumento che modifichi le difese, che cosa viene passato all'LLM e che cosa comunica verso l'esterno. L'helper privilegiato, il controllo pf, il guard che blocca e le licenze non sono inclusi.

Con esso vengono forniti anche i test: unit test speculari, test di input contraddittorio e fuzzing delle mutazioni, eseguito da swift test e verificato in CI. Il fuzzing ha provocato uno schianto incustodito (JSONSerialization stack-overflow su un oggetto JSON profondamente annidato); è risolto con un controllo della profondità di nidificazione prima del parser e registrato in SECURITY_TESTING.md.

§9

Il gettone

  • Utilizza Ed25519 (firme Curve25519). La chiave pubblica è incorporata nell'app (LicenseVerifier.embeddedPublicKeyBase64). La chiave privata corrispondente esiste solo nel backend della licenza (una variabile di ambiente Firebase Functions) e non si trova nel repository.
  • I dati firmati sono JSON canonici. La firma viene creata e verificata sui byte esatti prodotti dalla codifica LicensePayload (chiave di licenza, livello, hash del dispositivo, data di emissione, scadenza, conteggio dei posti) con .sortedKeys e .withoutEscapingSlashes di JSONEncoder.
  • È progettato per non riuscire a chiudersi. Se la chiave incorporata è mancante o non valida oppure se non è possibile produrre la firma o il JSON canonico, il risultato non è "verificato" e restituisce invalidSignature.

Associazione del dispositivo

device_hash = SHA-256( "RoamSwitch-LifetimeSalt-v1" : lowercase(IOPlatformUUID) )

L'UUID hardware grezzo non viene inviato al server. Nel raro caso in cui IOKit non restituisce a UUID, ritorna a un UUID casuale conservato in UserDefaults. Al momento della verifica, se il device_hash del token non corrisponde all'hash del dispositivo corrente, il risultato è deviceMismatch.

Funziona offline

Punto chiave: funziona senza server

Tutto ciò che validateSavedLicense() fa all'avvio è leggere il token dal portachiavi e verificarlo localmente con la chiave pubblica incorporata. Non si connette alla rete. Se il il server delle licenze viene spento, le funzionalità Pro continuano a funzionare su un Mac già attivato. Il server viene contattato solo per una nuova attivazione e per una disattivazione esplicita. Il l'avviso di disattivazione al server è la soluzione migliore: anche se fallisce, la disattivazione locale completa sempre.

L'impostazione predefinita è un acquisto una tantum (a vita); expires_at viene controllato solo quando is_lifetime è falso. Il numero dei posti è espresso per livello: 2 per Personal Pro, 5 per Squadra.

§10

Firma e autenticazione notarile (scripts/release.sh)

  1. Esegui xcodebuild archive (rilascio, firma manuale, applicazione ID sviluppatore).
  2. Esporta con -exportArchive come method: developer-id.
  3. Dopo notarytool submit --wait, esegui stapler staple sul file .app.
  4. Verifica con spctl -a -t exec -vv.
  5. Ricomprimere dopo aver pinzato per produrre l'artefatto di aggiornamento Sparkle (in modo che il ticket di autenticazione sia incluso e venga eseguito offline senza un avviso di Gatekeeper).
  6. Costruisci il DMG, autentica e pinza anche il DMG e verifica con stapler validate.

Aggiornamenti (Sparkle 2.9.6)

Aggiorna le impostazioni in Info.plist
ChiaveValore
SUFeedURLhttps://lafine.net/updates/appcast.xml
SUPublicEDKeyCNxzwijMzMCJzliId76Yl88S/9np6t/xg/zQ9YbYzHs=
SUEnableAutomaticChecksvero
SUSscheduledCheckInterval86400

Prima che venga applicato un aggiornamento, viene verificata la firma EdDSA elencata nell'appcast contro SUPublicEDKey incorporato nell'app. La chiave di firma privata esiste solo in l'ambiente di costruzione. L'appcast viene servito tramite HTTPS. Gli aggiornamenti Delta sono verificati tramite firma allo stesso modo.

Punto chiave: l'appcast è pensato per essere pubblico

Il fatto che l'URL di appcast.xml sia pubblico non è una debolezza. Il contenuto è solo versione, note di rilascio, URL, dimensione e firma EdDSA di ogni build. Poiché la firma è verificata con la chiave pubblica incorporata nell'app, nemmeno un attaccante in grado di sostituire l'appcast può far passare un aggiornamento malevolo senza la chiave di firma. Gatekeeper (Developer ID e notarizzazione) è la seconda barriera.

Restano due rischi. Il primo è che gli aggiornamenti non arrivino per un'interruzione dell'host o per un appcast danneggiato (non avviene alcuna installazione malevola; semplicemente non si aggiorna). Il secondo è un attacco freeze che sopprime deliberatamente gli aggiornamenti di sicurezza. Sparkle 2 verifica l'ordine delle versioni e respinge downgrade e replay, ma per impedire del tutto un freeze servirebbe un server di aggiornamento dedicato con scadenza. È un tema da valutare in futuro.

§11

Cosa deve gestire RoamSwitch

  • Sondaggi e attacchi da parte di un attaccante sulla stessa LAN o di un dispositivo IoT compromesso. Si risponde con la modalità stealth, l'audit delle porte esposte e l'isolamento dall'esterno (RESULTS-DEFENSE-2026-08-30 e RESULTS-PENTEST-2026-08-31 dimostrano il blocco autonomo in tutti gli scenari: ARP spoofing, porte sconosciute, cifratura ransomware e quarantena dei download).
  • Esposizione su una rete di cui non ti fidi. Interrompe automaticamente la condivisione dei servizi e AirDrop.
  • Attacchi man-in-the-middle (spoofing ARP/NDP). Dalla 1.7.6 si risponde su più livelli. (1) Tunnel VPN con kill switch (§5, la difesa principale; non dipende dall'integrità di L2), (2) blocco preventivo dell'ARP/NDP del gateway sulle reti non attendibili (§5), (3) rilevamento dello spoofing e Air-Gap di emergenza (a posteriori). Il tunnel VPN e il blocco del gateway sono Pro e disattivati per impostazione predefinita. Il rilevamento dello spoofing è attivo per impostazione predefinita, e l'Air-Gap di emergenza è attivo per impostazione predefinita quando Pro è abilitato.
  • Trovare server e database di sviluppo (Redis, MongoDB, Elasticsearch e così via) esposti su 0.0.0.0 senza autenticazione e bloccarli dall'esterno.
  • Rilevamento tempestivo di attività di crittografia non autorizzate simili a ransomware e arresto di tutto il traffico (non si basa sulle firme).
  • BadUSB e protezione di approvazione della tastiera fisica (USBKeyboardGuard, CGEventTap + IOKit) che intercetta e rilascia le sequenze di tasti da tastiere/cavi USB non approvati (Rubber Ducky, O.MG Cable, ecc.) per prevenire attacchi di command injection automatizzati.
  • Una richiesta di approvazione per l'archivio USB sconosciuto (un'unità non riconosciuta viene mantenuta di sola lettura anziché espulsa immediatamente) e una scansione ClamAV automatica sull'archivio collegato (opzionale).
  • Rileva chiavi API sensibili (OpenAI, Anthropic, GitHub, AWS, ecc.) negli appunti in modo completamente locale, prevenendo un'incollatura accidentale in un modulo web o in una chat IA prima che avvenga.
  • Rileva e segnala i file di modelli IA in formato Pickle pericolosi (rischio di esecuzione di codice arbitrario) scaricati da Hugging Face o dal web.
  • La firma di test EICAR, standard del settore, e reverse shell da manuale ben documentate all'interno dei file scaricati (StaticSignatureScanner, dalla 1.8.7, funziona anche senza ClamAV installato).
  • Un LaunchAgent/LaunchDaemon appena registrato che invoca direttamente un interprete di script grezzo (PersistenceMonitorGuard, dalla 1.8.7).
  • Righe a forma di reverse shell o simili aggiunte ai file di avvio della shell, agli script periodici, all'rc di SSH, agli hook git, agli hook di login e logout e agli script di Folder Action (StartupScriptWatch, lettura ogni 5 secondi).
  • Una shell o un interprete, oppure un nc, ncat o socat che esegue una shell sulla connessione, il cui input e output sono una connessione TCP aperta da esso verso un indirizzo pubblico (reverse shell). Ogni 4 secondi vengono esaminati solo i processi dell'utente connesso, e si notifica quando lo stesso rilevamento compare in due controlli di fila (ReverseShellWatchGuard, Pro, attivo per impostazione predefinita, solo notifica). I processi di root e le connessioni verso indirizzi privati o loopback non sono monitorati.
  • Riscrittura di DNS, router o PAC, ad esempio da parte di un falso server DHCP. Rispetto allo stato precedente della stessa rete, segnala un nuovo server DNS, un nuovo indirizzo PAC o WPAD attivato (NetworkSettingsWatchGuard, Pro, attivo per impostazione predefinita, solo notifica). Non blocca nulla e non modifica le impostazioni. VPN e DNS impostati manualmente o tramite profilo di configurazione non vengono confrontati. Una modifica legittima si accetta con «Aggiorna la base delle impostazioni di rete allo stato attuale…».
  • Attacchi di tipo «ClickFix», in cui una falsa schermata di avviso induce a eseguire da soli un comando nel Terminale — rilevati tramite pattern di comandi noti come malevoli nella cronologia della shell, attivando un air-gap di emergenza (ClickFixGuard, dalla 1.8.7, Pro, disattivato di default).
  • Rileva e notifica l'istante in cui un container viene avviato con una configurazione Docker a rischio di escape dal container, come la modalità --privileged o un mount collegato di /var/run/docker.sock (DockerEventGuard, da 1.8.9, Pro, disattivato per impostazione predefinita, solo notifica).
  • Controllo delle fughe di segreti/chiavi API che ora copre non solo il testo incollato, ma anche la scansione ricorsiva a livello di cartella (SecretLeakAuditor, scansione cartelle aggiunta in 1.8.9, interamente sul dispositivo).

Cosa abbiamo deciso di non fare

  • Non è un sostituto dell'antivirus. ClamAV e XProtect sono usati come ausiliari; RoamSwitch da solo non è un rilevatore di malware generico.
  • La politica è di non richiedere l'entitlement EndpointSecurity. Il motivo è che con un account personale è difficile superare la revisione. Le funzioni che richiedono il blocco prima dell'esecuzione (come ES_EVENT_TYPE_AUTH_EXEC) sono fuori ambito. In compenso, rilevamenti a posteriori come il rilevamento con firme statiche, il monitoraggio dell'avvio automatico e le contromisure ClickFix sono implementati senza l'entitlement.
  • Non è una garanzia. È uno strato di uno stack di difesa approfondita, non qualcosa che "previene completamente il ransomware". Anche il testo di marketing viene esaminato su questa premessa.
  • Non può proteggere un root o un kernel già compromesso. Se un utente malintenzionato ha già root, può rimuovere anche le regole pf dell'helper.
  • Non ripristina l'integrità L2 stessa. Il pin ARP/NDP preventivo è affidabile al primo utilizzo: se un utente malintenzionato è già presente prima della connessione, può bloccare un MAC falsificato. Il tunnel VPN (§5) è la risposta quando non si vuole fare questo presupposto: anche con L2 avvelenato, i contenuti sono crittografati e il kill-switch impedisce la fuoriuscita di testo in chiaro. Non sostituisce lo snooping DHCP aziendale o l'ispezione ARP dinamica.
  • Non fornisce un server VPN. La funzione tunnel utilizza una configurazione WireGuard fornita dall'utente; RoamSwitch non diventa un provider VPN.

Superficie di attacco aggiunta dall'installazione di RoamSwitch

Aggiunta la superficie di attacco e come è contenuta
Superficie d'attaccoCome è contenuto
Un LaunchDaemon che viene eseguito come root e il relativo servizio mach (com.tetsuharu.RoamSwitch.Helper) La superficie operativa è fissata su HelperProtocol (la tabella §3). Non esiste un canale di comando arbitrario. Le connessioni sono autorizzate da un requisito di firma del codice, utilizzando audit_token.
Se lo stesso RoamSwitch.app viene compromesso, tutte le operazioni dell'helper passano all'aggressore Hardened Runtime è attivo e all'app non vengono concessi privilegi non necessari. L'invio in rete è limitato ai percorsi della tabella del §7 (e alle funzioni avviate dall'utente o disattivate per impostazione predefinita descritte sotto la tabella). Non è dichiarato alcun entitlement di invio in rete, ma poiché l'app non è sottoposta a sandbox, ciò di per sé non vieta le comunicazioni (misurazioni alla fine del §7). Prevediamo di farlo revisionare da una terza parte.
I percorsi binari di sistema generati dall'helper I percorsi assoluti come /sbin/pfctl vengono specificati direttamente, senza dipendenza da PATH. Anche gli argomenti sono codificati (a parte i numeri di porta, le stringhe DNS, le coppie IP ARP/MAC e l'IP dell'endpoint VPN, tutti con convalida del formato).
Riscrittura della protezione del collegamento /etc/hosts (setLinkGuardSinkhole) Le scritture sono limitate a una sezione gestita delimitata; le linee esterne ad essa sono preservate alla lettera. I domini vengono normalizzati e convalidati, gli IP e la posta indesiderata vengono eliminati, l'elenco è limitato a 60.000 e il file viene scritto tramite un file temporaneo + sostituzione atomica. Si limita a incanalare i casi chiari (elenco di feed di minacce o omografo di marchi), decisi da un motore di verdetto esclusivamente locale. L'elenco dei blocchi stesso proviene dal feed delle minacce con firma verificata (chiave dedicata al feed).
Recupero del feed delle minacce di Link Guard (un giorno di sola ricezione GET) Recupero di un file statico senza stringa di query e senza identificatore per dispositivo (solo lo User-Agent standard). Il manifest e il corpo del feed sono entrambi verificati secondo Ed25519 e un recupero che non supera la verifica viene scartato (nessun fallback su dati non firmati). "Aggiornamento automatico: disattivato" rimuove completamente il percorso.
Pin ARP/NDP preventivo (lockGatewayARP) Vengono bloccate solo le voci della cache dei vicini di «gateway, router IPv6 e DNS sullo stesso link». Gli IP e i MAC ricevuti vengono validati nel formato e trattati con una riconciliazione rispetto all'insieme richiesto (non vengono aggiunte voci di propria iniziativa). Funziona solo sulle reti non attendibili ed è Pro e disattivato per impostazione predefinita. I limiti di TOFU sono indicati esplicitamente in «ciò che abbiamo deciso di non fare».
Tunnel VPN (wireGuardImport/Up/…, Homebrew wireguard-tools) Il .conf viene memorizzato dall'helper in 0600. L'IP dell'endpoint viene risolto dall'app e passato all'helper (l'helper non risolve mai un nome host arbitrario). La destinazione e i contenuti del tunnel sono sotto il controllo dell'utente. La funzionalità è disabilitata se wireguard-tools non è installato. Pro, disattivato per impostazione predefinita. Il kill switch passa attraverso PFRulesetCoordinator (§4).
Il server MCP passa lo stato del sistema a un LLM (un sostituto confuso) Nessuno strumento modifica impostazioni, protezioni, porte o dispositivi, e solo tre strumenti scrivono, per aggiornare i propri file di registro. I controlli degli URL sono offline. Il dominio delle impostazioni viene solo letto, mai scritto.
Dirottamento del percorso di aggiornamento Verifica della firma EdDSA (SUPublicEDKey), più un ticket di notarile in bundle. L'appcast è su HTTPS.

Appendice A

Tutto quanto affermato in questo documento può essere verificato rispetto all'artefatto distribuito con i seguenti comandi.

Firma e notarile

# Firma Developer ID e Team ID
codesign -dvvv /Applications/RoamSwitch.app 2>&1 | grep -E 'Authority|TeamIdentifier|flags'

# Se il ticket di notarizzazione è stato allegato (staple)
stapler validate /Applications/RoamSwitch.app
spctl -a -t exec -vvv /Applications/RoamSwitch.app

# Firma dell'helper incluso / server MCP
codesign -dvvv /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchHelper
codesign -dvvv /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

Entitlements (verifica che non sia dichiarato alcun entitlement di invio in rete; poiché l'app non è sottoposta a sandbox, ciò di per sé non vieta le comunicazioni)

codesign -d --entitlements :- /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchHelper
codesign -d --entitlements :- /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer
# → Un dizionario di entitlements vuoto. Nessuna chiave app-sandbox / network client.

Misurare il traffico

# Esegui tcpdump in parallelo per confermare che, nell'uso normale, non ci sia traffico al di fuori dei percorsi della tabella
sudo tcpdump -i any -n 'host not 127.0.0.1' and 'not port 53'
# Nessun traffico se non i percorsi della tabella (attivazione della licenza, controlli di aggiornamento, dati di aggiornamento firmati, aggiornamenti di ClamAV e così via)

Per un controllo più rigoroso e automatizzato con attribuzione per processo, vedere rs-zerotel-audit.sh in roamswitch-support/audit/

Architettura di difesa e test di penetrazione (5 confini di difesa)

# Verifica automaticamente in un unico passaggio il confine di autorizzazione XPC, la priorità Air-Gap di pf, il rilevamento dell'esposizione delle porte, l'invariante Read-Only di MCP (nessuno strumento con un nome che indichi una modifica) e il monitoraggio ARP
git clone https://github.com/lafine1211/roamswitch-support
cd roamswitch-support/audit
./rs-defense-audit.sh all

Test di penetrazione in tempo reale e audit di difesa multilivello da una VM macOS: RESULTS-DEFENSE-2026-08-30

Verifica della protezione dalle minacce DNS (malware Quad9 e blocco C2).

# Interroga il dominio di test ufficiale di Quad9 per verificare il blocco delle minacce
nslookup test.dns9.quad9.net
# → Deve restituire ** server can't find test.dns9.quad9.net: NXDOMAIN, cioè la risoluzione dei nomi è bloccata

Verifica di Web & Mail Download Guard (rilevamento in tempo reale con ClamAV)

# Crea la stringa di test antivirus standard e innocua (EICAR) in Downloads
echo 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > ~/Downloads/eicar_test.com
# → Il rilevamento FSEvents attiva una scansione immediata di ClamAV; non viene mostrata alcuna notifica e "firma di test EICAR rilevata (innocua)"
#   viene registrata nella cronologia delle notifiche. Poiché EICAR è un file di test standard del settore e non una minaccia reale,
#   non viene messo in quarantena né bloccato e il file resta al suo posto (solo un vero campione di malware viene spostato nel gestore della quarantena).

Verifica del rilevamento tramite firme statiche (senza necessità di EndpointSecurity)

## Una reverse shell da manuale tratta da riferimenti pubblici di offensive security (innocua, non viene mai eseguita)
echo 'bash -i >& /dev/tcp/127.0.0.1/4444 0>&1' > ~/Downloads/rs_test.sh
## → Anche senza ClamAV installato, appare una notifica «File scaricato pericoloso messo in quarantena» e il file viene
##   spostato immediatamente nella cartella Quarantine (indipendentemente dal database delle firme di ClamAV)

Verifica del nuovo monitoraggio dell'avvio automatico (PersistenceMonitorGuard)

# Creare un LaunchAgent innocuo che invoca direttamente un interprete di script grezzo (non viene mai realmente eseguito)
cat > ~/Library/LaunchAgents/com.example.selfcheck.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.example.selfcheck</string>
  <key>ProgramArguments</key><array><string>/bin/bash</string><string>-c</string><string>echo hi</string></array>
</dict></plist>
EOF
# → Entro pochi secondi dovrebbe apparire una notifica «Rilevata nuova registrazione di avvio automatico». Rimuoverlo in seguito:
rm ~/Library/LaunchAgents/com.example.selfcheck.plist

Link Guard (blocco delle connessioni di phishing)

# Se la sezione gestita è presente (2 righe BEGIN/END in modalità Pro + predefinita)
sudo grep -c 'RoamSwitch link guard' /etc/hosts

# Il contenuto della sezione e il numero di sinkhole
sudo sed -n '/BEGIN RoamSwitch link guard/,/END RoamSwitch link guard/p' /etc/hosts | head -4
sudo sed -n '/BEGIN RoamSwitch link guard/,/END RoamSwitch link guard/p' /etc/hosts | grep -c '^0\.0\.0\.0'

# Se viene effettivamente bloccato (verificato con una voce della sezione; innocuo)
D=$(sudo sed -n '/BEGIN RoamSwitch/,/END RoamSwitch/p' /etc/hosts | awk '/^0\.0\.0\.0/{print $2; exit}')
dscacheutil -q host -a name "$D"   # → ip_address: 0.0.0.0 (risoluzione dei nomi bloccata)

# Verifica anche che la sezione precedente scompaia tramite Menu → "Protezione link" → "Off"

Il feed delle minacce di sola ricezione (firma verificata)

# Feed e manifest pubblici (chiunque può recuperarli e verificarli)
curl -s https://lafine.net/updates/v1/manifest        # version/generated/threatfeed{...}
curl -sI https://lafine.net/updates/v1/manifest.sig   # → text/plain
# Viene inviata solo una GET senza query string, cookie o identificatore per dispositivo (solo lo User-Agent standard). Verificabile eseguendo tcpdump in parallelo.

Blocco preventivo ARP/NDP (§5, 1.7.5+)

# Connettersi a una rete non attendibile con il blocco preventivo attivo → verificare le voci permanent
arp -an | grep -i permanent          # Il gateway e le altre IP sono elencati come (permanent)
ndp -an | grep -i 'P '               # Lato IPv6 (P = permanent)
sudo cat "/Library/Application Support/RoamSwitch/gateway_arp_lock.json"  # L'insieme delle mappature IP→MAC attualmente fissate
# Rilascia il blocco dal menu → quanto sopra dovrebbe scomparire

Tunnel VPN + kill switch (§5, 1.7.6+)

# Presuppone wireguard-tools (tramite Homebrew)
brew list wireguard-tools >/dev/null && echo "wireguard-tools: OK"

# Attiva la VPN su una rete non attendibile → prima che il tunnel sia attivo, pf è in stato di kill-switch
sudo pfctl -sr | grep -E 'block drop all|pass .*(utun|udp)'   # block drop all + un insieme limitato di regole pass quick

# Dopo che il tunnel è attivo (wg-quick up già eseguito)
wg show                              # handshake / transfer è attivo
route -n get default | grep interface  # → utunN (la route predefinita è il tunnel)
# Disattiva la VPN → il kill-switch viene rilasciato e pf torna allo stato precedente

L'aiutante privilegiato stesso

# Il LaunchDaemon registrato
sudo launchctl print system/com.tetsuharu.RoamSwitch.Helper

# Le regole pf attualmente caricate (stato reale di Air-Gap / guardia porte)
sudo pfctl -sr

# La directory di stato dell'helper
ls -la "/Library/Application Support/RoamSwitch/"

La risposta del server MCP (controllo offline)

BIN=/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
              '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | "$BIN"
# Restituisce serverInfo e le definizioni degli strumenti. Non si verifica alcuna connessione di rete.

Sorgente e test del server MCP

git clone https://github.com/lafine1211/roamswitch-mcp
cd roamswitch-mcp
swift build -c release        # Lo stesso codice sorgente del binario distribuito
swift test                    # Test unitari, input avversari, stdio e fuzzing a mutazione
# Consulta SECURITY_TESTING.md per il contenuto dei test e i problemi riscontrati

Identificatore del dispositivo

# Il valore grezzo associato al token (viene inviato solo uno SHA-256 con salt)
ioreg -d2 -c IOPlatformExpertDevice | awk -F'"' '/IOPlatformUUID/{print $4}'
White paper Architettura / Sicurezza di RoamSwitch v1.6 · Ambito 1.13.0 (build 172) · Lafine Systems Design · 2026-10-19
Segnala eventuali errori o omissioni su lafine.net/contact.html.