Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Profils d’appareils

Chaque section et champ d'un profil d'appareil – transport, identifiants, topics, règle de connexion, limites, clés, provisionnement – avec les valeurs par défaut et les règles de suppression.

Un profil d’appareil décrit le comportement d’un type d’appareil. Chaque appareil utilise exactement un profil. Si vous modifiez le profil, tous les appareils qui l’utilisent suivent la modification. Créez un profil par type d’appareil : un profil par modèle de capteur, par famille de firmware, ou par besoin de sécurité (par exemple un profil TLS et un profil pour les anciens appareils qui ne peuvent pas utiliser TLS).

Ouvrez les profils dans Device Profiles du menu IoT. La consultation nécessite le rôle User ; la modification nécessite le rôle Admin. La stratégie de provisioning et les clés nécessitent l’autorisation distincte de gérer le provisioning (administrateurs).

La liste des profils

La liste affiche Name, Transport, Online rule, Devices (le nombre se met à jour toutes les 30 s) et Updated, avec les badges Default, Built-in et Platform template. Recherchez par nom et filtrez par transport et par règle de connexion.

Pour créer un profil, sélectionnez New profile, saisissez un Name, une Description et le Transport, puis sélectionnez Create profile. Les limites, les topics et les identifiants de connexion partent des valeurs par défaut du protocole ; vous les modifiez sur la page du profil. Vous devez choisir une règle de statut en ligne avant de pouvoir enregistrer le profil.

Le profil par défaut

Chaque organisation possède exactement un profil par défaut. Hermetry crée un profil nommé Default la première fois qu’il en a besoin. Il utilise :

  • la règle de statut en ligne Live connection,
  • le schéma de topics par défaut,
  • l’authentification par jeton d’accès uniquement,
  • les limites standard du protocole,
  • provisioning Disabled,
  • TLS uniquement (port 8883).

Votre premier profil personnalisé devient aussi le profil par défaut. Pour faire d’un autre profil le profil par défaut, ouvrez-le et sélectionnez Make default. Les nouveaux appareils qui ne nomment aucun profil reçoivent le profil par défaut.

Profils intégrés

Certains protocoles disposent d’un profil intégré, signalé par Built-in profile. Hermetry le crée la première fois qu’il est nécessaire :

Profil intégréUtilisé par
LoRaWAN EU868 Class A OTAA (1.0.3)Capteurs LoRaWAN ajoutés avec New device > LoRaWAN device
Passerelle LoRaWANPasserelles Basics Station
Le profil du protocole caméraCaméras et enregistreurs de ce protocole

Un profil intégré conserve son transport (« A built-in profile keeps its transport: devices of its protocol are registered with it. ») et ne peut pas être supprimé. Tout le reste est modifiable, et vous pouvez le renommer.

Profils issus d’un modèle

Un appareil sous licence que vous revendiquez reçoit une copie du profil de son modèle, créée à partir d’un modèle de la plateforme. L’en-tête du profil indique le modèle et la version d’origine, et certains champs affichent from template. Un tel profil n’accepte que les certificats X.509 (« This profile accepts X.509 certificates only »). Le provisioning reste Disabled sur une copie.

Sections du profil

OngletCe que vous définissez
GénéralName (de 1 à 128 caractères, unique dans votre organisation), Description (jusqu’à 2 000 caractères). Affiche la date de création et de dernière modification du profil, son ID, et ce qui l’utilise (In use).
Transport & authentificationTransport, identifiants de connexion autorisés, MQTT en clair, jeton dans l’URL, réseaux autorisés, commandes autorisées sans TLS, schémas de topics, topics personnalisés.
Statut en ligneLa manière dont Hermetry détermine qu’un appareil est en ligne.
LimitesLimites de débit, tailles de charge utile, fenêtre en vol, inactivité, appareils enfants de la passerelle, délai d’expiration par défaut des commandes.
Clés de télémétrieLes clés envoyées par les appareils, avec libellés, unités, décimales et plages.
Clés de configurationLes clés cfg.* que vous pouvez définir sur les appareils.
ProvisionnementLa manière dont les appareils sans identifiants s’enregistrent eux-mêmes.

D’autres modules ajoutent des onglets : Alarm rules, Commands, Firmware, LoRaWAN (profils LoRaWAN) et SNMP (profils SNMP).

Transport & authentification

