--- title: Déclarer une porte UniFi Access ou un contrôleur UniFi Network dans Link’nX description: "Déclarer une porte UniFi Access ou un contrôleur UniFi Network dans Link’nX. Link’nX : trouver UniFi Access ou Network selon contexte option et famille, déclarer une porte Access avec…" canonical: https://wiki.can-nx.com/guides/link-unifi-devices/ language: fr product: Link’nX audience: - administrateur - installateur context: Link’nX dans un projet et une gateway autorisés ; UniFi Access ou UniFi Network selon option et contrôleur ; FR/EN, navigation mobile --- # Déclarer une porte UniFi Access ou un contrôleur UniFi Network dans Link’nX Contexte : Link’nX dans un projet et une gateway autorisés ; UniFi Access ou UniFi Network selon option et contrôleur ; FR/EN, navigation mobile 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](https://wiki.can-nx.com/guides/link-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](https://wiki.can-nx.com/guides/link-lists/). ## 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](https://wiki.can-nx.com/guides/link-unifi-access-actions/), [événements et KNX Access](https://wiki.can-nx.com/guides/link-unifi-access-events-knx/), [actions Network](https://wiki.can-nx.com/guides/link-unifi-network-actions/), [présence et KNX Network](https://wiki.can-nx.com/guides/link-unifi-network-presence-knx/).