Points de terminaison de protocole

Certains appareils ne peuvent pas se connecter à Hermetry : un agent SNMP dans un onduleur, une caméra, un enregistreur. Hermetry se connecte à eux à la place. Vous décrivez le boîtier une seule fois comme un endpoint, puis vous y rattachez un ou plusieurs appareils. Le poller de la plateforme lit les appareils selon un planning et enregistre chaque résultat sous forme de message d’appareil ordinaire.

Terme	Signification
Protocol	Le langage qu’Hermetry utilise pour parler au boîtier : SNMP, caméra RTSP, ou le protocole HTTP des caméras et enregistreurs pris en charge
Endpoint	Un boîtier : son hôte, son port, ses réglages et ses secrets en écriture seule (mots de passe, communautés)
Device	Un appareil rattaché à un endpoint, avec une adresse sur celui-ci lorsque le boîtier dessert plusieurs appareils (le canal d’un enregistreur)

Les caméras et enregistreurs s’ajoutent avec leur propre choix, Camera or recorder ; voir Add a camera or recorder. Cette page couvre les règles générales et le choix Network device.

Avant de commencer

Créez un profil d’appareil pour le protocole. Sous Device profiles, sélectionnez New profile et choisissez le protocole comme Transport. Les profils interrogés utilisent la règle en ligne Last seen only. Sans un tel profil, vous voyez : « No device profile uses « … » yet. Create one with this transport under Device profiles; the new devices use it. »
Rendez le boîtier accessible à une adresse publique. Le poller fonctionne dans le cloud. Chaque enregistrement et chaque test résout l’hôte et refuse les adresses privées, de bouclage et de liaison locale (« The host is a private address. Only public addresses can be reached from the cloud; use a site router for a private network. ») ainsi que les ports qui appartiennent à des services de la plateforme (« That port belongs to a service and cannot be used. »).
Ouvrez votre pare-feu pour le poller. Le formulaire d’endpoint affiche les adresses fixes depuis lesquelles la plateforme se connecte : « The platform polls from …. Allow these addresses in the firewall of the site. » N’autorisez que ces adresses vers le port de l’appareil.

Ajouter un appareil réseau

Vous avez besoin des droits pour créer des appareils et gérer les endpoints de protocole.

Ouvrez Devices et sélectionnez New device. Choisissez Network device (« An SNMP agent or another box the platform polls, by its address and credentials; the connection is tested first. »).
Étape Connect : choisissez le Protocol, puis sous Connection soit un endpoint existant de ce protocole (affiché avec son nom, son hôte et le nombre d’appareils), soit A new endpoint.
Pour un nouvel endpoint, saisissez un Name et remplissez les champs du protocole. Sélectionnez Save and test the connection.
- Si le test réussit, continuez.
- Si le test échoue, l’endpoint est enregistré désactivé : « The endpoint is saved switched off because its test failed. Fix it and save again, or add the devices now and switch it on later on their Connection tab. » Corrigez les réglages et sélectionnez Save and test again, ou poursuivez avec Add the devices anyway.
Étape Devices : choisissez le Device profile. Puis cochez les entrées découvertes par Hermetry derrière l’endpoint, ou, pour un protocole sans découverte (SNMP), saisissez un Device name (et les champs d’adresse, si le protocole en a). Sélectionnez Add device.
Étape Done : « {count} devices were added. » Sélectionnez Add another pour en ajouter d’autres.

Les noms d’endpoints sont uniques dans votre organisation (« An endpoint with this name already exists. Choose another name. »).

Les secrets sont en écriture seule

Les mots de passe, communautés et autres champs secrets sont stockés chiffrés et ne sont jamais réaffichés, ni dans l’interface ni dans l’API. Le formulaire affiche « Stored. Leave empty to keep it; it is never shown again. ». Pour modifier un secret, saisissez-en un nouveau.

Si vous modifiez l’host, un port ou le user, vous devez saisir à nouveau le mot de passe (« You changed the host, a port or the user: enter the password again. »). Cela empêche d’envoyer un mot de passe enregistré à une nouvelle adresse.

