RoamSwitch Sensor Betriebshandbuch
Einrichtungs- und Betriebsleitfaden für einen Netzwerksensor, der allein durch das Aufstellen im LAN das Auftauchen neuer Geräte im selben Segment sowie Spoofing erkennt. Für Endgeräte mit installiertem RoamSwitch (Mac / Linux Client / Server Edition) führt er zusätzlich aktive Schwachstellen-Audits durch. Wird als apt-/dnf-Paket verteilt.
1. Überblick & Einordnung
RoamSwitch (Mac / Linux Client / Server Edition) ist in jeder Form ein auf dem Host residenter Agent. Dieser Aufbau hat zwei strukturelle blinde Flecken.
- Die Selbstdiagnose eines einzelnen Hosts hat einen grundsätzlichen blinden Fleck: Das Risiko lateraler Bewegung – "nach außen geschlossen, aber von einem anderen Gerät im selben LAN aus völlig offen einsehbar" – kann ein Host, der nur sich selbst betrachtet, niemals erkennen.
- Manche Geräte können RoamSwitch grundsätzlich nicht ausführen: IoT-Geräte (Netzwerkkameras, Smart Plugs, Multifunktionsdrucker), Gäste-/BYOD-Geräte, Netzwerkgeräte selbst, eingebettete Geräte und mehr.
RoamSwitch Sensor ist ein dedizierter Knoten im LAN, der diese beiden Lücken schließt. Umgesetzt sind aktive Schwachstellenprüfungen für Endgeräte mit RoamSwitch, ARP-basierte Geräteinventarisierung und Spoofing-Erkennung sowie Hinweise auf verdächtiges Verhalten durch optionale passive Erfassung (§6). Es wird nur erkannt und gemeldet; der Datenverkehr wird nicht blockiert.
updates.fetch_cve_map, Standard true; mit false offline). Geräte- oder Prüfdaten sind darin nicht enthalten. (2) Benachrichtigung und Aggregation an vom Betreiber festgelegte Ziele: wird nur gesendet, wenn es konfiguriert ist.Selbstschutz wird bewusst nicht implementiert (eine gezielte Designentscheidung). Wenn Sie den Sensor-Host selbst vor Angriffen schützen müssen, empfehlen wir, zusätzlich RoamSwitch for Linux Server Edition auf derselben Maschine zu installieren. Beide laufen als vollständig unabhängige Prozesse nebeneinander.
2. Aktuelle Verifizierungsumgebung
- Unterstütztes Betriebssystem: Debian 12 (bookworm)+ / Ubuntu 22.04+ (apt), Fedora/RHEL-Familie (dnf). Unterstützt werden
x86_64(amd64) undarm64(aarch64, z. B. Raspberry Pi). - Zielhardware (Zukunftsplan): Für den Praxisbetrieb stellen wir uns ein stromsparendes, für den Dauerbetrieb geeignetes Gerät vor, etwa einen lüfterlosen Mini-PC der N100/N150-Klasse, aber es gibt heute keinen dedizierten Build oder keine darauf ausgerichtete Auslieferung.
- Netzwerkplatzierung: An das zu überwachende LAN-Segment anschließen (er läuft im Host-Netzwerk, da er ARP direkt sieht). Eine feste IP-Adresse ist zwingend, weil er Anfragen entgegennimmt. Er lauscht auf TCP-Port
50543und nimmt TLS 1.3 auf demselben Port an (§4.4). - Ressourcenverbrauch: Der residente Speicher liegt bei einigen Dutzend MB, die CPU-Last im Leerlauf ist minimal.
- Empfohlen:
nmap(für den ARP-Sweep, die ergänzenden NSE-Prüfungen und die MAC-Prüfung geplanter Audits). Ohne nmap funktionieren die übrigen Funktionen weiterhin, aber es wird kein ARP-Sweep durchgeführt, und der Sensor fällt auf einen passiven Betrieb zurück, der nur Geräte sieht, mit denen er selbst kommuniziert hat.
nmap ist ein empfohlenes Paket. Sensor lässt sich auch ohne installieren, aber die regelmäßige Prüfung, die regelmäßige Prüfung nicht eingebundener Geräte und der aktive Scan des Geräteverzeichnisses (Erkennung stiller Geräte) laufen dann nicht. roamswitch-sensor status zeigt „nmap: nicht installiert“.
3. Installation & Start
Installieren Sie das Paket roamswitch-sensor aus dem offiziellen, signierten Paket-Repository. Nach der Installation wird roamswitch-sensor.service (systemd) automatisch aktiviert und gestartet.
3.1 APT (Ubuntu/Debian)
# 1. Repository-Signaturschlüssel registrieren
curl -fsSL https://lafine.net/apt/roamswitch-archive-keyring.asc \
| sudo gpg --dearmor -o /usr/share/keyrings/roamswitch-archive-keyring.gpg
# 2. Repository hinzufügen
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. Installieren
sudo apt update && sudo apt install roamswitch-sensor
3.2 DNF/RPM (Fedora/RHEL)
# 1. GPG-Schlüssel importieren
sudo rpm --import https://lafine.net/rpm/RPM-GPG-KEY-roamswitch
# 2. Repository-Konfigurationsdatei hinzufügen
sudo curl -fsSL -o /etc/yum.repos.d/roamswitch.repo https://lafine.net/rpm/fedora/roamswitch.repo
# 3. Installieren
sudo dnf install roamswitch-sensor
3.3 Startprüfung
systemctl status roamswitch-sensor.service
sudo roamswitch-sensor status
3.4 CLI/TUI ausführen
Die CLI (roamswitch-sensor) und das interaktive TUI (roamswitch-sensor-tui) können direkt nach der Installation ausgeführt werden.
sudo roamswitch-sensor status
sudo roamswitch-sensor-tui
ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE (eingestellt via systemctl edit roamswitch-sensor.service) an, um Ethernet/IPv4/IPv6-Header auf dieser Schnittstelle zu beobachten und neue Geräte oder Kontakt mit bekannten bösartigen IPs zu erkennen (siehe §6.1). Standardmäßig deaktiviert.4. Pairing (Code-Verfahren)
Im Auslieferungszustand vertraut Sensor niemandem. Das Pairing erfolgt mit einem einmaligen Pairing-Code, den der Sensor-Betreiber ausstellt. Das Vertrauensverhältnis — „Sensor darf aktive Schwachstellenprüfungen gegen diesen Endpunkt ausführen“ — wird in einem einzigen Pairing-Schritt gleichzeitig in beide Richtungen hergestellt (ein nur einseitiges Vertrauen gibt es nicht).
Voraussetzung: Betreiben Sie Sensor unter einer festen IP-Adresse (statische Zuweisung oder DHCP-Reservierung). Nach dem Pairing verbindet sich der Endpunkt fortan stets direkt mit der beim Pairing bestätigten IP-Adresse von Sensor (es gibt keine automatische Erkennung mehr, etwa per mDNS) — ändert sich Sensors IP später, ist ein erneutes Pairing nötig. Der Endpunkt selbst kann weiterhin eine dynamische IP haben.
4.1 Einen Pairing-Code ausstellen (Sensor-Seite)
# Auf der Sensor-Seite ausführen (oder in der TUI die Taste c drücken)
sudo roamswitch-sensor issue-code
Es erscheint ein einmaliger 8-stelliger Code (0/O/1/I/L sind ausgeschlossen). Er läuft 10 Minuten nach der Ausgabe ab. Teilen Sie ihn dem Bediener auf der Endgeräteseite sofort mit, zusammen mit dem TLS-Zertifikat-Fingerabdruck (SHA-256), der am Endgerät gepinnt wird.
4.2 Pairing mit dem Code (Endpunktseite)
# Endpunktseite (roamswitch-linux)
sudo roamswitch sensor pair --addr <SENSOR_IP> --code <CODE> --fingerprint <SHA256_FINGERPRINT>
In der Mac-Edition gelingt dasselbe in der GUI über den Menüleisten-Eintrag „🔍 RoamSwitch Sensor-Kopplung…“ durch Eingabe der IP-Adresse des Sensors, des Pairing-Codes und des Zertifikats-Fingerprints.
Nach der Kopplung wird jedes weitere aktive Audit und jeder Abruf von Ergebnissen mit Ed25519-Signaturen authentifiziert. Ein Linux-Endpunkt kommuniziert über TLS 1.3 nur mit einem Sensor, dessen Zertifikat zum eingegebenen Fingerprint passt, und fällt nie automatisch auf Klartext zurück (§4.4). Ab diesem Punkt betrachten der Endpunkt, der den Code kannte, und der Sensor, der ihn ausgestellt hat, einander als vertrauenswürdig.
issue-code einen neuen Code auszustellen.4.3 Manuelles Pairing (direktes Registrieren eines bekannten Public Keys)
Kennt der Sensor-Betreiber den Public Key und die Adresse eines Endpunkts bereits aus einer anderen Quelle, kann er diesen auch ohne Austausch eines Pairing-Codes direkt auf der Sensor-Seite registrieren (normalerweise sollten Sie stattdessen das codebasierte Verfahren aus §4.2 verwenden und den Endpunkt sich selbst pairen lassen). Ihren eigenen Public Key und Ihre Adresse können Sie mit den folgenden Befehlen abfragen.
# Eigenen Public Key/Adresse auf der Endpunktseite prüfen
sudo roamswitch sensor key
# Eigenen Public Key/Adresse/MAC-Adresse auf der Sensor-Seite prüfen
sudo roamswitch-sensor status
# Sensor-Seite
sudo roamswitch-sensor pair <vollständiger öffentlicher Schlüssel> --addr <IP-Adresse> --confirm
4.4 Sicherheit der Steuer-API (TCP 50543) (TLS, Fingerabdruck, Sperre)
Kopplung, Audit-Anfragen und der Abruf von Ergebnissen laufen über die Control-API des Sensors (TCP 50543). Die folgenden Schutzmaßnahmen sind eingebaut.
- TLS 1.3 und Zertifikats-Pinning:
control.tlsistoff/optional(Standard; nimmt auch Klartext an und warnt) /required(nur TLS 1.3). Das Zertifikat ist selbstsigniert (ECDSA P-256); das Vertrauen ergibt sich aus dem Pin des SHA-256-Fingerabdrucks. - Fingerprint-Bindung der Kopplungsanfrage: Der Endpunkt signiert den von ihm gepinnten Fingerprint mit seinem eigenen privaten Schlüssel und nimmt ihn in die Kopplungsanfrage auf. Eine Anfrage, die über einen Man-in-the-Middle mit einem anderen Zertifikat lief, schlägt mit
fingerprint_mismatchfehl, und der Pairing-Code wird nicht verbraucht. - Replay-sichere Signaturen (v2): Signaturen für Audit-Anfragen und den Abruf von Ergebnissen nutzen das v2-Format, das einen Zeitstempel (±300 s) und eine Nonce enthält, sodass Wiedereinspielungen abgewiesen werden. Veraltete v1-Signaturen enthalten beides nicht und können wiedereingespielt werden;
control.allow_legacy_signatures(Standardtrue, gedacht für die Migrationsphase; jede Verwendung protokolliert eine Deprecation-Warnung) entscheidet, ob sie akzeptiert werden. Setzen Sie es auffalse, sobald jeder Endpunkt v2 sendet. - Sperre: Bei Brute-Force auf den Kopplungscode führen 5 Fehlversuche innerhalb von 10 Minuten von derselben Quell-IP zu einer Sperre von 60 Sekunden (bei Wiederholung exponentiell bis auf maximal 1 Stunde verlängert); 20 Fehlversuche über alle Quellen hinweg lösen eine globale Sperre aus. Signaturfehler werden etwas großzügiger behandelt (10 pro Quell-IP, 100 insgesamt). Sperren werden mit der Benachrichtigung
control_api_lockoutgemeldet. - Lauschadresse: Das Einschränken von
control.bind_addr(Standard0.0.0.0, wirksam nach Neustart) auf die LAN-Adresse des Sensors verringert die Angriffsfläche. Der Daemon warnt, solange es sich um eine Wildcard-Adresse handelt. - Zertifikatsrotation:
roamswitch-sensor tls rotate(in der TUI auf dem BildschirmTdie TasteRdrücken) erzeugt das Zertifikat neu. Jeder Pin des alten Fingerprints wird ungültig, sodass jeder Endpunkt den neuen Wert eingeben muss (sudo roamswitch sensor repin <public key> --fingerprint <value>). Die Kopplung selbst bleibt erhalten.
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 auf required umstellenroamswitch-sensor status keine Warnung vor Klartextverbindungen mehr anzeigt → (3) sudo roamswitch-sensor config set control.tls required ausführen → den Daemon neu starten. off wird normalerweise nicht verwendet, da Linux-Endpunkte TLS voraussetzen und sich dann nicht mehr verbinden könnten.5. Aktive Schwachstellenprüfung
Sensor führt nicht-destruktive, beweisbasierte Schwachstellendiagnosen gegen gepaarte Endpunkte durch. Destruktive Operationen (Schreiben oder Löschen von Daten, Stoppen von Diensten) werden niemals ausgeführt.
sudo roamswitch-sensor scan <öffentlicher Schlüssel oder dessen Anfang>
Die Prüfung besteht aus vier Phasen.
- Vollständiger Portscan: erkennt lückenlos jeden offenen TCP-Port auf dem Zielhost.
- Diagnose bekannter Signaturen: nicht-destruktive, beweisbasierte Prüfungen bekannter Schwachstellenmuster – unauthentifizierte Exposition von Redis / dockerd / Memcached / MongoDB / Elasticsearch / CouchDB / Jenkins / VNC, SMTP-Open-Relay-Diagnose (eine sichere Methode, die nur
MAIL FROM/RCPT TOsendet, niemalsDATA) sowie Diagnosen für CORS-Fehlkonfigurationen, Path Traversal und Open Redirects auf Dev-Servern, unter anderem. - Generisches Banner-Grabbing: ruft für offene Ports, die nicht durch die obigen Signaturen abgedeckt sind, den Banner-String allein durch Verbindungsaufbau ab (es werden keine Daten gesendet). An einen offenen Port ohne Banner schickt er zur Unterscheidung des Dienstes ein einziges
GET / HTTP/1.0(höchstens 32 Ports je Audit). - Ergänzende nmap-NSE-Diagnose: breite, protokollübergreifende ergänzende Diagnose über
nmap --script safe. Wird automatisch ausgeführt, sobaldnmapauf dem Host installiert ist (andernfalls passiert nichts).
Dienste auf nicht standardmäßigen Ports werden ebenfalls geprüft. Dieselben rein lesenden Prüfungen werden zum Beispiel auf Redis an Port 6380 oder SSH an Port 2222 angewendet. Erkannt wird anhand des ersten Banners und der Antwort auf ein einmaliges GET / HTTP/1.0. Die Selbstauskunft eines Endgeräts (bis zu 64 Einträge auf einmal) liegt außerhalb der Signatur, erweitert daher den Bereich nie und dient nur zur Auswahl der Prüfungen.
Jeder Prüfdurchlauf wird in /var/lib/roamswitch-sensor/scan_history.json protokolliert – unabhängig davon, ob etwas gefunden wurde, da auch ein zu diesem Zeitpunkt sauberes Ergebnis einen dokumentarischen Wert hat – und kann über die CLI oder das TUI eingesehen werden.
roamswitch-sensor history
sudo roamswitch-sensor report <öffentlicher Schlüssel oder dessen Anfang> --out /tmp/report.md
Bei „Offene Ports: keine“ und ebenfalls ohne ARP-Antwort erscheint „Möglicherweise erreicht es das Gerät nicht.“ Das bedeutet nicht „kein Problem“. „nmap NSE: nicht ausgeführt (nmap ist nicht installiert)“ und „nicht zutreffend“ bedeuten Unterschiedliches.
5.1 Audit-Anfrage von Client-Seite (Pull-Modell)
Vom gekoppelten Endgerät aus lässt sich beim Sensor auch eine aktive Schwachstellenprüfung anfordern. Unter macOS über „Audit beim Sensor anfordern“ in der Menüleiste, unter Linux mit dem folgenden Befehl.
sudo roamswitch sensor request-audit
Nachdem Sensor das Audit ausgeführt hat, fragt der Endpunkt das Ergebnis ab — beginnend 5 Minuten nach der Anfrage, danach alle 5 Minuten, bis zu 5 Versuche lang (also maximal 25 Minuten). Jedes abgerufene Ergebnis wird auch lokal auf dem Endpunkt gespeichert.
roamswitch sensor results
In der Mac-Edition erscheinen Ergebnisse zudem in der Liste „Audit-Ergebnisse“ im Einstellungsfenster oder können über das MCP-Tool get_sensor_audit_results abgerufen werden — als Eingabe für einen KI-Agenten, der eine Abhilfemaßnahme plant. Der Abruf eines Ergebnisses kann auch ausdrücklich abgelehnt werden, etwa wenn das Pairing auf der Sensor-Seite aufgehoben wurde (siehe §10 F6).
5.2 Abweichungen von der Spezifikation, Grenzwerte und KI-Vermutungen (optional)
Abgleich mit der Spezifikation und Grenzwertprüfung (design_flaw.enabled; standardmäßig aus, Opt-in) Betrifft nur gekoppelte Endgeräte mit Einwilligung. Es sucht nach OpenAPI-/Swagger-Dokumenten und meldet Abweichungen zwischen Deklaration und tatsächlicher Antwort. Für Abfrageparameter werden feste, sichere Werte eingesetzt, und Auffälligkeiten wie 5xx werden gemeldet. Gesendet wird nur GET, höchstens 20 Anfragen pro Gerät. Die Reihenfolge ist fest; die KI wählt sie nicht (die Zusammenfassung maskiert Geheimnisse, höchstens 240 Zeichen pro Eintrag).
KI Hypothesen schreiben lassen (optional) roamswitch-sensor design-hypotheses übergibt nur die Zusammenfassung der Aufzeichnungen an das gewählte KI-Werkzeug und lässt unbestätigte Hypothesen schreiben. Es läuft mit den Rechten des ausführenden Benutzers, und die Zusammenfassung kann an den Anbieter gesendet werden. An Geräte wird nichts gesendet.
6. Passive ARP-Überwachung & LAN-Sichtbarkeit
Sensor erfasst die Geräte im LAN auf zwei Wegen. (1) Überwachung der ARP-Tabelle: Sie wird etwa alle 10 Sekunden gelesen; erkannt werden neue IP/MAC-Paare und MAC-Änderungen bekannter IPs (ein Hinweis auf Spoofing). (2) Aktiver ARP-Sweep: Mit nmap -sn -PR wird das direkt angebundene Subnetz (maximal /22) stündlich untersucht und im Inventar gespeichert. Ohne nmap gilt nur (1).
roamswitch-sensor arp-events
Erkannte Ereignisse zeigt roamswitch-sensor arp-events sowie der TUI-Reiter „ARP-Ereignisse“ (Enter für Details). Jedes Ereignis enthält seinen Zeitpunkt, einen Schweregrad (von kritisch bis Info; eine MAC-Änderung der Gateway-IP ist „kritisch“), die Begründung, die Identität der beteiligten Geräte und konkrete nächste Schritte.
6.1 Erweiterung der passiven LAN-Sichtbarkeit (Opt-in)
Während die obige ARP-Überwachung nur Geräte erfasst, mit denen Sensor selbst kommuniziert hat, werden durch Setzen der Umgebungsvariable ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE auf eine Zielschnittstelle nur die Ethernet/IPv4/IPv6-Header darauf und das, was Geräte über sich selbst ankündigen, beobachtet (außer bei DNS, DHCP, mDNS, SSDP, WS-Discovery und LLDP wird kein Dateninhalt gelesen), um Folgendes zu leisten.
- Passive Beobachtung neuer Geräte: Geräte, mit denen Sensor nie direkt kommuniziert hat und die die reine ARP-Überwachung nicht abdeckt. Wird aus Broadcast-/Multicast-Verkehr gelernt.
- Erkennung von Kontakt mit bekannten bösartigen IPs: markiert Datenverkehr, dessen Ziel-IP mit dem lokalen Bedrohungs-Feed übereinstimmt (gleiches Format wie der Egress Guard von RoamSwitch selbst) — nur Erkennung, niemals Blockierung.
- VLAN-Tags (802.1Q / 802.1ad): Ist der Mirror-Port ein Trunk, werden auch getaggte Frames gelesen (bis zu einem doppelten Tag). Die gesehenen VLAN-IDs bleiben im Geräteverzeichnis erhalten, höchstens 8 pro Gerät. Sie werden nur an Geräte gehängt, die schon im Verzeichnis stehen; allein aus einer VLAN-ID entsteht nie ein Gerät.
- IPv6-Verkehr: Quelle, Ziel und Ports werden wie bei IPv4 gelesen. Die Prüfungen auf neue Geräte und bekannte bösartige IPs betreffen nur IPv4 (IPv6-Privacy-Adressen wechseln ständig). Für das Lernen des Verhaltens je Gerät und für die Erkennung von Massenversand und Verbindungen zu Verwaltungsports von IoT-Geräten wird auch IPv6 genutzt.
- Was Geräte über sich selbst ankündigen: LLDP (Name und Beschreibung von Switches, Access Points und IP-Telefonen), mDNS-TXT (
model=md=ty=) und WS-Discovery (UDP 3702; Name und Modell von ONVIF-Kameras) werden gelesen und zum „Modellhinweis“ im Geräteverzeichnis. Angekündigte Zeichenketten werden ohne Steuerzeichen und auf 96 Zeichen gekürzt gespeichert.
sudo systemctl edit roamswitch-sensor.service
# [Service]
# Environment=ROAMSWITCH_SENSOR_PASSIVE_CAPTURE_IFACE=eth0
sudo systemctl restart roamswitch-sensor.service
roamswitch-sensor passive-events
Nachdem Sie Umgebungsvariablen ergänzt haben, starten Sie mit sudo systemctl restart roamswitch-sensor neu. systemctl edit allein wirkt nicht auf den laufenden Daemon. Ob es wirkt, prüfen Sie an „Passive Erfassung: empfängt auf eth0“ in roamswitch-sensor status. Steht dort weiter „Passive Erfassung ist deaktiviert“, wurde nicht neu gestartet.
Der Empfangspuffer wird mit capture.rcvbuf_mb geändert (MiB; Standard 4, 0 für den Systemstandard). Da die einzige Berechtigung CAP_NET_RAW ist, wird alles über net.core.rmem_max hinaus abgeschnitten. Erscheint kernel_drops, erhöhen Sie rmem_max (z. B.: sudo sysctl -w net.core.rmem_max=8388608; dauerhaft über /etc/sysctl.d/) und auch capture.rcvbuf_mb.
6.2 Geräteverzeichnis und Gerätenotizen
Das Inventar lässt sich mit roamswitch-sensor device-inventory ansehen. Geräte, für die mit device-note eine Notiz hinterlegt wurde, gelten als „bekannt“, nicht registrierte als „zu prüfen“. Beobachtete VLAN-IDs erscheinen auch in der Spalte vlans des Exports und an anderen Stellen.
sudo roamswitch-sensor refresh
roamswitch-sensor device-inventory
sudo roamswitch-sensor device-note aa:bb:cc:dd:ee:ff "3F copier"
6.3 Referenzinformationen zu verdächtigem Verhalten (nur Erkennung)
Bei aktivem passivem Mitschnitt (§6.1, Opt-in) werden die folgenden Referenzinformationen angezeigt. Alles davon ist nur Erkennung und Anzeige; der Sensor blockiert nie Datenverkehr.
- Verhalten von IoT-Geräten (
iot-events): Verbindungen klassifizierter Geräte zu bekannten bösartigen IPs oder zu Verwaltungsports (SSH/RDP/SMB usw.). Zusätzlich wird die Modellerkennung anhand der eigenen mDNS-/SSDP-/DHCP-/LLDP-/WS-Discovery-Ankündigungen der Geräte genutzt. - Verdächtiger Datenverkehr (
network-threats): Verbindungen zu vielen Zielen innerhalb eines 30-Sekunden-Fensters (Hinweis auf Scanning oder einen Sprungpunkt), eine Flut von Verbindungen zu einem Ziel (Hinweis auf DDoS-Beteiligung) sowie Anzeichen von DNS-Tunneling/C2 (nur die strukturellen Merkmale der Abfragenamen werden verwendet; Domainnamen werden nicht gespeichert). - Advisories (
iot-advisories): Referenzinformationen zu öffentlichen CVEs für Produkte bekannter IoT-Hersteller (statisch mitgeliefert; es gibt kein Netzwerk-Update).
6.4 Anzeige des nicht Sichtbaren (Abdeckung)
Passives Mithören kann von sich aus nicht unterscheiden, ob nichts zu hören ist oder das Netzwerk nur ruhig ist. Der Sensor zählt nur, was er selbst beobachten konnte, und verwechselt Nicht-Sichtbares nicht mit „keine Ereignisse“. Es entstehen keine neuen Verbindungen und keine neuen Sockets. Standardmäßig aktiv.
roamswitch-sensor statusund der TUI-Statusbildschirm (i) zeigen einen Block „Sichtbarer Bereich“: den Zustand des passiven Mitschnitts (empfängt, Schnittstellenname, bisherige Frames, Sekunden seit dem letzten Frame, oder deaktiviert) und je eine Zeile pro Ursache für alles, was nicht gesehen wird.- Benachrichtigungen (Webhook, syslog) gehen nur an Ziele, die der Betreiber bereits eingerichtet hat: einmal
coverage_gap(Schweregrad medium), wenn ein blinder Fleck entsteht, und einmalcoverage_restored(info), wenn er endet. Was nur ruhig sein könnte (info), wird nur auf dem Bildschirm gezeigt und nicht gemeldet. - Ist das Senden an den Collector aktiviert, kommen
summary.captureundsummary.coverage_noteszur bestehenden Meldung hinzu, und die Sensor-Liste des Dashboards zeigt ein Abzeichen und eine Zählkarte für blinde Flecken.
Beispiele für gezählte Ursachen: Der passive Mitschnitt lässt sich nicht öffnen, ein Stillstand von 30 Sekunden oder mehr, 5 aufeinanderfolgende Empfangsfehler, 5 Minuten ohne Frames bei gleichzeitig unterbrochener Verbindung, Kernel-Verwerfungen (letzte 10 Minuten), Frames über 2048 Byte und Frames, deren Header nicht lesbar ist. Ein Durchlauf, in dem die ARP-Tabelle nicht gelesen werden kann, wird gezählt, ohne die Basislinie zu löschen.
Was nicht geht Gezählt wird nur, was der Sensor selbst beobachten kann. Ein Fall, in dem der Empfang in Ordnung ist, die ankommenden Frames aber einseitig sind (etwa bei falsch eingerichtetem Mirror-Port), lässt sich nicht erkennen. Gab es 5 Minuten lang keine Frames, die Verbindung steht aber (capture_silent, info), sagt er offen, dass sich „ruhig“ und „nichts zu hören“ nicht unterscheiden lassen.
7. CLI-Befehlsübersicht
| Befehl | Funktionsübersicht |
|---|---|
roamswitch-sensor status |
Zeigt den eigenen Public Key, die IP- und MAC-Adresse des Sensors, die Anzahl gekoppelter Endpunkte, ARP-Ereignisse und ausstehende Audit-Anfragen sowie den TLS-Status der Control-API |
roamswitch-sensor issue-code |
Stellt einen einmaligen Pairing-Code aus (10 Minuten gültig); zeigt außerdem den Zertifikats-Fingerprint des Sensors |
roamswitch-sensor list |
Listet alle gepaarten Endpunkte auf |
roamswitch-sensor pair <public-key> [--addr <IP>] [--name <name>] --confirm |
Paart einen Endpunkt manuell durch direkte Angabe von Public Key und Adresse (normalerweise ist es einfacher, issue-code zu verwenden und den Endpunkt sich selbst pairen zu lassen) |
roamswitch-sensor unpair <public-key> |
Hebt ein Pairing auf |
roamswitch-sensor scan <public-key> |
Führt eine aktive Schwachstellenprüfung gegen einen gepaarten Endpunkt aus |
roamswitch-sensor history [public-key] |
Zeigt den Prüfverlauf (ohne Public Key für alle Endpunkte) |
roamswitch-sensor report <public-key> [--out <file>] |
Gibt das jüngste Prüfergebnis als Markdown-Bericht aus |
roamswitch-sensor arp-events |
Zeigt erkannte ARP-Ereignisse (neue Geräte, Spoofing-Verdacht) |
roamswitch-sensor pairing show / tls show |
Zeigt den TLS-Status der Control-API (Modus, Fingerprint, Warnung vor Klartextverbindungen, Lausch-IP, ob veraltete v1-Signaturen akzeptiert werden); pairing show und tls show sind gleichwertig |
roamswitch-sensor tls rotate |
Erzeugt das TLS-Zertifikat neu (jeder Pin des alten Fingerprints wird ungültig; Endpunkte müssen neu pinnen) |
roamswitch-sensor refresh |
Durchsucht das LAN jetzt neu (ARP-Sweep) und aktualisiert das Geräteverzeichnis |
roamswitch-sensor device-inventory |
Zeigt das Geräteverzeichnis (jedes im LAN beobachtete Gerät, sein Online-Status und seine Notiz) |
roamswitch-sensor device-note <MAC> [note] |
Hinterlegt eine Notiz für ein Gerät (ohne Notiztext wird sie gelöscht) |
roamswitch-sensor passive-events / iot-events / network-threats / iot-advisories |
Zeigt die Ereignisse des passiven Mitschnitts (neue Geräte und Verbindungen zu bösartigen IPs / IoT-Verhalten / verdächtiger Datenverkehr / IoT-Advisories) |
roamswitch-sensor lan-overview [--json]roamswitch-sensor network-threats --json [--limit N] [--min-severity …] |
Zeigt den Gesamtzustand des LAN (Geräteanzahl, VLANs, Anzahl der Bedrohungen usw.) und eine Liste der Bedrohungen. --json gibt JSON aus (--limit höchstens 500). Beides ist schreibgeschützt und kann auch ohne root ausgeführt werden. PersonalSOC und die Linux-Version von MCP lesen es. |
roamswitch-sensor config [show | set <Schlüssel> <Wert>] |
Einstellungen anzeigen oder ändern (geplante Audits, Benachrichtigungen, Aufbewahrung, Collector, Control-API, Abruf von Erkennungsdaten, Sprache). control.bind_addr und control.tls werden erst nach Neustart des Daemons wirksam; die übrigen erfordern keinen Neustart (§11.8) |
roamswitch-sensor diff [öffentlicher Schlüssel] |
Änderungen seit dem vorherigen Audit anzeigen (neue Befunde, behobene, neu geöffnete Ports, vermutlich nicht erreichbar) |
roamswitch-sensor export <scans|inventory|audit-log|unmanaged|all> … |
Audit-Nachweise als CSV / JSON / druckbares HTML schreiben |
roamswitch-sensor audit-log [verify] |
Betriebs- und Freigabeprotokoll anzeigen; verify erkennt Manipulationen an der Hash-Kette |
roamswitch-sensor notify-test |
Testbenachrichtigung an die konfigurierten Ziele (Webhook / syslog) senden, um die Verbindung zu prüfen |
roamswitch-sensor audit-unmanaged <IP|MAC> --confirmroamswitch-sensor unmanaged-audits |
Leichte Prüfung von Geräten ohne RoamSwitch (nur Verbindungstests). audit-unmanaged <IP oder MAC> --confirm startet eine von Hand, unmanaged-audits [--detail] listet die Ergebnisse (§13) |
roamswitch-sensor design-hypotheses [鍵] --llm 名前 |
Lässt das gewählte KI-Werkzeug aus dem neuesten design_flaw-Ergebnis unbestätigte Vermutungen schreiben (§5.2). --llm, --model, --timeout, --show-prompt |
roamswitch-sensor lockdown [status | on | off] |
Zeigt, ob der Sensor gesperrt ist (status), sperrt ihn (on --reason TEXT) oder hebt die Sperre auf (off). Gesperrt beendet er Kopplungen, Prüfungen, Uploads und Benachrichtigungen (§14) |
roamswitch-sensor decommission --confirm |
Löscht Schlüssel und gespeicherte Daten dieses Sensors und sperrt ihn (nicht umkehrbar). Das Auditprotokoll bleibt erhalten; die zuvor gekoppelten Endpunkte werden samt Anleitung zum Aufheben der Kopplung aufgelistet (§14) |
Die CLI unterstützt nur Japanisch und Englisch (sie richtet sich nach der Umgebungsvariable LANG).
8. TUI-Bedienungsanleitung
Die interaktive TUI (roamswitch-sensor-tui) gibt es in 10 Sprachen und sie bietet alles, was CLI und Einstellungen können (m zeigt die Funktionsliste). Die 6 Haupt-Tabs (Gekoppelt, Netzwerkaufbau, ARP-Ereignisse, Prüfverlauf, Unterschiede, Aktionsprotokoll) wechseln Sie mit Tab. Die Unterschiede zeigen Neues in Rot, Behobenes in Grün und vermutlich Unerreichbares in Gelb.
| Taste | Aktion |
|---|---|
Tab | Wechselt zwischen den Tabs |
↑↓ / j k | Wählt einen Eintrag aus |
c | Stellt einen Pairing-Code aus (10 Minuten gültig). Der Bildschirm zeigt den auf dem Endpunkt auszuführenden Befehl sudo roamswitch sensor pair --addr <this Sensor’s IP> --code <code> --fingerprint <fingerprint> mit den tatsächlichen Werten |
u | Hebt ein Pairing auf |
s | Führt eine aktive Schwachstellenprüfung gegen den ausgewählten Endpunkt aus |
a | (Reiter Netzwerkgeräte) Ausgewähltes Gerät nach einer Bestätigung leicht prüfen (§13). Ergebnisse im Reiter „Nicht verwaltete Geräte“ des Menüs |
K | Diesen Sensor sperren oder freigeben, nach einer Bestätigung; solange er gesperrt ist, steht unten auf jedem Bildschirm ein roter Hinweis. Die Außerbetriebnahme steht im Menü (§14) |
n | (Reiter Netzwerk) Dem gewählten Gerät eine Notiz (Name, Zweck, Standort) hinzufügen; ein Gerät mit Notiz gilt als erfasst |
r | LAN sofort neu durchsuchen (ARP-Sweep; läuft sonst automatisch stündlich) |
e | Audit-Nachweise exportieren (CSV der Scan-Ergebnisse, des Geräteverzeichnisses und des Audit-Protokolls; HTML-Bericht; JSON). Ein Formular erlaubt die Auswahl von Inhalt, Format, Endpunkt, Startdatum und Ziel; die Dateien werden in der Anzeigesprache erzeugt (10 Sprachen). Das Standardziel ist ~/.local/state/roamswitch-sensor/; Dateien werden neu angelegt und sind nur für den Eigentümer lesbar (eine vorhandene Datei wird nie überschrieben), und der Export selbst wird im Audit-Protokoll festgehalten |
p | Manuelle Kopplung (Public Key und Adresse eingeben, dann ein Bestätigungsbildschirm, dann ausführen). Das Formular zeigt den TLS-Fingerprint des Sensors, den der Endpunkt pinnt |
T | TLS- und Kopplungsstatus (Modus, Fingerprint, Warnung vor Klartextverbindungen, Lausch-IP, ob veraltete v1-Signaturen akzeptiert werden). R erzeugt das Zertifikat neu (mit einem Bestätigungsbildschirm, der die Auswirkungen erklärt) |
C | Konfigurationseditor (zeigt und ändert jeden Konfigurationsschlüssel; Webhook-URLs sind stets maskiert; Schlüssel, die einen Neustart erfordern, sind markiert) |
N | Benachrichtigungstest (zeigt Erfolg oder Fehlschlag je Ziel; URLs sind maskiert) |
m | Funktionsmenü (passive Überwachung, IoT-Verhalten, verdächtiger Datenverkehr, IoT-Advisories, Status i, Collector-Verwaltung und mehr) |
O | Collector-Verwaltung (nur auf einem Host mit dem Datenverzeichnis des Collectors): Sensoren registrieren, widerrufen und auflisten, das Lese-Token und das Zurücksetzen einer Audit-Protokoll-Anomalie. Mit n legen Sie fest, wohin die eigenen Meldungen des Collectors gehen |
f / l / v | (Reiter Scan-Verlauf) nach Endpunkt filtern. (Reiter Audit-Protokoll) l ändert die Anzahl der angezeigten Zeilen, und v prüft die Hash-Kette erneut |
Enter | Details der ausgewählten Zeile anzeigen (Audit-Verlauf, Änderungen, ARP-Ereignisse, Geräte, Protokoll) |
w | (In einer Detailansicht) Den Bericht in eine Datei an einem von Ihnen gewählten Ziel schreiben (in der Anzeigesprache erzeugt) |
L | Die Anzeigesprache wählen (wird in der Einstellung language gespeichert und gilt daher auch für vom Daemon erzeugte Benachrichtigungen und Protokolle) |
q | Beendet |
9. Vertrauensmodell & Sicherheitsdesign
- Bestätigung über einen Out-of-Band-Kanal (nicht TOFU): Der Betreiber gibt den auf dem Sensor-Bildschirm angezeigten Zertifikats-Fingerprint und den Pairing-Code per Telefon, Chat o. Ä. an den Endpunkt weiter. Der Endpunkt ruft den Pin nie über das Netzwerk ab (es ist kein TOFU, das der ersten Verbindung bedingungslos vertraut) und kommuniziert nur mit einem Sensor, dessen Zertifikat zum eingegebenen Wert passt, und koppelt sich nur mit diesem. Die bei der Kopplung ausgetauschten Public Keys verifizieren jede spätere Sondierung und Anfrage.
- So konzipiert, dass Lücken erkannt werden, die destruktive Aktionen ermöglichen würden – ohne selbst je eine destruktive Aktion auszuführen: Jede aktive Schwachstellenprüfung ist nicht-destruktiv (sie schreibt oder löscht niemals Daten und stoppt keine Dienste). Erkannt werden dagegen die Fehlkonfigurationen selbst – etwa „ohne Authentifizierung beschreibbar“ oder „funktioniert als Open Relay“ –, die bei Ausnutzung eine destruktive Aktion ermöglichen würden.
- Fehlalarm-Vermeidung (Ausschluss der Eigenprüfung): Damit der Schutz zur Erkennung eingehender Portscans die Vollport-Prüfung des Sensors nicht fehldeutet, wird sie über die Quell-IP ausgenommen (die IP dient nicht zur Vertrauensentscheidung). Ab der Prüfanforderung durch das Endgerät bis zum Bericht (höchstens etwa 25 Minuten) wird ruhig benachrichtigt. Zu allen anderen Zeiten bleibt die Warnung wie bisher deutlich.
- Ausgehender Datenverkehr ist begrenzt, und Gerätedaten werden standardmäßig nicht gesendet: Erkannte Geräteinformationen, Audit-Ergebnisse und ARP-Ereignisse werden standardmäßig nur im lokalen Speicher des Sensors abgelegt und nie an Lafine oder Dritte gesendet. Der einzige ausgehende Datenverkehr ist der Abruf von Erkennungsdaten (der CVE-Map und der nmap-NSE-Datenbank; mit
updates.fetch_cve_mapabschaltbar, ohne Geräte- oder Audit-Daten) sowie die Benachrichtigungen (Webhook, syslog) und Uploads an den zentralen Collector aus §11, die nur an Ihre eigenen Ziele gehen und nur, wenn Sie sie konfigurieren.
10. Fehlerbehebung & FAQ
F1. Die Eingabe eines Pairing-Codes wird abgelehnt.
Es gibt vier mögliche Ursachen. (1) Seit der Ausstellung sind mehr als 10 Minuten vergangen (mit issue-code neu ausstellen). (2) Eingabefehler. (3) Die IP in --addr weicht von der festen IP des Sensors ab. (4) --fingerprint weicht vom Zertifikat ab (mit roamswitch-sensor pairing show prüfen). Bei wiederholten Fehlern erfolgt die Sperre mit rate_limited.
F2. Das ergänzende NSE-Diagnoseergebnis ist leer.
Die Ursache ist eine der beiden folgenden. (1) Im Container ist nmap nicht installiert. (2) Die Ausführung erfolgte, aber für die Zielports gab es tatsächlich keine Ausgabe eines passenden sicheren Skripts. Die ergänzende nmap-NSE-Diagnose läuft automatisch, wenn nmap auf dem Host installiert ist.
F3. Wie lange dauert eine vollständige Prüfung?
Der reine Scan aller Ports dauert etwa einige Dutzend Sekunden. Ist nmap auf dem Host installiert, kommt die ergänzende NSE-Diagnose automatisch hinzu und kann je nach Anzahl der offenen Ports des Ziels bis zu etwa 2 Minuten dauern. Die TUI zeigt während der Ausführung fortlaufend die verstrichenen Sekunden an, sodass sich der Fortschritt verfolgen lässt.
F4. Ich habe gepaart, kann aber immer noch kein Audit ausführen.
Es gibt vier mögliche Ursachen. (1) Auf dem Endgerät ist sensor_pairing_enabled: true nicht gesetzt (standardmäßig aus). (2) Die feste IP des Sensors hat sich geändert (erneutes Koppeln ist nötig). (3) Auf der Sensor-Seite wurde unpair ausgeführt. (4) Das Zertifikat wurde neu erstellt, daher ist der Pin des Endgeräts veraltet (roamswitch sensor repin). Prüfen Sie in den Listen beider Seiten die gegenseitige Registrierung.
F5. Kann Sensor selbst zusammen mit RoamSwitch (Client/Server Edition) verwendet werden?
Ja. Da Sensor bewusst ohne Selbstschutzfunktionen konzipiert ist, empfehlen wir, RoamSwitch for Linux Server Edition zusätzlich auf derselben Maschine zu betreiben. Beide arbeiten als vollständig unabhängige Prozesse und Datenspeicher ohne Konflikte.
F6. roamswitch sensor results meldet, das Pairing sei aufgehoben worden.
Das Pairing dieses Endpunkts wurde auf der Sensor-Seite mit unpair entfernt. Bitten Sie den Sensor-Betreiber, einen neuen Pairing-Code auszustellen, und pairen Sie erneut mit roamswitch sensor pair --addr <ip> --code <code> --fingerprint <SHA-256>.
11. Audit-Funktionen für Organisationen (optional)
Funktionen für Sicherheitsteams großer Organisationen, die Audit-Nachweise und einen klaren Überblick über Veränderungen benötigen. Alle sind standardmäßig deaktiviert, und es wird nie etwas an Lafine oder Dritte gesendet – jedes Ziel für Benachrichtigungen oder Aggregation legt Ihre Organisation selbst fest. Einstellungen ändern Sie mit sudo roamswitch-sensor config set <Schlüssel> <Wert> (kein Neustart des Daemons nötig; jede Änderung wird im Betriebsprotokoll festgehalten); config show zeigt die aktuellen Werte.
11.1 Geplante Audits und Änderungserkennung
Mit schedule.enabled auf true werden alle gekoppelten Endgeräte regelmäßig geprüft (standardmäßig alle 24 Stunden). Den Unterschied zur vorherigen Prüfung zeigt roamswitch-sensor diff. Sind alle zuvor offenen Ports nicht mehr sichtbar, lässt sich das nicht von einem ausgeschalteten Gerät unterscheiden und gilt daher als vermutlich unerreichbar.
Auch unbeaufsichtigte Prüfungen brechen die Zusage nicht, nur zugestimmte Endgeräte zu prüfen. Die MAC des Zeitpunkts der letzten Authentifizierung des Endgeräts wird gespeichert; vor und nach der Prüfung wird per nmap-ARP geprüft, ob dieselbe MAC unter dieser IP antwortet. Weicht sie ab, wird nicht geprüft (oder das Ergebnis verworfen) und benachrichtigt.
Endgeräte in einem anderen VLAN sind standardmäßig ausgenommen. Mit schedule.allow_routed_endpoints (standardmäßig aus) wird unter anderem geprüft, ob eine signierte Anfrage innerhalb von schedule.routed_proof_minutes (Standard 30 Minuten, 5 bis 1440) von derselben Adresse eingegangen ist.
Die Gründe, warum es nicht läuft (kein nmap, ein Gerät ohne Adresse, ein Gerät ohne Identitätsbindung), erscheinen als Warnung unter „Sichtbarer Bereich“ in status. Ist ein Benachrichtigungsziel gesetzt, wird einmal coverage_gap zugestellt und nach der Behebung coverage_restored. Während des Lockdowns und außerhalb des Zeitfensters gibt es keine Warnung, sondern eine Zeile in status.
11.2 Benachrichtigungen (Webhook und syslog)
Regressionen, neue Geräte, ARP-Spoofing und Ähnliches werden an notify.webhook_urls und notify.syslog.host (RFC 5424, UDP oder TCP) gesendet. Mit notify.min_severity und dem Wiederholungsintervall lässt sich eingrenzen; die Verbindung prüft roamswitch-sensor notify-test.
status zeigt die Benachrichtigungsziele und das letzte Zustellergebnis. Solange die Zustellung fehlschlägt, erscheint eine Warnung; prüfen Sie mit roamswitch-sensor notify-test. Bei Erfolg verschwindet die Warnung.
11.3 Audit-Nachweise exportieren
roamswitch-sensor export <scans|inventory|audit-log|all> --format csv|json|html [--out Datei] [--endpoint Anfang des öffentlichen Schlüssels] [--since Datum]. html lässt sich im Browser als PDF speichern. CSV ist gegen Formelinjektion abgesichert. Die Ausgabe hat 0600, und der Export selbst wird ebenfalls im Aktionsprotokoll vermerkt. In der TUI sind dieselben Angaben mit der Taste e möglich.
11.4 Betriebs- und Freigabeprotokoll (manipulationssicher)
Kopplung, Prüfungen, Konfigurationsänderungen und abgelehnte Zugriffe werden zusammen mit dem Ausführenden protokolliert. Jede Zeile ist eine Hash-Kette, die den SHA-256 der vorherigen Zeile enthält; Manipulation erkennt roamswitch-sensor audit-log verify (bei Auffälligkeit Exitcode 2). Webhook-URL-Werte werden nicht gespeichert. Zum Schutz vor dem Löschen des Endes wird auch der Anfang an den Collector (§11.6) gesendet.
11.5 Aufbewahrung
Setzen Sie retention.scan_history_days, retention.audit_log_days und retention.inventory_stale_days, damit alte Audit-Historie, Protokolleinträge und lange nicht gesehene Geräte automatisch gelöscht werden (0 = nie nach Alter löschen, Standard). Geräte mit einer Notiz werden nie aus dem Inventar entfernt.
11.6 Mehrere Sensoren zusammenführen (zentraler Collector, optional)
Laufen mehrere Sensoren an mehreren Standorten, betreiben Sie auf einem separaten Host roamswitch-sensor-collector (im Paket enthalten, standardmäßig deaktiviert), der signierte Zusammenfassungen aller Sensoren sammelt.
# 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
- Akzeptiert werden nur signierte Anfragen von registrierten (
enroll) Sensoren (Ed25519-Identität); der Zeitstempel weist außerdem Wiedereinspielungen zurück. - Sobald er von außerhalb des LAN erreichbar ist, ist TLS erforderlich. Tragen Sie
--bind 0.0.0.0:8443 --tls-cert … --tls-key …inCOLLECTOR_ARGSin/etc/default/roamswitch-sensor-collectorein oder nutzen Sie--allow-plain-httphinter einem TLS-terminierenden Reverse-Proxy. Das Lauschen auf etwas anderem als 127.0.0.1 ohne TLS wird beim Start abgelehnt. - Das Dashboard ist durch ein Token geschützt und bietet Filter nach Standort, Ereignisse nach Schweregrad und CSV-Export. Es hebt Sensoren hervor, die verstummt sind, sowie Sensoren, deren Audit-Protokoll abgeschnitten, zurückgesetzt oder verzweigt wirkt (nach der Untersuchung mit
clear-anomaly <öffentlicher-Schlüssel>aufheben). - Mit
collector.send_unmanaged_devices(Standardtrue) werden auch nicht gekoppelte Geräte in die Zusammenfassung aufgenommen und in „nicht gekoppelte RoamSwitch-Hosts“ und „unbekannte Geräte“ unterteilt. Gesendet werden nur MAC, Hersteller, Geräteklasse und Erstfeststellung, keine Kommunikationsinhalte. - Ist
collector.send_unmanaged_audits(Standardfalse) aktiviert, werden aus der jüngsten leichten Prüfung von Geräten ohne RoamSwitch die in KEV gelisteten Produkte, ohne Authentifizierung antwortende Dienste und die Anzahl der Funde gesendet (bis zu 200 Geräte). Banner, Anfragen und Antworten sowie Freigabeprotokolle werden nicht gesendet. „Unbestätigt“ bedeutet nicht zwingend verwundbar. - Der Sensor sendet
summary.behavior_learned_devices(Zahl der Geräte, deren Lernphase abgeschlossen ist) undsummary.behavior_anomalies_active(Zahl der Geräte mit ungewöhnlichem Verhalten in den letzten 24 Stunden). Es sind nur Zahlen, Gerätenamen werden nicht gesendet. Ist das Verhaltenslernen aus, sind beide 0. Sie erscheinen als Karte im Dashboard und in den Sensor-Details. - Wird dasselbe Gerät (MAC) oder dasselbe gekoppelte Endgerät von einem Sensor an einem anderen Standort gemeldet, wird es als „Roaming zwischen Standorten“ erfasst (
/api/roaming, Dashboard). Standorte werden anhand des Namens ausenroll --siteverglichen. Die Einträge werden 90 Tage und höchstens 500 Stück aufbewahrt; gespeichert werden nur MAC, öffentlicher Schlüssel, Standortname und Zeit. - Ein stehengebliebener oder gestohlener Sensor kann sich nicht selbst melden, deshalb meldet der Collector per Webhook / syslog. Erfasst werden ein Sensor, der länger als
--stale-minutes(Standard 60 Minuten) nichts gesendet hat, Auffälligkeiten im Prüfprotokoll (critical) und Roaming zwischen Standorten (info). Wiederholungen werden standardmäßig auf 30 Minuten begrenzt, und in den 20 Minuten nach einem Neustart wird kein Sensor als gestoppt eingestuft. Solange kein Ziel gesetzt ist, wird nichts gesendet und nichts blockiert. Die Webhook-URL wird über die Standardeingabe übergeben, Weiterleitungen werden nicht verfolgt.
# 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
Kann der Collector seinen Verlauf (scans.jsonl, events.jsonl) nicht lesen, zählt er das Ungelesene mit, damit es nicht mit „keine Daten“ verwechselt wird. Eine beschädigte Zeile wird einzeln übersprungen; Zeilen, deren Datum nicht lesbar ist, löscht die Bereinigung nicht. Das Ergebnis erscheint in storage_health von /api/overview, im Dashboard und im Startprotokoll. Es findet keine neue Kommunikation statt.
11.7 Abruf von Erkennungsdaten (updates.fetch_cve_map)
Der Sensor ruft jeden Tag die signierte CVE-Map (die bekannten Schwachstellendaten für aktive Prüfungen) und die nmap-NSE-Datenbank vom Update-Dienst ab. Dieser Datenverkehr enthält keine Geräte- oder Audit-Daten. Für einen vollständigen Offline-Betrieb führen Sie sudo roamswitch-sensor config set updates.fetch_cve_map false aus (die Änderung gilt ohne Neustart ab dem nächsten Zyklus, und danach werden nur noch die mitgelieferten Daten verwendet).
11.8 Referenz der Konfigurationsschlüssel
Aktuelle Werte prüfen Sie mit roamswitch-sensor config show, ändern können Sie sie mit config set <key> <value> [<key> <value> …] (mehrere Schlüssel werden atomar gespeichert; auch der Konfigurationseditor C der TUI ändert sie). Nur Schlüssel, die in der Spalte „Neustart“ mit „Ja“ markiert sind, erfordern einen Neustart des Daemons (sudo systemctl restart roamswitch-sensor).
| Schlüssel | Typ / Werte | Standard | Neustart |
|---|---|---|---|
site | string | (empty) | Nein |
language | ja | en | ko | zh-Hans | zh-Hant | de | fr | es | it | pt-PT | (empty = system locale) | Nein |
schedule.enabled | bool | false | Nein |
schedule.interval_hours | int | 24 | Nein |
schedule.window_start_hour | int 0–23 | (unset = always) | Nein |
schedule.window_end_hour | int 0–23 | (unset = always) | Nein |
schedule.max_parallel | int 1–8 | 1 | Nein |
schedule.allow_routed_endpoints | bool | false | Nein |
schedule.routed_proof_minutes | int 5–1440 | 30 | Nein |
notify.webhook_urls | URL list | (empty) | Nein |
notify.min_severity | info | medium | high | critical | medium | Nein |
notify.cooldown_minutes | int | 30 | Nein |
notify.syslog.host | string | (empty = off) | Nein |
notify.syslog.port | int | 514 | Nein |
notify.syslog.protocol | udp | tcp | udp | Nein |
retention.scan_history_days | int (0 = never prune) | 0 | Nein |
retention.audit_log_days | int (0 = never prune) | 0 | Nein |
retention.inventory_stale_days | int (0 = never prune) | 0 | Nein |
collector.enabled | bool | false | Nein |
collector.url | URL | (empty) | Nein |
collector.push_interval_minutes | int | 15 | Nein |
collector.send_unmanaged_devices | bool | true | Nein |
collector.send_unmanaged_audits | bool | false | Nein |
collector.probe_control_port | bool | false | Nein |
control.bind_addr | IP address | 0.0.0.0 | Ja |
control.tls | off | optional | required | optional | Ja |
control.allow_legacy_signatures | bool | true | Nein |
updates.fetch_cve_map | bool | true | Nein |
control.listen_ipv6 | bool | false | Ja |
capture.rcvbuf_mb | int 0–256 (MiB, 0 = system default) | 4 | Ja |
dhcp.active_probe | bool | true | Nein |
dhcp.allowed_servers | MAC / IP list | (empty = learn the first) | Nein |
ipv6.enabled | bool | true | Nein |
ipv6.active_probe | bool | true | Nein |
ipv6.allowed_routers | MAC / IP list | (empty = trust the IPv4 gateway) | Nein |
unmanaged_audit.enabled | bool (needs authorization + allowed_cidrs first) | false | Nein |
unmanaged_audit.authorization | string | (empty) | Nein |
unmanaged_audit.allowed_cidrs | CIDR list (IPv4 ≤ /16 and IPv6 ≤ /48 refused) | (empty) | Nein |
unmanaged_audit.exclude | IP / CIDR / MAC list | (empty) | Nein |
unmanaged_audit.interval_hours | int | 168 | Nein |
unmanaged_audit.max_parallel | int 1–4 | 2 | Nein |
unmanaged_audit.product_check | bool (needs unmanaged_audit.enabled) | false | Nein |
unmanaged_audit.noauth_check | bool (needs unmanaged_audit.enabled) | false | Nein |
design_flaw.enabled | bool | false | Nein |
design_flaw.llm.tool | claude | opencode | codex | agy | (empty) | (empty) | Nein |
design_flaw.llm.model | string | (empty) | Nein |
design_flaw.llm.timeout_secs | int (0 or 5–600) | 0 | Nein |
security.on_revoked | lockdown | wipe | none | lockdown | Nein |
security.lockdown_after_offline_days | int (0 = off) | 0 | Nein |
12. Rogue-DHCP- und IPv6-Erkennung
Erkennt Angriffe, bei denen eingeschleuste Router o. Ä. sich als legitim ausgeben und den Kommunikationsweg der Endgeräte kapern. Es wird nur erkannt und benachrichtigt; der Datenverkehr wird nicht blockiert. Standardmäßig aktiv, passive Erfassung ist nicht nötig. Die Ergebnisse erscheinen in roamswitch-sensor network-threats, in der TUI, in Benachrichtigungen, Protokollen und Exporten.
12.1 Rogue-DHCP-Server (IPv4 und DHCPv6)
Stündlich wird von einer zufälligen MAC genau ein DHCP-Discover gesendet und es werden alle Server gezählt, die antworten. Ein REQUEST wird nicht gesendet, eine Adresse wird nicht geleast. Der erste Server wird als legitim gelernt, später auftauchende Server werden gemeldet. Wer ein anderes Gateway oder einen anderen DNS verteilt, ist critical.
12.2 IPv6 (Rogue-Router-Advertisements, NDP-Spoofing, reine IPv6-Geräte)
Unzulässige Router-Advertisements: Verhält sich ein anderes Gerät als das IPv4-Gateway als IPv6-Router, wird gemeldet (bei regulärem Aufbau in ipv6.allowed_routers eintragen). Advertisements, deren Hop-Limit nicht 255 ist, werden ignoriert. NDP-Spoofing: Wird die MAC einer IPv6-Adresse ausgetauscht, wird gemeldet (bei einem Router high). Nur über IPv6 sichtbare Geräte: Geräte, die nur in der Nachbartabelle auftauchen, werden gemeldet.
12.3 Wer als legitim gilt, und die Einstellungen
Sind dhcp.allowed_servers und ipv6.allowed_routers gesetzt, wird jede Antwort von anderen gemeldet (bei leerer Liste wird der erste gelernt). Mit ipv6.enabled lässt sich die IPv6-Überwachung abschalten. Das IPv6-Lauschen der Steuer-API (50543) wird mit control.listen_ipv6 (Standard false) ergänzt. Globales IPv6 kann aus dem Internet erreichbar sein und ist daher standardmäßig deaktiviert.
13. Leichte Prüfung von Geräten ohne RoamSwitch (optional)
Die aktive Schwachstellenprüfung in §5 betrifft nur gekoppelte und zugestimmte Endgeräte. Wenn Sie bei nicht gekoppelten Druckern, Kameras, NAS usw. prüfen möchten, „was nach außen offen ist“, steht eine weit begrenztere, separate Prüfung zur Verfügung. Tiefe Diagnosen wie OpenVAS, Anmeldeversuche, das Ausnutzen von Schwachstellen, nmap NSE und Vollport-Scans erfolgen nur bei zugestimmten Endgeräten.
13.1 Was geprüft wird
Es umfasst nur TCP-Verbindungsprüfungen auf 55 feste Ports, das Lesen des Banners, das ein offener Port von sich aus sendet (bei Webdiensten ein einziges HEAD /) und Hinweise auf bereits veröffentlichte Schwachstellen. Das Ergebnis lautet „aus dem LAN erreichbar“, nicht „verwundbar“. Produktprüfung und Authentifizierungsprüfung sind getrennte Opt-ins (standardmäßig aus).
13.2 Aktivieren
Vor dem Aktivieren sind unmanaged_audit.authorization (die genehmigende Stelle) und unmanaged_audit.allowed_cidrs (der Bereich; breiter als /16 bei IPv4 oder /48 bei IPv6 wird abgelehnt) zu setzen. Geplante Läufe erfolgen standardmäßig alle 168 Stunden; manuelle Läufe erfordern --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 Schutzvorkehrungen
Geräte außerhalb von allowed_cidrs, Geräte in unmanaged_audit.exclude, gekoppelte Endgeräte und der Sensor selbst werden unter keinen Umständen untersucht. Die MAC-Adresse wird davor und danach geprüft; gehört sie zu einem anderen Gerät, wird abgebrochen oder das Ergebnis verworfen. Der Text von authorization wird bei jedem Lauf ins Protokoll geschrieben.
13.4 Produktprüfung (hat das Produkt Schwachstellen aus dem CISA-KEV-Katalog? Opt-in)
unmanaged_audit.product_check (standardmäßig aus) liest den Produktnamen aus der Weboberfläche eines Geräts und meldet, ob eine CISA-KEV-Schwachstelle vorliegt. Gesendet werden nur GET / und Weiterleitungen (höchstens 2) an Web-Ports (80, 8080, 8181, 443, 8443, 10443). Anmeldungen, Passwortversuche, erratene Pfade und Eingaben zum Ausnutzen von Schwachstellen werden konstruktionsbedingt nicht gesendet. Höchstens 12 Anfragen pro Gerät, im Abstand von 150 ms.
Ein Produkt wird nur benannt, wenn seine Merkmale alle in derselben Antwort vorkommen. Hat die vom Gerät gemeldete Version eine CVE im betroffenen NVD-Bereich, wird sie als „betroffen“ (high) gemeldet; lässt sich die Version nicht lesen, als Hinweis „nicht bestätigt“ (medium), und das Gerät wird nicht als anfällig bezeichnet. Eine lesbare Version liefert nur MikroTik RouterOS. Unterstützt werden unter anderem Fortinet FortiGate, Ivanti Connect Secure und Citrix NetScaler. Die Merkmale beruhen auf öffentlichen Erkennungssignaturen und wurden nicht an echten Geräten geprüft.
Die KEV-Kopie ist mitgeliefert. Nur wenn product_check und updates.fetch_cve_map beide aktiviert sind, wird alle 24 Stunden eine öffentliche Feed-Datei der CISA abgerufen (es werden keinerlei LAN-Informationen gesendet).
Prüfung, ob ein Dienst ohne Authentifizierung antwortet (unmanaged_audit.noauth_check; standardmäßig aus, Opt-in) Es wird je eine rein lesende Anfrage gesendet, und zwar nur an die folgenden Ports, die offen waren: Redis (6379, PING), Memcached (11211), Docker API (2375), Elasticsearch (9200), etcd (2379), CouchDB (5984), kubelet (10250), ZooKeeper (2181), Ollama (11434). Es gibt keine Schreibzugriffe, keine Konfigurationsänderungen, kein AUTH, kein Senden oder Erraten von Passwörtern und keine Anmeldungen.
MongoDB, MySQL und Ähnliche werden nicht geprüft, da ein Versuch einer Anmeldung gleichkommen könnte. Das Ergebnis lautet „ohne Authentifizierung geantwortet“, „Authentifizierung erforderlich“, „abgelehnt“ oder „nicht feststellbar“. Die Prüfung läuft nur unter derselben Einwilligung wie das leichte Audit. Nur für Geräte verwenden, die Sie selbst verwalten.
14. Bei Verlust, Diebstahl oder Außerbetriebnahme
Ein Sensor enthält die Liste der je Endpunkt gefundenen Schwachstellen, die Adressen der gekoppelten Endpunkte und seinen Signaturschlüssel. Die gekoppelten Endpunkte behandeln ihn außerdem als zugelassenen Scanner; ein gestohlener Sensor im selben LAN könnte sich also als solcher ausgeben. Das verhindert Folgendes.
14.1 Widerruf am Collector und Sperre
Wird ein Sensor mit roamswitch-sensor-collector revoke <öffentlicher Schlüssel> --reason Grund widerrufen, werden seine Übermittlungen mit 403 sensor_revoked abgelehnt. Ein Sensor, der vom Widerruf erfährt, stoppt sich selbst (Lockdown) und beendet Audit, Übermittlung, Benachrichtigungen und Sondierung. Der Stopp bleibt auch nach einem Neustart bestehen, die Daten bleiben erhalten. Nur wenn sicher ist, dass der Sensor in der Hand des Eigentümers ist, lässt er sich mit roamswitch-sensor lockdown off aufheben.
14.2 Löschen, Außerbetriebnahme und Offline-Erkennung
Ist security.on_revoked auf wipe gesetzt, werden beim Widerruf Schlüssel, TLS-Schlüssel, Konfiguration (einschließlich Webhook-URL), Endgeräteliste, Audit-Ergebnisse und Geräteinventar mit Nullen überschrieben und gelöscht. Nur die Bedienungs- und Genehmigungsprotokolle bleiben als Nachweis erhalten. Der Standardwert lockdown hält lediglich an. Mit security.lockdown_after_offline_days (Standard 0 = deaktiviert) stoppt sich auch ein Sensor selbst, der lange nicht senden kann.
14.3 Was das nicht leisten kann
Endgeräte vertrauen diesem Sensor weiter, bis jedes selbst die Kopplung aufhebt, und der Sensor kann sie nicht benachrichtigen. Führen Sie auf jedem angezeigten Endgerät unter Linux roamswitch sensor unpair <öffentlicher Schlüssel dieses Sensors> aus, unter Mac Einstellungen > Sensor > Kopplung aufheben. Ein ausgeschaltet entwendeter Sensor erhält den Stoppbefehl nie, daher ist die Festplattenverschlüsselung (LUKS usw.) der eigentliche Schutz. Das Überschreiben garantiert auf Flash oder CoW keine vollständige Löschung.