Keycloak新版本自定义身份提供商模板配置方法咨询

问题背景 #

在Keycloak 19.0.3及更早版本中，自定义身份提供商的HTML模板可以直接打包到theme-resources/resources/partials目录，作为提供商jar包的一部分。但从21.0.0版本开始，新管理控制台上线后，若设置--features-disabled=admin2完全禁用旧控制台，会导致无法配置自定义提供商，进而影响自定义模板的正常显示。

可行解决方案 #

不用fork整个Keycloak项目，以下两种方案可以实现自定义模板的加载：

• 自定义主题扩展
  将自定义身份提供商的模板文件放到自定义主题的login/partials目录（例如themes/your-custom-theme/login/partials），然后在Keycloak后台配置使用该自定义主题。新版本Keycloak会优先加载自定义主题中的模板文件，完全适配新控制台的逻辑。

• SPI扩展资源加载
  在自定义身份提供商的SPI实现里，通过ThemeResourceProvider接口注册自定义资源路径。在Provider类中重写资源加载逻辑，把模板文件作为SPI的内置资源打包，让Keycloak能够正确识别并加载这些模板，全程无需依赖旧控制台的配置流程。

• 临时过渡方案（不推荐长期使用）
  若需要临时兼容旧配置逻辑，可以不设置--features-disabled=admin2，通过控制台权限控制限制旧控制台的访问范围，先用旧控制台完成自定义提供商的配置，之后再切换到新控制台使用。

内容的提问来源于stack exchange，提问作者lazyneuron