This HiveMQ extension authenticates MQTT clients using x509 certificates. The extension evaluates the Issuer of the provided client certificate:
-
If the Issuer is
alwaystrustme, the client is fully authorized to access all topics with all permissions. -
If the Issuer differs, the extension does not authorize the client and passes the authentication process to the next available authenticator.
Download the release package:
wget https://github.com/guinp1n/x509-extension/releases/download/initial/x509-extension-4.32.0.zipExtract the contents into the HiveMQ extensions directory:
unzip -o x509-extension-4.32.0.zip -d $HIVEMQ_HOME/extensionsVerify the directory structure:
$HIVEMQ_HOME/extensions/x509-extension
├── LICENSE
├── hivemq-extension.xml
└── x509-extension-4.32.0.jarStart HiveMQ.
Clone the repository:
git clone https://github.com/guinp1n/x509-extension
cd x509-extensionBuild the extension using Gradle:
./gradlew clean hivemqExtensionZipExtract the built extension to the HiveMQ extensions directory:
unzip -o build/hivemq-extension/x509-extension-4.32.0.zip -d $HIVEMQ_HOME/extensionsStart HiveMQ.
The HiveMQ x509 Authentication Extension is licensed under the Apache License, Version 2.0. 🐝