Home Security
Assistant

Eine benutzerdefinierte Home Assistant-Integration, die Echtzeit-Netzwerksicherheitsüberwachung für Ihr Zuhause bietet. Sie kombiniert passive NetFlow/IPFIX-Verkehrsanalyse mit aktivem Netzwerk-Scanning, externer IP-Bedrohungsintelligenz, DNS-Blacklist-Prüfungen und Schwachstellenerkennung — alles präsentiert in einem dedizierten Multi-View-Sidebar-Dashboard.

Auf GitHub ansehen Funktionen entdecken

Home Assistant Logo

Hauptfunktionen

Technische Dokumentation


Netzwerkkarte

 Netzwerkfluss-Analyse

Überwachen Sie Ihren gesamten Netzwerkverkehr passiv, ohne Agenten auf Geräten zu installieren. Home Security Assistant empfängt NetFlow v5, v9 und IPFIX-Datagramme auf einem konfigurierbaren UDP-Port und klassifiziert internen vs. externen Verkehr anhand Ihrer konfigurierten CIDR-Bereiche.

  • Verfolgt pro Gerät Flusszahlen, Byte-Volumen und Verbindungshistorie
  • Erkennt verdächtige Muster: ausgehender Verkehr zu häufig missbrauchten Ports, Port-Scanning, ungewöhnliches Ausgangsvolumen
  • Funktioniert mit jedem Standard-NetFlow/IPFIX-Exporter — keine proprietäre Hardware erforderlich

Aktiver Netzwerk-Scanner

 Aktiver Netzwerk-Scanner

Gehen Sie über passive Überwachung hinaus mit optionalem Ping + Port-Scanning aller beobachteten internen Hosts. Der Scanner läuft in konfigurierbaren Intervallen und entdeckt Dienste auch wenn Hosts Ping blockieren.

  • Konfigurierbare Scan-Ports — einzelne Ports, Bereiche oder beides angeben (z.B. 22,80,443,8000-9000). Standardmäßig 47 bekannte Ports
  • HTTP-Fingerprinting — leichtgewichtige WhatWeb-ähnliche Technologieerkennung identifiziert CMS-Plattformen (WordPress, Joomla, Drupal), Webserver (Tomcat, IIS, Caddy), Anwendungen (Grafana, GitLab, Nextcloud, Pi-hole, Synology DSM, UniFi) und Laufzeitumgebungen (PHP, Node.js, ASP.NET)
  • Berichtet Online-Status, Ping-Latenz, offene Ports, OS-Fingerabdruck und erkannte Technologien pro Host

Externe IP-Intelligenz

 Externe IP-Intelligenz

Jede externe IP, die mit Ihrem Netzwerk kommuniziert, wird automatisch mit Bedrohungsintelligenz aus mehreren Quellen angereichert und bietet Ihnen beispiellose Sichtbarkeit darüber, wer sich mit Ihrem Zuhause verbindet.

  • Anreicherung über IPInfo.io, VirusTotal, Shodan und AbuseIPDB (alle optional, API-Schlüssel konfigurierbar)
  • Reverse-DNS-Auflösung für externe IPs
  • Prüft externe IPs und Hostnamen gegen Bedrohungsintelligenz-Blacklists (abuse.ch-Feeds standardmäßig, vollständig anpassbar)
  • Konfigurierbares Aufbewahrungsfenster für externe IP-Historie (Standard 24 Stunden, oder unbegrenzt aufbewahren)

NVD-Browser

 Schwachstellenerkennung

Entdecken Sie proaktiv bekannte Schwachstellen in Ihrem Netzwerk, bevor Angreifer es tun. Home Security Assistant fragt die NIST National Vulnerability Database (NVD) ab und gleicht Ergebnisse mit dem CISA-Katalog bekannter ausgenutzter Schwachstellen ab.

  • NVD-Anreicherung — präzise CPE-Hersteller/Produkt-Filterung für über 20 Service-Mappings: SSH (OpenSSH, Dropbear), HTTP (Apache, nginx), MySQL/MariaDB, FTP, SMTP, Redis, MongoDB, PostgreSQL, Samba, MQTT und mehr
  • Service-bewusstes Vorladen — fragt NVD nur für tatsächlich in Ihrem Netzwerk erkannte Dienste ab
  • HTTP-Technologie-Validierung — CVEs für Webanwendungen werden nur gemeldet, wenn die Technologie per HTTP-Fingerprinting bestätigt wurde, wodurch falsch-positive Ergebnisse eliminiert werden
  • CISA KEV-Markierungen — hebt CVEs hervor, die aktiv ausgenutzt werden
  • Versionsbereich-Abgleich — prüft, ob Ihre exakt erkannte Version in einem verwundbaren Bereich liegt

