mirror of
https://github.com/boostorg/mqtt5.git
synced 2025-11-07 19:31:37 +01:00
aeab5f9665
Summary: related to T12804 - fixes in publisher and receiver examples - update year to 2024 - remove extra documentation link in README - remove unnecessary copyright & license section, it is automatically generated from 00_main.qbk Reviewers: ivica Reviewed By: ivica Subscribers: miljen, iljazovic Differential Revision: https://repo.mireo.local/D27889
37 lines
1.5 KiB
Plaintext
37 lines
1.5 KiB
Plaintext
[section:network_connection Establishing a network connection with different protocols ]
|
|
The __MQTT__ protocol requires the underlying transport protocol that ensures
|
|
orderly, lossless transmission of byte streams between the Client and Server in both directions.
|
|
|
|
The following examples demonstrate how to establish a network connection using suitable
|
|
transport protocols such as TCP/IP, TLS/SSL, and WebSocket.
|
|
|
|
[import ../../../example/network_connection.cpp]
|
|
|
|
[h3 TCP/IP connection]
|
|
To create a TCP/IP connection with a Broker, initialise __Client__ with __TCP_SOCKET__ as the __StreamType__.
|
|
[tcp]
|
|
|
|
[h3 TLS/SSL connection]
|
|
To establish a secure and encrypted connection using the TLS/SSL protocol, supply a context object that meets the __TlsContext__ requirements.
|
|
Additionally, initialise __Client__ with an underlying stream that implements TLS/SSL protocol as the __StreamType__.
|
|
|
|
This example will demonstrate how to set up an SSL connection using __SSL_CONTEXT__ and __SSL_STREAM__.
|
|
To use SSL support in __Asio__, __OPENSSL__ is required.
|
|
[tls]
|
|
|
|
[h3 WebSocket connection]
|
|
The WebSocket connection can be established over an unencrypted TCP/IP connection or an encrypted TLS/SSL connection.
|
|
|
|
The following example will showcase setting up WebSocket over TCP/IP and WebSocket over TLS/SLL connection using
|
|
__WEBSOCKET_STREAM__.
|
|
|
|
[h4 WebSocket over TCP/IP]
|
|
[websocket_tcp]
|
|
|
|
[h4 WebSocket over TLS/SSL]
|
|
[websocket_tls]
|
|
|
|
Once the __Client__ has been initialised with a suitable __StreamType__, it is prepared for configuration and utilisation.
|
|
|
|
[endsect]
|