keycloak-event-listener-mqtt/README.md
2024-02-18 19:03:59 +01:00

36 lines
1.2 KiB
Markdown

# MQTT Event Listener Provider for Keycloak
Keycloak SPI to publish events to a MQTT broker
Based on https://github.com/softwarefactory-project/keycloak-event-listener-mqtt
**TODO: Reduce JAR size**
## Configuration
- `server-uri` (String): MQTT broker URI
- `username` (String) / `password` (String): Credentials
- `topic` (String): MQTT base topic
- `use-persistence` (Boolean): MQTT persistence
- `retained` (Boolean): Message retention
- `clean-session` (Boolean): Establish clean sessions
- `connection-timeout` (Int): Timeout duration in seconds
- `qos` (Int): MQTT QoS
## Installtion
Copy the JAR into `providers/` and run Keycloak with these options:
```sh
./bin/kc.sh start \
--proxy=edge \
--hostname-strict=false \
--spi-events-listener-mqtt-server-uri tcp://localhost:1883 \
--spi-events-listener-mqtt-username username \
--spi-events-listener-mqtt-password password \
--spi-events-listener-mqtt-topic keycloak \
--spi-events-listener-mqtt-use-persistence true \
--spi-events-listener-mqtt-retained true \
--spi-events-listener-mqtt-clean-session true \
--spi-events-listener-mqtt-qos 0
```