Déclarer un interphone 2N dans Link’nX : API HTTP et import XML

Déclarez un interphone 2N dans Link’nX avec son adresse IPv4, un compte API HTTP et les méthodes d’authentification de ses API d’interrupteur et d’enregistrement. L’import de sa configuration XML préremplit la déclaration et fournit la liste des utilisateurs reprise par les actions et déclencheurs 2N.

Destiné à l’installateur ou à l’administrateur autorisé.

Avant de commencer

• L’adresse IPv4 de l’interphone et l’accès à son interface web.
• Le compte API HTTP prévu sur cet interphone et son mot de passe.
• Les méthodes d’authentification configurées sur l’interphone pour la fonction d’interrupteur et pour l’enregistrement des événements.
• Pour préremplir la déclaration, la configuration XML exportée de cet interphone.

Préparer l’interphone 2N

Link’nX commande l’interphone et reçoit ses événements par l’API HTTP de 2N. Saisissez l’adresse IP de l’interphone dans un navigateur, connectez-vous à son interface web, puis ouvrez Services → HTTP API. Les libellés cités sont ceux de l’interface 2N en anglais.

1. Dans l’onglet Services, cochez Enable pour Switch API, qui permet à Link’nX de commander les interrupteurs, et pour Logging API, qui lui transmet les événements : code saisi, appel, ouverture de porte, etc.

2. Pour chacun de ces deux services, relevez la méthode choisie dans Authentication : None, Basic ou Digest. La déclaration Link’nX doit indiquer la même méthode pour chaque service ; sinon, Link’nX ne peut pas communiquer avec l’interphone.

   

3. Dans un onglet Account, cochez Account Enabled, renseignez Username et Password sous User Settings, puis cochez sous User Privileges les droits des fonctions utilisées par Link’nX. Ce compte est celui que vous déclarerez dans Link’nX.

   

4. Pour préremplir la déclaration, exportez la configuration de l’interphone depuis System → Maintenance → Back Up configuration. Le fichier XML obtenu s’importe dans le formulaire Link’nX.

Ouvrir le formulaire de déclaration

1. Dans Link’nX, vérifiez le projet et la gateway. Ouvrez Appareils → Sécurité & Accès → 2N, ou cherchez 2N dans Rechercher un appareil…. Sur mobile, ouvrez d’abord le menu à trois traits. Le guide de navigation traite les cartes absentes ou verrouillées.
2. Cliquez sur Ajouter. L’écran Déclaration d’un 2N s’ouvre.
3. Si vous disposez de la configuration XML, importez-la d’abord, puis complétez les champs. Sinon, renseignez directement la connexion.

Importer la configuration XML

1. Cliquez sur Importer une configuration, en bas du formulaire, puis sélectionnez le fichier .xml de l’interphone concerné.
2. Vérifiez le nom du fichier affiché, puis relisez Nom, Adresse IP et les deux méthodes d’authentification. L’import peut remplacer des valeurs déjà saisies, y compris un nom personnalisé.
3. Vérifiez ou sélectionnez Nom utilisateur parmi les propositions disponibles, puis renseignez Mot de passe : le fichier ne remplit pas à lui seul tous les champs obligatoires.
4. Enregistrez la déclaration avec la disquette une fois la connexion complétée (section suivante). Un fichier importé sans sauvegarde n’est pas conservé dans Link’nX.

Les utilisateurs repris du fichier sont ensuite proposés dans les filtres des événements 2N de cet appareil. L’import prépare la déclaration Link’nX ; ce n’est pas une procédure de restauration de l’interphone 2N. Le fichier peut contenir des noms et des données d’accès : importez-le uniquement dans ce formulaire.

Renseigner la connexion et enregistrer

Champ	Saisie attendue
Nom	Nom permettant de retrouver l’interphone, obligatoire et limité à 64 caractères. Exemple fictif : « Accueil 2N ».
Adresse IP	Adresse IPv4 réelle de l’interphone. Une adresse vide ou mal formée empêche l’enregistrement ; l’exemple du champ n’est pas celui de votre installation.
Nom utilisateur	Compte API HTTP prévu sur cet interphone. Des propositions peuvent apparaître après import de la configuration.
Mot de passe	Mot de passe de ce compte, à saisir dans l’interface uniquement.
Méthode d’authentification de l’API d’interrupteur	None, Basic ou Digest, selon la configuration de cette fonction dans l’interphone.
Méthode d’authentification de l’API d’enregistrement	None, Basic ou Digest, selon la configuration de la réception des événements. Ce réglage est distinct du précédent.

Tous ces champs sont requis. Ne choisissez pas None pour contourner un échec d’authentification ; faites confirmer le mode prévu si vous ne le connaissez pas.

Cliquez ensuite sur la disquette en bas à droite, puis attendez Succès ! et le retour à la liste.

Vérifier le résultat

1. Retrouvez la ligne par Nom, Adresse IP et Nom utilisateur, puis cliquez sur son crayon Éditer.
2. Dans Modification du 2N, relisez les paramètres conservés.
3. Testez ensuite l’interphone avec les actions et déclencheurs 2N : une commande d’interrupteur valide la réponse de l’interphone et l’API d’interrupteur, un événement reçu valide l’API d’enregistrement. Testez les deux, car chaque API a sa propre authentification.

Modifier ou supprimer la déclaration

• Si vous modifiez Mot de passe, le champ Confirmer le mot de passe apparaît : saisissez la même nouvelle valeur dans les deux champs. Les mots de passe ne correspondent pas demande de corriger cette confirmation. Enregistrez avec la disquette et attendez Mis à jour !, puis relisez la déclaration.
• Pour abandonner une modification, quittez le formulaire ; dans Modifications non enregistrées, Annuler reste sur place et Ne pas enregistrer abandonne les changements.
• Avant de supprimer la déclaration, faites vérifier les actions et scénarios qui l’utilisent. Si les conséquences sont incertaines, contactez le support avant de supprimer.

En cas de problème

• La disquette reste grisée : contrôlez les champs requis, le format IPv4 et, après un changement de mot de passe, sa confirmation. Vérifiez séparément les deux méthodes d’authentification.
• Le fichier est choisi, mais des valeurs ou des utilisateurs attendus manquent : vérifiez qu’il s’agit du bon export et du bon interphone, puis les champs réellement remplis. Le nom du fichier et l’icône de configuration indiquent un import, pas la reprise de toutes ses données. Ne modifiez pas le XML au hasard.
• Aucune commande ni aucun événement : dans l’interface 2N, vérifiez que Switch API et Logging API sont cochés, que leur méthode d’authentification est celle de la déclaration et que le compte est activé avec les privilèges nécessaires.
• Les commandes fonctionnent, mais pas les événements : vérifiez Logging API dans l’interphone, puis relisez la Méthode d’authentification de l’API d’enregistrement et les filtres du déclencheur.

Contacter le support

Si le problème persiste après ces vérifications, écrivez à support@can-nx.com en indiquant le modèle de l’interphone, le projet et la gateway, l’objectif, le résultat affiché et les étapes réalisées. Ne joignez pas de fichier contenant des données sensibles et ne transmettez jamais le mot de passe.

Interface en anglais : 2N → Add → 2N Declaration, Name, IP address, Username, Password, Switch API authentication method, Logging API authentication method, Import configuration, puis 2N Modification, Edit et Confirm password.