Déclarer une porte UniFi Access ou un contrôleur UniFi Network dans Link’nX

Ces parcours concernent l’administrateur ou l’installateur disposant du projet, de la gateway et de l’option correspondante. UniFi Access commande des portes ; UniFi Network gère des équipements et clients réseau. UniFi Protect est une autre intégration, destinée à la vidéosurveillance.

Trouver la bonne famille

Sélectionnez le projet et la gateway dans Link’nX. Dans la navigation des appareils, ouvrez Sécurité & Accès → UniFi Access ou Maison intelligente → UniFi Network. Vous pouvez aussi rechercher le nom de la famille. Sur petit écran, ouvrez d’abord la navigation. Cliquez sur Ajouter dans la liste.

Si l’entrée est absente, vérifiez le contexte et l’option disponible selon le guide de navigation. Une carte marquée Bientôt ne confirme pas que l’intégration est disponible pour votre installation. Pour obtenir l’accès, la licence ou la compatibilité du modèle, contactez support@can-nx.com.

UniFi Access : une déclaration par porte

Préparez l’hôte et le port du contrôleur Access, un jeton API autorisé pour cette installation et la porte à commander. La création du jeton et la configuration initiale du contrôleur doivent être confirmées par l’installateur ; ne transmettez jamais le jeton au chatbot ou par e-mail.

1. Renseignez Nom, jusqu’à 64 caractères : par exemple Entrée fictive.
2. Dans Hôte (nom d’hôte ou IP), indiquez le contrôleur, jusqu’à 128 caractères. Le champ accepte un nom réseau ou une IP.
3. Vérifiez Port, prérempli à 12445. Utilisez le port confirmé pour l’installation.
4. Renseignez Jeton API, masqué à l’écran.
5. Dans Porte contrôlée, cliquez sur Détecter les portes. Cette détection est possible avant le premier enregistrement lorsque l’hôte et le jeton sont renseignés.
6. Attendez le résultat, puis sélectionnez votre porte dans Porte. Aucune porte n’est choisie automatiquement pour vous.
7. Cliquez sur le bouton rond avec une disquette, en bas à droite. Attendez Succès !, puis retrouvez la déclaration dans la liste.
8. Sur sa ligne, cliquez sur le crayon Éditer pour relire l’hôte, le port et la porte. La détection est relancée à l’ouverture de l’édition.

Une déclaration représente une porte. Pour plusieurs portes du même contrôleur, créez les déclarations correspondantes ; ne remplacez pas la porte d’une déclaration utilisée par des automatismes sans vérifier leurs cibles.

La détection bloque ou la porte a disparu

• Contrôleur injoignable ou jeton invalide… : vérifiez l’hôte, le port, le jeton et l’accès du contrôleur depuis l’installation, puis cliquez sur Réessayer. Ce message ne permet pas de déterminer lequel de ces éléments est en cause. Après un échec, Identifiant de la porte (saisie manuelle) permet de renseigner l’UUID confirmé dans la console Access. Ne devinez pas cet identifiant.
• Aucune porte sur ce contrôleur… : la détection a renvoyé une liste vide. Vérifiez les portes dans la console UniFi Access, puis cliquez sur Actualiser. Ce résultat n’ouvre pas la saisie manuelle. Si vous créez une déclaration, une porte reste nécessaire pour enregistrer.
• Introuvable sur le contrôleur pour une ancienne porte : son identifiant peut rester affiché, mais cela ne prouve pas qu’elle existe encore ou soit joignable. Vérifiez la console et sélectionnez la porte voulue avant de sauvegarder. Une indisponibilité passagère ne justifie pas de choisir une autre porte au hasard.
• Un changement d’hôte ou de port peut effacer la sélection de porte : relancez la détection et vérifiez la cible. Une saisie manuelle non encore enregistrée peut aussi être remplacée lorsque la détection réussit.

Si ces vérifications ont déjà été faites, contactez support@can-nx.com avec le contexte, le message et les essais. Une capture utile doit masquer le jeton et les données privées.

UniFi Network : déclarer la console

Préparez une console UniFi OS, son hôte et son port, la clé du site Network et les identifiants d’un compte local autorisé à administrer le contrôleur. Le parcours pour un ancien contrôleur autonome sur un autre port doit être confirmé pour votre version ; changer uniquement le port ne suffit pas à établir sa compatibilité. Ne remplacez pas le nom d’utilisateur et le mot de passe par un jeton Access.

1. Renseignez Nom, jusqu’à 64 caractères.
2. Saisissez Hôte (nom d’hôte ou IP), jusqu’à 128 caractères : par exemple console.example.test, valeur fictive à remplacer.
3. Vérifiez Port, prérempli à 443, selon la console installée.
4. Renseignez Site, jusqu’à 64 caractères, prérempli à default. Confirmez la clé du site ; son nom d’affichage ne suffit pas nécessairement.
5. Renseignez Nom d’utilisateur, jusqu’à 128 caractères, et Mot de passe du compte local. Ces deux champs sont obligatoires. Le mot de passe peut être visible pendant la saisie : masquez-le dans toute capture.
6. Cliquez sur la disquette en bas à droite, attendez Succès !, puis vérifiez la liste. Rouvrez avec Éditer pour relire hôte, port et site.

Ce formulaire ne propose pas de détection des portes ni de sélection automatique des clients réseau. L’enregistrement de la déclaration ne prouve pas que le contrôleur a accepté une commande. Si les actions ou retours restent indisponibles, vérifiez les paramètres et le compte local avec l’installateur, puis contactez support@can-nx.com sans joindre les identifiants confidentiels.

Modifier ou supprimer

Utilisez Éditer, modifiez les champs utiles, enregistrez et relisez la déclaration. Si vous quittez avec des changements non enregistrés, tenez compte de la confirmation de départ. Dans la liste, la corbeille Supprimer ouvre une confirmation : vérifiez les automatismes qui utilisent la déclaration avant de confirmer. Aucune restauration automatique n’est promise ; voir les listes et confirmations.

Questions anticipées

Mon compte Link est-il le compte demandé dans Network ? Le formulaire Network demande le compte local du contrôleur. Faites confirmer ce compte par l’installateur.

La liste vide signifie-t-elle que mon jeton est faux ? Ce résultat est distinct de l’échec de détection. Suivez la branche correspondant au message affiché.

Le chatbot peut-il vérifier ma porte ? Il explique le parcours ; la déclaration enregistrée ne lui donne pas accès à votre installation.

Suite : actions Access, événements et KNX Access, actions Network, présence et KNX Network.