Geräte-Fingerprinting

 Geräte-Fingerprinting & Anreicherung

Jedes Gerät in Ihrem Netzwerk wird automatisch identifiziert und kategorisiert und bietet Ihnen ein vollständiges Inventar Ihres vernetzten Zuhauses.

  • Erkennt Geräterollen: Gateway, Kamera, IoT, unbekannt usw.
  • Bearbeitbare Rollen — korrigieren Sie jede automatisch erkannte Rolle per Dropdown; Änderungen bleiben nach Neustart erhalten
  • Reichert Geräteidentitäten aus Home Assistant device_tracker-Entitäten an (IP, Name, Hostname, MAC)
  • Markiert Geräte mit bekannten hohen/kritischen CVE-Schwachstellen als „gefährdet“

Sicherheitsbefunde

 Umsetzbare Sicherheitsbefunde

Kein Durchsuchen roher Protokolle mehr. Erhalten Sie klare, priorisierte Befunde mit Schweregrad-Bewertungen, Quell-IPs, Kategorien und Vorkommenszählern.

  • Kategorien: verdächtige Ports, Port-Scanning, hoher Ausgangsverkehr, Schwachstellen
  • Verwerfbare Befunde — behobene Probleme aus der Oberfläche entfernen
  • Härtungsempfehlungen basierend auf beobachtetem Verhalten und Telemetrielücken

Home Security Assistant

Sidebar-Dashboard

Eine dedizierte Multi-View-Single-Page-Anwendung, direkt in der Home Assistant Sidebar registriert. Automatische Aktualisierung alle 30 Sekunden mit Live-Updates.

Ansicht Beschreibung
Übersicht Zusammenfassende Statistiken, Active-Scan-Karte, NetFlow-Listener-Status, aktuelle Warnungen und NVD-Keyword-Chips farbcodiert nach Quelle
Netzwerkkarte Live-Force-Directed-Graph mit Zoom/Pan, zeigt gescannte Hosts, Flow-aktive Hosts, gefährdete Geräte, Gateways und Top-externe Peers
Hosts Durchsuchbares Geräteinventar mit erkannten Rollen, Scan-Ergebnissen und Tracker-angereicherten Namen
Befunde Umsetzbare Sicherheitsbefunde mit Verwerfen-Buttons, CVE-Details und Behebungshinweisen
Externe IPs Angereicherte externe IP-Tabelle mit Bedrohungsbewertungen, VirusTotal-Treffern, AbuseIPDB-Scores und On-Demand-Abfrage
Schwachstellen Sortierbarer CVE-Browser mit CVSS-Scores, Schweregrad, CISA KEV-Markierungen und Detail-Modal mit vollständiger Beschreibung und CPE-Kriterien
Empfehlungen Priorisierte Härtungsvorschläge basierend auf dem aktuellen Netzwerkzustand

Home Security Assistant

Sensoren & Dienste

Sensoren

Sensor Beschreibung
Aktive Geräte Anzahl der beobachteten internen Geräte
Gescannte Geräte Anzahl der Geräte mit aktiven Scan-Ergebnissen
Gesamte Flüsse Gesamtzahl der aufgenommenen NetFlow/IPFIX-Datensätze
Offene Befunde Anzahl umsetzbarer (hoher/kritischer) Befunde
Schwachstellen-Anzahl Anzahl erkannter CVE-Schwachstellen
Verdächtige Quellen Geräte, die häufig missbrauchte Ports erreichen
Quellen mit hohem Ausgang Geräte, die den Schwellenwert für ausgehende Daten überschreiten
NVD-Schlüsselwörter Anzahl der NVD-Suchschlüsselwörter im Cache mit CVE-Zähler pro Schlüsselwort und Quellklassifikation

