第9章 サーバーキャッシュ設定
Red Hat Single Sign-On には、2 種類のキャッシュがあります。データベースの前にあるキャッシュのタイプが 1 つあり、DB の負荷が軽減され、データをメモリーに保持することで全体的な応答時間が増加します。レルム、クライアント、ロール、およびユーザーメタデータはこの種類のキャッシュに保存されます。このキャッシュはローカルキャッシュです。より Red Hat Single Sign-On サーバーがあるクラスター内にある場合でも、ローカルキャッシュはレプリケーションを使用しません。代わりに、ローカルにコピーのみを保持し、エントリーが更新されても無効化メッセージが残りのクラスターに送信され、エントリーはエビクトされます。別個のレプリケートされたキャッシュ work
があります。この作業では、ローカルキャッシュから削除されるエントリーについて、無効化メッセージをクラスター全体に送信します。これにより、ネットワークトラフィックが大幅に削減され、効率的な状態になり、機密メタデータをネットワーク経由で送信しないようにします。
2 つ目のキャッシュは、ユーザーセッション、オフライントークンの管理、およびログイン失敗の追跡を処理し、サーバーがパスワードのシャッシングやその他の攻撃を検出できるようにします。これらのキャッシュに保持されるデータは一時的なものですが、メモリーのみはクラスター全体に複製される可能性があります。
本章では、クラスター化されていないデプロイメントの両方で、これらのキャッシュの設定オプションについて説明します。
これらのキャッシュの高度な設定は、JBoss EAP 設定ガイドの Infinispan セクションを参照してください。
9.1. エビクションとの有効期限
Red Hat Single Sign-On には複数の異なるキャッシュが設定されます。セキュアなアプリケーション、一般的なセキュリティーデータ、設定オプションに関する情報を保持するレルムキャッシュがあります。また、ユーザーメタデータを含むユーザーキャッシュもあります。両方のキャッシュを 10000 エントリーに制限し、最も最近使用されたエビクションストラテジーを使用します。それぞれがクラスター設定のエビクションを制御するオブジェクトリビジョンキャッシュにも関連付けられます。このキャッシュは暗黙的に作成され、設定されたサイズの 2 倍になります。ユーザーセッション、オフライントークン、およびログインの失敗には、個別のキャッシュもあります。これらのキャッシュのサイズもバインドされません。
これらのキャッシュのエビクションポリシーおよび最大エントリーは、操作モード に応じて、standalone.xml、standalone-ha.xml、または domain.xml で設定できます。
non-clustered
<subsystem xmlns="urn:jboss:domain:infinispan:4.0"> <cache-container name="keycloak" jndi-name="infinispan/Keycloak"> <local-cache name="realms"> <eviction max-entries="10000" strategy="LRU"/> </local-cache> <local-cache name="users"> <eviction max-entries="10000" strategy="LRU"/> </local-cache> <local-cache name="sessions"/> <local-cache name="offlineSessions"/> <local-cache name="loginFailures"/> <local-cache name="work"/> <local-cache name="authorization"> <eviction strategy="LRU" max-entries="100"/> </local-cache> <local-cache name="keys"> <eviction strategy="LRU" max-entries="1000"/> <expiration max-idle="3600000"/> </local-cache> </cache-container>
clustered
<subsystem xmlns="urn:jboss:domain:infinispan:4.0"> <cache-container name="keycloak" jndi-name="infinispan/Keycloak"> <transport lock-timeout="60000"/> <local-cache name="realms"> <eviction max-entries="10000" strategy="LRU"/> </local-cache> <local-cache name="users"> <eviction max-entries="10000" strategy="LRU"/> </local-cache> <distributed-cache name="sessions" mode="SYNC" owners="1"/> <distributed-cache name="offlineSessions" mode="SYNC" owners="1"/> <distributed-cache name="loginFailures" mode="SYNC" owners="1"/> <distributed-cache name="authorization" mode="SYNC" owners="1"/> <replicated-cache name="work" mode="SYNC"/> <local-cache name="keys"> <eviction max-entries="1000" strategy="LRU"/> <expiration max-idle="3600000"/> </local-cache> </cache-container>
許可されるエントリーの数を制限または拡張するには、eviction
要素または特定のキャッシュ設定の expiration
要素を追加または編集します。