ROAMSWITCH SENSOR ・ Dernière mise à jour : 2026-10-27

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.

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.

Politique de trafic sortant (aucune donnée d’appareil ni résultat d’audit envoyé par défaut)
Sensor n'est pas « Zero Telemetry ». (1) Récupération des données de détection : la table CVE et d'autres données sont récupérées chaque jour (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

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
Opt-in : extension de la visibilité LAN passive
Pour une utilisation avec un port miroir de commutateur (SPAN) ou un pont transparent en ligne, spécifiez le nom de l'interface cible dans la variable d'environnement 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.

Lorsqu'un code d'appairage a expiré
Un code d'appairage expire automatiquement 10 minutes après son émission et ne peut jamais être utilisé deux fois. Toute tentative d'appairage après expiration est rejetée. Dans ce cas, demandez à l'opérateur du Sensor d'en émettre un nouveau avec 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.

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
Passer control.tls à required
(1) Mettez à jour chaque terminal vers une version compatible TLS et effectuez l’appairage TLS (ou le réépinglage) sur chacun → (2) vérifiez que roamswitch-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.

  1. Analyse complète des ports : détecte de façon exhaustive tous les ports TCP ouverts sur l'hôte cible.
  2. 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, jamais DATA), et diagnostics de mauvaise configuration CORS, de traversée de répertoires et de redirection ouverte sur les serveurs de développement, entre autres.
  3. 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.0 pour reconnaître le service (32 ports au plus par audit).
  4. Diagnostic complémentaire nmap NSE : diagnostic complémentaire à large couverture de protocoles via nmap --script safe. S'exécute automatiquement dès que nmap est 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.

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.

Une carte réseau ordinaire vs un port miroir
Même une simple carte réseau ordinaire fonctionne pour détecter de nouveaux appareils dans le cadre du trafic ARP/broadcast/multicast (vérifié sur du matériel réel sur un LAN physique). Cependant, observer le trafic unicast général entre deux autres hôtes du LAN nécessite un port miroir de commutateur (SPAN), ou la configuration de Sensor en tant que pont transparent en ligne.

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.

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.

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> --confirm
roamswitch-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
TabChange d'onglet
↑↓ / j kSé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
uSupprime un appairage
sExé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
KVerrouille 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é
rRéanalyser le LAN maintenant (balayage ARP ; sinon exécuté automatiquement toutes les heures)
eExporte 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
pAppairage 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)
NTest de notification (affiche le succès ou l’échec pour chaque destination ; les URL sont masquées)
mMenu des fonctions (surveillance passive, comportement IoT, trafic suspect, avis de sécurité IoT, état i, gestion du collecteur, etc.)
OGestion 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
EnterAfficher 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)
LChoisit 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)
qQuitte

9. Modèle de confiance & conception de sécurité

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
# 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
sitestring(empty)Non
languageja | en | ko | zh-Hans | zh-Hant | de | fr | es | it | pt-PT(empty = system locale)Non
schedule.enabledboolfalseNon
schedule.interval_hoursint24Non
schedule.window_start_hourint 0–23(unset = always)Non
schedule.window_end_hourint 0–23(unset = always)Non
schedule.max_parallelint 1–81Non
schedule.allow_routed_endpointsboolfalseNon
schedule.routed_proof_minutesint 5–144030Non
notify.webhook_urlsURL list(empty)Non
notify.min_severityinfo | medium | high | criticalmediumNon
notify.cooldown_minutesint30Non
notify.syslog.hoststring(empty = off)Non
notify.syslog.portint514Non
notify.syslog.protocoludp | tcpudpNon
retention.scan_history_daysint (0 = never prune)0Non
retention.audit_log_daysint (0 = never prune)0Non
retention.inventory_stale_daysint (0 = never prune)0Non
collector.enabledboolfalseNon
collector.urlURL(empty)Non
collector.push_interval_minutesint15Non
collector.send_unmanaged_devicesbooltrueNon
collector.send_unmanaged_auditsboolfalseNon
collector.probe_control_portboolfalseNon
control.bind_addrIP address0.0.0.0Oui
control.tlsoff | optional | requiredoptionalOui
control.allow_legacy_signaturesbooltrueNon
updates.fetch_cve_mapbooltrueNon
control.listen_ipv6boolfalseOui
capture.rcvbuf_mbint 0–256 (MiB, 0 = system default)4Oui
dhcp.active_probebooltrueNon
dhcp.allowed_serversMAC / IP list(empty = learn the first)Non
ipv6.enabledbooltrueNon
ipv6.active_probebooltrueNon
ipv6.allowed_routersMAC / IP list(empty = trust the IPv4 gateway)Non
unmanaged_audit.enabledbool (needs authorization + allowed_cidrs first)falseNon
unmanaged_audit.authorizationstring(empty)Non
unmanaged_audit.allowed_cidrsCIDR list (IPv4 ≤ /16 and IPv6 ≤ /48 refused)(empty)Non
unmanaged_audit.excludeIP / CIDR / MAC list(empty)Non
unmanaged_audit.interval_hoursint168Non
unmanaged_audit.max_parallelint 1–42Non
unmanaged_audit.product_checkbool (needs unmanaged_audit.enabled)falseNon
unmanaged_audit.noauth_checkbool (needs unmanaged_audit.enabled)falseNon
design_flaw.enabledboolfalseNon
design_flaw.llm.toolclaude | opencode | codex | agy | (empty)(empty)Non
design_flaw.llm.modelstring(empty)Non
design_flaw.llm.timeout_secsint (0 or 5–600)0Non
security.on_revokedlockdown | wipe | nonelockdownNon
security.lockdown_after_offline_daysint (0 = off)0Non

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.

← Manuel d'exploitation Server Edition Vers la page d'installation de l'édition Linux →