Transport

TransportAppareils
MQTTConnexion via MQTT.
HTTPEnvoi en HTTPS uniquement.
MQTT et HTTPL’un ou l’autre.
LoRaWANRejoignent le réseau via le serveur réseau LoRaWAN de Hermetry. Ils ne se connectent pas eux-mêmes.
Un protocole à interrogationSont interrogés par la plateforme via un point d’accès (agents SNMP, caméras, enregistreurs). Les paramètres MQTT, de jeton et de réseau ne s’appliquent pas.

Modifier le transport ne modifie jamais la règle de statut en ligne ; une règle que le transport ne peut pas utiliser bloque l’enregistrement.

Allowed authentication (au moins un) : Access token, MQTT basic (username and password), X.509 certificate. Voir Device credentials.

Sécurité du transport

ParamètrePar défautEffet
MQTT en clairTLS uniquement (port 8883)Un appareil qui se connecte sur le port non chiffré 1883 est refusé. Passer un profil en TLS only met immédiatement fin aux sessions en clair de ses appareils. Plain MQTT allowed (port 1883) est destiné aux appareils qui ne peuvent pas utiliser TLS.
Jeton dans l’URL (appareils qui ne peuvent pas envoyer d’en-têtes)DésactivéAutorise POST /api/v1/{token}/telemetry et /attributes. Un tel profil devient HTTP uniquement : toute connexion MQTT de ses appareils est refusée.
Réseaux autorisésVide (tout réseau)Jusqu’à 64 réseaux IPv4 ou IPv6 (203.0.113.0/24) ou adresses uniques. Les appareils situés hors de ces réseaux sont refusés (MQTT CONNACK 5, HTTP 403).
Commandes autorisées sans TLSVideJusqu’à 32 noms de commandes exacts qu’un appareil peut recevoir sur une session en clair. Toute autre commande attend une session TLS.

Avertissement

Ne listez que des commandes sans TLS dont une mauvaise utilisation est sans gravité, comme sys.info ou sys.ping. Ne listez jamais sys.reboot, ota.check ou cert.renew. Les mises à jour du firmware et les paramètres des appareils ne sont jamais envoyés en clair, et une réinitialisation d’usine n’est jamais envoyée du tout.

Topic schemes (au moins un) :

SchémaTopics
Le schéma par défautv1/telemetry, v1/attributes, v1/rpc/… et le reste de l’ensemble par défaut. Les topics v1/… inconnus sont rejetés.
Compatible avec les systèmes héritésv1/devices/me/telemetry et v1/devices/me/attributes uniquement, pour les firmwares existants : pas de commandes, de revendication, de provisioning ni de topics de passerelle.

Avec les deux activés, les anciens et les nouveaux firmwares partagent un profil ; les messages descendants suivent ce à quoi chaque appareil s’est abonné.

Custom topics (Accept topics outside v1/ as telemetry) : tout topic hors v1/ est accepté comme télémétrie. Un objet JSON devient des clés ; tout autre contenu devient une seule clé raw de taille limitée.

ChampPar défautPlage
Préfixer les clés avec le topicDésactivé : lorsque la même clé arrive sur deux topics, la dernière écriture l’emporte—
Profondeur maximale des topics (niveaux)81 à 16
Longueur maximale du topic (caractères)12816 à 256
Topics distincts par appareil501 à 1 000
Payload brut maximal (octets)4,096256 à 65 536, jamais au-dessus de la limite de charge utile

Statut en ligne

RègleUn appareil est en ligne lorsque
Connexion en directIl maintient sa connexion MQTT. Recommandé pour les appareils qui gardent MQTT ouvert.
Message récentSon dernier message est plus récent que Expected interval (seconds) × Factor. La page affiche « Shown offline after … without a message. »
Dernière activité uniquementJamais affiché comme en ligne ou hors ligne. Les listes indiquent quand il a été vu pour la dernière fois.

Intervalle attendu est de 60 à 604 800 secondes et requis pour Message récent. Facteur est de 1,5 à 10 (une décimale), 3 par défaut. Les appareils HTTP et LoRaWAN n’ont pas de connexion ; Connexion en direct n’est donc pas proposée pour eux, et les appareils interrogés utilisent Dernière activité uniquement. Voir Statut de connexion et activité.

Limites

