TP-Link Omada Open API pour Home Assistant (intégration de la Marketplace)

Installations: 194 partagent leurs statistiques
Étoiles GitHub: 42
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v1.11.1, 27 octobre 2026
Catégorie: Informatique et réseau, Routeurs et réseau
Type: Intégration de la Marketplace
Marque: TP-Link
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: omada_open_api
Source: github.com/bullitt186/ha-omada-open-api
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

À propos

TP-Link Omada Open API surveille et contrôle les points d’accès, interrupteurs, passerelles et clients Omada SDN depuis Home Assistant. Elle se connecte à un contrôleur Omada hébergé dans le cloud ou local via l’Omada Open API, et les passerelles Fusion se connectent à la place avec le nom d’utilisateur et le mot de passe de leur interface web. Elle ajoute des capteurs, des capteurs binaires, des suivis d’appareil, des boutons, des interrupteurs et des entités de mise à jour du firmware. Les interrupteurs couvrent le PoE, la LED, le SSID, les bandes radio et l’accès réseau des clients, et les boutons couvrent le redémarrage, la localisation, la reconnexion et un test de débit de la passerelle. Le suivi de présence des clients peut être limité par SSID, peut inclure ou exclure les clients filaires et invités, et dispose d’un mode de découverte automatique à activer volontairement. Les capteurs facultatifs comprennent des cartes thermiques des menaces, la surveillance des tunnels VPN et l’utilisation radio, et les intervalles de mise à jour sont réglables dans les options. Les entités de contrôle nécessitent des droits d’écriture sur l’Open API, et les comptes cloud gratuits ne sont pas pris en charge.

Résumé automatique du README et du code de bullitt186/ha-omada-open-api, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
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

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.

Sélectionner le type de contrôleur

Type de contrôleurHébergé dans le cloud utilise le cloud TP-Link ; local se connecte directement à ton contrôleur

Identifiants de l’API Omada

Omada IDMSP ID ou Customer ID de ton application Open API
Client IDClient ID OAuth2 de ton application Open API
Client SecretClient Secret OAuth2 de ton application Open API

Sélectionner la région du cloud

RégionChoisis la région du cloud qui correspond au déploiement de ton contrôleur Omada

URL du contrôleur local

URL du contrôleurURL complète avec le protocole et le port
Vérifier le certificat TLSLaisse cette option activée pour les certificats HTTPS valides. Désactive-la pour te connecter à un contrôleur matériel (par exemple OC200/OC300) qui utilise le certificat auto-signé d’usine.

Identifiants de la passerelle Fusion

