Différences

Ci-dessous, les différences entre deux révisions de la page.

--- raspberrypi:linux:mqtt_mosquitto [2022/08/01 17:36] – [3.1.2 Arrêt, redémarrage] phil
+++ raspberrypi:linux:mqtt_mosquitto [2022/08/16 08:44] (Version actuelle) – [3.1.3 Tests] phil
@@ Ligne 52: / Ligne 52: @@
 Le principe d’échange est très proche de celui de Twitter. Les messages sont envoyés par les éditeurs sur un **canal d'information** appelé **topic**. Ces messages peuvent être lus par les abonnés. Les topics peuvent avoir une hiérarchie qui permet de sélectionner finement les informations que l’on désire.
-<callout type="primary" icon="true">Les **messages** envoyés par les éditeurs peuvent être de toute sorte, mais ne peuvent excéder une taille de **256 Mo**.</callout>
+<callout type="primary" icon="true">Les **messages** envoyés par les éditeurs peuvent être de toute sorte, mais ne peuvent excéder une taille de **256 Mo** bien que dans les **mises en œuvre réelles**, le maximum soit de **2 à 4 Ko**.</callout>
 {{ :raspberrypi:linux:broker-based-mqtt-protocol.jpg?nolink |}}
@@ Ligne 73: / Ligne 73: @@
 **Le caractère joker +** \\
-**+** est le joker pour un **unique niveau hiérarchique**. Un client souscrivant à "maison/+/temp" recevra les messages adressés par d'autres clients aux topics :
+**+** est le joker pour un **unique niveau hiérarchique**. Un client souscrivant à "**maison/+/temp**" recevra les messages adressés par d'autres clients aux topics :
   * "maison/salon/temp"
@@ Ligne 85: / Ligne 85: @@
 **Le caractère joker #** \\
-Le **#** est un joker **multiniveau** s'utilisant toujours après un / et en dernier caractère. Il est destiné à remplacer n'importe quel niveau supérieur dans le topic. "maison/#" correspondra aux topics :
+Le **#** est un joker **multiniveau** s'utilisant toujours après un / et en dernier caractère. Il est destiné à remplacer n'importe quel niveau supérieur dans le topic. \\ "**maison/#**" correspondra aux topics :
   * "maison/salon/temp"
@@ Ligne 146: / Ligne 146: @@
 Mosquitto fait partie de la <html><a href="https://www.eclipse.org/" target="_blank">Fondation Eclipse</a></html> et est un projet de <html><a href="https://iot.eclipse.org/" target="_blank">iot.eclipse.org</a></html>.
-===== 3. Installation et mise en oeuvre =====
+===== 3. Installation et mise en oeuvre basique =====
 ==== 3.1 Sur un Raspberry Pi ====
@@ Ligne 200: / Ligne 200: @@
 <callout type="info" icon="true">Le paquet **mosquitto-clients** fournit deux commandes, <html><a href="https://mosquitto.org/man/mosquitto_sub-1.html" target="_blank">mosquitto_sub</a></html> pour une souscription et <html><a href="https://mosquitto.org/man/mosquitto_pub-1.html" target="_blank">mosquitto_pub</a></html> pour une publication.</callout>
-  - Test sur le RaspBerry Pi (localhost)
+== 3.1.3.1 Test sur le RaspBerry Pi (localhost) ==
 Pour tester le bon fonctionnement du broker, nous allons publier le message (payload) "//Bonjour//" sur le canal d'information (topic) //test/val// à l'aide d'un client **mosquitto_pub**. Ce message sera reçu par un client **mosquitto_sub** abonné à //test/val//.
@@ Ligne 221: / Ligne 221: @@
 {{ :raspberrypi:linux:testpubsublocalhost.png?nolink |}}
-  - Test sur le réseau local
+== 3.1.3.2 Test sur le réseau local ==
-<callout type="warning" icon="true"></callout>
+  * **Ressource** : <html><a href="https://mosquitto.org/man/mosquitto-conf-5.html" target="_blank">Page de manuel de moustique.conf</a</html>
+<callout icon="fa fa-hand-stop-o" color="red" title="STOP">A partir de la **version 2 de Mosquitto** seule la **connexion sur le réseau local** est acceptée par le broker.  \\ Pour effectuer le test précédent entre un courtier situé sur une machine (PC, Raspberry Pi,etc.) et un éditeur/abonné situé sur une autre machine (PC, smartphone, etc.) via un réseau local, il est nécessaire de modifier le fichier de configuration **mosquitto.conf** situé dans **/etc/mosquitto/**.  \\ Pour cela :  \\
+- Ouvrir le fichier mosquitto.conf  \\
+- Ajouter les interfaces à l'aide de l'option **listener**
+</callout>
+<code bash *.bash>
+# Ouvrir le fichier mosquitto.conf
+sudo nano /etc/mosquitto/mosquitto.conf
+</code>
+//Exemple// : connexion au broker situé sur un Raspberry Pi, sur l'hôte local et sur le réseau local via les interfaces Ethernet et wifi.
+{{ :raspberrypi:linux:mosquittoconf.png?nolink |}}
+// Tests // réalisés entre un RaspBerry pi et un smartphone
+{{ :raspberrypi:linux:mosquittolan.png?nolink&400 |}}
+Consulter la page [[reseaux:outils:mymqtt|Wiki Réseau - Test d'un broker Mosquitto avec MyMQTT (Android App)]] pour la mise en oeuvre du test.
 ==== 3.2. Sous Windows ====
 Voir ce <html><a href="http://www.steves-internet-guide.com/install-mosquitto-broker/" target="_blank">lien</a></html> pour installer le broker Mosquitto sous Windows,
@@ Ligne 229: / Ligne 245: @@
 ==== 3.3 Sur un NAS Synology ====
 {{ :raspberrypi:linux:synologyico.jpg?nolink&80|}}
-  * **Source** : <html><a href="https://projetsdiy.fr/installer-mosquitto-nas-synology-fonctionnant-dsm-6-2-docker/" target="_blank">Installer le broker MQTT Mosquitto sur NAS Synology (DSM 6.2+) avec Docker</a></html>
+  * **Source** : <html><a href="https://www.lesalexiens.fr/actualites/tutoriel-installer-mosquitto-mqtt-sur-nas-synology/" target="_blank">Installer le broker MQTT Mosquitto sur NAS Synology (DSM 6.2+) avec Docker</a></html>
 Le fichier mosquitto.conf se situe dans le dossier **/usr/local/mosquitto/var**. Se connecter en **ssh**. Ouvrir **mosquitto.conf** avec nano et le compléter comme ci-dessous :
@@ Ligne 249: / Ligne 265: @@
 ===== 4 Sécurité =====
-Cette partie ne sera pas exploitée lors du développement sur un réseau local dans la salle de classe.
+<callout type="info" icon="true">Cette partie ne sera pas exploitée lors du développement sur un réseau local dans la salle de classe. A prendre en compte si l'accès au broker se fait via Internet.</callout>
 ==== 4.1 Authentification ====
@@ Ligne 257: / Ligne 273: @@
 **Fichier de configuration de Mosquitto** \\
-<callout type="warning" icon="true">Par défaut, le fichier de configuration  **mosquitto.conf** situé dans **/etc/mosquitto/** contient :</callout>
+<callout type="warning" icon="true">Par défaut, le fichier de configuration **mosquitto.conf** d'un Raspberry Pi, situé dans **/etc/mosquitto/**, contient :</callout>
 <code bash mosquitto.conf>
@@ Ligne 270: / Ligne 286: @@
 log_dest file /var/log/mosquitto/mosquitto.log
 include_dir /etc/mosquitto/conf.d
+# -------------------------------------------
+# A ajouter à partir de la version 2
+# -------------------------------------------
+listener localhost # actif par défaut mais à ajouter
+listener @IP1      # si ajout d'@IP(s)
+listener @IP2
+# etc.
 </code>
   * //**mosquitto.pid**// : le fichier contenant le numéro de processus du démon Mosquitto permettant la gestion du fonctionnement en arrière-plan (mode serveur)
   * //**persistence**// : la directive permettant au serveur de conserver l'état des connexions, des abonnements et des messages dans un fichier enregistré sur le disque. Ceci permet au serveur de recharger ces informations en cas de redémarrage.
@@ Ligne 287: / Ligne 311: @@
 Le Raspberry pi demande un mot de passe. Entrer //**mot2passe**//. \\
-**-c** crée le fichier \\
+  * **-c** crée le fichier \\
-**sondes** est l'identifiant
+  * **sondes** est l'identifiant
 En supprimant -c de la commande ci-dessus, il est possible :
@@ Ligne 310: / Ligne 334: @@
 password_file /etc/mosquitto/passwd
 allow_anonymous false # Connexions sans mot de passe non autorisées
-</code>
-> //**password_file**// permet de spécifier le fichier de mots de passe à utiliser
+# password_file permet de spécifier le fichier de mots de passe à utiliser
-> //**allow-anonymous**// autorise (**true**) ou non (**false**) les connexions anonymes (sans mot de passe)
+# allow-anonymous autorise (**true**) ou non (**false**) les connexions anonymes (sans mot de passe)
+</code>
   * Redémarrer le serveur
@@ Ligne 341: / Ligne 365: @@
   * //Exemple de résultat//
-{{ :raspberrypi:linux:mosquittosecur.png?nolink&600 |}}
+{{ :raspberrypi:linux:mosquittosecur.png?nolink&500 |}}
@@ Ligne 403: / Ligne 427: @@
     * Enregistrement des messages
-==== 7.2 MQTTlens ====
+Consulter la page [[reseaux:outils:mymqtt|Wiki Réseau - Test d'un broker Mosquitto avec MyMQTT (Android App)]] pour sa mise en oeuvre.
+==== 7.2 MQTTlens : un client pour navigateur ====
 {{ :raspberrypi:linux:mqttlensico.png?nolink|}}
 MQTTlens est une application Google Chrome, qui se connecte à un courtier MQTT et peut s'abonner et publier sur des sujets MQTT.