[jira] [Updated] (ARTEMIS-6297) Shore up gaps in MQTT documentation

["ASF GitHub Bot (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/ARTEMIS-6297?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

ASF GitHub Bot updated ARTEMIS-6297:
------------------------------------
    Labels: pull-request-available  (was: )

> Shore up gaps in MQTT documentation
> -----------------------------------
>
>                 Key: ARTEMIS-6297
>                 URL: https://issues.apache.org/jira/browse/ARTEMIS-6297
>             Project: Artemis
>          Issue Type: Task
>            Reporter: Justin Bertram
>            Assignee: Justin Bertram
>            Priority: Major
>              Labels: pull-request-available
>          Time Spent: 10m
>  Remaining Estimate: 0h
>
> There are two main gaps in the MQTT docs...
> h3. Address/queue mapping and security
> The MQTT user documentation doesn't explain how MQTT topics and subscriptions map onto the Core address model, so users have no clear reference for how {{security-setting}} permissions apply to MQTT clients:
>   - {{createAddress}}
>   - {{send}}
>   - {{createDurableQueue}} / {{createNonDurableQueue}}
>   - {{consume}}
>   - {{deleteDurableQueue}} / {{deleteNonDurableQueue}}
> It's also not documented that the broker automatically cleans up subscription queues independent of delete permissions, which could otherwise look like a security inconsistency.
> Also, there's no test coverage confirming that an explicit {{UNSUBSCRIBE}} is actually subject to {{deleteDurableQueue}}/{{deleteNonDurableQueue}} enforcement, so this behavior could regress unnoticed.
> h3. Optional MQTT 5 features
> The MQTT 5 specification's optional features aren't called out anywhere, leaving it unclear which of them the broker actually supports.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@artemis.apache.org
For additional commands, e-mail: issues-help@artemis.apache.org