Guide des opérations CLI/sans tête

1. Composants

Un déploiement sans tête s'exécute sur le démon + roamswitch CLI (plus roamswitch-mcp si vous le souhaitez). Tous les mécanismes de défense autonomes fonctionnent sans aucune interface graphique.

2. Démon (services systemd)

Édition client

sudo systemctl status  roamswitch.service      # État de fonctionnement
sudo systemctl enable  roamswitch.service      # Démarrage automatique au boot (activé à l'installation)
sudo systemctl restart roamswitch.service      # Redémarrer
journalctl -u roamswitch.service -f            # Suivre les journaux
journalctl -u roamswitch.service --since "1h ago"

Ce que fait le démon client de manière autonome au démarrage et à chaque cycle (3 s) :

• Identifie la passerelle MAC connectée et applique les profils nftables (open / balanced / lockdown) sur trusted_networks
• Détection comportementale des ransomwares (fanotify + entropie de Shannon + canaris)
• Analyse des logiciels malveillants à l'accès (fanotify, éventuellement ClamAV)
• Surveillance de l'usurpation d'identité ARP et épinglage préventif de la passerelle ARP/NDP sur des réseaux non fiables
• Renforcement du noyau (sysctl / Yama / core dumps / /tmp noexec) par profil
• Application DNS de protection contre les menaces (dns_enabled + dns_scope)
• Link Guard (NFQUEUE) pour l'interception de phishing
• Sortie de l'état d'exécution vers /run/roamswitch/state.json

Édition serveur

sudo systemctl status  roamswitch-server.service      # État de fonctionnement
sudo systemctl restart roamswitch-server.service      # Redémarrer
sudo systemctl reload  roamswitch-server.service      # Recharger le fichier de configuration
journalctl -u roamswitch-server.service -f            # Suivre les journaux

3. Référence des commandes CLI

Syntaxe de base : roamswitch <command> [options]. L'exécution sans arguments est par défaut status. La langue de sortie suit automatiquement les paramètres régionaux du système d'exploitation (LC_ALL / LC_MESSAGES / LANG).

Exemples

sudo roamswitch status                 # Diagnostic complet client (24 éléments)
sudo roamswitch status --server        # Diagnostic complet Server Edition (30 éléments)
sudo roamswitch ports -a               # Tous les ports en écoute
roamswitch guards                      # État des gardes
roamswitch audit-url https://examp1e-login.com
roamswitch audit-secrets ./deploy.env
roamswitch audit-secrets .                          # Analyser récursivement le répertoire courant
roamswitch audit-logs 72               # Analyser les journaux des dernières 72 heures
sudo roamswitch sharing on             # Arrêt automatique de SSH/Samba/RDP sur réseau non approuvé
sudo roamswitch fim verify             # Vérification de l'intégrité des fichiers FIM
sudo roamswitch fim update             # Mettre à jour la référence FIM
sudo roamswitch emergency-restore      # Lever entièrement le confinement d'urgence et restaurer
sudo roamswitch airgap enable          # Confinement d'urgence
sudo roamswitch airgap disable         # Lever
sudo roamswitch server ack             # Accuser réception du minuteur de sécurité (arrêter la reprise automatique)
roamswitch canary                      # Historique des incidents du canari
roamswitch port-anomaly                # Historique des incidents du Port Anomaly Guard
roamswitch server ebpf                 # État d'isolement et historique des incidents du garde eBPF
roamswitch notifications               # Historique des notifications des 7 derniers jours
roamswitch frozen                      # Lister les processus gelés
sudo roamswitch frozen resume 12345    # Libérer un faux positif
sudo roamswitch sensor pair --addr 192.168.1.50 --code AB3DFGH2  # S'appaire avec Sensor à l'aide d'un code d'appairage
sudo roamswitch sensor key             # Affiche la clé publique/l'adresse propres à ce terminal
roamswitch port-scan                   # Historique de détection de scan de ports

Le démon de l'édition serveur s'exécute en tant que root ; les commandes qui doivent lire le jeu de règles nftables ou identifier le propriétaire d'un processus (status / status --server / ports -a) renvoient donc des résultats inexacts sans sudo (un faux verdict « inactif », ou des informations de processus manquantes). Les commandes qui modifient la configuration (sharing / fim update / airgap / emergency-restore, etc.) nécessitent également sudo. Toutes les autres commandes, en lecture seule, fonctionnent correctement sans sudo.

4. Fichiers de configuration

Édition client (~/.config/roamswitch/config.json)

Le démon s'exécute en tant que root et analyse /home/*/.config/roamswitch/config.json, en utilisant le premier fichier valide qu'il trouve (ou /root/.config/roamswitch/config.json dans les environnements root uniquement).

Édition serveur (/etc/roamswitch/server.conf)

Server Edition utilise un fichier de configuration au format INI avec des autorisations strictes (0600, root uniquement). Reportez-vous au Manuel d'utilisation de Server Edition.

Il n'utilise aucune communication réseau externe, se connectant localement au socket démon ou appelant roamswitch-core. Voir Guide de configuration MCP

• Page produit RoamSwitch pour Linux
• Livre blanc sur la sécurité des clients
• Livre blanc sur la sécurité des serveurs
• Manuel d'utilisation du serveur
• AI Assistant et guide d'intégration MCP
• FAQ