Dienste

Dienst Beschreibung
homesec.trigger_scan Sofort einen vollständigen aktiven Netzwerk-Scan starten, ohne auf das nächste geplante Intervall zu warten
homesec.nvd_refresh Den lokalen NVD-CVE-Cache leeren und frische Schwachstellendaten von NVD abrufen

Home Security Assistant

Schnellinstallation

Der Einstieg mit Home Security Assistant dauert nur wenige Minuten.

  1. Kopieren Sie das Verzeichnis custom_components/homesec in Ihren Home Assistant custom_components/-Ordner.
  2. Starten Sie Home Assistant neu.
  3. Gehen Sie zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suchen Sie nach „Home Security Assistant“.
  4. Konfigurieren Sie die Bind-Adresse, den UDP-Port, interne Netzwerk-CIDRs, Scanner-Einstellungen und optionale API-Schlüssel.
  5. Richten Sie Ihren Router oder Flow-Exporter auf den Home Assistant-Host und den konfigurierten Port.

Die Device-Tracker-Anreicherung erfolgt automatisch — wenn Sie Router- oder Präsenz-Integrationen haben, die device_tracker-Entitäten erstellen, nutzt Home Security Assistant deren Namen, Hostnamen und MAC-Adressen.

Empfohlene Exporter

  • OpenWrt mit softflowd
  • OPNsense / pfSense NetFlow- oder IPFIX-Export
  • UniFi-Gateway-Flow-Export
  • MikroTik Traffic Flow

Home Security Assistant

Konfigurationsoptionen

Alle Optionen können nach der Einrichtung über Konfigurieren auf der Integrationskarte geändert werden. Änderungen lösen ein automatisches Neuladen aus.

Grundeinstellungen

Option Standard Beschreibung
Bind-Adresse 0.0.0.0 UDP-Empfangsadresse
Bind-Port 2055 UDP-Empfangsport
Interne Netzwerke 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12 Kommagetrennte CIDRs
Sidebar-Panel aktivieren true Das Web-UI-Panel registrieren

Aktiver Scanner

Option Standard Beschreibung
Aktiven Scanner aktivieren true Ping + Port-Scan interner Hosts
Scan-Intervall 300 s Sekunden zwischen aktiven Scans
Scan-Ausnahmen leer Kommagetrennte IPs, die beim Scannen übersprungen werden
Scan-Ports 47 Standard-Ports Kommagetrennte Ports oder Bereiche zum Prüfen

Bedrohungsintelligenz & Anreicherung

Option Standard Beschreibung
Externe IP-Aufbewahrung 24 h Wie lange externe IPs aufbewahrt werden (0 = unbegrenzt)
Reverse-DNS aktivieren true Hostnamen externer IPs auflösen
Blacklist-URLs abuse.ch-Feeds Kommagetrennte URLs für Bedrohungsintelligenz-Feeds
IPInfo-Token leer Optional, verbessert das IP-Geolokalisierungskontingent
VirusTotal API-Schlüssel leer Optional, aktiviert VT-Abfragen
Shodan API-Schlüssel leer Optional, aktiviert Shodan-Abfragen
AbuseIPDB API-Schlüssel leer Optional, aktiviert Missbrauchsbewertungen
Anreicherungs-Cache-TTL 300 min Minuten bis zur erneuten Abfrage der Anbieter

Schwachstellen-Datenbank (NVD)

Option Standard Beschreibung
NVD API-Schlüssel leer Optional, erhöht das NVD-Ratelimit auf 50 Anfragen / 30 s
NVD-Cache-TTL 12 h Stunden bis zum erneuten Abruf der CVE-Daten
NVD minimales CVE-Jahr 2020 Ältestes CVE-Jahr zum Einbeziehen (0 = alle Jahre)
NVD-Suchschlüsselwörter 16 Standard Produktnamen für NVD-Abfragen (z.B. OpenSSH, nginx, WordPress)

Home Security Assistant

Sichern Sie Ihr Smart Home noch heute

Home Security Assistant ist kostenlos, Open-Source und für die Home Assistant-Community entwickelt. Beginnen Sie in wenigen Minuten mit der Überwachung Ihres Netzwerks.

Auf GitHub ansehen Kontaktieren Sie uns