Le jeton d’une passerelle est son seul identifiant. Cette page explique comment le remplacer, comment arrêter une passerelle temporairement ou définitivement, et ce qui arrive à la connexion dans chaque cas. Toutes les actions se font dans l’onglet LoRaWAN de la passerelle (pour un routeur sous licence : le volet LoRaWAN gateway) et nécessitent la permission de gérer les passerelles. Chacune vous demande d’abord une confirmation et est consignée dans le journal d’audit.
Fonctionnement du jeton
- Hermetry crée un jeton aléatoire lorsque vous ajoutez une passerelle Basics Station et l’affiche une seule fois.
- Seule une empreinte (SHA-256) du jeton est stockée. Personne, y compris le personnel d’Hermetry, ne peut relire le jeton.
- La passerelle envoie le jeton dans l’en-tête
Authorization: Bearerà chaque connexion. - Le jeton est lié à l’EUI de la passerelle. Le même jeton sur une autre passerelle est refusé (
eui_mismatch).
Les routeurs sous licence n’ont pas de jeton ; ils utilisent leur certificat d’appareil.
Remplacer le jeton
Remplacez le jeton si vous l’avez perdu, si une personne qui ne devrait pas l’avoir a pu le voir, ou lorsque vous confiez une passerelle à un nouvel installateur.
- Ouvrez l’onglet LoRaWAN de la passerelle.
- Sélectionnez Rotate token.
- Confirmez Rotate the token : « La passerelle est déconnectée immédiatement et le reste jusqu’à ce que vous y installiez le nouveau jeton. »
- L’onglet affiche le nouvel Token header ainsi que les boutons de téléchargement de
tc.uri,tc.trustettc.key. Copiez-les maintenant : ils ne sont affichés qu’une seule fois. - Installez le nouveau jeton sur la passerelle et redémarrez son packet forwarder. Voir Connecter une passerelle Basics Station.
Ce qui se passe :
| Moment | Effet |
|---|---|
| Vous confirmez | L’ancien jeton cesse de fonctionner immédiatement. La connexion ouverte de la passerelle est fermée. |
| Jusqu’à la mise à jour de la passerelle | La passerelle tente de se reconnecter avec l’ancien jeton et est refusée. Les appareils captés uniquement par cette passerelle n’atteignent pas Hermetry. |
| Vous installez le nouveau jeton | La passerelle se reconnecte. |
Une fois le nouveau jeton retiré de l’écran, la section de configuration indique : The token was shown once when the gateway was added. Rotate the token to get a new one; the gateway stays disconnected until it has the new one.
Désactiver et activer
Disable est un arrêt temporaire, par exemple pendant le déplacement d’une passerelle ou si vous soupçonnez un usage abusif.
- Sélectionnez Disable.
- Confirmez Disable the gateway : « La passerelle est déconnectée et refusée jusqu’à ce que vous la réactiviez. Les appareils qu’elle est la seule à capter cessent d’atteindre la plateforme. »
Le statut de la passerelle devient Disabled et sa connexion est fermée immédiatement. Son jeton, son EUI, son appareil et son historique sont conservés.
Pour annuler, sélectionnez Enable et confirmez : « La passerelle peut à nouveau se connecter avec son jeton. » La passerelle se reconnecte d’elle-même avec le jeton qu’elle possède déjà.
Supprimer
Remove supprime la passerelle définitivement.
- Sélectionnez Remove.
- Confirmez Remove the gateway.
| Type de passerelle | Ce qui est supprimé | Ce qui est conservé |
|---|---|---|
| Passerelle Basics Station | La fiche de la passerelle, son jeton, sa revendication d’EUI et son appareil. La connexion est fermée. | Ses mesures enregistrées. |
| Routeur sous licence | La fiche de gateway du routeur et sa revendication d’EUI. La liaison LoRaWAN est fermée. | L’appareil du routeur et ses mesures. |
Après suppression, l’EUI est à nouveau libre : vous, ou une autre organisation, pouvez l’enregistrer.
Remarque
Une passerelle ne peut pas être supprimée avec la suppression générique d’appareil de la page Devices. Hermetry indique que l’appareil possède encore un enregistrement LoRaWAN. Utilisez Remove dans l’onglet LoRaWAN, qui supprime d’abord les éléments LoRaWAN.
Délai de coupure d’une passerelle
Une rotation, une désactivation ou une suppression ferme immédiatement la connexion de la passerelle. Si ce signal est retardé, chaque connexion de passerelle ouverte est aussi revérifiée dans le registre des passerelles toutes les 60 secondes ; une passerelle révoquée est donc fermée au plus tard dans la minute.
Via l’API
| Action | Requête |
|---|---|
| Remplacer le jeton | POST /tenant/<tenantId>/api/iot/lorawan/gateways/<gatewayId>/credentials renvoie { gateway, token, stationConfig } une seule fois. |
| Désactiver | PATCH …/gateways/<gatewayId> avec { "status": "DISABLED" } |
| Activer | PATCH …/gateways/<gatewayId> avec { "status": "ACTIVE" } |
| Renommer | PATCH …/gateways/<gatewayId> avec { "name": "…" } |
| Supprimer | DELETE …/gateways/<gatewayId> |
L’EUI et le protocole d’une passerelle ne changent jamais. Une passerelle Basics Station reste toujours en mode cloud ; demander un autre mode est refusé avec A Basics Station gateway always runs in cloud mode. Remplacer le jeton d’une passerelle sans jeton (un routeur sous licence) est refusé avec This gateway does not use a token. (no_token_auth).
Entrées du journal d’audit
| Action | Entrée d’audit |
|---|---|
| Passerelle ajoutée | iot_lorawan.gateway.created |
| Renommée, désactivée, activée, déplacée sur la carte | iot_lorawan.gateway.updated |
| Jeton remplacé | iot_lorawan.gateway.credential_rotated |
| Supprimée | iot_lorawan.gateway.deleted |