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

Reconnexion et temporisation

Pour les auteurs de micrologiciels : lorsque Hermetry refuse ou termine une connexion, ce que reçoit l'appareil, et le temps qu'il doit attendre avant de réessayer.

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

CodeMoment où Hermetry l’envoieCalendrier
0La connexion est acceptéeRéinitialisation après 60 secondes de connexion (ci-dessous)
1Le CONNECT concerne un niveau de protocole que Hermetry ne prend pas en charge, comme MQTT 5Arrêt. Corrigez le client.
3Le 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 organisationNormal
4Jeton d’accès inconnu, nom d’utilisateur ou mot de passe MQTT erroné, ou CONNECT sans nom d’utilisateurLong
5Non 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 portLong

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.

SituationValeur par défaut
La négociation TLS et le CONNECT ne sont pas effectués à temps5 secondes à partir de la connexion TCP
Trop de connexions provenant de la même adresse publique se connectent au même moment64 par adresse sur chaque nœud de courtier
L’adresse est bloquée après des échecs de connexionPlus 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 sessionQue faire
Aucune donnée reçue pendant 1,5 fois le keepaliveSe 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 relaisSe 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ébitSe reconnecter selon le calendrier normal, puis envoyer moins de messages. Voir Profils d’appareils.
Un nœud de courtier redémarreSes 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 normalCalendrier long
Utilisé aprèsUne perte de réseau, un socket fermé, CONNACK 3Le premier CONNACK 4 ou 5
Première attente1 seconde (un appareil peut démarrer jusqu’à 5 secondes)5 minutes (un appareil peut démarrer jusqu’à 15 minutes)
Attentes suivantesDoublée à chaque foisDoublée à chaque fois
Attente maximale5 minutes (jusqu’à 30 minutes tant que la liaison montante active de l’appareil est facturée au volume)1 heure
GigueChaque attente multipliée par un facteur aléatoire entre 0,5 et 1,5Identique

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

StatutSignificationQue faire
429 rate_limitedAu-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 blockedL’adresse est bloquée après des échecs de connexionAttendre les Retry-After secondes (le reste du blocage). Corriger le jeton.
503Le service est occupé, pas prêt ou en cours d’arrêt, ou retient votre organisationAttendre les Retry-After secondes (30), puis suivre le calendrier normal.
401Aucun jeton, ou jeton inconnuCalendrier long. Vérifier le jeton.
403Non 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, 413Le message lui-même est incorrect ou trop volumineuxNe 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.