Keycloak服务器安装和配置

安装地址：https://www.keycloak.org/archive/downloads-4.4.0.html

参考文档：https://www.keycloak.org/docs/latest/server_installation/index.html#guide-overview

解压文件：

分发目录结构：

aaarticlea/png;base64,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" alt="" />

目录解释

bin: 包含启动服务和管理操作的脚本
domain: 在domain模式下的keycloak的配置文件和工作目录
standalone:包含在standalone模式下的keycloak的配置文件和工作目录

后端类库
modules:服务器使用的JAVA库

前端展示：
themes:服务器显示的所有css,img
welcome-content：服务器显示的模板和html类文件（实际上使用的是ftl模板）

操作模式

Standalone Mode：

Standalone模式仅在您要运行一个且仅运行一个Keycloak服务器实例时才有用。

该模式下无法进群部署，而且无法使用分布式缓存。

如果你的服务器运行失败，用户将无法登陆。建议不要在生产环境下面使用该模式。

模式配置：standalone文件夹下的configuration下的standalone.xml来配置。

目前使用standalone模式进行测试。

Standalone Clustered Mode

独立集群模式可用于集群部署。该模式要求在每个机器拥有keycloak分发的副本。该模式一开始部署非常简单，但在之后可能变得非常麻烦。

模式配置：

该发行版具有大多数预先配置的应用服务器配置文件，用于在群集中运行。它具有网络，数据库，缓存和发现的所有特定基础结构设置。如果在群集中没有配置共享数据库连接，将无法运行。同时你应该部署某种类型的负载均衡器。

配置文件为：standalone-ha

Domain Clustered Mode

域模式是一种集中管理和发布服务器配置的方法。

随着群集规模的扩大，以标准模式运行群集会很快变得更加严重。每次需要进行配置更改时，都要在群集中的每个节点上执行此操作。域模式通过提供存储和发布配置的中心位置来解决此问题。设置起来可能相当复杂，但最终还是值得的。此功能内置于Keycloak派生的WildFly 服务器中。

以下是在域模式下运行的一些基本概念。

域控制器

域控制器是一个负责存储，管理和发布集群中每个节点的常规配置的过程。此过程是集群中节点获取其配置的中心点。主控制器主机控制器负责管理特定计算机上的服务器实例。您将其配置为运行一个或多个服务器实例。域控制器还可以与每台计算机上的主机控制器进行交互以管理群集。为了减少运行进程的数量，域控制器还充当其运行的计算机上的主机控制器。

域名简介

域配置文件是一组命名的配置，可供服务器用于引导。域控制器可以定义不同服务器使用的多个域配置文件。

服务器组

服务器组是服务器的集合。它们作为一个进行管理和配置。您可以将域配置文件分配给服务器组，该组中的每个服务都将使用该域配置文件作为其配置。

在域模式下，域控制器在主节点上启动。群集的配置驻留在域控制器中。接下来，在群集中的每台计算机上启动主机控制器。每个主机控制器部署配置指定将在该计算机上启动的Keycloak服务器实例数。当主机控制器启动时，它会启动与配置完成时一样多的Keycloak服务器实例。这些服务器实例从域控制器中提取其配置。

Cross-Datacenter Replication Mode

standalone模式下集成MYSQL

1.创建keycloak数据库

2.在keycloak目录，创建红色路径 ..\keycloak 4.4.0.Final\modules\system\layers\base\com\mysql\main

3.下载MySQL 驱动并复制到上面路径

4.添加Module.xml文件在该目录下

<?xml version="1.0" ?>

<module xmlns="urn:jboss:module:1.3" name="com.mysql">

<resources>

<resource-root path="mysql-connector-java-5.1.40.jar"/>

</resources>

<dependencies>

<module name="javax.api"/>

<module name="javax.transaction.api"/>

</dependencies>

</module>

5.修改standalone.xml文件：

找到： <subsystem xmlns="urn:jboss:domain:datasources:5.0">

添加DataSource：

<datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" use-java-context="true">

                        <connection-url>jdbc:mysql://localhost:3306/keycloak?useSSL=false&tcpRcvBuf=102400000</connection-url>

                        <driver-class>com.mysql.jdbc.Driver</driver-class>

                        <driver>mysql</driver>

                        <security>

                            <user-name>root</user-name>

                            <password>root</password>

                        </security>

</datasource>

<drivers>

                    <driver name="mysql" module="com.mysql">

                    <!-- <driver-class>com.mysql.jdbc.Driver</driver-class>     -->

                        <xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>

                    </driver>

</drivers>

　　在/bin目录下启动standalone.bat。