CLI/Guida alle operazioni senza testa

1. Componenti

Una distribuzione headless viene eseguita sul demone + roamswitch CLI (più roamswitch-mcp se lo si desidera). Tutti i meccanismi di difesa autonomi funzionano senza alcuna GUI.

2. Demone (servizi di sistema)

Edizione cliente

sudo systemctl status  roamswitch.service      # Stato di funzionamento
sudo systemctl enable  roamswitch.service      # Avvio automatico al boot (abilitato all'installazione)
sudo systemctl restart roamswitch.service      # Riavvia
journalctl -u roamswitch.service -f            # Segui i log
journalctl -u roamswitch.service --since "1h ago"

Cosa fa il demone client in modo autonomo all'avvio e ad ogni ciclo (3 s):

• Identifica il MAC del gateway connesso e applica i profili nftables (open / balanced / lockdown) rispetto a trusted_networks
• Rilevamento ransomware comportamentale (fanotify + entropia di Shannon + canarini)
• Scansione malware in accesso (fanotify, facoltativamente ClamAV)
• Monitoraggio dello spoofing ARP e blocco preventivo ARP/NDP del gateway su reti non attendibili
• Rafforzamento del kernel (sysctl / Yama / core dump / /tmp noexec) per profilo
• Applicazione DNS di protezione dalle minacce (dns_enabled + dns_scope)
• Link guard (NFQUEUE) per l'intercettazione del phishing
• Uscita dello stato di runtime su /run/roamswitch/state.json

Edizione server

sudo systemctl status  roamswitch-server.service      # Stato di funzionamento
sudo systemctl restart roamswitch-server.service      # Riavvia
sudo systemctl reload  roamswitch-server.service      # Ricarica il file di configurazione
journalctl -u roamswitch-server.service -f            # Segui i log

3. Riferimento ai comandi CLI

Sintassi di base: roamswitch <command> [options]. L'esecuzione senza argomenti viene eseguita per impostazione predefinita su status. La lingua di output segue automaticamente le impostazioni internazionali del sistema operativo (LC_ALL / LC_MESSAGES / LANG).

Esempi

sudo roamswitch status                 # Diagnostica completa client (24 voci)
sudo roamswitch status --server        # Diagnostica completa Server Edition (30 voci)
sudo roamswitch ports -a               # Tutte le porte in ascolto
roamswitch guards                      # Stato delle guardie
roamswitch audit-url https://examp1e-login.com
roamswitch audit-secrets ./deploy.env
roamswitch audit-secrets .                          # Scansione ricorsiva della directory corrente
roamswitch audit-logs 72               # Analizza i log delle ultime 72 ore
sudo roamswitch sharing on             # Arresto automatico di SSH/Samba/RDP su reti non attendibili
sudo roamswitch fim verify             # Verifica dell'integrità dei file FIM
sudo roamswitch fim update             # Aggiorna la baseline FIM
sudo roamswitch emergency-restore      # Rimuovi completamente il blocco di emergenza e ripristina
sudo roamswitch airgap enable          # Blocco di emergenza
sudo roamswitch airgap disable         # Rimuovi
sudo roamswitch server ack             # Conferma il timer di sicurezza (arresta il ripristino automatico)
roamswitch canary                      # Cronologia degli incidenti del canary
roamswitch port-anomaly                # Cronologia degli incidenti del Port Anomaly Guard
roamswitch server ebpf                 # Stato di isolamento e cronologia degli incidenti della guardia eBPF
roamswitch notifications               # Cronologia delle notifiche degli ultimi 7 giorni
roamswitch frozen                      # Elenca i processi congelati
sudo roamswitch frozen resume 12345    # Rilascia un falso positivo
sudo roamswitch sensor pair --addr 192.168.1.50 --code AB3DFGH2  # Si abbina a Sensor tramite un codice di abbinamento
sudo roamswitch sensor key             # Mostra la chiave pubblica/indirizzo propri di questo endpoint
roamswitch port-scan                   # Cronologia di rilevamento delle scansioni delle porte

Il demone dell'edizione server viene eseguito come root, quindi i comandi che devono leggere il set di regole nftables o identificare il proprietario di un processo (status / status --server / ports -a) restituiscono risultati imprecisi senza sudo (un falso verdetto “inattivo”, o informazioni di processo mancanti). Anche i comandi che modificano la configurazione (sharing / fim update / airgap / emergency-restore, ecc.) richiedono sudo. Tutti gli altri comandi, di sola lettura, funzionano correttamente senza di esso.

4. File di configurazione

Edizione client (~/.config/roamswitch/config.json)

Il demone viene eseguito come root ed esegue la scansione di /home/*/.config/roamswitch/config.json, utilizzando il primo file valido che trova (o /root/.config/roamswitch/config.json in ambienti solo root).

Edizione server (/etc/roamswitch/server.conf)

Server Edition utilizza un file di configurazione in formato INI con autorizzazioni rigide (0600, solo root). Fare riferimento al Manuale operativo Server Edition

Non utilizza alcuna comunicazione di rete esterna, si connette localmente al socket del demone o chiama roamswitch-core. Vedere la Guida all'installazione del sistema MCP

• Pagina del prodotto RoamSwitch per Linux
• Libro bianco sulla sicurezza del cliente
• Libro bianco sulla sicurezza dei server
• Manuale operativo del server
• Assistente AI e Guida all'integrazione MCP
• FAQ