CommunitySPIEvent / Webhook / MessagingActive
keycloak-webhook
Send Keycloak events to webhooks (HTTP, AMQP, Syslog).KeycloakイベントをWebhook等へ送信
- ★
- 114
- Forks
- 37
- Contributors
- 11
- Updated
- 2026-07-26
- KC
- —
- License
- MIT
What it can doできること5
- Send Keycloak events (login, registration, logout, …) as webhooks over HTTP, AMQP (RabbitMQ) or Syslog — deploy only the transports you need.Keycloakのイベント(ログイン・登録・ログアウトなど)を、HTTP・AMQP(RabbitMQ)・Syslogで通知できる。必要な送信方式のモジュールだけ導入すればよい
- Send HTTP webhooks to several endpoints at once, with optional basic auth.HTTPでは複数のエンドポイントへ同時送信でき、Basic認証も任意で使える
- Use Syslog over TCP/UDP in RFC 3164 or RFC 5424 format.SyslogはTCP/UDP、RFC 3164/5424形式に対応
- Limit which events trigger webhooks (
WEBHOOK_EVENTS_TAKEN); all settings come from environment variables.通知するイベントをWEBHOOK_EVENTS_TAKENで絞り込める。設定はすべて環境変数 - Supports Keycloak 21 through 26, with Docker and Kubernetes (init container) examples.Keycloak 21〜26に対応し、DockerとKubernetes(initコンテナ)の導入例がある
What it cannot do / limitsできないこと・制約3
- The current release for every listed Keycloak version is a release candidate (0.10.0-rc.1).対応表の全バージョンで、現行リリースはRC版(0.10.0-rc.1)
- The README documents no retry, signing (HMAC) or per-realm webhook management — targets are global environment variables.再送、署名(HMAC)、realmごとのWebhook管理についてはREADMEに記載がない。送信先はグローバルな環境変数で指定する
- JAR files must be renamed (no version or
-allsuffix) before deployment.配置前にJARのファイル名を変更する必要がある(バージョンと-allを外す)
Requirements前提条件
- The core JAR plus at least one transport JAR in
/opt/keycloak/providers, and thewebhook-http(or other) event listener enabled per realm.コアJARと、少なくとも1つの送信方式のJARを/opt/keycloak/providersに置き、realmごとにwebhook-httpなどのリスナーを有効化