Cette page s’adresse aux personnes qui écrivent le micrologiciel des appareils ou le logiciel des passerelles. Elle rassemble en un seul endroit ce que fait Hermetry lorsqu’il refuse ou termine une connexion, et la manière dont un appareil doit se reconnecter. Les paramètres de connexion, les identifiants et les motifs de déconnexion affichés dans l’onglet Journal sont décrits dans MQTT ; les règles générales des appareils figurent dans Versions de protocole et règles des appareils.
Les codes CONNACK envoyés par Hermetry
| Code | Moment où Hermetry l’envoie | Calendrier |
|---|---|---|
| 0 | La connexion est acceptée | Réinitialisation après 60 secondes de connexion (ci-dessous) |
| 1 | Le CONNECT concerne un niveau de protocole que Hermetry ne prend pas en charge, comme MQTT 5 | Arrêt. Corrigez le client. |
| 3 | Le service démarre, s’arrête ou est occupé ; l’adresse de l’appareil est bloquée pendant un court instant après des échecs de connexion ; un nom d’utilisateur MQTT est mis en attente après des mots de passe erronés répétés ; l’appareil est mis en attente après un conflit de prise de contrôle ; la plateforme est surchargée et retient votre organisation | Normal |
| 4 | Jeton d’accès inconnu, nom d’utilisateur ou mot de passe MQTT erroné, ou CONNECT sans nom d’utilisateur | Long |
| 5 | Non autorisé : l’appareil est désactivé, son certificat est révoqué ou expiré, l’organisation est suspendue ou a atteint sa limite d’appareils ou d’appareils connectés, ou le profil n’autorise pas ce type de connexion, ce réseau ou ce port | Long |
Hermetry n’envoie pas CONNACK 2 avec MQTT 3.1.1. L’identifiant client ne constitue jamais un motif de refus : tout identifiant client est accepté, et la session est enregistrée sous le numéro de série de l’appareil (ou son identifiant d’appareil s’il n’en a pas). La raison derrière un code n’est jamais envoyée à l’appareil ; elle est inscrite dans l’onglet Journal de l’appareil.
Connexions fermées sans CONNACK
Certaines connexions sont fermées avant qu’un CONNACK puisse être envoyé. L’appareil ne voit qu’un socket fermé et suit le calendrier normal.
| Situation | Valeur par défaut |
|---|---|
| La négociation TLS et le CONNECT ne sont pas effectués à temps | 5 secondes à partir de la connexion TCP |
| Trop de connexions provenant de la même adresse publique se connectent au même moment | 64 par adresse sur chaque nœud de courtier |
| L’adresse est bloquée après des échecs de connexion | Plus de 10 échecs de connexion en 5 minutes bloquent l’adresse pendant 60 secondes |
Sessions terminées par Hermetry
Hermetry n’envoie aucun code de motif lors d’une déconnexion : l’appareil constate la fermeture de la connexion. Ce qu’il doit faire ensuite :
| Raison de la fin de la session | Que faire |
|---|---|
| Aucune donnée reçue pendant 1,5 fois le keepalive | Se reconnecter selon le calendrier normal. Vérifiez que l’appareil envoie PINGREQ lorsqu’il est inactif. |
| Une autre connexion du même appareil a pris le relais | Se reconnecter selon le calendrier normal. Si cela se répète, deux appareils partagent un même identifiant. |
| L’identifiant a été renouvelé ou révoqué, l’appareil désactivé ou supprimé, l’organisation suspendue (revérifié environ toutes les 60 secondes) | Se reconnecter selon le calendrier normal. Le prochain CONNACK (4 ou 5) fait passer l’appareil au calendrier long. |
| L’appareil a continuellement dépassé sa limite de débit | Se reconnecter selon le calendrier normal, puis envoyer moins de messages. Voir Profils d’appareils. |
| Un nœud de courtier redémarre | Ses connexions sont fermées sur environ 30 secondes, dans un ordre aléatoire. Se reconnecter selon le calendrier normal ; un CONNECT qui atteint un nœud en cours d’arrêt reçoit CONNACK 3. |
| Un message n’a pas pu être mis en file d’attente (aucun PUBACK reçu) | La session est fermée environ 5 secondes plus tard. Se reconnecter, puis renvoyer les messages non acquittés. |
Keepalive
- Se connecter avec un keepalive de 60 secondes et envoyer PINGREQ lorsqu’il n’y a rien d’autre à envoyer.
- Hermetry ferme une session lorsque rien n’est reçu pendant 1,5 fois le keepalive : 90 secondes pour 60.
- Un keepalive de 0, ou supérieur au maximum du courtier (300 secondes par défaut), est traité au maximum.
- Un message Will est accepté puis ignoré. Hermetry détermine lui-même l’état de la connexion.
Les deux calendriers de temporisation
| Calendrier normal | Calendrier long | |
|---|---|---|
| Utilisé après | Une perte de réseau, un socket fermé, CONNACK 3 | Le premier CONNACK 4 ou 5 |
| Première attente | 1 seconde (un appareil peut démarrer jusqu’à 5 secondes) | 5 minutes (un appareil peut démarrer jusqu’à 15 minutes) |
| Attentes suivantes | Doublée à chaque fois | Doublée à chaque fois |
| Attente maximale | 5 minutes (jusqu’à 30 minutes tant que la liaison montante active de l’appareil est facturée au volume) | 1 heure |
| Gigue | Chaque attente multipliée par un facteur aléatoire entre 0,5 et 1,5 | Identique |
Règles associées aux calendriers :
- Réinitialiser le calendrier après une connexion d’au moins 60 secondes. Une connexion interrompue plus tôt ne le réinitialise pas, afin qu’un appareil que le serveur ferme sans cesse ne se reconnecte pas en boucle serrée.
- Le calendrier normal repart aussi de zéro lorsque l’appareil change de liaison montante active, par exemple d’Ethernet vers les données mobiles.
- Après un démarrage ou une mise à jour du micrologiciel, attendre un délai aléatoire de 0 à 30 secondes avant la première tentative. Une vague d’appareils mis à jour ne se reconnecte ainsi pas en un seul pic.
- Arrêter sur CONNACK 1 jusqu’à la correction du client.
Le calendrier long ramène un appareil en ligne dans les 90 minutes environ suivant la correction du problème, par exemple après la réactivation de l’appareil ou l’augmentation du forfait.
/* Wait before reconnect attempt n (n = 0, 1, 2 ...), in seconds. */
double backoff_s(int n, int long_schedule)
{
double first = long_schedule ? 300.0 : 1.0;
double cap = long_schedule ? 3600.0 : 300.0;
double wait = first * pow(2.0, n);
if (wait > cap)
wait = cap;
return wait * (0.5 + (double)rand() / RAND_MAX); /* factor 0.5 to 1.5 */
}
Astuce
Initialisez le générateur aléatoire différemment sur chaque appareil, par exemple à partir de son numéro de série et d’une source d’aléa matérielle. Des appareils qui partagent une même graine choisissent les mêmes attentes et arrivent malgré tout en même temps.
Mots de passe erronés répétés
Après plus de 5 échecs de connexion (CONNACK 4) pour un même nom d’utilisateur MQTT depuis un même réseau en 15 minutes, ce nom d’utilisateur reçoit CONNACK 3 pendant 15 secondes, cette durée doublant à chaque nouvel échec jusqu’à 5 minutes. Un appareil qui a reçu un CONNACK 4 puis reçoit un CONNACK 3 utilise généralement toujours un mauvais mot de passe : maintenez-le sur le calendrier long jusqu’à ce qu’une connexion réussisse.
Via l’API HTTP de l’appareil
| Statut | Signification | Que faire |
|---|---|---|
429 rate_limited | Au-delà du débit de l’appareil ou de l’organisation, ou au-delà du débit de requêtes de l’adresse du client (50 par seconde, rafales de 200, par défaut) | La requête n’a pas été enregistrée. Attendre les Retry-After secondes, puis la renvoyer. |
429 blocked | L’adresse est bloquée après des échecs de connexion | Attendre les Retry-After secondes (le reste du blocage). Corriger le jeton. |
503 | Le service est occupé, pas prêt ou en cours d’arrêt, ou retient votre organisation | Attendre les Retry-After secondes (30), puis suivre le calendrier normal. |
401 | Aucun jeton, ou jeton inconnu | Calendrier long. Vérifier le jeton. |
403 | Non autorisé : appareil désactivé, organisation suspendue, en dehors des réseaux autorisés par le profil, ou règle de profil (tls_required, quarantined) | Calendrier long, ou corriger la configuration. |
400, 413 | Le message lui-même est incorrect ou trop volumineux | Ne pas renvoyer le même message. |
Une fois l’appareil de nouveau en ligne
Suivre l’ordre de connexion décrit dans MQTT : s’abonner, envoyer hello, demander les attributs partagés, puis envoyer les mesures mises en mémoire tampon avant les mesures en direct. Deux points sont importants après une longue interruption :
- Les mesures mises en mémoire tampon doivent respecter le débit de rejeu que l’appareil trouve dans l’attribut partagé
session_limits. Ne pas envoyer toute la mémoire tampon aussi vite que la liaison le permet. - Après une interruption, de nombreux appareils demandent leurs paramètres en même temps, et Hermetry les cadence. Les sections de paramètres absentes de la réponse peuvent arriver quelques instants plus tard sur
v1/attributes/set, sous la même forme. Les appliquer dès leur réception.

