You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by jb...@apache.org on 2023/01/27 17:10:23 UTC
[activemq-artemis] branch main updated: NO-JIRA update MQTT docs for WSS
This is an automated email from the ASF dual-hosted git repository.
jbertram pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git
The following commit(s) were added to refs/heads/main by this push:
new 009f539406 NO-JIRA update MQTT docs for WSS
009f539406 is described below
commit 009f539406b30215d1d2f16e74eb2371907b6f90
Author: Justin Bertram <jb...@apache.org>
AuthorDate: Fri Jan 27 11:10:16 2023 -0600
NO-JIRA update MQTT docs for WSS
---
docs/user-manual/en/mqtt.md | 14 ++++++++++++--
1 file changed, 12 insertions(+), 2 deletions(-)
diff --git a/docs/user-manual/en/mqtt.md b/docs/user-manual/en/mqtt.md
index 6226828644..59cf05b85f 100644
--- a/docs/user-manual/en/mqtt.md
+++ b/docs/user-manual/en/mqtt.md
@@ -169,13 +169,23 @@ browsers which support Web Sockets can send and receive MQTT messages.
MQTT over Web Sockets is supported via a normal MQTT acceptor:
```xml
-<acceptor name="mqtt-ws-acceptor">tcp://localhost:1883?protocols=MQTT</acceptor>
+<acceptor name="mqtt-ws-acceptor">tcp://host:1883?protocols=MQTT</acceptor>
```
With this configuration, Apache ActiveMQ Artemis will accept MQTT connections
over Web Sockets on the port `1883`. Web browsers can then connect to
`ws://<server>:1883` using a Web Socket to send and receive MQTT messages.
+SSL/TLS is also available, e.g.:
+
+```xml
+<acceptor name="mqtt-wss-acceptor">tcp://host:8883?protocols=MQTT;sslEnabled=true;keyStorePath=/path/to/keystore;keyStorePassword=myPass</acceptor>
+```
+
+Web browsers can then connect to `wss://<server>:8883` using a Web Socket to
+send and receive MQTT messages.
+
+
## Automatic Subscription Clean-up
Sometimes MQTT clients don't clean up their subscriptions. In such situations
@@ -314,4 +324,4 @@ MQTT `acceptor` in `broker.xml`, e.g.:
```xml
<acceptor name="mqtt">tcp://0.0.0:1883?protocols=MQTT;closeMqttConnectionOnPublishAuthorizationFailure=false</acceptor>
-```
\ No newline at end of file
+```