ROAMSWITCH SENSOR ・ Zuletzt aktualisiert: 2026-10-27

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.

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.

Richtlinie für ausgehenden Datenverkehr (standardmäßig werden keine Gerätedaten oder Audit-Ergebnisse gesendet)
Sensor ist nicht „Zero Telemetry“. (1) Abruf von Erkennungsdaten: Die CVE-Zuordnung und weitere Daten werden täglich abgerufen (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

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
Opt-in: Erweiterung der passiven LAN-Sichtbarkeit
Zur Verwendung mit einem Switch-Mirror-Port (SPAN) oder einer Inline-transparenten Bridge geben Sie den Namen der Zielschnittstelle in der Umgebungsvariable 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.

Wenn ein Pairing-Code abgelaufen ist
Ein Pairing-Code läuft automatisch 10 Minuten nach Ausstellung ab und kann niemals zweimal eingelöst werden. Ein Pairing-Versuch nach Ablauf wird abgelehnt. Bitten Sie in diesem Fall den Sensor-Betreiber, mit 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.

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 umstellen
(1) Jeden Endpunkt auf eine TLS-fähige Version aktualisieren und auf jedem die TLS-Kopplung abschließen (oder neu pinnen) → (2) bestätigen, dass roamswitch-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.

  1. Vollständiger Portscan: erkennt lückenlos jeden offenen TCP-Port auf dem Zielhost.
  2. 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 TO sendet, niemals DATA) sowie Diagnosen für CORS-Fehlkonfigurationen, Path Traversal und Open Redirects auf Dev-Servern, unter anderem.
  3. 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).
  4. Ergänzende nmap-NSE-Diagnose: breite, protokollübergreifende ergänzende Diagnose über nmap --script safe. Wird automatisch ausgeführt, sobald nmap auf 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.

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.

Ein gewöhnlicher NIC vs. ein Mirror-Port
Selbst ein einzelner gewöhnlicher NIC funktioniert zur Erkennung neuer Geräte im Rahmen von ARP-/Broadcast-/Multicast-Verkehr (auf echter Hardware in einem physischen LAN verifiziert). Um jedoch allgemeinen Unicast-Verkehr zwischen zwei anderen Hosts im LAN zu beobachten, ist ein Switch-Mirror-Port (SPAN) oder die Einrichtung von Sensor als Inline-transparente Bridge erforderlich.

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.

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.

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> --confirm
roamswitch-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
TabWechselt zwischen den Tabs
↑↓ / j kWählt einen Eintrag aus
cStellt 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
uHebt ein Pairing auf
sFü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
KDiesen 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
rLAN sofort neu durchsuchen (ARP-Sweep; läuft sonst automatisch stündlich)
eAudit-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
pManuelle 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
TTLS- 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)
CKonfigurationseditor (zeigt und ändert jeden Konfigurationsschlüssel; Webhook-URLs sind stets maskiert; Schlüssel, die einen Neustart erfordern, sind markiert)
NBenachrichtigungstest (zeigt Erfolg oder Fehlschlag je Ziel; URLs sind maskiert)
mFunktionsmenü (passive Überwachung, IoT-Verhalten, verdächtiger Datenverkehr, IoT-Advisories, Status i, Collector-Verwaltung und mehr)
OCollector-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
EnterDetails 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)
LDie Anzeigesprache wählen (wird in der Einstellung language gespeichert und gilt daher auch für vom Daemon erzeugte Benachrichtigungen und Protokolle)
qBeendet

9. Vertrauensmodell & Sicherheitsdesign

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
# 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
sitestring(empty)Nein
languageja | en | ko | zh-Hans | zh-Hant | de | fr | es | it | pt-PT(empty = system locale)Nein
schedule.enabledboolfalseNein
schedule.interval_hoursint24Nein
schedule.window_start_hourint 0–23(unset = always)Nein
schedule.window_end_hourint 0–23(unset = always)Nein
schedule.max_parallelint 1–81Nein
schedule.allow_routed_endpointsboolfalseNein
schedule.routed_proof_minutesint 5–144030Nein
notify.webhook_urlsURL list(empty)Nein
notify.min_severityinfo | medium | high | criticalmediumNein
notify.cooldown_minutesint30Nein
notify.syslog.hoststring(empty = off)Nein
notify.syslog.portint514Nein
notify.syslog.protocoludp | tcpudpNein
retention.scan_history_daysint (0 = never prune)0Nein
retention.audit_log_daysint (0 = never prune)0Nein
retention.inventory_stale_daysint (0 = never prune)0Nein
collector.enabledboolfalseNein
collector.urlURL(empty)Nein
collector.push_interval_minutesint15Nein
collector.send_unmanaged_devicesbooltrueNein
collector.send_unmanaged_auditsboolfalseNein
collector.probe_control_portboolfalseNein
control.bind_addrIP address0.0.0.0Ja
control.tlsoff | optional | requiredoptionalJa
control.allow_legacy_signaturesbooltrueNein
updates.fetch_cve_mapbooltrueNein
control.listen_ipv6boolfalseJa
capture.rcvbuf_mbint 0–256 (MiB, 0 = system default)4Ja
dhcp.active_probebooltrueNein
dhcp.allowed_serversMAC / IP list(empty = learn the first)Nein
ipv6.enabledbooltrueNein
ipv6.active_probebooltrueNein
ipv6.allowed_routersMAC / IP list(empty = trust the IPv4 gateway)Nein
unmanaged_audit.enabledbool (needs authorization + allowed_cidrs first)falseNein
unmanaged_audit.authorizationstring(empty)Nein
unmanaged_audit.allowed_cidrsCIDR list (IPv4 ≤ /16 and IPv6 ≤ /48 refused)(empty)Nein
unmanaged_audit.excludeIP / CIDR / MAC list(empty)Nein
unmanaged_audit.interval_hoursint168Nein
unmanaged_audit.max_parallelint 1–42Nein
unmanaged_audit.product_checkbool (needs unmanaged_audit.enabled)falseNein
unmanaged_audit.noauth_checkbool (needs unmanaged_audit.enabled)falseNein
design_flaw.enabledboolfalseNein
design_flaw.llm.toolclaude | opencode | codex | agy | (empty)(empty)Nein
design_flaw.llm.modelstring(empty)Nein
design_flaw.llm.timeout_secsint (0 or 5–600)0Nein
security.on_revokedlockdown | wipe | nonelockdownNein
security.lockdown_after_offline_daysint (0 = off)0Nein

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.

← Server Edition Betriebshandbuch Zur Linux Edition-Einrichtungsseite →