Le test de connexion

Le test exécute la vérification propre au protocole (pour SNMP, une lecture du groupe system). Le résultat est OK ou Failed avec une raison, ainsi que des avertissements qui n’font pas échouer le test.

Échec	Signification
« The user name or password was refused. »	Identifiants incorrects
« The device refused the connection. Check the port. »	Rien n’écoute sur ce port
« The device did not answer in time. »	Pare-feu, mauvais hôte ou appareil éteint
« The host name does not resolve. »	Nom DNS inconnu
« The secure connection could not be set up (certificate). »	Problème de certificat sur un appareil HTTPS
« The stored credentials cannot be read. Enter them again. »	Ressaisir les secrets
« The protocol module is not active for this workspace. »	Le protocole ne fait pas partie de votre offre

Les tests sont limités : « This endpoint was just tested. Wait a few seconds. » Chaque test et chaque sondage d’un nouvel hôte est consigné dans le journal d’audit.

Découvrir des appareils

Un protocole capable de lister ce qui se trouve derrière lui (les canaux d’un enregistreur) propose Discover devices / Discover more devices. La liste affiche Name, Address et State (Online, Offline, Already connected). Cochez ce que vous voulez et sélectionnez Add {count} devices. Chacun devient un appareil de cet endpoint, interrogé selon l’intervalle de son profil.

La limite d’appareils de votre offre est vérifiée pour l’ensemble du lot avant la création de tout appareil : « {current} of {limit} devices used; {adding} more do not fit in your plan. »

L’onglet Connection

La page d’un appareil interrogé comporte un onglet Connection. Il affiche :

Champ	Signification
Endpoint, Protocol, Address	Où l’appareil est interrogé
Credentials	« Set: … (never shown; Edit replaces them) »
Last poll, Last success, Next poll	Le planning ; Never polled avant la première interrogation
Failed polls in a row, Last error	Pourquoi l’appareil ne répond pas
Device events	Pour les endpoints qui reçoivent des événements d’appareils, voir Camera events

Actions sur l’onglet :

Edit endpoint ouvre le formulaire d’endpoint. Si plusieurs appareils partagent l’endpoint, une note l’indique : « Shared by {n} devices. A change to the endpoint applies to all of them ».
Switch off / Switch on arrête ou reprend l’interrogation. Un endpoint désactivé n’interroge aucun de ses appareils. Réactiver l’endpoint le teste à nouveau.
Disconnect arrête l’interrogation de l’appareil et conserve ses données. Pour le dernier appareil d’un endpoint, vous choisissez Only disconnect ou Disconnect and delete the endpoint.
Connect through an endpoint rattache un appareil qui n’en a pas. Le profil de l’appareil doit utiliser le protocole de l’endpoint (« The device’s profile uses a different transport than this endpoint’s protocol. Change the profile first. »).

La colonne IP address de la liste des appareils affiche l’adresse publique du boîtier depuis lequel un appareil interrogé est lu.

Endpoints inutilisés

Un endpoint qui ne dessert aucun appareil conserve tout de même ses identifiants enregistrés. Dans le choix Network device, Unused endpoints ({n}) les liste ; sélectionnez Delete this unused endpoint pour en supprimer un. Un endpoint qui dessert encore des appareils ne peut pas être supprimé (« The endpoint still serves devices. Disconnect them first. »).

Erreurs

Message	Correction
« A device is already connected at this address of the endpoint. »	Choisissez une autre adresse (canal).
« This endpoint can hold only one device, and it already has one. »	Ajoutez un nouvel endpoint pour l’appareil suivant.
« The device is already connected through an endpoint. »	Déconnectez-le d’abord.
« Des appareils sont en cours d’ajout. Réessayez dans un instant. »	Un autre ajout est en cours dans votre organisation.
« Protocole non installé »	Le module du protocole n’est pas disponible ; l’appareil n’est pas interrogé.