À propos
UniFi Insights connecte Home Assistant à UniFi Network, Protect, Access et aux produits Ubiquiti associés grâce à une clé d’API. Elle fonctionne avec une console sur le réseau local ou avec n’importe quelle console d’un compte UniFi via UniFi Cloud, et se configure dans l’interface. Elle ajoute des capteurs, des capteurs binaires, des interrupteurs, des boutons, des caméras, des serrures, des lumières, des événements, des suivis d’appareil et des mises à jour de firmware, regroupés sous leurs appareils UniFi. Les actions couvrent des tâches comme le redémarrage d’appareils, le redémarrage des ports PoE, la reconnexion de clients sans fil et l’exportation des règles réseau sous forme de document. Des options permettent de suivre les clients WiFi et filaires, de limiter l’interrogation à certains sites choisis et de recevoir les événements de porte Access. Six cartes de tableau de bord sont installées avec elle, et les diagnostics masquent les clés d’API, les adresses et les noms de clients.
Résumé automatique du README et du code de tinkerologie/ha-unifi-insights, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Volets
- Caméras
- Serrures
- Alarmes
- Médias
- Interrupteurs
- Capteurs
- Présence
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Type de connexion
- Type de connexionLocal : connecte-toi directement à ton appareil UniFi sur ton réseau. Distant : connecte-toi via UniFi Cloud avec ta clé d’API cloud.
Connexion locale
- URL de l’hôteL’URL de ton appareil UniFi (par exemple https://192.168.1.1)
- Clé d’APIClé d’API de ton UniFi Controller (Réglages → Control Plane → API Keys)
- Vérifier le certificat SSLDésactive pour les certificats auto-signés (courant pour les appareils locaux)
- Jeton d’API UniFi Access (facultatif)Crée-le dans Access > Settings > General > Advanced. Il est distinct de la clé d’API UniFi et active les portes Access, les commandes d’urgence et les événements. Laisse vide pour ignorer Access.
- Port de l’API développeur UniFi AccessPort de l’API développeur UniFi Access sur la console. La valeur par défaut officielle est 12445.
Connexion distante (UniFi Cloud)
- Clé d’APIClé d’API cloud de ton compte UniFi. Après la validation, tu choisiras l’une des consoles auxquelles cette clé d’API peut accéder.
Sélectionner la console distante
- ConsoleCes consoles ont été découvertes avec ta clé d’API.
UniFi Carrier Fabric
- Clé d’APIUne clé d’API avec les autorisations Carrier Fabric ISP (type ISP).
Également demandé lors d’une nouvelle connexion au compte.
Réauthentifier
- Clé d’APIUne nouvelle clé d’API de ton UniFi Controller (Réglages → Control Plane → API Keys)
Reconfigurer
- URL de l’hôteL’URL de ton appareil UniFi (par exemple https://192.168.1.1)
- Clé d’APIClé d’API de ton UniFi Controller (Réglages → Control Plane → API Keys)
- Vérifier le certificat SSLDésactive pour les certificats auto-signés (courant pour les appareils locaux)
- ID de la consoleL’ID de la console cloud UniFi à laquelle cette entrée se connecte
- Jeton d’API UniFi Access (facultatif)Saisis un nouveau jeton pour remplacer celui qui est enregistré. Laisse vide pour garder le jeton actuel.
- Port de l’API développeur UniFi AccessPort de l’API développeur UniFi Access sur la console.
- Supprimer le jeton AccessActive pour supprimer le jeton Access et son webhook de résultat d’accès. Ignoré si un nouveau jeton est saisi.
Après la mise en place
- Suivre les clients WiFiCrée des entités de suivi d’appareil pour les clients WiFi connectés. Cela peut créer beaucoup d’entités.
- Suivre les clients filairesCrée des entités de suivi d’appareil pour les clients filaires (LAN) connectés. Cela peut créer beaucoup d’entités.
- Activer le contrôle des clientsCrée des entités d’interrupteur d’autorisation/blocage et de bouton de reconnexion pour les clients connectés, ainsi que des boutons Wake-on-LAN (désactivés par défaut) pour les clients filaires. Désactiver cette option supprime les boutons des clients.
- SitesInterroge uniquement ces sites. Laisse vide pour inclure tous les sites de la console. Les sites non sélectionnés ne sont pas interrogés, ce qui réduit le trafic d’API sur les consoles multisites.
- Suivre chaque abonné comme appareilCrée une entrée d’appareil pour chaque abonné de ton organisation Carrier Fabric.
- Activer les actions de service (suspendre et reprendre les abonnés)Autorise la suspension et la reprise des services des abonnés depuis Home Assistant.
- Recevoir les événements de porte Access (accordés et refusés)Home Assistant doit être joignable depuis la console pour ces événements. Désactive pour supprimer le webhook Access.
Textes issus du code de tinkerologie/ha-unifi-insights. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- AlarmesAlarme
- Capteurs binairesÉtat, Connexion, VPN site à site, Stockage presque plein, Détection de mouvement, Détection de personnes, Détection de véhicules, Détection d’animaux, Détection de colis et 11 autres
- BoutonsRedémarrage de l’appareil, Redémarrage PoE, Générer un bon invité, Déverrouiller, Reconnecter, Lire, Démarrer la ronde PTZ, Arrêter la ronde PTZ
- VoletsPortail
- PrésencePosition
- ÉvénementsSonnette, Détection intelligente, Porte/Fenêtre, Modifications des règles réseau, Résultat d’accès
- ImagesPlan d’étage, Code QR du dernier bon, Code QR WiFi
- SerruresSerrure
- MédiasHaut-parleur
- NombresVolume du microphone, Niveau de luminosité, Volume du carillon, Nombre de répétitions, Durée du bon, Limite d’invités du bon, Limite de téléchargement du bon, Limite d’envoi du bon, Limite de données du bon
- SélecteursMode HDR, Mode vidéo, Sonnerie, Préréglage PTZ, Liveview
- CapteursCharge CPU, Mémoire, Durée de marche, Débit montant émis, Débit montant reçu, Température, Humidité, Batterie et 72 autres
- InterrupteursVoyant d’état, Mode FPS élevé, Autoriser, Redémarrage électrique, Client VPN, Verrouillage, Évacuation
- Mises à jourFirmware
Actions
- Actualiser les donnéesForce une actualisation immédiate des données de UniFi Insights.Champs : ID du site
- Redémarrer l’appareilRedémarre un appareil UniFi.Champs : ID du site, ID de l’appareil, Entité
- Définir les sonnettes associées au carillonChoisis quelles sonnettes font sonner un carillon UniFi Protect. La sélection remplace l’association actuelle du carillon. Laisse Sonnettes vide pour dissocier toutes les sonnettes.Champs : ID du carillon, Sonnettes, Entité, Appareil
- Suspendre l’abonnéArrête le service internet d’un abonné. Nécessite que l’option « Enable service actions » soit activée sur l’entrée d’intégration Carrier Fabric, et une clé d’API de fournisseur d’accès avec la portée suspend:service.Champs : Motif, Entité, Appareil
- Rétablir l’abonnéRétablit le service internet d’un abonné. Nécessite que l’option « Enable service actions » soit activée sur l’entrée d’intégration Carrier Fabric, et une clé d’API de fournisseur d’accès avec la portée resume:service.Champs : Entité, Appareil
- Redémarrer électriquement un port PoERedémarre électriquement un port compatible PoE sur un appareil réseau UniFi.Champs : ID du site, ID de l’appareil, Index du port, Entité
- Reconnecter le clientReconnecte au Wi-Fi un client sans fil connecté. N’accepte que les clients actuellement connectés et sans fil.Champs : ID du site, ID du client, Entité, Appareil
- Supprimer les clientsSupprime de UniFi Network les anciens clients sans nom et de courte durée. Oublie les clients qui n’ont ni nom, ni nom d’hôte, ni IP fixe et qui ont été vus pendant 15 minutes ou moins. Si un horodatage est manquant, le client n’est pas exclu par le contrôle de l’ancienneté. Traite les sites sélectionnés dans les réglages de l’intégration, sur les consoles où Network est disponible. Les clients dont l’horodatage n’est pas un nombre sont conservés. Nécessite un utilisateur administrateur. Ne supprime pas les appareils ni les entités de Home Assistant.
- Jouer la sonnerie du carillonCette action renvoie toujours une erreur de non-prise en charge, car l’API officielle de Protect n’a pas de route de lecture pour le carillon.Champs : ID du carillon, ID de la sonnerie, Entité, Appareil
- Exporter les règles réseauRenvoie un instantané des politiques de pare-feu, des routes basées sur des politiques, des redirections de ports, des règles de trafic, des règles NAT et des routes statiques d’une console, sous la forme d’un document versionné, pour la comparaison, le suivi des versions et la récupération manuelle. Ce n’est pas une sauvegarde complète de la console : les réseaux, zones, listes de correspondance de trafic, groupes et définitions VPN auxquels les règles font référence ne sont pas inclus, et il n’y a pas d’importation. Les règles sont lues depuis la console au moment où tu exécutes l’action. Seul un type de règle avec le statut ok est complet. Failed signifie que la réponse n’a pas pu être lue, n’était pas du JSON, était incomplète ou contenait un enregistrement impossible à analyser. Unsupported signifie que la console a refusé la requête, ou que le site n’a pas de nom classique pour les cinq types de règles autres que les politiques de pare-feu. Nécessite un utilisateur administrateur. L’action renvoie seulement des données ; elle n’écrit aucun fichier.Champs : ID du site, Console, Types de règles, Masquer les valeurs sensibles
- Définir le code PIN d'un utilisateur AccessAttribue un code PIN à un utilisateur UniFi Access. Le code PIN doit contenir uniquement des chiffres. La console vérifie sa longueur et renvoie un refus si elle n'accepte pas la valeur. Nécessite un utilisateur administrateur.Champs : ID utilisateur, PIN, Console
- Supprimer le code PIN d'un utilisateur AccessSupprime le code PIN attribué à un utilisateur UniFi Access. Nécessite un utilisateur administrateur.Champs : ID utilisateur, Console
- Définir le statut d'un utilisateur AccessDéfinit un compte utilisateur UniFi Access sur ACTIVE ou DEACTIVATED. Cela contrôle tout le compte, donc un utilisateur désactivé perd l'accès avec chaque identifiant. Nécessite un utilisateur administrateur.Champs : ID utilisateur, Statut, Console
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du README
Monitor and control your UniFi system from Home Assistant: UniFi Network, UniFi Protect, UniFi Access, UniFi InnerSpace, UniFi Mobility, UniFi Site Manager and UniFi Carrier Fabric, in one integration.
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Volet, carte Serrure, Apple Watch, centre de contrôle.Informations
- Installations
- 413 partagent leurs statistiques
- Étoiles GitHub
- 47
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2026.10.4,
- Catégorie
- Informatique et réseau, Routeurs et réseau
- Type
- Intégration de la Marketplace
- Marque
- Ubiquiti
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
unifi_insights- Problèmes
- Signaler un problème
















