Appareils – Hermetry

Un appareil est tout élément qui envoie des données à Hermetry ou reçoit des commandes de sa part : un capteur, un automate, un compteur, une caméra, une passerelle LoRaWAN, un routeur sous licence. Chaque appareil appartient à une seule organisation et utilise exactement un seul profil d’appareil. Cette section explique comment ajouter des appareils, les connecter, protéger leurs identifiants, consulter leur statut, leur envoyer des commandes, mettre à jour leur micrologiciel et modifier leurs paramètres.

Le modèle d’appareil

Élément	Description	Lecture
Appareil	Un enregistrement dans Devices : nom (unique dans votre organisation), libellé, type, profil, statut, numéro de série facultatif, et indication de passerelle ou non.	La liste des Devices et la page de l’appareil
Profil d’appareil	Les paramètres communs à un même type d’appareil : transport, identifiants de connexion, topics, limites, règle de connexion, clés de télémétrie et de configuration, provisioning, ainsi que règles d’alarme, commandes et micrologiciel.	Profils d’appareil
Identifiant	Ce avec quoi l’appareil se connecte. Au plus un identifiant actif par appareil.	Identifiants des appareils
Télémétrie	Mesures horodatées, une série par clé.	Télémétrie et données
Attributs	Valeurs qui décrivent ou configurent l’appareil : client (celles de l’appareil), shared (envoyées à l’appareil) et server (conservées sur la plateforme).	Attributs
État de connexion	En ligne ou hors ligne selon la règle du profil, dernière activité vue, journal de connexion.	Statut de connexion et activité
Emplacement	Le site, le bâtiment, la pièce ou la machine où se trouve l’appareil.	Placer les appareils

Comment les appareils atteignent Hermetry

Mode	Usage	Page
MQTT 3.1.1 sur TLS	Appareils qui maintiennent une connexion ouverte	MQTT, Référence MQTT des topics et des charges utiles
HTTPS	Appareils qui se réveillent, envoient des données puis se rendorment, ou réseaux qui bloquent MQTT	API HTTP des appareils
LoRaWAN	Capteurs sur batterie derrière des passerelles LoRaWAN (EU868)	LoRaWAN
Via une passerelle	Appareils de terrain derrière un routeur ou une passerelle qui transmet pour eux	Passerelles et appareils derrière une passerelle
Interrogés par la plateforme	Boîtiers qui ne peuvent pas se connecter d’eux-mêmes : agents SNMP, caméras IP et enregistreurs	Passerelles et appareils derrière une passerelle

Vous ne savez pas laquelle convient ? Consultez Choisir comment connecter vos appareils.

Comment les appareils entrent dans votre organisation

Mode	Usage	Page
New device (manuellement)	Quelques appareils que vous configurez vous-même	Ajouter et revendiquer des appareils
Import depuis un fichier CSV	De quelques dizaines à quelques centaines d’appareils d’un coup (jusqu’à 1 000 lignes par fichier)	Importer des appareils en masse
Auto-provisioning avec une clé de profil	De nombreux appareils identiques qui s’enregistrent eux-mêmes au premier démarrage	Ajouter et revendiquer des appareils, Quarantaine
Revendication	Appareils sous licence, avec le code figurant sur leur page Cloud	Appareils sous licence
Une passerelle signale un nouvel enfant	Appareils de terrain derrière une passerelle	Appareils derrière une passerelle
Enregistrement LoRaWAN ou mode appairage	Capteurs LoRaWAN	Ajouter un appareil OTAA, Mode appairage

Comment les appareils prouvent leur identité

Identifiant	Connexion
Jeton d’accès	Nom d’utilisateur MQTT = jeton, mot de passe vide. HTTP : `Authorization: Bearer <token>`.
MQTT basique	Nom d’utilisateur et mot de passe, éventuellement liés à un seul identifiant client.
Certificat X.509	Un certificat client émis par l’autorité de certification des appareils Hermetry. Utilisé par les appareils sous licence.

Les secrets ne sont affichés qu’une seule fois, à leur émission ou à leur renouvellement. Hermetry ne conserve que leurs empreintes (hashs). Les capteurs LoRaWAN, les enfants de passerelle et les appareils interrogés n’ont pas d’identifiant propre : leur passerelle, le serveur réseau ou l’interrogateur apporte leurs données.

Statut de l’appareil

Statut	Signification
Active	L’appareil peut se connecter et ses données sont stockées.
Disabled	La connexion de l’appareil est refusée. Sa connexion en cours prend fin lorsque vous le désactivez.
Quarantined	L’appareil s’est enregistré lui-même et attend une approbation. Il peut se connecter, mais ses données sont écartées tant qu’un administrateur ne l’a pas activé. Il compte dans votre limite d’appareils.

Le statut est distinct de l’état de connexion. Un appareil actif peut être Online, Offline, Never connected ou n’afficher que Last seen, selon la règle de connexion de son profil.

Permissions

Permission	Rôle minimum par défaut
Consulter les appareils	Utilisateur
Créer des appareils	Administrateur
Modifier et désactiver des appareils	Administrateur
Supprimer des appareils	Administrateur
Gérer les identifiants des appareils	Administrateur
Consulter les attributs des appareils	Utilisateur
Écrire les attributs server et shared des appareils	Administrateur

Les autres modules IoT ajoutent leurs propres permissions (commandes, micrologiciel, alarmes, LoRaWAN, paramètres). Voir Référence des permissions.

Limites

Votre offre fixe le nombre d’appareils que vous pouvez avoir. Chaque appareil compte : appareils en quarantaine, passerelles et capteurs LoRaWAN, enfants de passerelle et appareils interrogés. Lorsque vous atteignez la limite, les nouveaux appareils sont refusés avec le message indiquant que la limite d’appareils de l’offre est atteinte. Voir Offres et option IoT.

Dans cette section

Bases

Connexion

Gestion à distance des appareils