Manuel d'exploitation RoamSwitch Sensor
Guide d'installation et d'exploitation d'un capteur réseau qui, par sa simple présence sur le LAN, détecte l'apparition de nouveaux appareils sur le même segment et l'usurpation. Pour les terminaux dotés de RoamSwitch (Mac / Linux Client / Server Edition), il effectue aussi des audits actifs de vulnérabilités. Distribué sous forme de paquets apt / dnf.
1. Présentation & positionnement
RoamSwitch (Mac / Linux Client / Server Edition) est, dans tous les cas, un agent résidant sur l'hôte. Cette forme comporte deux angles morts structurels.
- L'auto-diagnostic d'un hôte isolé comporte un angle mort fondamental : le risque de mouvement latéral — « fermé vers l'extérieur, mais totalement exposé depuis un autre appareil du même LAN » — ne peut jamais être détecté par un hôte qui ne s'observe que lui-même.
- Certains appareils ne pourront jamais exécuter RoamSwitch : appareils IoT (caméras réseau, prises connectées, imprimantes multifonctions), appareils invités/BYOD, équipements réseau eux-mêmes, appareils embarqués, etc.
RoamSwitch Sensor est un nœud dédié placé sur le LAN, qui comble ces deux lacunes. Sont implémentés : l'audit actif des vulnérabilités des terminaux où RoamSwitch est installé, l'inventaire des appareils par ARP et la détection d'usurpation, et des informations indicatives sur les comportements suspects grâce à la capture passive sur option (§6). Il se limite à détecter et à signaler ; il ne bloque pas le trafic.
updates.fetch_cve_map, true par défaut ; false pour le mode hors ligne). Elles ne contiennent aucune donnée d'appareil ni d'audit. (2) Notification et agrégation vers des destinations définies par l'opérateur : envoyées uniquement si elles sont configurées.L'autodéfense n'est délibérément pas implémentée (un choix de conception assumé). Si vous devez protéger l'hôte du Sensor lui-même contre les attaques, nous recommandons d'installer séparément RoamSwitch for Linux Server Edition sur la même machine. Les deux s'exécutent en tant que processus totalement indépendants et coexistent sans conflit.
2. Environnement de vérification actuel
- OS pris en charge : Debian 12 (bookworm) ou ultérieur / Ubuntu 22.04 ou ultérieur (apt), famille Fedora/RHEL (dnf).
x86_64(amd64) etarm64(aarch64, par exemple Raspberry Pi) sont pris en charge. - Matériel cible (plan futur) : pour une exploitation réelle, nous envisageons un appareil basse consommation adapté au fonctionnement continu, comme un mini PC sans ventilateur de la gamme N100/N150, mais aucune construction ni livraison dédiée à cet effet n'est proposée aujourd'hui.
- Placement sur le réseau : le raccorder au segment du LAN à surveiller (il s'exécute sur le réseau de l'hôte, car il voit directement l'ARP). Une adresse IP fixe est obligatoire, car il reçoit des requêtes. Il écoute sur le port TCP
50543et reçoit aussi TLS 1.3 sur ce même port (§4.4). - Consommation de ressources : la mémoire résidente est d'environ quelques dizaines de Mo, et la charge CPU au repos est minime.
- Recommandé :
nmap(utilisé pour le balayage ARP, les vérifications complémentaires NSE et la vérification MAC des audits planifiés). Sans lui, les autres fonctions continuent de marcher, mais aucun balayage ARP n’est effectué et Sensor bascule en mode passif, où il ne voit que les appareils avec lesquels il a lui-même communiqué.
nmap est un paquet recommandé. Sensor s'installe sans lui, mais l'audit périodique, l'audit périodique des appareils non encore intégrés et le scan actif du registre des appareils (détection des appareils silencieux) ne fonctionnent pas. roamswitch-sensor status affiche « nmap : non installé ».
3. Installation & démarrage
Installez le paquet roamswitch-sensor depuis le dépôt officiel signé. Après l'installation, roamswitch-sensor.service (systemd) est automatiquement activé et démarré.
3.1 APT (Ubuntu / Debian)
# 1. Enregistrer la clé de signature du dépôt
curl -fsSL https://lafine.net/apt/roamswitch-archive-keyring.asc \
| sudo gpg --dearmor -o /usr/share/keyrings/roamswitch-archive-keyring.gpg
# 2. Ajouter le dépôt
echo "deb [signed-by=/usr/share/keyrings/roamswitch-archive-keyring.gpg] https://lafine.net/apt stable main" \
| sudo tee /etc/apt/sources.list.d/roamswitch.list
# 3. Installer
sudo apt update && sudo apt install roamswitch-sensor
3.2 DNF / RPM (Fedora / RHEL)
# 1. Importer la clé GPG
sudo rpm --import https://lafine.net/rpm/RPM-GPG-KEY-roamswitch
# 2. Ajouter le fichier de configuration du dépôt
sudo curl -fsSL -o /etc/yum.repos.d/roamswitch.repo https://lafine.net/rpm/fedora/roamswitch.repo
# 3. Installer
sudo dnf install roamswitch-sensor
3.3 Vérification du démarrage
systemctl status roamswitch-sensor.service
sudo roamswitch-sensor status
3.4 Exécution du CLI / TUI
Le CLI (roamswitch-sensor) et le TUI interactif (roamswitch-sensor-tui) peuvent être exécutés directement après l'installation.
sudo roamswitch-sensor status
sudo roamswitch-sensor-tui
ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE (définie via systemctl edit roamswitch-sensor.service) pour observer les en-têtes Ethernet/IPv4/IPv6 sur cette interface et détecter les nouveaux appareils ou le contact avec des IP malveillantes connues (voir §6.1). Désactivé par défaut.4. Appairage (méthode par code)
À sa sortie d'usine, Sensor ne fait confiance à rien. L'appairage se fait à l'aide d'un code d'appairage à usage unique émis par l'opérateur du Sensor. La relation de confiance — « Sensor est autorisé à exécuter des audits actifs de vulnérabilités contre ce terminal » — s'établit simultanément dans les deux sens en une seule étape d'appairage (il n'existe pas d'état de confiance à sens unique).
Prérequis : faites fonctionner Sensor avec une adresse IP fixe (attribution statique, ou réservation côté serveur DHCP). Une fois l'appairage effectué, le terminal se connecte désormais toujours directement à l'adresse IP de Sensor constatée lors de l'appairage (il n'y a plus de découverte automatique, via mDNS ou autre) ; si l'IP de Sensor change par la suite, un nouvel appairage sera nécessaire. Le terminal peut, lui, conserver une IP dynamique.
4.1 Émettre un code d'appairage (côté Sensor)
# À exécuter côté Sensor (ou appuyer sur c dans le TUI)
sudo roamswitch-sensor issue-code
Un code à usage unique de 8 caractères s'affiche (0/O/1/I/L sont exclus). Il expire 10 minutes après son émission. Communiquez-le sans attendre à l'opérateur côté terminal, avec l'empreinte du certificat TLS (SHA-256) à épingler sur le terminal.
4.2 Appairage avec le code (côté terminal)
# Côté terminal (roamswitch-linux)
sudo roamswitch sensor pair --addr <SENSOR_IP> --code <CODE> --fingerprint <SHA256_FINGERPRINT>
Sur l’édition Mac, vous pouvez faire de même dans l’interface graphique depuis l’élément de la barre des menus « 🔍 RoamSwitch Sensor Pairing… », en saisissant l’adresse IP du Sensor, le code d’appairage et l’empreinte du certificat.
Une fois l’appairage effectué, chaque audit actif et chaque récupération de résultats ultérieurs sont authentifiés par des signatures Ed25519. Un terminal Linux ne dialogue en TLS 1.3 qu’avec un Sensor dont le certificat correspond à l’empreinte que vous avez saisie, et ne retombe jamais automatiquement en clair (§4.4). À ce stade, le terminal qui connaissait le code et le Sensor qui l’a émis se font mutuellement confiance.
issue-code.4.3 Appairage manuel (enregistrement direct d’une clé publique déjà connue)
Si l'opérateur du Sensor connaît déjà, par un autre canal, la clé publique et l'adresse d'un terminal, il peut aussi l'enregistrer directement côté Sensor sans échanger de code d'appairage (il est en principe préférable d'utiliser la méthode par code du §4.2 et de laisser le terminal s'appairer lui-même). Vous pouvez consulter votre propre clé publique et votre adresse avec les commandes suivantes.
# Vérifier sa propre clé publique/adresse côté terminal
sudo roamswitch sensor key
# Vérifier sa propre clé publique/adresse/adresse MAC côté Sensor
sudo roamswitch-sensor status
# Côté Sensor
sudo roamswitch-sensor pair <clé publique complète> --addr <adresse IP> --confirm
4.4 Sécurité de l'API de contrôle (TCP 50543) (TLS, empreinte, verrouillage)
L’appairage, les demandes d’audit et la récupération des résultats passent par l’API de contrôle de Sensor (TCP 50543). Les protections suivantes sont intégrées.
- TLS 1.3 et épinglage de certificat :
control.tlsvautoff/optional(par défaut ; accepte aussi le texte en clair et avertit) /required(TLS 1.3 uniquement). Le certificat est auto-signé (ECDSA P-256), et la confiance repose sur l'épinglage de son empreinte SHA-256. - Liaison de l’empreinte à la demande d’appairage : le terminal signe l’empreinte qu’il a épinglée avec sa propre clé privée et l’inclut dans la demande d’appairage. Une demande passée par un homme du milieu présentant un autre certificat échoue avec
fingerprint_mismatch, et le code d’appairage n’est pas consommé. - Signatures résistantes au rejeu (v2) : les signatures des demandes d’audit et de récupération des résultats utilisent le format v2, qui inclut un horodatage (±300 s) et un nonce, de sorte que les rejeux sont refusés. Les anciennes signatures v1 n’ont ni l’un ni l’autre et peuvent être rejouées ;
control.allow_legacy_signatures(truepar défaut, prévu pour la période de migration ; chaque utilisation journalise un avertissement de dépréciation) détermine si elles sont acceptées. Réglez-le surfalsedès que tous les terminaux envoient du v2. - Verrouillage : face à une attaque par force brute du code d'appairage, 5 échecs en 10 minutes depuis la même IP source entraînent un verrouillage de 60 secondes (prolongé de façon exponentielle jusqu'à 1 heure en cas de répétition), et 20 échecs toutes sources confondues déclenchent un verrouillage global. Les échecs de signature sont traités avec un peu plus de souplesse (10 par IP source, 100 au total). Les verrouillages sont signalés par la notification
control_api_lockout. - Adresse d’écoute : restreindre
control.bind_addr(0.0.0.0par défaut, appliqué au redémarrage) à l’adresse LAN de Sensor réduit l’exposition. Le démon émet un avertissement tant qu’il s’agit d’une adresse générique. - Rotation du certificat :
roamswitch-sensor tls rotate(dans la TUI, écranT, toucheR) régénère le certificat. Tous les épinglages de l’ancienne empreinte deviennent invalides : chaque terminal doit donc saisir la nouvelle valeur (sudo roamswitch sensor repin <public key> --fingerprint <value>). L’appairage lui-même est conservé.
sudo roamswitch-sensor pairing show # mode, fingerprint, warnings
sudo roamswitch-sensor tls rotate # regenerate the certificate
sudo roamswitch sensor repin <PUBLIC_KEY> --fingerprint <NEW_FINGERPRINT> # on each endpoint
control.tls à requiredroamswitch-sensor status n’affiche plus d’avertissement de connexion en clair → (3) exécutez sudo roamswitch-sensor config set control.tls required → redémarrez le démon. off n’est normalement pas utilisé, car les terminaux Linux exigent TLS et ne pourraient plus se connecter.5. Audit actif des vulnérabilités
Sensor exécute des diagnostics de vulnérabilité non destructifs et à preuve d'exploitation sur les terminaux appairés. Il n'effectue jamais d'opération destructive (écriture ou suppression de données, arrêt de services).
sudo roamswitch-sensor scan <clé publique ou son début>
L'audit se compose de quatre phases.
- Analyse complète des ports : détecte de façon exhaustive tous les ports TCP ouverts sur l'hôte cible.
- Diagnostic de signatures connues : vérifications non destructives et à preuve d'exploitation de schémas de vulnérabilité connus — exposition non authentifiée de Redis / dockerd / Memcached / MongoDB / Elasticsearch / CouchDB / Jenkins / VNC, diagnostic de relais ouvert SMTP (une méthode sûre qui n'envoie que
MAIL FROM/RCPT TO, jamaisDATA), et diagnostics de mauvaise configuration CORS, de traversée de répertoires et de redirection ouverte sur les serveurs de développement, entre autres. - Récupération générique de bannière : pour les ports ouverts non couverts par les signatures ci-dessus, récupère la chaîne de bannière par simple connexion (aucune donnée n'est envoyée). À un port ouvert qui n'affiche aucune bannière, il envoie un seul
GET / HTTP/1.0pour reconnaître le service (32 ports au plus par audit). - Diagnostic complémentaire nmap NSE : diagnostic complémentaire à large couverture de protocoles via
nmap --script safe. S'exécute automatiquement dès quenmapest installé sur l'hôte (sans effet dans le cas contraire).
Les services sur des ports non standard sont aussi examinés. Les mêmes vérifications en lecture seule sont appliquées, par exemple, à Redis sur le port 6380 ou à SSH sur le port 2222. L'identification repose sur la bannière initiale et la réponse à un seul GET / HTTP/1.0. La liste auto-déclarée d'un terminal (64 entrées au plus à la fois) n'est pas couverte par la signature ; elle n'élargit donc jamais le périmètre et sert uniquement à choisir les vérifications.
Chaque exécution d'audit est enregistrée dans /var/lib/roamswitch-sensor/scan_history.json — que quelque chose ait été détecté ou non, car un résultat propre à ce moment-là a aussi une valeur d'archive — et peut être consultée via le CLI ou le TUI.
roamswitch-sensor history
sudo roamswitch-sensor report <clé publique ou son début> --out /tmp/report.md
Lorsque s'affiche « Ports ouverts : aucun » et qu'il n'y a pas non plus de réponse ARP, le message « Il se peut que cela n'atteigne pas l'appareil » apparaît. Cela ne signifie pas « aucun problème ». « nmap NSE : non exécuté (nmap n'est pas installé) » et « sans objet » ont des sens différents.
5.1 Demande d’audit depuis le client (modèle pull)
Depuis un terminal appairé, il est aussi possible de demander au Sensor un audit actif des vulnérabilités. Sur Mac, via « Demander un audit au Sensor » dans la barre des menus ; sur Linux, avec la commande suivante.
sudo roamswitch sensor request-audit
Une fois l’audit exécuté par Sensor, le terminal interroge le résultat à partir de 5 minutes après la demande, puis toutes les 5 minutes, jusqu’à 5 tentatives (soit 25 minutes maximum au total). Tout résultat récupéré est également enregistré localement sur le terminal.
roamswitch sensor results
Dans l’édition Mac, les résultats apparaissent aussi dans la liste « Résultats d’audit » de la fenêtre de réglages, ou peuvent être lus via l’outil MCP get_sensor_audit_results, comme donnée d’entrée pour un agent IA élaborant un plan de remédiation. La récupération d’un résultat peut aussi être explicitement refusée, par exemple si l’appairage a été révoqué côté Sensor (voir §10 Q6).
5.2 Écarts avec la spécification, valeurs limites et pistes d'une IA (facultatif)
Écarts avec la spécification et valeurs limites (design_flaw.enabled ; désactivé par défaut, sur adhésion) Ne concerne que les terminaux appairés et consentants. Recherche les documents OpenAPI / Swagger et signale les écarts entre ce qui est déclaré et les réponses réelles. Applique aux paramètres de requête des valeurs sûres fixes et signale les anomalies telles que les 5xx. N'envoie que des GET, 20 requêtes au plus par appareil. L'ordre est fixe ; l'IA ne le choisit pas (le résumé masque les secrets, 240 caractères au plus par élément).
Faire rédiger des hypothèses par une IA (facultatif) roamswitch-sensor design-hypotheses ne transmet que le résumé des enregistrements à l'outil d'IA choisi et lui fait rédiger des hypothèses non confirmées. Il s'exécute avec les droits de l'utilisateur qui le lance, et le résumé peut être envoyé au fournisseur. Rien n'est envoyé aux appareils.
6. Surveillance ARP passive & visibilité LAN
Sensor repère les appareils du LAN de deux façons. (1) Surveillance de la table ARP : elle est lue environ toutes les 10 secondes, et les nouvelles paires IP/MAC ainsi que les changements de MAC d'une IP connue (signe d'usurpation) sont détectés. (2) Balayage ARP actif : nmap -sn -PR examine toutes les heures le sous-réseau directement connecté (jusqu'à /22) et enregistre le résultat dans l'inventaire. Sans nmap, seul (1) s'applique.
roamswitch-sensor arp-events
Les événements détectés sont affichés par roamswitch-sensor arp-events et dans l’onglet « Événements ARP » de la TUI (Entrée pour les détails). Chaque événement comporte son horodatage, une gravité (de critique à info ; un changement de MAC de l’IP de la passerelle est « critique »), le raisonnement, l’identité des appareils concernés et des actions concrètes à mener.
6.1 Extension de la visibilité LAN passive (opt-in)
Alors que la surveillance ARP ci-dessus ne couvre que les appareils avec lesquels Sensor a lui-même communiqué, définir la variable d'environnement ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE sur une interface cible permet d'observer uniquement les en-têtes Ethernet/IPv4/IPv6 sur celle-ci et ce que les appareils annoncent d'eux-mêmes (le contenu des données n'est lu que pour DNS, DHCP, mDNS, SSDP, WS-Discovery et LLDP) et d'effectuer ce qui suit.
- Observation passive des nouveaux appareils : appareils avec lesquels Sensor n'a jamais communiqué directement, non couverts par la seule surveillance ARP. Appris à partir du trafic broadcast/multicast.
- Détection du contact avec des IP malveillantes connues : signale le trafic dont l'IP de destination correspond au flux de menaces local (même format que l'Egress Guard de RoamSwitch lui-même) — détection uniquement, jamais bloqué.
- Balises VLAN (802.1Q / 802.1ad) : quand le port miroir est un trunk, les trames étiquetées sont lues aussi (jusqu'à une double balise). Les ID de VLAN vus sont conservés dans le registre des appareils, 8 au plus par appareil. Ils ne sont ajoutés qu'aux appareils déjà présents dans le registre ; un ID de VLAN seul ne crée jamais d'appareil.
- Trafic IPv6 : la source, la destination et les ports sont lus comme pour IPv4. Les contrôles « nouvel appareil » et « IP malveillante connue » ne portent que sur IPv4 (les adresses de confidentialité IPv6 changent sans cesse). Le trafic IPv6 sert à l'apprentissage du comportement par appareil et à la détection des envois massifs et des connexions vers les ports d'administration des appareils IoT.
- Ce que les appareils annoncent d'eux-mêmes : LLDP (nom et description des commutateurs, points d'accès et téléphones IP), TXT mDNS (
model=md=ty=) et WS-Discovery (UDP 3702 ; nom et modèle des caméras ONVIF) sont lus et deviennent l'« indice de modèle » du registre des appareils. Les chaînes annoncées sont enregistrées sans caractères de contrôle et limitées à 96 caractères.
sudo systemctl edit roamswitch-sensor.service
# [Service]
# Environment=ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE=eth0
sudo systemctl restart roamswitch-sensor.service
roamswitch-sensor passive-events
Après avoir ajouté la variable d'environnement, redémarrez avec sudo systemctl restart roamswitch-sensor. systemctl edit seul n'est pas pris en compte par le démon en cours d'exécution. Vérifiez la prise en compte avec « Capture passive : réception sur eth0 » dans roamswitch-sensor status. Si « La capture passive est désactivée » s'affiche toujours, le redémarrage n'a pas eu lieu.
Le tampon de réception se règle avec capture.rcvbuf_mb (en MiB ; 4 par défaut, 0 pour la valeur par défaut du système). Comme le seul privilège est CAP_NET_RAW, tout ce qui dépasse net.core.rmem_max est tronqué. Si kernel_drops apparaît, augmentez rmem_max (par exemple : sudo sysctl -w net.core.rmem_max=8388608 ; pour le rendre permanent, utilisez /etc/sysctl.d/) et augmentez aussi capture.rcvbuf_mb.
6.2 Registre des appareils et notes d’appareil
L'inventaire s'affiche avec roamswitch-sensor device-inventory. Les appareils pour lesquels une note a été enregistrée avec device-note sont « connus » ; les autres sont « à vérifier ». Les ID de VLAN observés apparaissent aussi dans la colonne vlans de l'export, entre autres.
sudo roamswitch-sensor refresh
roamswitch-sensor device-inventory
sudo roamswitch-sensor device-note aa:bb:cc:dd:ee:ff "3F copier"
6.3 Informations de référence sur les comportements suspects (détection uniquement)
Lorsque la capture passive (§6.1, activée sur option) est active, les informations de référence suivantes sont présentées. Il s’agit uniquement de détection et d’affichage ; Sensor ne bloque jamais le trafic.
- Comportement des appareils IoT (
iot-events) : connexions d’appareils classifiés vers des IP malveillantes connues ou vers des ports d’administration (SSH/RDP/SMB, etc.). L’identification du modèle à partir des annonces mDNS/SSDP/DHCP/LLDP/WS-Discovery des appareils eux-mêmes est également utilisée. - Trafic suspect (
network-threats) : connexions vers de nombreuses destinations dans une fenêtre de 30 secondes (signe de balayage ou de rebond), afflux de connexions vers une même destination (signe de participation à un DDoS) et signes de tunneling DNS/C2 (seules les caractéristiques structurelles des noms de requête sont utilisées ; les noms de domaine ne sont pas stockés). - Avis de sécurité (
iot-advisories) : informations de référence sur les CVE publiques concernant les produits de constructeurs IoT connus (intégrées statiquement ; aucune mise à jour via le réseau).
6.4 Affichage de ce que le Sensor ne voit pas (couverture)
La surveillance passive ne peut pas, à elle seule, distinguer l'absence de tout son d'un réseau calme. Le Sensor ne compte que ce qu'il a pu observer lui-même et ne confond pas ce qu'il ne voit pas avec « aucun événement ». Il n'ouvre ni nouvelle connexion ni nouveau socket. Activé par défaut.
roamswitch-sensor statuset l'écran d'état de la TUI (i) affichent un bloc « ce qui est visible » : l'état de la capture passive (en réception, nom de l'interface, nombre de trames jusqu'ici, secondes depuis la dernière trame, ou désactivée) et une ligne par cause pour tout ce qui n'est pas vu.- Les notifications (Webhook, syslog) ne partent que vers des destinations déjà configurées par l'exploitant : un
coverage_gap(gravité medium) quand un angle mort apparaît et uncoverage_restored(info) quand il disparaît. Ce qui peut n'être que du calme (info) s'affiche seulement à l'écran et n'est pas notifié. - Lorsque l'envoi au collecteur est activé,
summary.captureetsummary.coverage_notess'ajoutent à l'envoi existant, et la liste des Sensors du tableau de bord affiche un badge et une carte de comptage pour les angles morts.
Exemples de causes comptées : la capture passive ne peut pas être ouverte, un blocage de 30 secondes ou plus, 5 échecs de réception consécutifs, aucune trame pendant 5 minutes avec le lien également coupé, des abandons du noyau (10 dernières minutes), des trames de plus de 2048 octets et des trames dont l'en-tête est illisible. Un cycle où la table ARP est illisible est compté sans effacer la référence.
Ce qu'il ne peut pas faire Il ne compte que ce que le Sensor peut observer lui-même. Il ne peut pas distinguer un cas où la réception est bonne mais où les trames qui arrivent sont biaisées, comme un port miroir mal configuré. Lorsqu'aucune trame n'est passée en 5 minutes alors que le lien est actif (capture_silent, info), il dit clairement qu'il ne peut pas distinguer « calme » de « n'entend rien ».
7. Référence des commandes CLI
| Commande | Description |
|---|---|
roamswitch-sensor status |
Affiche la clé publique, l’IP et l’adresse MAC propres de Sensor, le nombre de terminaux appairés, d’événements ARP et de demandes d’audit en attente, ainsi que l’état TLS de l’API de contrôle |
roamswitch-sensor issue-code |
Émet un code d’appairage à usage unique (valable 10 minutes) ; affiche aussi l’empreinte du certificat de Sensor |
roamswitch-sensor list |
Affiche la liste des terminaux appairés |
roamswitch-sensor pair <public-key> [--addr <IP>] [--name <name>] --confirm |
Appaire manuellement un terminal en indiquant directement sa clé publique et son adresse (il est en principe plus simple d'utiliser issue-code et de laisser le terminal s'appairer lui-même) |
roamswitch-sensor unpair <public-key> |
Supprime un appairage |
roamswitch-sensor scan <public-key> |
Exécute un audit actif de vulnérabilités sur un terminal appairé |
roamswitch-sensor history [public-key] |
Affiche l'historique d'audit (omettre la clé publique pour tous les terminaux) |
roamswitch-sensor report <public-key> [--out <file>] |
Exporte le résultat d'audit le plus récent sous forme de rapport Markdown |
roamswitch-sensor arp-events |
Affiche les événements ARP détectés (nouveaux appareils, suspicion d'usurpation) |
roamswitch-sensor pairing show / tls show |
Affiche l’état TLS de l’API de contrôle (mode, empreinte, avertissement de connexion en clair, IP d’écoute, acceptation ou non des anciennes signatures v1) ; pairing show et tls show sont équivalents |
roamswitch-sensor tls rotate |
Régénère le certificat TLS (tous les épinglages de l’ancienne empreinte deviennent invalides ; les terminaux doivent réépingler) |
roamswitch-sensor refresh |
Relance immédiatement l’analyse du LAN (balayage ARP) et met à jour le registre des appareils |
roamswitch-sensor device-inventory |
Affiche le registre des appareils (tous les appareils observés sur le LAN, leur état en ligne et leur note) |
roamswitch-sensor device-note <MAC> [note] |
Enregistre une note pour un appareil (omettez la note pour la supprimer) |
roamswitch-sensor passive-events / iot-events / network-threats / iot-advisories |
Affiche les événements issus de la capture passive (nouveaux appareils et connexions vers des IP malveillantes / comportement IoT / trafic suspect / avis de sécurité IoT) |
roamswitch-sensor lan-overview [--json]roamswitch-sensor network-threats --json [--limit N] [--min-severity …] [--lang …] |
Affiche l'état global du LAN (nombre d'appareils, VLAN, nombre de menaces, etc.) et la liste des menaces. --json produit du JSON (--limit : 500 au maximum). Les deux sont en lecture seule et peuvent être exécutés sans être root. PersonalSOC et la version Linux de MCP les lisent. |
roamswitch-sensor config [show | set <clé> <valeur>] |
Affiche ou modifie les réglages (audits planifiés, notifications, conservation, collecteur, API de contrôle, récupération des données de détection, langue). control.bind_addr et control.tls prennent effet au redémarrage du démon ; les autres n’exigent aucun redémarrage (§11.8) |
roamswitch-sensor diff [clé publique] |
Afficher ce qui a changé depuis l'audit précédent (nouvelles détections, résolues, ports nouvellement ouverts, injoignable probable) |
roamswitch-sensor export <scans|inventory|audit-log|unmanaged|all> … |
Écrire les preuves d'audit en CSV / JSON / HTML imprimable |
roamswitch-sensor audit-log [verify] |
Afficher le journal des opérations et des approbations ; verify détecte toute altération de la chaîne de hachage |
roamswitch-sensor notify-test |
Envoyer une notification de test aux destinations configurées (webhook / syslog) pour vérifier la connexion |
roamswitch-sensor audit-unmanaged <IP|MAC> --confirmroamswitch-sensor unmanaged-audits |
Audit léger des appareils sans RoamSwitch (tests de connexion seulement). audit-unmanaged <IP ou MAC> --confirm en lance un à la main, unmanaged-audits [--detail] liste les résultats (§13) |
roamswitch-sensor design-hypotheses [鍵] --llm 名前 |
Fait écrire des pistes non vérifiées par l'outil d'IA choisi à partir du dernier résultat design_flaw (§5.2). --llm, --model, --timeout, --show-prompt |
roamswitch-sensor lockdown [status | on | off] |
Indique si le Sensor est verrouillé (status), le verrouille (on --reason TEXTE) ou le déverrouille (off). Verrouillé, il arrête l'appairage, les audits, les envois et les notifications (§14) |
roamswitch-sensor decommission --confirm |
Efface les clés et les données de ce Sensor et le verrouille (irréversible). Le journal d'audit est conservé, et les terminaux qui lui étaient appairés sont listés avec la façon de les dissocier (§14) |
Le CLI ne prend en charge que le japonais et l'anglais (il suit la variable d'environnement LANG).
8. Guide d'utilisation du TUI
La TUI interactive (roamswitch-sensor-tui) existe en 10 langues et permet de tout faire comme la CLI et les paramètres (m affiche la liste des fonctions). Les 6 onglets principaux (appairés, configuration réseau, événements ARP, historique des audits, différences, journal des opérations) se changent avec Tab. Les différences affichent en rouge les nouveautés, en vert les éléments résolus et en jaune les cas de suspicion d'inaccessibilité.
| Touche | Action |
|---|---|
Tab | Change d'onglet |
↑↓ / j k | Sélectionne un élément |
c | Émet un code d’appairage (valable 10 minutes). L’écran affiche la commande à exécuter sur le terminal, sudo roamswitch sensor pair --addr <this Sensor’s IP> --code <code> --fingerprint <fingerprint>, avec les valeurs réelles déjà renseignées |
u | Supprime un appairage |
s | Exécute un audit actif de vulnérabilités sur le terminal sélectionné |
a | (Onglet Appareils réseau) Audit léger de l'appareil sélectionné, après un écran de confirmation (§13). Les résultats sont dans l'onglet « Appareils non gérés » du menu |
K | Verrouille ou déverrouille ce Sensor après un écran de confirmation ; un bandeau rouge reste en bas de chaque écran tant qu'il est verrouillé. La mise hors service est dans le menu (§14) |
n | (Onglet Appareils) Ajouter une note — nom, usage, emplacement — à l'appareil sélectionné ; un appareil avec note est considéré comme identifié |
r | Réanalyser le LAN maintenant (balayage ARP ; sinon exécuté automatiquement toutes les heures) |
e | Exporte les preuves d’audit (CSV des résultats d’analyse, du registre des appareils et du journal d’audit ; rapport HTML ; JSON). Un formulaire permet de choisir le contenu, le format, le terminal, la date de début et la destination ; les fichiers sont produits dans la langue d’affichage (10 langues). La destination par défaut est ~/.local/state/roamswitch-sensor/ ; les fichiers sont créés neufs et lisibles uniquement par leur propriétaire (un fichier existant n’est jamais écrasé), et l’export lui-même est consigné dans le journal d’audit |
p | Appairage manuel (saisie de la clé publique et de l’adresse, puis écran de confirmation, puis exécution). Le formulaire affiche l’empreinte TLS de Sensor que le terminal épingle |
T | État TLS et appairage (mode, empreinte, avertissement de connexion en clair, IP d’écoute, acceptation ou non des anciennes signatures v1). R régénère le certificat (avec un écran de confirmation qui en explique l’impact) |
C | Éditeur de configuration (affiche et modifie chaque clé de configuration ; les URL de webhook sont toujours masquées ; les clés nécessitant un redémarrage sont signalées) |
N | Test de notification (affiche le succès ou l’échec pour chaque destination ; les URL sont masquées) |
m | Menu des fonctions (surveillance passive, comportement IoT, trafic suspect, avis de sécurité IoT, état i, gestion du collecteur, etc.) |
O | Gestion du collecteur (uniquement sur un hôte disposant du répertoire de données du collecteur) : enrôler, révoquer et lister les Sensors, jeton de lecture, et effacement d’une anomalie du journal d’audit. n règle la destination des alertes propres au collecteur |
f / l / v | (Onglet Historique des analyses) filtre par terminal. (Onglet Journal d’audit) l modifie le nombre de lignes affichées et v revérifie la chaîne de hachage |
Enter | Afficher le détail de la ligne sélectionnée (historique, changements, événements ARP, appareils, journal) |
w | (Dans une vue détaillée) écrit le rapport dans un fichier à la destination de votre choix (produit dans la langue d’affichage) |
L | Choisit la langue d’affichage (enregistrée dans le réglage language : elle s’applique donc aussi aux notifications et aux journaux produits par le démon) |
q | Quitte |
9. Modèle de confiance & conception de sécurité
- Confirmation hors bande (pas de TOFU) : l’opérateur transmet au terminal l’empreinte du certificat affichée sur l’écran de Sensor et le code d’appairage, de vive voix, par chat ou équivalent. Le terminal ne récupère jamais l’empreinte via le réseau (ce n’est pas du TOFU, qui fait aveuglément confiance à la première connexion) et ne dialogue et n’établit un appairage qu’avec un Sensor dont le certificat correspond à la valeur saisie. Les clés publiques échangées lors de l’appairage vérifient ensuite chaque sonde et chaque requête.
- Conçu pour découvrir les failles qui permettraient une action destructive, sans jamais en exécuter une lui-même : chaque audit actif de vulnérabilités est non destructif (il n'écrit ni ne supprime jamais de données, et n'arrête jamais de service). Ce qui est détecté, ce sont les erreurs de configuration elles-mêmes — comme « inscriptible sans authentification » ou « fonctionne comme relais ouvert » — qui, si exploitées, permettraient une action destructive.
- Prévention des faux positifs (exclusion de l'auto-audit) : pour que la garde de détection des scans de ports entrants ne confonde pas l'audit de tous les ports du Sensor, celui-ci est exclu d'après son IP source (l'IP n'est pas utilisée pour décider de la confiance). Entre la demande d'audit du terminal et le rapport (environ 25 minutes au plus), la notification reste sobre. À tout autre moment, l'avertissement reste fort comme auparavant.
- Le trafic sortant est limité et aucune donnée d’appareil n’est envoyée par défaut : les informations sur les appareils découverts, les résultats d’audit et les événements ARP sont stockés uniquement dans le stockage local de Sensor par défaut et ne sont jamais envoyés à Lafine ni à un tiers. Le seul trafic sortant est la récupération des données de détection (la carte des CVE et la base de données NSE de nmap ; elle peut être arrêtée avec
updates.fetch_cve_mapet ne contient aucune donnée d’appareil ni d’audit), ainsi que les notifications (webhook, syslog) et les envois au collecteur central décrits au §11, qui ne vont que vers vos propres destinations et uniquement si vous les configurez.
10. Dépannage & FAQ
Q1. La saisie d'un code d'appairage est rejetée.
Il y a quatre causes possibles. (1) Plus de 10 minutes se sont écoulées depuis l'émission (la réémettre avec issue-code). (2) Une erreur de saisie. (3) L'IP de --addr diffère de l'IP fixe du Sensor. (4) --fingerprint diffère du certificat (à vérifier avec roamswitch-sensor pairing show). Des erreurs répétées entraînent un blocage rate_limited.
Q2. Le résultat du diagnostic complémentaire NSE est vide.
La cause est l'une des deux suivantes. (1) nmap n'est pas installé dans le conteneur. (2) L'exécution a eu lieu, mais aucun script sûr correspondant aux ports cibles n'a réellement produit de sortie. Le diagnostic complémentaire nmap NSE s'exécute automatiquement si nmap est installé sur l'hôte.
Q3. Combien de temps prend un audit complet ?
Le seul balayage de tous les ports prend quelques dizaines de secondes. Si nmap est installé sur l'hôte, le diagnostic complémentaire NSE s'y ajoute automatiquement et peut durer jusqu'à 2 minutes environ, selon le nombre de ports ouverts de la cible. La TUI affiche en continu les secondes écoulées pendant l'exécution, ce qui permet de suivre la progression.
Q4. J'ai appairé, mais je n'arrive toujours pas à lancer d'audit.
Il y a quatre causes possibles. (1) sensor_pairing_enabled: true n'est pas défini sur le terminal (désactivé par défaut). (2) L'IP fixe du Sensor a changé (un nouvel appairage est nécessaire). (3) Un unpair a été effectué côté Sensor. (4) Le certificat a été régénéré, et l'épinglage du terminal est périmé (roamswitch sensor repin). Vérifiez dans les listes des deux côtés l'enregistrement de l'autre.
Q5. Sensor peut-il être utilisé en parallèle de RoamSwitch lui-même (Client/Server Edition) ?
Oui. Sensor étant conçu sans fonction d'autodéfense, nous recommandons d'installer également RoamSwitch for Linux Server Edition sur la même machine. Les deux fonctionnent avec des processus et des stockages de données totalement indépendants, sans conflit.
Q6. roamswitch sensor results indique que l’appairage a été révoqué.
L’appairage de ce terminal a été supprimé côté Sensor avec unpair. Demandez à l’opérateur du Sensor d’émettre un nouveau code d’appairage, puis réappairez avec roamswitch sensor pair --addr <ip> --code <code> --fingerprint <SHA-256>.
11. Fonctions d'audit à l'échelle d'une organisation (optionnelles)
Un ensemble de fonctions pour les équipes de sécurité des grandes organisations qui ont besoin de preuves d'audit et d'une vue claire de ce qui a changé. Toutes sont désactivées par défaut, et rien n'est jamais envoyé à Lafine ni à un tiers : chaque destination de notification ou d'agrégation est choisie par votre organisation. Les réglages se modifient avec sudo roamswitch-sensor config set <clé> <valeur> (sans redémarrer le démon ; chaque modification est consignée dans le journal des opérations) ; config show affiche les valeurs actuelles.
11.1 Audits planifiés et détection des changements
Avec schedule.enabled à true, tous les terminaux appairés sont audités périodiquement (toutes les 24 heures par défaut). La différence avec l'audit précédent se vérifie avec roamswitch-sensor diff. Lorsque tous les ports ouverts auparavant deviennent invisibles, on ne peut pas les distinguer d'un terminal à l'arrêt ; le cas est donc classé suspicion d'inaccessibilité.
Même les audits sans surveillance ne rompent pas la garantie de n'auditer que les terminaux consentants. La MAC du moment de la dernière authentification du terminal est enregistrée, et avant et après l'audit, l'ARP de nmap vérifie que la même MAC répond sur cette IP. Si elle diffère, l'audit n'est pas effectué (ou son résultat est écarté) et une notification est envoyée.
Les terminaux d'un autre VLAN sont exclus par défaut. Avec schedule.allow_routed_endpoints (désactivé par défaut), la vérification se fait notamment par l'arrivée d'une requête signée depuis la même adresse dans les schedule.routed_proof_minutes (30 minutes par défaut, de 5 à 1440).
Les raisons pour lesquelles il ne s'exécute pas (pas de nmap, appareil sans adresse, appareil sans liaison d'identité) apparaissent comme avertissement dans « Périmètre visible » de status. Si une destination de notification est définie, un coverage_gap est envoyé une fois, puis coverage_restored une fois le problème résolu. Pendant le verrouillage et hors de la plage horaire, il n'y a pas d'avertissement, mais une ligne dans status.
11.2 Notifications (webhook et syslog)
Les régressions, nouveaux appareils, usurpations ARP, etc. sont envoyés à notify.webhook_urls et notify.syslog.host (RFC 5424, UDP ou TCP). On peut filtrer avec notify.min_severity et l'intervalle de renvoi, et vérifier la connectivité avec roamswitch-sensor notify-test.
status affiche les destinations de notification et le dernier résultat de livraison. Tant que la livraison échoue, un avertissement s'affiche ; vérifiez avec roamswitch-sensor notify-test. En cas de succès, l'avertissement disparaît.
11.3 Export des preuves d'audit
roamswitch-sensor export <scans|inventory|audit-log|all> --format csv|json|html [--out fichier] [--endpoint début de la clé publique] [--since date]. Le html peut être enregistré en PDF depuis un navigateur. Le CSV est protégé contre l'injection de formules. La sortie est en 0600, et l'export lui-même est aussi consigné dans le journal des opérations. Dans la TUI, la touche e permet les mêmes réglages.
11.4 Journal des opérations et des approbations (infalsifiable)
L'appairage, les audits, les modifications de configuration et les accès refusés sont consignés avec leur auteur. Chaque ligne forme une chaîne de hachage contenant le SHA-256 de la ligne précédente, et toute altération se détecte avec roamswitch-sensor audit-log verify (code de sortie 2 en cas d'anomalie). Les valeurs des URL de webhook ne sont pas conservées. Pour parer à une suppression de la fin, le début est aussi envoyé au collecteur (§11.6).
11.5 Conservation
Renseignez retention.scan_history_days, retention.audit_log_days et retention.inventory_stale_days pour supprimer automatiquement l'ancien historique d'audit, les anciennes entrées du journal et les appareils non vus depuis longtemps (0 = aucune suppression par ancienneté, valeur par défaut). Les appareils ayant une note ne sont jamais retirés de l'inventaire.
11.6 Agréger plusieurs Sensors (collecteur central, optionnel)
Lorsque plusieurs Sensors fonctionnent sur plusieurs sites, exécutez roamswitch-sensor-collector (fourni dans le paquet, désactivé par défaut) sur un hôte distinct pour collecter les synthèses signées de chacun.
# On the collector host (a separate host from the Sensor is recommended)
sudo systemctl enable --now roamswitch-sensor-collector # listens on 127.0.0.1:8443 by default
sudo roamswitch-sensor-collector token # read token for the dashboard
sudo roamswitch-sensor-collector enroll <Sensor public key> --name Tokyo --site Tokyo
# On each Sensor
sudo roamswitch-sensor config set collector.url https://collector.example.org:8443
sudo roamswitch-sensor config set collector.enabled true
- Seules les requêtes signées (Ed25519) des Sensors enregistrés (
enroll) sont acceptées ; l'horodatage permet en outre de rejeter les rejeux. - TLS est obligatoire dès que le service est joignable depuis l'extérieur du LAN. Placez
--bind 0.0.0.0:8443 --tls-cert … --tls-key …dansCOLLECTOR_ARGSde/etc/default/roamswitch-sensor-collector, ou utilisez--allow-plain-httpderrière un reverse proxy qui termine TLS. Écouter sur autre chose que 127.0.0.1 sans TLS est refusé au démarrage. - Le tableau de bord est protégé par un jeton et propose un filtrage par site, les événements par gravité et l'export CSV. Il met en évidence les Sensors devenus silencieux ainsi que ceux dont le journal d'audit semble tronqué, revenu en arrière ou bifurqué (à lever avec
clear-anomaly <clé-publique>après enquête). - Avec
collector.send_unmanaged_devices(truepar défaut), les appareils non appairés sont aussi inclus dans le résumé et répartis entre « hôtes RoamSwitch non appairés » et « appareils inconnus ». Seuls la MAC, le fabricant, la classe d'appareil et la première détection sont envoyés ; le contenu des communications n'est pas inclus. - Lorsque
collector.send_unmanaged_audits(falsepar défaut) est activé, il envoie, à partir du dernier audit léger des appareils sans RoamSwitch, les produits listés dans KEV, les services ayant répondu sans authentification et le nombre de détections (jusqu'à 200 appareils). Les bannières, les requêtes et réponses et les enregistrements de l'approbateur ne sont pas envoyés. « Non confirmé » ne signifie pas forcément vulnérable. - Le Sensor envoie
summary.behavior_learned_devices(nombre d'appareils dont la période d'apprentissage est terminée) etsummary.behavior_anomalies_active(nombre d'appareils au comportement inhabituel dans les dernières 24 heures). Ce ne sont que des nombres ; aucun nom d'appareil n'est envoyé. Si l'apprentissage du comportement est désactivé, les deux valent 0. Ils apparaissent dans une carte du tableau de bord et dans le détail du Sensor. - Lorsque le même appareil (MAC) ou terminal appairé est signalé par un Sensor d'un autre site, il est consigné comme « itinérance entre sites » (
/api/roaming, tableau de bord). Les sites sont comparés d'après le nom donné dansenroll --site. Les enregistrements sont conservés 90 jours, dans la limite de 500, et seuls la MAC, la clé publique, le nom du site et l'heure sont stockés. - Un Sensor arrêté ou volé ne peut pas se signaler lui-même ; le collecteur prévient donc par Webhook / syslog. Sont concernés : un Sensor sans envoi depuis plus de
--stale-minutes(60 minutes par défaut), les anomalies du journal d'audit (critical) et l'itinérance entre sites (info). Les renvois sont limités par défaut à 30 minutes, et dans les 20 minutes suivant un redémarrage aucun Sensor n'est jugé arrêté. Tant qu'aucune destination n'est définie, rien n'est envoyé ni bloqué. L'URL du webhook est transmise sur l'entrée standard, et les redirections ne sont pas suivies.
# On the collector host: where the collector's own alerts go
echo 'https://hooks.example.org/…' | sudo roamswitch-sensor-collector notify set --add-webhook - --min-severity high
sudo roamswitch-sensor-collector notify set --syslog-host 192.0.2.10 --syslog-protocol tcp
sudo roamswitch-sensor-collector notify show # a Webhook URL is shown up to its host only
sudo roamswitch-sensor-collector notify test
Lorsque le collecteur n'a pas pu lire son historique (scans.jsonl, events.jsonl), il compte ce qui n'a pas pu être lu, pour que cela ne soit pas pris pour « aucune donnée ». Une ligne corrompue est ignorée seule, et les lignes dont la date est illisible ne sont pas supprimées par le nettoyage. Le résultat apparaît dans storage_health de /api/overview, dans le tableau de bord et dans le journal de démarrage. Aucune nouvelle communication n'a lieu.
11.7 Récupération des données de détection (updates.fetch_cve_map)
Sensor récupère chaque jour auprès du service de mise à jour la carte des CVE signée (les données de vulnérabilités connues utilisées par les vérifications actives) et la base de données NSE de nmap. Ce trafic ne transporte aucune donnée d’appareil ni d’audit. Pour fonctionner entièrement hors ligne, exécutez sudo roamswitch-sensor config set updates.fetch_cve_map false (le changement prend effet au cycle suivant sans redémarrage, et seules les données intégrées sont ensuite utilisées).
11.8 Référence des clés de configuration
Consultez les valeurs actuelles avec roamswitch-sensor config show et modifiez-les avec config set <key> <value> [<key> <value> …] (plusieurs clés sont enregistrées de façon atomique ; l’éditeur de configuration C de la TUI les modifie aussi). Seules les clés marquées « Oui » dans la colonne Redémarrage exigent un redémarrage du démon (sudo systemctl restart roamswitch-sensor).
| Clé | Type / valeurs | Par défaut | Redémarrage |
|---|---|---|---|
site | string | (empty) | Non |
language | ja | en | ko | zh-Hans | zh-Hant | de | fr | es | it | pt-PT | (empty = system locale) | Non |
schedule.enabled | bool | false | Non |
schedule.interval_hours | int | 24 | Non |
schedule.window_start_hour | int 0–23 | (unset = always) | Non |
schedule.window_end_hour | int 0–23 | (unset = always) | Non |
schedule.max_parallel | int 1–8 | 1 | Non |
schedule.allow_routed_endpoints | bool | false | Non |
schedule.routed_proof_minutes | int 5–1440 | 30 | Non |
notify.webhook_urls | URL list | (empty) | Non |
notify.min_severity | info | medium | high | critical | medium | Non |
notify.cooldown_minutes | int | 30 | Non |
notify.syslog.host | string | (empty = off) | Non |
notify.syslog.port | int | 514 | Non |
notify.syslog.protocol | udp | tcp | udp | Non |
retention.scan_history_days | int (0 = never prune) | 0 | Non |
retention.audit_log_days | int (0 = never prune) | 0 | Non |
retention.inventory_stale_days | int (0 = never prune) | 0 | Non |
collector.enabled | bool | false | Non |
collector.url | URL | (empty) | Non |
collector.push_interval_minutes | int | 15 | Non |
collector.send_unmanaged_devices | bool | true | Non |
collector.send_unmanaged_audits | bool | false | Non |
collector.probe_control_port | bool | false | Non |
control.bind_addr | IP address | 0.0.0.0 | Oui |
control.tls | off | optional | required | optional | Oui |
control.allow_legacy_signatures | bool | true | Non |
updates.fetch_cve_map | bool | true | Non |
control.listen_ipv6 | bool | false | Oui |
capture.rcvbuf_mb | int 0–256 (MiB, 0 = system default) | 4 | Oui |
dhcp.active_probe | bool | true | Non |
dhcp.allowed_servers | MAC / IP list | (empty = learn the first) | Non |
ipv6.enabled | bool | true | Non |
ipv6.active_probe | bool | true | Non |
ipv6.allowed_routers | MAC / IP list | (empty = trust the IPv4 gateway) | Non |
unmanaged_audit.enabled | bool (needs authorization + allowed_cidrs first) | false | Non |
unmanaged_audit.authorization | string | (empty) | Non |
unmanaged_audit.allowed_cidrs | CIDR list (IPv4 ≤ /16 and IPv6 ≤ /48 refused) | (empty) | Non |
unmanaged_audit.exclude | IP / CIDR / MAC list | (empty) | Non |
unmanaged_audit.interval_hours | int | 168 | Non |
unmanaged_audit.max_parallel | int 1–4 | 2 | Non |
unmanaged_audit.product_check | bool (needs unmanaged_audit.enabled) | false | Non |
unmanaged_audit.noauth_check | bool (needs unmanaged_audit.enabled) | false | Non |
design_flaw.enabled | bool | false | Non |
design_flaw.llm.tool | claude | opencode | codex | agy | (empty) | (empty) | Non |
design_flaw.llm.model | string | (empty) | Non |
design_flaw.llm.timeout_secs | int (0 or 5–600) | 0 | Non |
security.on_revoked | lockdown | wipe | none | lockdown | Non |
security.lockdown_after_offline_days | int (0 = off) | 0 | Non |
12. Détection DHCP et IPv6 pirates
Détecte les attaques où un routeur ou un appareil similaire introduit se fait passer pour légitime et détourne le chemin de communication des terminaux. Il se limite à détecter et notifier ; il ne bloque pas le trafic. Activé par défaut, sans capture passive requise. Les résultats apparaissent dans roamswitch-sensor network-threats, la TUI, les notifications, les journaux et les exports.
12.1 Serveurs DHCP pirates (IPv4 et DHCPv6)
Chaque heure, il envoie un seul DHCP discover depuis une MAC aléatoire et compte tous les serveurs qui répondent. Il n'envoie pas de REQUEST et n'emprunte pas d'adresse. Il apprend le premier serveur comme légitime et signale ceux qui apparaissent ensuite. Tout serveur distribuant une autre passerelle ou un autre DNS est critical.
12.2 IPv6 (annonces de routeur pirates, usurpation NDP, appareils IPv6 seuls)
Annonces de routeur illégitimes : si un appareil autre que la passerelle IPv4 se comporte en routeur IPv6, une notification est envoyée (à enregistrer dans ipv6.allowed_routers si la configuration est normale). Les annonces dont la limite de sauts n'est pas 255 sont ignorées. Usurpation NDP : signalée lorsque la MAC d'une adresse IPv6 est remplacée (high s'il s'agit d'un routeur). Appareils visibles uniquement en IPv6 : les appareils n'apparaissant que dans la table de voisinage sont signalés.
12.3 Qui est légitime, et les réglages
Si dhcp.allowed_servers et ipv6.allowed_routers sont définis, toute réponse d'un autre émetteur est signalée (si la liste est vide, le premier est appris). ipv6.enabled permet de désactiver la surveillance IPv6. L'écoute IPv6 de l'API de contrôle (50543) s'ajoute avec control.listen_ipv6 (false par défaut). L'IPv6 global peut être joignable depuis Internet ; il est donc désactivé par défaut.
13. Audit léger des appareils sans RoamSwitch (optionnel)
L'audit actif des vulnérabilités du §5 ne vise que les terminaux appairés et consentants. Pour vérifier « ce qui est ouvert vers l'extérieur » sur des imprimantes, caméras, NAS, etc. non appairés, on peut utiliser une vérification distincte, bien plus limitée. Les diagnostics approfondis de type OpenVAS, les tentatives de connexion, l'exploitation de vulnérabilités, nmap NSE et les scans de tous les ports ne sont effectués que sur les terminaux consentants.
13.1 Ce qui est fait
Il se limite à des vérifications de connexion TCP sur 55 ports fixes, à la lecture de la bannière qu'un port ouvert envoie de lui-même (un seul HEAD / pour le web) et à des notes sur des vulnérabilités déjà publiées. Le résultat dit « joignable depuis le LAN », jamais « vulnérable ». L'identification du produit et la vérification de l'authentification sont des options distinctes à activer (désactivées par défaut).
13.2 L'activer
Avant l'activation, définissez unmanaged_audit.authorization (l'approbateur) et unmanaged_audit.allowed_cidrs (la plage ; toute plage plus large que /16 en IPv4 ou /48 en IPv6 est refusée). L'exécution planifiée a lieu par défaut toutes les 168 heures ; l'exécution manuelle exige --confirm.
sudo roamswitch-sensor config set unmanaged_audit.authorization "IT policy 2026-07, approved by A. Suzuki"
sudo roamswitch-sensor config set unmanaged_audit.allowed_cidrs 192.168.10.0/24
sudo roamswitch-sensor config set unmanaged_audit.exclude 192.168.10.1
sudo roamswitch-sensor config set unmanaged_audit.enabled true
sudo roamswitch-sensor audit-unmanaged 192.168.10.40 --confirm
roamswitch-sensor unmanaged-audits --detail
13.3 Garde-fous
Les appareils hors de allowed_cidrs, ceux de unmanaged_audit.exclude, les terminaux appairés et le Sensor lui-même ne sont jamais examinés, quoi qu'il arrive. L'adresse MAC est vérifiée avant et après ; si elle correspond à un autre appareil, l'examen est interrompu ou le résultat écarté. Le texte de authorization est consigné dans le journal à chaque exécution.
13.4 Vérification du produit (a-t-il des vulnérabilités du KEV de la CISA ? Opt-in)
unmanaged_audit.product_check (désactivé par défaut) lit le nom du produit dans l'interface web d'un appareil et indique s'il présente une vulnérabilité du CISA KEV. Il n'envoie que GET / et les redirections (2 au plus) vers les ports web (80, 8080, 8181, 443, 8443, 10443). Par conception, il n'envoie ni connexion, ni tentative de mot de passe, ni chemin deviné, ni entrée exploitant une vulnérabilité. Au plus 12 requêtes par appareil, espacées de 150 ms.
Un produit n'est nommé que si tous ses marqueurs apparaissent dans la même réponse. Si la version indiquée par l'appareil a un CVE dans une plage affectée du NVD, elle est signalée comme « concernée » (high) ; si la version est illisible, comme avis « non confirmé » (medium), sans déclarer l'appareil vulnérable. Seul MikroTik RouterOS expose une version lisible. Les produits pris en charge incluent Fortinet FortiGate, Ivanti Connect Secure et Citrix NetScaler. Les marqueurs reposent sur des signatures de détection publiques et n'ont pas été vérifiés sur de vrais appareils.
La copie du KEV est fournie avec le produit. Uniquement lorsque product_check et updates.fetch_cve_map sont tous deux activés, un fichier du flux public de la CISA est récupéré toutes les 24 heures (aucune information du LAN n'est envoyée).
Vérification de la réponse sans authentification (unmanaged_audit.noauth_check ; désactivée par défaut, sur adhésion) Envoie une seule requête en lecture seule à chacun des ports suivants, uniquement s'ils étaient ouverts : Redis (6379, PING), Memcached (11211), Docker API (2375), Elasticsearch (9200), etcd (2379), CouchDB (5984), kubelet (10250), ZooKeeper (2181), Ollama (11434). Aucune écriture, aucune modification de configuration, aucun AUTH, aucun envoi ni essai de mots de passe, aucune connexion.
MongoDB, MySQL et les autres ne sont pas examinés, car une tentative pourrait équivaloir à une connexion. Le résultat est l'un des suivants : « a répondu sans authentification », « authentification requise », « refusé », « indéterminé ». La vérification ne s'exécute qu'avec le même consentement que l'audit léger. À utiliser uniquement sur des appareils que vous administrez.
14. En cas de perte, de vol ou de mise hors service
Un Sensor contient la liste des vulnérabilités trouvées sur chaque terminal, les adresses des terminaux appairés et sa clé de signature. Les terminaux appairés le traitent aussi comme un scanner autorisé ; un Sensor volé branché sur le même LAN pourrait donc se faire passer pour tel. Voici ce qui l'en empêche.
14.1 Révocation sur le collecteur et verrouillage
Lorsqu'un Sensor est révoqué avec roamswitch-sensor-collector revoke <clé publique> --reason motif, ses envois sont refusés avec 403 sensor_revoked. Un Sensor qui apprend sa révocation s'arrête de lui-même (verrouillage) et suspend l'audit, l'envoi, les notifications et les sondages. L'arrêt persiste après un redémarrage, et les données sont conservées. Ce n'est que lorsqu'il est certain que le Sensor est entre les mains de son propriétaire que l'on peut le lever avec roamswitch-sensor lockdown off.
14.2 Effacement, mise hors service et détection hors ligne
Avec security.on_revoked réglé sur wipe, la révocation écrase par des zéros, puis supprime, les clés, la clé TLS, la configuration (y compris l'URL de Webhook), la liste des terminaux, les résultats d'audit et l'inventaire des appareils. Seuls les journaux d'opérations et d'approbations sont conservés, comme preuve. La valeur par défaut, lockdown, ne fait qu'arrêter le Sensor. Avec security.lockdown_after_offline_days (0 par défaut = désactivé), un Sensor qui ne peut plus envoyer pendant longtemps s'arrête aussi de lui-même.
14.3 Ce que cela ne peut pas faire
Les terminaux continuent de faire confiance à ce Sensor jusqu'à ce que chacun l'ait retiré, et le Sensor ne peut pas les en informer. Sur chaque terminal affiché, exécutez roamswitch sensor unpair <clé publique de ce Sensor> sous Linux, ou Réglages > Sensor > Dissocier sous Mac. Un Sensor emporté hors tension ne reçoit jamais l'ordre d'arrêt ; le chiffrement du disque (LUKS, etc.) est donc la vraie défense. L'effacement par écrasement ne garantit pas un effacement complet sur flash ou CoW.