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

Votre adresse de serveur réseau

Chaque organisation dispose de sa propre adresse de serveur réseau LoRaWAN. Où la trouver, à quoi elle ressemble, et le certificat du serveur.

Vos passerelles se connectent au serveur réseau de Hermetry à une adresse qui appartient à votre organisation. Vous renseignez cette adresse une seule fois sur chaque passerelle. Cette page explique l’adresse, son origine et la manière de la lire.

À quoi ressemble l’adresse

wss://<your organisation's web address name>.<network server host>
  • wss:// désigne une connexion websocket sécurisée (TLS). Les passerelles ne se connectent jamais par une connexion non chiffrée.
  • La première partie est le nom de l’adresse web de votre organisation (son slug), le même nom que celui de votre sous-domaine gratuit.
  • La seconde partie est l’hôte du serveur réseau de l’installation Hermetry.

Par exemple, une organisation dont l’adresse web est acme.hermetry.com connecte ses passerelles à wss://acme.<hôte du serveur réseau>.

Toutes les passerelles de votre organisation utilisent la même adresse. Chaque passerelle possède toutefois son propre jeton, si bien que l’adresse seule ne permet à personne d’entrer.

Où la trouver

Vous n’avez pas besoin de saisir l’adresse à la main :

  • Juste après avoir ajouté une passerelle, le panneau affiche les valeurs de configuration avec des boutons Copier et vous permet de télécharger les trois fichiers de configuration.
  • Ensuite, ouvrez la passerelle depuis la page Devices puis son onglet LoRaWAN. La section Connect the gateway affiche la même adresse.

La section de configuration affiche :

ValeurSignification
Adresse LNSL’adresse à laquelle la passerelle se connecte (le tc.uri de la passerelle).
Adresse de découverte (demandée à la place par certaines passerelles)La même adresse suivie de /router-info. Certaines passerelles interrogent d’abord cette adresse pour savoir où se connecter.
En-tête du jetonLa ligne d’autorisation pour le tc.key de la passerelle. Affichée uniquement juste après l’ajout de la passerelle ou la rotation de son jeton.

Le certificat du serveur

Votre passerelle doit faire confiance au certificat TLS du serveur réseau. Le paramètre tc.trust de la passerelle contient le certificat auquel elle fait confiance.

  • Lorsque l’installation fournit le certificat, l’étape 3 de la configuration indique Set the server certificate (tc.trust): download it below, or choose the system’s certificate store if the gateway offers it. Le fichier tc.trust est proposé au téléchargement avec le jeton.
  • Dans le cas contraire, l’étape 3 indique This installation does not hand out the server certificate. Use the gateway’s system certificate store. Choisissez le magasin de certificats intégré à la passerelle.

Si votre adresse web change

L’adresse du serveur réseau suit le nom de l’adresse web de votre organisation. Lorsqu’un administrateur modifie ce nom, l’adresse de vos passerelles change avec lui. Mettez à jour l’Adresse LNS sur chaque passerelle, sans quoi elles ne pourront pas se connecter au nouveau nom.

Lorsqu’aucune adresse n’est affichée

Si la configuration indique The LNS address of this installation is not configured yet. Ask your administrator., l’installation ne dispose d’aucune adresse de serveur réseau. Les passerelles ne pourront pas se connecter tant que l’administrateur de la plateforme n’en aura pas défini une. Sur le service hébergé, l’adresse est toujours définie.

Ports

L’adresse ne comporte pas de port lorsque le serveur réseau est joint sur le port TLS standard 443. Si une installation utilise un autre port, l’adresse l’indique (wss://name.host:port). Copiez l’adresse exactement telle qu’elle est affichée.

La lire via l’API

GET /tenant/<tenantId>/api/iot/lorawan/setup

Nécessite l’autorisation de consulter les passerelles LoRaWAN. La réponse ne contient aucun secret :

{
  "setup": {
    "lnsUrl": "wss://acme.lns.example.com",
    "routerInfoUrl": "wss://acme.lns.example.com/router-info",
    "trustAvailable": true,
    "region": "EU868"
  }
}

trustAvailable indique si l’installation fournit le fichier tc.trust. La réponse liste aussi les protocoles de passerelle pris en charge : Basics Station et le lien de routeur sous licence (voir Routeurs sous licence comme passerelles LoRaWAN).

Suite

Connecter une passerelle Basics Station.