https://github.com/hivemq/hivemq-deny-wildcard-extension

HiveMQ extension for denying subscriptions to the root wildcard
https://github.com/hivemq/hivemq-deny-wildcard-extension

extension hivemq hivemq-extension mqtt security subscription wildcard

Last synced: about 2 months ago
JSON representation

HiveMQ extension for denying subscriptions to the root wildcard

• Host: GitHub
• URL: https://github.com/hivemq/hivemq-deny-wildcard-extension
• Owner: hivemq
• License: apache-2.0
• Created: 2018-12-10T11:28:09.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-14T04:14:49.000Z (4 months ago)
• Last Synced: 2024-09-14T16:42:36.197Z (4 months ago)
• Topics: extension, hivemq, hivemq-extension, mqtt, security, subscription, wildcard
• Language: Java
• Homepage: https://www.hivemq.com/extension/deny-root-wildcard-subscriptions-extension/
• Size: 275 KB
• Stars: 7
• Watchers: 17
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.adoc
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
:hivemq-support: http://www.hivemq.com/support/

:hivemq-extension-download: https://www.hivemq.com/extension/deny-root-wildcard-subscriptions-extension/

= HiveMQ Deny Root Wildcard Subscription Extension

image:https://img.shields.io/badge/Extension_Type-Security-orange?style=for-the-badge[Extension Type]

image:https://img.shields.io/github/v/release/hivemq/hivemq-deny-wildcard-extension?style=for-the-badge[GitHub release (latest by date),link=https://github.com/hivemq/hivemq-deny-wildcard-extension/releases/latest]

image:https://img.shields.io/github/license/hivemq/hivemq-deny-wildcard-extension?style=for-the-badge&color=brightgreen[GitHub,link=LICENSE]

image:https://img.shields.io/github/actions/workflow/status/hivemq/hivemq-deny-wildcard-extension/check.yml?branch=master&style=for-the-badge[GitHub Workflow Status,link=https://github.com/hivemq/hivemq-deny-wildcard-extension/actions/workflows/check.yml?query=branch%3Amaster]

== Purpose

This extension denies any subscription to the root wildcard topic.

In general, root wildcard subscribers tend to be a bottleneck in many scenarios.

== Installation

* Download the extension from the {hivemq-extension-download}[HiveMQ Marketplace^].

* Copy the content of the zip file to the `extensions` folder of your HiveMQ nodes.

== Configuration

No configuration is needed, the extension works out of the box.

== First Steps

After the extension is installed, it is automatically enabled at startup.

Now, no client is allowed to subscribe to `\#`, `+/#`, `$share/group/#` or any other topic filter that would represent a root wildcard.

== Need Help?

If you encounter any problems, we are happy to help.

The best place to get in contact is our {hivemq-support}[support^].

== Contributing

If you want to contribute to HiveMQ Deny Wildcard Extension, see the link:CONTRIBUTING.md[contribution guidelines].

== License

HiveMQ Deny Wildcard Extension is licensed under the `APACHE LICENSE, VERSION 2.0`.

A copy of the license can be found link:LICENSE[here].