URL de la passerelleURL complète avec le protocole (par exemple https://192.168.1.1)
Nom d’utilisateurNom d’utilisateur de connexion à l’interface web
Mot de passeMot de passe de connexion à l’interface web

Sélectionner les sites

Sites à surveillerSélectionne un ou plusieurs sites Omada pour surveiller les appareils et les clients

Filtrer les clients par SSID (facultatif)

Filtrer par SSID (facultatif)Sélectionne des SSID pour restreindre la liste des clients ; les clients filaires sont toujours affichés

Sélectionner les clients à suivre (facultatif)

Clients à suivreSélectionne les clients réseau pour lesquels créer des entités de suivi d’appareil

Après la mise en place

Filtrer par SSID (facultatif)Sélectionne des SSID pour restreindre la liste des clients ; les clients filaires sont toujours affichés
Clients à suivre
Applications à suivre
Intervalle d’interrogation des appareils (secondes)
Intervalle d’interrogation des clients (secondes)
Intervalle d’interrogation du trafic des applications (secondes)
Délai de déconnexion du client (minutes)Mets 0 pour une détection immédiate de la déconnexion. Les valeurs de 1 à 60 maintiennent l’appareil comme présent pendant ce nombre de minutes après sa disparition du réseau.
Découvrir automatiquement les suivis de présence des clients (à activer volontairement ; désactivé par défaut)Désactivé par défaut. Active-le pour créer un suivi de présence uniquement par client réseau actif ; les grands réseaux peuvent en créer des centaines. Les clients déjà suivis conservent leur identité et leurs contrôles plus riches.
Supprimer les clients découverts automatiquement et inactifs après ce nombre de jours30 jours par défaut. Mets 0 pour conserver indéfiniment les entrées du registre découvertes automatiquement. Le nettoyage ne supprime jamais les clients sélectionnés manuellement ni les appareils qui ont encore d’autres entités.
Uniquement ces SSID sans fil (vide pour tous)Noms de SSID exacts, facultatifs. Une sélection vide inclut tous les SSID sans fil.
Inclure les clients filairesSi désactivé, seuls les clients sans fil correspondant à la sélection de SSID sont découverts.
Exclure les clients invitésEmpêche les clients temporaires du réseau invité de créer des entrées dans le registre.
Exclure les adresses MAC administrées localement ou privéesLes adresses MAC administrées localement correspondent souvent à des adresses Wi-Fi privées. Laisse cette option désactivée si ces appareils sont utiles pour la détection de présence.
Découvrir uniquement les clients ayant un nomIgnore les clients pour lesquels Omada ne signale qu’une adresse MAC, sans nom ni nom d’hôte.
Clients à exclure de la découverte automatiqueLes adresses MAC explicitement exclues restent ignorées si elles se reconnectent.
Afficher le RSSI Wi-Fi, le SNR et la qualité du signal sur les suivis de clients existantsActivé par défaut. Affiche le RSSI (dBm), le SNR (dB) et le niveau du signal (%) signalés par le contrôleur comme attributs de chaque suivi existant. Les changements de SSID mettent à jour le même appareil ; aucune entité de capteur de signal distincte n’est créée.
Capteurs de bande passante quotidienne (totaux de téléchargement/envoi)
Capteurs du nombre de clients par appareil
Capteurs de diagnostic (CPU, mémoire, durée de fonctionnement, IP, firmware)
Capteurs d’utilisation radio (TX/RX/interférences par bande)
Capteurs de bande passante (téléchargé, envoyé, débit d’activité RX/TX)
Capteurs de signal (RSSI, SNR, puissance du signal)
Interrupteur d’accès au réseau (bloquer/débloquer)
Bouton de reconnexion
Capteurs de carte thermique des menaces (quotidien/hebdomadaire/mensuel)
Capteurs de surveillance VPN (tunnels et pairs)
Test de débit WAN (bouton de déclenchement, résultats et état d’exécution)

Textes issus du code de bullitt186/ha-omada-open-api. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

Capteurs binairesÉtat, Économie d’énergie, Connecté, Internet, Test de débit en cours, Optimisation WLAN en cours
BoutonsRedémarrer, Reconnecter, Optimisation WLAN, Localiser, Lancer le test de débit
CapteursClients connectés, Clients filaires, Clients sans fil, Clients invités, Total des clients, Consommation PoE, Durée de fonctionnement, Utilisation du CPU, Utilisation de la mémoire, Type d’appareil, Tag, Appareil de liaison montante et 69 autres
InterrupteursPoE, Accès au réseau, LED, Diffusion, SSID, Radio 2,4 GHz, Radio 5 GHz, Radio 5 GHz-1, Radio 5 GHz-2, Radio 6 GHz
Mises à jourMicrologiciel

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Les identifiants de l’API Omada ont un accès en lecture seule, Le suivi du trafic des applications nécessite une passerelle

Extrait du README

Monitor and control your TP-Link Omada SDN infrastructure directly from Home Assistant.

Extrait du README de bullitt186/ha-omada-open-api, MIT License. Abrégé.

S’affiche dans Vulpo :

carte Bascule rapide, carte Bouton, carte Graphique, Apple Watch, centre de contrôle.

Informations

Installations: 194 partagent leurs statistiques
Étoiles GitHub: 42
Connexion: Utilise le cloud du fournisseur
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v1.11.1, 27 octobre 2026
Catégorie: Informatique et réseau, Routeurs et réseau
Type: Intégration de la Marketplace
Marque: TP-Link
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: omada_open_api
Source: github.com/bullitt186/ha-omada-open-api
Problèmes: Signaler un problème