Template:Networking rutos manual mqtt: Difference between revisions
Template:Networking rutos manual mqtt (view source)
Revision as of 09:37, 4 September 2023
, 4 September 2023no edit summary
No edit summary |
No edit summary |
||
Line 26: | Line 26: | ||
The <b>MQTT Broker</b> is an entity that listens for connections on the specified port and relays received messages to MQTT client. To begin using this devices as an MQTT Broker, enable it in this page. In order to make the device accept MQTT connections from WAN (remote networks), you also need to turn the 'Enable Remote Access' slider on. | The <b>MQTT Broker</b> is an entity that listens for connections on the specified port and relays received messages to MQTT client. To begin using this devices as an MQTT Broker, enable it in this page. In order to make the device accept MQTT connections from WAN (remote networks), you also need to turn the 'Enable Remote Access' slider on. | ||
[[File: | [[File:Networking_rutos_manual_mqtt_broker_v3.png|border|class=tlt-border]] | ||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 38: | Line 38: | ||
<td>off | on; default: <b>off</b></td> | <td>off | on; default: <b>off</b></td> | ||
<td>Turn MQTT Broker on or off.</td> | <td>Turn MQTT Broker on or off.</td> | ||
</tr> | |||
<tr> | |||
<td>Custom configuration</td> | |||
<td>off | on; default: <b>off</b></td> | |||
<td>Enables reading of custom configuration.</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 57: | Line 62: | ||
The <b>Security</b> section is used to configure TLS/SSL . | The <b>Security</b> section is used to configure TLS/SSL . | ||
[[File: | [[File:Networking rutos manual mqtt broker settings security v3.png|border|class=tlt-border]] | ||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
<tr> | <tr> | ||
<th> | <th>Field name</th> | ||
<th>value</th> | <th>value</th> | ||
<th>description</th> | <th>description</th> | ||
Line 74: | Line 79: | ||
<td>Certificate based {{!}} <span style="color:darkred">Pre-shared key based</span>; default: '''Certificate based'''</td> | <td>Certificate based {{!}} <span style="color:darkred">Pre-shared key based</span>; default: '''Certificate based'''</td> | ||
<td>Select type of TLS.</td> | <td>Select type of TLS.</td> | ||
</tr> | |||
<tr> | |||
<td>Require certificate</td> | |||
<td>off | on; default: <b>on</b></td> | |||
<td>Demand client certificate and key from the client.</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 118: | Line 128: | ||
<b>Note</b>: this table has a coloring scheme to indicate which fields can be seen with different configuration. | <b>Note</b>: this table has a coloring scheme to indicate which fields can be seen with different configuration. | ||
[[File: | [[File:Networking_rutos_manual_mqtt_broker_settings_bridge_v2.png|border|class=tlt-border]] | ||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 167: | Line 177: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td><span style="color:blue">On:</span> Bridge | <td><span style="color:blue">On:</span> Bridge certificate File</td> | ||
<td>.crt file; default: <b>none</b></td> | <td>.crt file; default: <b>none</b></td> | ||
<td>Uploads a server (broker) certificate file. A certificate file is a type of digital certificate that is used by client systems to make authenticated requests to a remote server.</td> | <td>Uploads a server (broker) certificate file. A certificate file is a type of digital certificate that is used by client systems to make authenticated requests to a remote server.</td> | ||
Line 180: | Line 190: | ||
<td>tlsv1 | tlsv1.1 | tlsv1.2; default: <b>tlsv1</b></td> | <td>tlsv1 | tlsv1.1 | tlsv1.2; default: <b>tlsv1</b></td> | ||
<td>TLS version used by the other broker.</td> | <td>TLS version used by the other broker.</td> | ||
</tr> | |||
<tr> | |||
<td><span style="color:blue">On:</span> Bridge ALPN</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Configure the application layer protocol negotiation option for the TLS session. Useful for brokers that support both websockets and MQTT on the same port. </td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 195: | Line 210: | ||
<td>string; default: <b>none</b></td> | <td>string; default: <b>none</b></td> | ||
<td>Username for authentication to the remote broker.</td> | <td>Username for authentication to the remote broker.</td> | ||
</tr> | |||
<tr> | |||
<td><span style="color:red">On:</span> Require password</td> | |||
<td>on | off; default: <b>off</b></td> | |||
<td>Password for authentication to the remote broker.</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 210: | Line 230: | ||
<td>off | on; default: <b>off</b></td> | <td>off | on; default: <b>off</b></td> | ||
<td>When turned on, discards session state after connecting or disconnecting.</td> | <td>When turned on, discards session state after connecting or disconnecting.</td> | ||
</tr> | |||
<tr> | |||
<td>Enable notification</td> | |||
<td>off | on; default: <b>off</b></td> | |||
<td>Publish notification messages to the local and remote brokers giving information about the state of the bridge connection.</td> | |||
</tr> | |||
<tr> | |||
<td>Enable local notifications</td> | |||
<td>off | on; default: <b>off</b></td> | |||
<td>Only publish notification messages to the local broker giving information about the state of the bridge connection.</td> | |||
</tr> | |||
<tr> | |||
<td>Keepalive interval</td> | |||
<td>(5-65535); default: <b>60</b></td> | |||
<td>Set the keepalive interval for this bridge connection, in seconds.</td> | |||
</tr> | </tr> | ||
</table> | </table> | ||
Line 215: | Line 250: | ||
You can also create and manage MQTT topics in the <b>Topics</b> list below the Bridge section. To add a new topic, click the 'Add' button. | You can also create and manage MQTT topics in the <b>Topics</b> list below the Bridge section. To add a new topic, click the 'Add' button. | ||
[[File:Networking_rutos_manual_mqtt_broker_settings_bridge_topics_add_button.png|border|class=tlt-border]] | [[File:Networking_rutos_manual_mqtt_broker_settings_bridge_topics_add_button v2.png|border|class=tlt-border]] | ||
You can then configure the newly added topic from the same page. | You can then configure the newly added topic from the same page. | ||
[[File:Networking_rutos_manual_mqtt_broker_settings_bridge_topics.png|border|class=tlt-border]] | [[File:Networking_rutos_manual_mqtt_broker_settings_bridge_topics v2.png|border|class=tlt-border]] | ||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 248: | Line 283: | ||
The <b>Miscellaneous</b> section is used to configure MQTT broker parameters that are related to neither Security nor Bridge. | The <b>Miscellaneous</b> section is used to configure MQTT broker parameters that are related to neither Security nor Bridge. | ||
[[File:Networking_rutos_manual_mqtt_broker_settings_miscellaneous.png|border|class=tlt-border]] | [[File:Networking_rutos_manual_mqtt_broker_settings_miscellaneous v2.png|border|class=tlt-border]] | ||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 275: | Line 310: | ||
<td>off | on; default: <b>on</b></td> | <td>off | on; default: <b>on</b></td> | ||
<td>Turns anonymous access to this broker on or off.</td> | <td>Turns anonymous access to this broker on or off.</td> | ||
</tr> | |||
<tr> | |||
<td>Max queued messages</td> | |||
<td>[0..65535]; default: <b>1000</b></td> | |||
<td>The maximum number of QoS 1 and 2 messages to hold in a queue per client above those that are currently in-flight. Set to 0 for no maximum (not recommended).</td> | |||
</tr> | |||
<tr> | |||
<td>Maximum packet size</td> | |||
<td>[1..268435456]; default: <b>1048576</b></td> | |||
<td>Maximum size of packet before it will be dropped.</td> | |||
</tr> | </tr> | ||
</table> | </table> |