红帽全球峰会4.4. Keycloak 集成
您可以使用 Keycloak 保护 HawtIO 控制台。要将 HawtIO 与 Keycloak 集成，您需要：
- 准备 Keycloak 服务器
- 将 HawtIO 部署到 favourite 运行时(Quarkus、Spring Boot、Wild、Jetty、Tomcat 等)，并将它配置为使用 Keycloak 进行身份验证
4.4.1. 准备 Keycloak 服务器
安装并运行 Keycloak 服务器。最简单的方法是使用 Docker 镜像 ：
docker run -d --name keycloak \ -p 18080:8080 \ -e KEYCLOAK_ADMIN=admin \ -e KEYCLOAK_ADMIN_PASSWORD=admin \ quay.io/keycloak/keycloak start-dev
docker run -d --name keycloak \
-p 18080:8080 \
-e KEYCLOAK_ADMIN=admin \
-e KEYCLOAK_ADMIN_PASSWORD=admin \
quay.io/keycloak/keycloak start-dev
在这里，我们为 Keycloak 服务器使用端口号 18080，以避免与其他应用程序可能使用的端口冲突。
您可以使用用户 admin / password admin 登录 Keycloak 管理控制台 http://localhost:18080/admin/。将 hawtio-demo-realm.json 导入到 Keycloak 中。为此，可单击 Create Realm 按钮，然后导入 hawtio-demo-realm.json。它将创建 hawtio-demo realm。
hawtio-demo 域具有 hawtio-client 应用程序作为公共客户端安装，并且定义了一些 realm 角色，如 admin 和 viewer。这些角色的名称与默认的 HawtIO 角色相同，该角色可以登录 HawtIO 管理控制台和 JMX。
另外，还有 3 个用户：
admin-
用户 用户，其密码为
admin viewer-
用户 用户，具有密码
查看器 jdoe-
用户(
passwordpassword)和未分配任何角色，不允许该用户登录 HawtIO。
目前，角色的不同不会影响 Quarkus 和 Spring Boot 上的 HawtIO 访问权限，因为 HawtIO RBAC 功能尚未在这些运行时实施。
4.4.2. 配置
HawtIO 的 Keycloak 集成配置由两个部分组成：与运行时中的 Keycloak 集成（服务器侧），并与 HawtIO 控制台中的 Keycloak 集成（客户端侧）。
每个部分都需要进行以下设置：
- 服务器端
- Keycloak 适配器的特定于运行时的配置
- 客户端
-
HawtIO Keycloak 配置
keycloak-hawtio.json
4.4.2.1. Quarkus
首先，应用所需的配置， 以将 HawtIO 附加到 Quarkus 应用程序。
您需要将 Quarkus 应用程序与 Keycloak 集成为 Quarkus OIDC 扩展。将以下依赖项添加到 pom.xml 中：
pom.xml
<dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-oidc</artifactId> </dependency>
<dependency>
<groupId>io.quarkus</groupId>
<artifactId>quarkus-oidc</artifactId>
</dependency>4.4.2.1.1. 服务器端
然后，在 application.properties 中添加以下行（配置服务器端 OIDC 扩展）：
application.properties
quarkus.oidc.token-state-manager.split-tokens = true 非常重要，因为您可能会遇到大量大小会话 Cookie 令牌问题，且无法与 Keycloak 集成。
4.4.2.1.2. 客户端
最后，在 Quarkus 应用程序项目中的 src/main/resources 下创建 keycloak-hawtio.json （充当 client-side HawtIO JS 配置）：
keycloak-hawtio.json
根据代码 交换代码挑战方法高级配置，将 pkceMethod 设置为 S256。如果没有启用 PKCE，请不要设置这个选项。
构建并运行项目，它将与 Keycloak 集成。
4.4.2.1.3. Example
如需工作 示例，请参阅 quarkus-keycloak 示例。
4.4.2.2. Spring Boot
首先，应用所需的配置， 以将 HawtIO 附加到 Spring Boot 应用程序。
您需要将 Spring Boot 应用程序与 Keycloak 集成的内容是，将以下依赖项添加到 pom.xml 中（将 4.x.y 替换为最新的 HawtIO 发行版本）：
pom.xml
<dependency> <groupId>io.hawt</groupId> <artifactId>hawtio-springboot-keycloak</artifactId> <version>4.x.y</version> </dependency>
<dependency>
<groupId>io.hawt</groupId>
<artifactId>hawtio-springboot-keycloak</artifactId>
<version>4.x.y</version>
</dependency>4.4.2.2.1. 服务器端
然后，在 application.properties 中添加以下行（配置服务器端 Keycloak 适配器）：
application.properties
4.4.2.2.2. 客户端
最后，在 Spring Boot 项目中的 src/main/resources 下创建 keycloak-hawtio.json （充当 client-side HawtIO JS 配置）：
keycloak-hawtio.json
构建并运行项目，它将与 Keycloak 集成。
4.4.2.2.3. Example
有关工作 示例，请参阅 springboot-keycloak 示例。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}