Les limites de débit utilisent la forme count:seconds ; plusieurs fenêtres s’appliquent ensemble, chacune plus longue que la précédente (4 au maximum par famille, un nombre de 1 à 1 000 000 sur une période de 1 seconde à 1 jour). Valeur par défaut du protocole rétablit une famille.

FamillePar défaut
Messages de télémétrie10:1,300:60
Points de télémétrie200:1,6000:60
Mises à jour d’attributs5:1,60:60
Demandes d’attributs5:1,60:60
Messages RPC5:1,60:60
Demandes de certificats1:3600
Connexions6:60

Hermetry applique les limites de messages de télémétrie, de points de télémétrie et de mises à jour d’attributs à chaque appareil. Au-delà d’une limite, le message est acquitté et supprimé. Les propriétaires et administrateurs reçoivent une notification par appareil et par heure. Chaque appareil reçoit ses limites effectives dans l’attribut partagé session_limits.

ChampPar défautPlage
Messages rejoués par secondeVide : la moitié du nombre de télémétrie par seconde1 à 10 000
Charge utile maximale des messages (octets)65,5361 024 à 65 536
Charge utile maximale en liaison descendante (octets)65,5361 024 à 65 536
Messages non acquittés maximum (MQTT)201 à 1 000
Délai d’inactivité (secondes)60010 à 604 800. Un appareil qui n’envoie rien pendant ce délai est inactif (ce qui n’est pas la même chose que hors ligne).
Nombre maximum d’enfants d’une passerelle5000 à 10 000
Profil des nouveaux enfantsProfil enfant génériqueTout profil ; utilisé lorsque la passerelle ne nomme aucun type
Délai RPC par défaut (secondes)101 à 300

Clés de télémétrie

Listez les clés envoyées par les appareils (500 au maximum). Chaque clé a un Type (Nombre, Nombre entier, Oui / non, Texte, JSON) et, facultativement, une Unité (32 caractères au maximum), un Libellé (128 au maximum), un Min, un Max et des Décimales (0 à 10). Les tableaux de bord les utilisent : une jauge prend la plage comme échelle par défaut. Les clés suivent les règles de clés : jusqu’à 64 caractères parmi A–Z a–z 0–9 _ . -, et ne commençant pas par _, fw_, current_fw_ ou cfg..

Les clés non listées sont tout de même stockées.

Lorsque vous supprimez ou renommez des clés, le profil affiche Les clés supprimées sont encore utilisées avec les règles d’alarme et les autres lecteurs qui les lisent, et propose Les mettre à jour vers les nouveaux noms ou Conserver.

Clés de configuration

Les clés cfg.* qu’un appareil accepte comme attributs partagés, chacune avec un type, un libellé et des limites : Min, Max, Valeurs autorisées (100 au maximum), Longueur min et Longueur max, et Secret (écriture seule). Voir Attributs.

Provisionnement

La stratégie (Désactivé, Autoriser la création de nouveaux appareils, Seulement les appareils pré-provisionnés) et les clés de provisionnement. Voir Ajouter et revendiquer des appareils.

Enregistrement des modifications

  • Enregistrer les modifications n’envoie que les champs que vous avez modifiés ; Annuler les supprime. Vos modifications restent dans le formulaire lorsque vous changez d’onglet.
  • Enregistrer des modifications du transport, des identifiants, des réseaux, des schémas de topics ou des limites d’un profil en usage demande Modifier la manière dont les appareils de … se connectent ? : les sessions en cours qui ne sont plus conformes prennent fin immédiatement. Sélectionnez Enregistrer et appliquer.
  • Si quelqu’un d’autre a enregistré le profil après que vous l’avez ouvert, votre enregistrement est refusé : « Quelqu’un d’autre a enregistré ce profil après que vous l’avez ouvert. » Utilisez Recharger le profil.

Dupliquer et supprimer

  • Dupliquer le profil crée « un nouveau profil avec tous les paramètres de celui-ci ; le provisionnement commence désactivé et aucune clé n’est copiée », nommé <name> (copy).
  • Supprimer le profil est refusé pour le profil par défaut (« définissez d’abord un autre profil par défaut »), un profil intégré, un modèle de plateforme, et un profil encore utilisé par des appareils, des règles d’alarme ou des commandes (« Encore utilisé par … : déplacez-les ou supprimez-les d’abord. »).

Voir aussi