Intégration UniFi Network pour Gladys Assistant
Intégration Ubiquiti UniFi pour UCG, UDM, Switches, APs et détection de présence.
Publiée par guim31
- Appareils
- Version 1.5.2
- Nécessite Gladys >=4.62.0
- ★ 0
Cette intégration permet de connecter votre console Ubiquiti UniFi OS (UCG Fiber, Dream Machine UDM/UDM-SE, UniFi Express, Cloud Key ou contrôleur UniFi hébergé) à Gladys Assistant.
Fonctionnalités
- Détection de présence (Device Tracker) : Suivi en temps réel des smartphones et appareils connectés à votre réseau Wi-Fi / Ethernet pour déclencher des scènes de présence / absence dans Gladys.
- Contrôle d'accès Internet : Bouton interrupteur pour bloquer ou autoriser l'accès web de n'importe quel appareil connecté.
- Contrôle des ports PoE : Allumer ou éteindre l'alimentation PoE d'un port de switch (pratique pour redémarrer une caméra IP ou un point d'accès).
- Wi-Fi Invités & SSID : Interrupteurs pour activer ou désactiver facilement des réseaux Wi-Fi (ex: Wi-Fi Invités).
- Supervision WAN & Santé : Remontée des débits montant et descendant (Mbps) et de l'état de votre Gateway.
Guide d'Authentification
L'intégration prend en charge 2 modes au choix :
Mode 1 : Clé API Locale (Recommandé)
- Rendez-vous sur votre console UniFi dans le menu Integrations (ex:
https://192.168.100.1/network/default/integrationsou UniFi Network > Control Plane / Settings > Integrations). - Cliquez sur Create New API Key.
- Nommez la clé (ex:
Gladys) et copiez la clé générée. - Dans Gladys, choisissez le mode Clé API Locale et collez la clé.
Mode 2 : Compte Administrateur Local (Nom d'utilisateur & Mot de passe)
- Connectez-vous à votre console UniFi OS (
https://192.168.100.1). - Allez dans Admins / Utilisateurs (👥) (ou dans Control Plane / Identity > Admins).
- Cliquez sur + Create New et cochez Restrict to Local Access Only.
- Définissez un nom d'utilisateur (ex:
gladys) et un mot de passe fort. - Attribuez-lui le rôle Admin.
- Dans Gladys, choisissez le mode Nom d'utilisateur & Mot de passe local et entrez ces identifiants.
Utilisation
- Une fois la configuration enregistrée dans Gladys, cliquez sur le bouton Tester la connexion UniFi pour valider la communication.
- Allez dans l'onglet Découverte de Gladys pour ajouter votre Gateway, vos clients réseau (smartphones), vos ports PoE et vos réseaux Wi-Fi.
Dépannage
En cas de problème, consultez les journaux (logs) du conteneur Docker dans l'interface Gladys ou avec docker logs gladys-integration-unifi.
Paramètres de configuration
Voici les paramètres demandés par UniFi Network dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connexion Locale UniFi OS | section | Non | Sélectionnez le mode d'authentification et entrez vos identifiants locaux UniFi ou votre clé API locale. |
| Adresse IP / Hôte | string | Oui | Adresse IP de votre console UniFi OS (ex: 192.168.1.1). |
| Port | number | Oui | |
| Mode d'authentification | select | Oui | |
| Clé API Locale | secret | Non | Clé API générée dans UniFi Network > Intégrations. |
| Nom d'utilisateur local | string | Non | Nom d'admin local créé dans Console > Utilisateurs & Admins (requis si mode Identifiants). |
| Mot de passe local | secret | Non | |
| ID du Site | string | Oui | |
| Délai de déconnexion présence (s) | number | Non | Délai d'inactivité avant d'indiquer un appareil absent (évite les faux positifs en veille). |
| Filtres de découverte des appareils | section | Non | Configurez quels appareils doivent être découverts et envoyés à Gladys. |
| Découvrir l'infrastructure (Console, APs, Switches) | boolean | Non | |
| Découvrir les clients du réseau | boolean | Non | |
| Clients connectés uniquement (Ignorer les anciens clients) | boolean | Non | Importer uniquement les clients actuellement connectés pour éviter d'importer des centaines d'anciens appareils hors-ligne. |
| Type de connexion des clients | select | Non | |
| SSIDs Wi-Fi autorisés | string | Non | Filtrer les clients Wi-Fi par noms de SSID (séparés par des virgules, ex: Maison, IoT). Laissez vide pour autoriser tous les SSIDs. |
Comment installer UniFi Network dans Gladys
- Dans Gladys, ouvrez Intégrations : UniFi Network apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-integration-unifi:1.5.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-integration-unifi.
UniFi Network nécessite Gladys >=4.62.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
UniFi Network est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation