git.sur5r.net Git - freertos/blob - FreeRTOS-Labs/Demo/FreeRTOS_IoT_Libraries/mqtt/readme.txt

   1 See https://freertos.org/mqtt/ for further information.\r
   2 \r
   3 Contains projects that demonstrate the IoT MQTT library.\r
   4 \r
   5 - Securing MQTT Communication -\r
   6 Internet of Things use cases require MQTT communications to be secured, but secure\r
   7 authentication and encryption are not part of the MQTT specification.  It is\r
   8 therefore common to use MQTT in combination with Transport Layer Security (TLS).\r
   9 TLS encrypts data sent across a network and enables the data's destination to be\r
  10 authenticated.  'Server authentication' is when the MQTT client authenticates the\r
  11 identity of the MQTT broker.  'Mutual authentication' is when the MQTT broker also\r
  12 authenticates the identity of the MQTT client.\r
  13 \r
  14 \r
  15 - Pre-configured MQTT Example Projects -\r
  16 The examples contained in subdirectories from here demonstrate the concepts\r
  17 described above one at a time.  The first example demonstrates plain text\r
  18 (unencrypted) MQTT communication, the second example builds on the first to\r
  19 introduce weak server authentication, and the third example builds on the second to\r
  20 introduce strong mutual authentication.  Note:  It is our recommendation to always\r
  21 use strong mutual authentication in any Internet of Things (IoT) application.  The\r
  22 plain text project is only provided to validate MQTT communication can be\r
  23 established prior to introducing encryption and authentication, and to allow the\r
  24 MQTT packets to be observed using a network packet sniffer such as Wireshark for\r
  25 those who wish to do so.  The first two projects are in no way intended to be\r
  26 examples suitable for production use.\r