OfficialSPIStorage / DatastoreActive

keycloak-cassandra-extension

ba-itsys/keycloak-cassandra-extension ↗

Store Keycloak data in Apache Cassandra.KeycloakのデータをApache Cassandraに保存

★
28
Forks
11
Contributors
10
Updated
2026-10-19
KC
26.8.1
License
Apache-2.0

What it can doできること4

  • Store Keycloak entities in Apache Cassandra — every storage area except authorization and events — with no relational database needed.Keycloakのエンティティを、認可とイベント以外のすべての領域でApache Cassandraに保存できる。リレーショナルDBは不要
  • Serve only sessions and other dynamic data from Cassandra (cache mode) and keep the rest in JPA, or choose the areas explicitly.セッションなどの動的データだけをCassandraに置き、残りをJPAにする（cache モード）ことも、領域を明示的に選ぶこともできる
  • Route areas per realm via realm attributes, and combine with the filestore extension.realm属性で、realmごとに保存先を振り分けられる。filestore拡張との併用も可能
  • Add extras such as optimistic locking, a refresh-token reuse grace period, username/email uniqueness checks and indexed user attributes.楽観ロック、リフレッシュトークン再利用の猶予期間、ユーザー名とメールの重複チェック、インデックス付きユーザー属性などの追加機能もある

What it cannot do / limitsできないこと・制約4

  • Keycloak Organizations are not supported and must be turned off.KeycloakのOrganizations機能には非対応で、無効にする必要がある
  • User search is limited to username (case-insensitive), email and service accounts; other attribute searches scan all users unless declared as indexed. attributes.ユーザー検索は、ユーザー名（大文字小文字を区別しない）・メール・サービスアカウントに限られる。それ以外の属性検索は indexed. 属性にしない限り全件走査になる
  • Requires the preview stateless feature, and realm/authorization caches are disabled.プレビュー機能 stateless が必要で、realmと認可のキャッシュは無効化される
  • Changing per-realm routing does not migrate existing data; once 26.8 has saved an identity provider you cannot roll back.realmごとの振り分けを変えても既存データは移行されない。26.8でIdPを保存した後は、旧版に戻せない

Requirements前提条件