Skip to content

Commit 71b4d5a

Browse files
committed
Update MQTT docs to use new anonymous_login_user
This commit is a follow-up of #2017
1 parent 58b87e2 commit 71b4d5a

File tree

1 file changed

+7
-10
lines changed

1 file changed

+7
-10
lines changed

docs/mqtt.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -303,27 +303,28 @@ that make sure remote clients can successfully connect:
303303

304304
* Create one or more new user(s), grant them full permissions to the virtual host used by the MQTT plugin and make clients
305305
that connect from remote hosts use those credentials. This is the recommended option.
306-
* Set `default_user` and `default_pass` via [plugin configuration](#config) to a non-`guest` user who has the
306+
* Set `anonymous_login_user` and `anonymous_login_pass` to a non-`guest` user who has the
307307
[appropriate permissions](./access-control).
308308

309309

310310
### Anonymous Connections {#anonymous-connections}
311311

312-
MQTT supports optional authentication (clients may provide no credentials) but RabbitMQ
313-
does not. Therefore a default set of credentials is used for anonymous connections.
312+
MQTT supports optional authentication (clients may provide no credentials).
313+
Therefore a default set of credentials is used for anonymous connections.
314314

315-
The `mqtt.default_user` and `mqtt.default_pass` configuration keys are used to specify
315+
The `anonymous_login_user` and `anonymous_login_pass` configuration keys are used to specify
316316
the credentials:
317317

318318
```ini
319-
mqtt.default_user = some-user
320-
mqtt.default_pass = s3kRe7
319+
anonymous_login_user = some-user
320+
anonymous_login_pass = s3kRe7
321321
```
322322

323323
It is possible to disable anonymous connections:
324324

325325
```ini
326326
mqtt.allow_anonymous = false
327+
anonymous_login_user = none
327328
```
328329

329330
If the `mqtt.allow_anonymous` key is set to `false` then clients **must** provide credentials.
@@ -344,8 +345,6 @@ mqtt.listeners.tcp.default = 1883
344345
# anonymous connections, if allowed, will use the default
345346
# credentials specified here
346347
mqtt.allow_anonymous = true
347-
mqtt.default_user = guest
348-
mqtt.default_pass = guest
349348

350349
mqtt.vhost = /
351350
mqtt.exchange = amq.topic
@@ -774,8 +773,6 @@ With the second one, there is a limit of 2 GB per vhost. Both are node-local
774773
To configure the store, use <code>rabbitmq_mqtt.retained_message_store</code> configuration key:
775774

776775
```ini
777-
mqtt.default_user = guest
778-
mqtt.default_pass = guest
779776
mqtt.allow_anonymous = true
780777
mqtt.vhost = /
781778
mqtt.exchange = amq.topic

0 commit comments

Comments
 (0)