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

Questions fréquentes

Réponses courtes aux questions que posent le plus souvent les nouveaux clients et les auteurs de firmware, chacune accompagnée d'un lien vers la page qui l'explique.

Cette page répond aux questions que posent le plus souvent les nouveaux clients et les auteurs de firmware. Chaque réponse est courte et renvoie vers la page qui contient tous les détails.

Premiers pas

De quoi ai-je besoin pour connecter mon premier appareil ?

Une organisation, un membre avec le rôle Admin (la création d’appareils l’exige par défaut), et un appareil ou un ordinateur capable d’exécuter un client MQTT ou curl. Le réseau doit autoriser le trafic sortant TCP 8883 (MQTT sur TLS) ou 443 (HTTPS). Voir Connect your first device.

Où trouver le nom d’hôte auquel mes appareils se connectent ?

Sur la carte Connection details de la page de l’appareil. Elle affiche l’hôte du broker, le port et l’adresse HTTPS pour cet appareil. Voir Hostnames, ports and IP addresses.

Quels ports notre pare-feu doit-il autoriser ?

Le trafic sortant TCP 8883 pour MQTT sur TLS, et 443 pour l’application et l’API HTTP des appareils. Les passerelles LoRaWAN utilisent le port indiqué dans leur adresse de serveur réseau, 443 lorsqu’aucun port n’est indiqué. Rien ne doit entrer, sauf pour les appareils que Hermetry interroge, comme les agents SNMP et les caméras. Voir Hostnames, ports and IP addresses.

Quels navigateurs pouvons-nous utiliser ?

Chrome, Edge et Firefox 111 ou version ultérieure, ainsi que Safari 16.4 ou version ultérieure. Les clés d’accès (passkeys), les notifications push, les vues 3D et la vidéo des caméras ont des exigences supplémentaires. Voir Supported browsers.

Connexion des appareils

Quels protocoles mes appareils peuvent-ils utiliser ?

MQTT sur TLS, l’API d’appareils HTTPS, et LoRaWAN via le serveur réseau de Hermetry. Les appareils incapables de se connecter eux-mêmes peuvent être interrogés (SNMP, caméras) ou transmettre leurs données via une passerelle. Voir Choose how to connect.

MQTT 5 est-il pris en charge ?

Non. Hermetry utilise MQTT 3.1.1 (niveau de protocole 4). Un CONNECT en MQTT 5 est refusé avec le code de retour CONNACK 1. Voir MQTT.

Un appareil peut-il se connecter sans TLS ?

Seulement si son profil d’appareil autorise le MQTT non chiffré sur le port 1883. Par défaut, les profils n’acceptent que TLS (port 8883), et un appareil qui se connecte sur le port 1883 est alors refusé. Voir Device transport security.

Comment un appareil prouve-t-il son identité ?

Avec un jeton d’accès (le nom d’utilisateur MQTT, ou un jeton bearer over HTTPS), un nom d’utilisateur et un mot de passe MQTT, ou un certificat X.509. Chaque appareil doit avoir ses propres identifiants. Voir Device credentials.

Avec quel topic et quel payload envoyer la télémétrie ?

Publiez un objet JSON sur v1/telemetry, par exemple {"temperature": 21.5}, ou un objet contenant ts et values. Voir MQTT topics and payload reference.

Notre firmware publie déjà sur v1/devices/me/telemetry. Devons-nous le modifier ?

Non, si vous attribuez à son profil le schéma de topics Legacy compatible. Ce schéma ne transporte que la télémétrie et les attributs, sans topics de commande. Voir MQTT topics and payload reference.

Quelle peut être la taille d’un message ?

64 KiB par défaut. Un profil peut fixer sa limite de charge utile entre 1 KiB et 64 KiB. Voir Device profiles.

Que deviennent les mesures avec un horodatage incorrect ?

Une mesure dont l’horodatage est postérieur de plus de 10 minutes à l’heure actuelle est supprimée, et non corrigée ; les paramètres de télémétrie de l’organisation peuvent modifier cette fenêtre. Une mesure sans horodatage reçoit l’heure de son arrivée. Un appareil sans horloge synchronisée doit donc omettre l’horodatage. Voir Timestamps, late and duplicate readings.

Firmware et accès à distance

Comment les mises à jour du firmware parviennent-elles à un appareil ?

Hermetry écrit la mise à jour sous forme d’attributs partagés, dont fw_url, un lien de téléchargement HTTPS à courte durée de vie (15 minutes par défaut). L’appareil télécharge, vérifie et installe l’image, et signale sa progression dans fw_state. Une image non signée ne peut pas être affectée, sauf si le profil autorise les images non signées. Voir Firmware updates (OTA).

Pouvons-nous ouvrir l’interface web d’un routeur sans adresse IP fixe ?

Oui, pour les routeurs sous licence rattachés à votre organisation dont le firmware le permet. Le routeur établit la connexion sortante lorsque vous sélectionnez Open panel, donc aucun port n’a besoin d’être ouvert sur site. Un routeur accepte au maximum 3 sessions ouvertes simultanément. Voir Remote access to a router’s panel.

Organisation et sécurité

Pouvons-nous utiliser notre propre domaine ?

Chaque organisation dispose d’une adresse gratuite sous le domaine de la plateforme. Un domaine personnalisé tel que iot.example.com est disponible si votre offre inclut les domaines personnalisés ; vous créez les enregistrements DNS, et le certificat est géré pour vous. Voir Web addresses and custom domains.

Pourquoi les e-mails de connexion viennent-ils de l’expéditeur de la plateforme et non du nôtre ?

Les codes de connexion, les réinitialisations de mot de passe, les liens de vérification et d’invitation passent toujours par le service de messagerie propre à la plateforme, afin qu’aucun autre serveur de messagerie ne puisse les lire. Ils portent malgré tout l’identité visuelle de votre organisation. Voir Account and security e-mails.

Comment protéger la connexion de nos membres ?

Les membres peuvent ajouter des clés d’accès (passkeys), une application d’authentification, ou des codes par e-mail ou SMS, et un propriétaire peut exiger la vérification en deux étapes pour chaque membre. Voir Two-factor sign-in and passkeys.