Ajout d’une connexion MQTT basique

note

Les connexions MQTT basiques ne sont pas encore disponibles dans ThingPark Enterprise auto-hébergé.

Les connexions MQTT basiques fournissent une connexion bidirectionnelle directe entre le Network Server (NS) et des serveurs d’applications tiers (AS) utilisant le protocole MQTT : les messages uplink sont publiés sur des topics MQTT et les messages downlink sont reçus depuis un topic MQTT.

Les payloads des capteurs sont échangés dans un format encodé sans le support de drivers de payload.

Pour en savoir plus sur les connexions MQTT basiques et l’interface de tunnel NS-AS, voir l’API data-plane de l’interface de tunnel.

Sélectionnez Connexions, puis cliquez sur ADD CONNECTION sur la page Connections ou, depuis le Dashboard, allez au widget CONNECTIONS et cliquez sur .
Cliquez sur le type de connexion Basic MQTT.
Saisissez les informations de votre connexion :
- Nom
- Domaines (facultatif) : Si la séparation des autorisations basée sur les domaines a été activée par un administrateur, vous pouvez associer votre connexion à des domaines pour restreindre sa visibilité. Les connexions spécifiques aux domaines sont visibles uniquement par les utilisateurs autorisés dont les restrictions de domaine correspondent. Pour en savoir plus, consultez À propos des domaines.
  - Si aucun domaine n'est défini, la connexion est interdomaines et visible par tous les utilisateurs. Cependant, les utilisateurs ayant des restrictions de domaine ont un accès en lecture seule aux connexions inter-domaines.
  - Si votre compte utilisateur a des restrictions de domaine, les domaines associés doivent correspondre à vos restrictions de domaine sans aucun préfixe de domaine (seuls les domaines complets peuvent être attribués aux ressources).
- Informations supplémentaires (facultatif) : Toute information utile, administrative par exemple, liée à la connexion.
Dans le champ MQTT broker, sélectionnez le type de MQTT broker à utiliser :
- Hébergé par ThingPark : Utilise le MQTT broker géré par ThingPark. Les topics MQTT sont affectés automatiquement et affichés en lecture seule dans le dashboard de la connexion après la création. Passez à l’étape 6.
  
  note
  Le MQTT broker hébergé par ThingPark n’est disponible que sur ThingPark SaaS, et uniquement s’il est activé par l’opérateur.
- Externe : Connexion à votre propre MQTT broker. Continuez avec l’étape 5.
  
  note
  Si le MQTT broker hébergé par ThingPark n’a pas été activé par l’opérateur, le champ MQTT broker n’est pas affiché et le formulaire utilise toujours le mode External.

Configurez la connexion au MQTT broker externe :

Hostname : Nom d’hôte ou adresse IP du MQTT broker, éventuellement suivi d’un port. Exemple : myhostname:8883, broker.example.com, 192.168.1.10:1883.

Protocole : Méthode de sécurité et d’authentification utilisée pour se connecter au MQTT broker :

Protocole	Description
TLS avec authentification par nom d’utilisateur/mot de passe (par défaut)	Connexion chiffrée utilisant des identifiants de connexion.
TLS avec authentification par certificat client	Connexion chiffrée utilisant le TLS mutuel (certificat client).
TLS avec authentification par nom d’utilisateur/mot de passe + certificat client	Connexion chiffrée utilisant à la fois des identifiants de connexion et un certificat client.
TCP avec authentification par nom d’utilisateur/mot de passe	Connexion non chiffrée utilisant uniquement des identifiants de connexion.

Client ID : Identifiant unique pour cette connexion client MQTT sur le broker. Si un autre client se connecte avec le même Client ID, la connexion précédente peut être déconnectée.
Nom d’utilisateur MQTT (pour les protocoles basés sur un mot de passe) : Nom d’utilisateur utilisé pour s’authentifier auprès du MQTT broker.
Mot de passe MQTT (pour les protocoles basés sur un mot de passe) : Mot de passe utilisé pour s’authentifier auprès du MQTT broker.
Certificat CA (facultatif, pour les protocoles TLS) : Certificat CA au format PEM utilisé pour vérifier le certificat serveur du MQTT broker lors de la négociation TLS.
Certificat (pour les protocoles TLS mutuels) : Certificat client au format PEM utilisé pour l’authentification TLS du client.
Clé privée (pour les protocoles TLS mutuels) : Clé privée au format PEM associée au certificat client.
Topic uplink : Topic MQTT utilisé pour publier les messages uplink. Le topic ne doit pas contenir de wildcards MQTT (+ ou #). Les variables suivantes sont dynamiquement remplacées par les valeurs réelles du capteur lorsqu’un message est publié :
- {DevEUI} : remplacé par l’EUI du capteur.
- {DeviceTopicPath} : remplacé par le chemin de topic du capteur.
Valeur par défaut : mqtt/things/{DevEUI}/uplink
Topic downlink : Topic MQTT utilisé pour s’abonner aux messages downlink. Le topic peut contenir des wildcards MQTT (+ et #). S’il n’est pas défini, les messages downlink ne peuvent pas être envoyés aux capteurs associés.

Valeur par défaut : mqtt/things/+/downlink
QoS (si disponible) : Niveau de Quality of Service MQTT utilisé pour la livraison des messages :
- Au plus une fois (QoS 0) (par défaut) : Les messages sont envoyés une fois sans acquittement. Surcharge minimale, mais les messages peuvent être perdus.
- Au moins une fois (QoS 1) : Les messages sont acquittés et retransmis si nécessaire. Assure la livraison, mais les messages peuvent être reçus plus d’une fois.
note
Ce champ est uniquement affiché si le QoS 1 a été activé par l’opérateur.

Configurez le format des messages :
- Format de message : Type d’encodage utilisé pour transmettre les data des capteurs à votre application. Utilisez le format de message supporté par le serveur d’applications :
  - ThingPark (JSON). Exemple :
    { "DevEUI":"78A8952D2E2992C5", "FPort":2, "LrrRSSI":-60.000000 }
  - ThingPark (JSON non typé) : Document JSON dans lequel toutes les valeurs, y compris les valeurs numériques, sont transmises sous forme de chaînes. Exemple :
    { "DevEUI":"78A8952D2E2992C5", "FPort":"2", "LrrRSSI":"-60.000000" }
  - ThingPark (XML)
Cliquez sur AJOUTER.