9.4. 粘性会话

典型的集群部署由负载均衡器（代理）以及 2 个或更多专用网络上的 Red Hat Single Sign-On 服务器组成。出于性能目的，如果负载均衡器将与特定浏览器会话相关的所有请求转发到同一红帽单点登录后端节点，则可能会很有用。

其原因在于，Red Hat Single Sign-On 正在使用在覆盖下的 Infinispan 分布式缓存来保存与当前身份验证会话和用户会话相关的数据。Infinispan 分布式缓存默认使用一个所有者进行配置。这意味着特定的会话只保存在一个集群节点中，如果其他节点想要访问会话，则其他节点需要远程查找会话。

例如，如果 ID 为 123 的身份验证会话保存在 node1 上的 Infinispan 缓存中，而 node2 需要通过网络将请求发送到 node1，才能返回特定的会话实体。

如果特定会话实体总是在本地可用，可以使用粘性会话的帮助来完成。集群环境中的工作流带有公共前端负载均衡器，两个后端 Red Hat Single Sign-On 节点都可以如下：

此时，如果负载均衡器将所有下一请求转发到 node2，这是节点，其所有者为 ID 为 123，因此 Infinispan 可以在本地查找此会话。身份验证完成后，身份验证会话将转换为用户会话，因此也会保存在 node2 上，因为它具有相同的 ID 123。

在集群设置中不强制使用粘性会话，但出于上述原因，最好是性能。您需要通过 AUTH_SESSION_ID Cookie 将负载平衡器配置为粘性。它如何取决于您的负载均衡器。

建议在 Red Hat Single Sign-On 一侧使用系统属性 jboss.node.name，其值与路由名称对应。例如，-Djboss.node.name=node1 将使用 node1 来识别路由。此路由将由 Infinispan 缓存使用，并在节点是特定密钥的所有者时附加到 AUTH_SESSION_ID Cookie。以下是使用这个系统属性启动命令的示例：

cd $RHSSO_NODE1
./standalone.sh -c standalone-ha.xml -Djboss.socket.binding.port-offset=100 -Djboss.node.name=node1

通常在生产环境中，路由名称应使用与后端主机相同的名称，但这不是必须的。您可以使用不同的路由名称。例如，如果您要隐藏您的专用网络内 Red Hat Single Sign-On 服务器的主机名。

<subsystem xmlns="urn:jboss:domain:keycloak-server:1.1">
  ...
    <spi name="stickySessionEncoder">
        <provider name="infinispan" enabled="true">
            <properties>
                <property name="shouldAttachRoute" value="false"/>
            </properties>
        </provider>
    </spi>

</subsystem>