Une intégration personnalisée pour Home Assistant qui offre une surveillance de la sécurité réseau en temps réel pour votre maison. Elle combine l'analyse passive du trafic NetFlow/IPFIX avec le scan actif du réseau, le renseignement sur les menaces IP externes, les vérifications de listes noires DNS et la détection de vulnérabilités — le tout présenté dans un tableau de bord multi-vues dédié dans la barre latérale.
Surveillez passivement tout votre trafic réseau sans installer d'agents sur aucun appareil. Home Security Assistant écoute les datagrammes NetFlow v5, v9 et IPFIX sur un port UDP configurable et classifie le trafic interne vs. externe en utilisant vos plages CIDR configurées.
Allez au-delà de la surveillance passive avec le ping + scan de ports optionnel de tous les hôtes internes observés. Le scanner s'exécute à intervalle configurable et découvre les services même lorsque les hôtes bloquent le ping.
22,80,443,8000-9000). 47 ports bien connus par défaut
Chaque IP externe qui communique avec votre réseau est automatiquement enrichie avec du renseignement sur les menaces provenant de multiples sources, vous offrant une visibilité inégalée sur qui se connecte à votre maison.
Découvrez proactivement les vulnérabilités connues sur votre réseau avant les attaquants. Home Security Assistant interroge la base de données nationale des vulnérabilités du NIST (NVD) et croise les résultats avec le catalogue CISA des vulnérabilités exploitées connues.
Chaque appareil de votre réseau est automatiquement identifié et catégorisé, vous offrant un inventaire complet de votre maison connectée.
device_tracker (IP, nom, hostname, MAC)
Plus besoin de fouiller dans les journaux bruts. Obtenez des constats clairs et priorisés avec des niveaux de sévérité, des IP sources, des catégories et des compteurs d'occurrences.
La protection DNS intégrée permet à Home Security Assistant d'inspecter le trafic DNS et de bloquer les domaines malveillants en temps réel.
malware, phishing et adsdomaine=ip pour split-DNS local et mappages fixeshomesec_malicious_dns pour les requêtes bloquées
Une application mono-page multi-vues dédiée, enregistrée directement dans la barre latérale de Home Assistant. Rafraîchissement automatique toutes les 30 secondes avec mises à jour en direct.
| Vue | Description |
|---|---|
| Vue d'ensemble | Statistiques résumées, carte de scan actif, santé du collecteur NetFlow, alertes récentes, statut du proxy DNS et puces de mots-clés NVD colorées par source |
| Carte réseau | Graphe à forces en direct avec zoom/panoramique montrant les hôtes scannés, les hôtes avec flux actifs, les appareils à risque, les passerelles et les principaux pairs externes |
| Hôtes | Inventaire d'appareils recherchable avec rôles inférés, résultats de scan et noms enrichis par le tracker |
| Constats | Constats de sécurité exploitables avec boutons de rejet, détails CVE et conseils de remédiation |
| IP externes | Tableau d'IP externes enrichi avec évaluations de menaces, résultats VirusTotal, scores AbuseIPDB et recherche à la demande |
| Vulnérabilités | Navigateur CVE triable avec scores CVSS, sévérité, indicateurs CISA KEV, indicateurs de détection réseau et fenêtre de détail avec description complète et critères CPE |
| Statistiques | Top IP externes et pays contactés, plus budget d'enrichissement, détection de plan fournisseur et visibilité des erreurs API |
| Requêtes DNS | Journal DNS paginé avec filtres domaine/client, verdict/catégorie, mode malveillant uniquement et graphique par catégorie bloquée |
| Recommandations | Suggestions de durcissement priorisées basées sur l'état actuel de votre réseau |
| Capteur | Description |
|---|---|
| Appareils actifs | Nombre d'appareils internes observés |
| Appareils scannés | Nombre d'appareils avec résultats de scan actif |
| Total des flux | Total des enregistrements NetFlow/IPFIX ingérés |
| Constats ouverts | Nombre de constats exploitables (haute/critique) |
| Nombre de vulnérabilités | Nombre de vulnérabilités CVE détectées |
| Sources suspectes | Appareils accédant à des ports couramment abusés |
| Sources à sortie élevée | Appareils dépassant le seuil de données sortantes |
| Mots-clés NVD | Nombre de mots-clés de recherche NVD en cache avec compteur CVE par mot-clé et classification de source |
| Service | Description |
|---|---|
homesec.trigger_scan |
Lancer immédiatement un scan réseau complet sans attendre le prochain intervalle planifié |
homesec.nvd_refresh |
Vider le cache NVD local et récupérer des données de vulnérabilités fraîches depuis NVD |
homesec.blacklist_refresh |
Vider les entrées threat-intel chargées et retélécharger immédiatement les URLs de blocklists configurées |
Démarrer avec Home Security Assistant ne prend que quelques minutes.
https://github.com/domo-monster/HomeSecurityAssistant comme dépôt d'intégration personnalisé.custom_components/homesec dans votre dossier custom_components/ de Home Assistant.L'enrichissement par le tracker est automatique — si vous avez des intégrations de routeur ou de présence qui créent
des entités device_tracker, Home Security Assistant utilisera ces noms, hostnames et adresses MAC.
softflowd
Toutes les options peuvent être modifiées après l'installation via Configurer sur la carte de l'intégration. Les modifications déclenchent un rechargement automatique.
| Option | Défaut | Description |
|---|---|---|
| Adresse d'écoute | 0.0.0.0 |
Adresse d'écoute UDP |
| Port d'écoute | 2055 |
Port d'écoute UDP |
| Réseaux internes | 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, fd00::/8, fe80::/10 |
CIDR séparés par des virgules |
| Activer le panneau latéral | true |
Enregistrer le panneau Web UI |
| Option | Défaut | Description |
|---|---|---|
| Activer le scanner actif | true |
Ping + scan de ports des hôtes internes |
| Intervalle de scan | 3000 s |
Secondes entre les scans actifs |
| Exceptions de scan | vide | IP séparées par des virgules à ignorer lors du scan |
| Ports de scan | 47 ports par défaut | Ports ou plages séparés par des virgules à sonder |
| Option | Défaut | Description |
|---|---|---|
| Rétention IP externes (propres) | 5 h |
Durée de conservation des IP externes propres (0 = indéfiniment) |
| Rétention IP suspectes | 48 h |
Durée de conservation des IP externes classées suspectes |
| Rétention IP malveillantes | 168 h |
Durée de conservation des IP externes classées malveillantes |
| Activer le DNS inverse | true |
Résoudre les noms d'hôtes des IP externes |
| URL des listes noires | Flux abuse.ch | URL de flux de renseignement sur les menaces séparées par des virgules |
| Clé API VirusTotal | vide | Optionnel, active les recherches VT |
| Clé API AbuseIPDB | vide | Optionnel, active les scores d'abus |
| TTL du cache d'enrichissement | 1440 min |
Minutes avant de réinterroger les fournisseurs |
| Seuil AbuseIPDB avant requête VirusTotal | 30 |
VirusTotal est interrogé uniquement si le score AbuseIPDB atteint ce seuil |
| Budget quotidien VirusTotal | 500 |
Nombre maximal de requêtes VirusTotal par jour |
| Budget quotidien AbuseIPDB | 1000 |
Nombre maximal de requêtes AbuseIPDB par jour |
| Option | Défaut | Description |
|---|---|---|
| TTL du cache NVD | 12 h |
Heures avant de récupérer à nouveau les données CVE |
| Année CVE minimum NVD | 2020 |
Année CVE la plus ancienne à inclure (0 = toutes les années) |
| Mots-clés de recherche NVD | 16 par défaut | Noms de produits à rechercher dans NVD (ex. OpenSSH, nginx, WordPress) |
| Option | Défaut | Description |
|---|---|---|
| Activer le proxy DNS | false |
Lancer un proxy DNS local qui filtre les requêtes avec des blocklists threat-intel |
| Port du proxy DNS | 53 |
Port UDP d'écoute du proxy DNS |
| DNS amont du proxy | 1.1.1.1 |
Résolveur amont pour les requêtes non bloquées |
| Sources de contrôle DNS proxy | vide | Limiter le blocage à des sources de flux spécifiques (vide = toutes) |
| Catégories DNS bloquées | vide | Catégories de flux à bloquer (ex. malware, phishing, ads) |
| Overrides DNS | vide | Règles statiques domaine=ip (une par ligne ou séparées par des virgules) |
| Rétention du journal DNS | 24 h |
Heures de conservation des entrées de journal DNS (0 = tout conserver) |
Home Security Assistant est gratuit, open-source et conçu pour la communauté Home Assistant. Commencez à surveiller votre réseau en quelques minutes.