Keycloak中为角色配置预定义属性列表的实现方案咨询

Keycloak 18.0.2（Quarkus发行版）原生不支持在Admin GUI中为新建角色预设默认展示的属性配置，你检索不到公开解决方案是正常的，该能力从未作为Keycloak原生功能上线。

• 存储层逻辑：角色属性以键值对形式存储在每个角色实体独立的attributes字段中，Keycloak没有设计全局角色属性模板对应的数据表、配置项，新建角色的attributes字段默认为空集合。
• 控制台逻辑：18.0.2版本搭载的旧版AngularJS Admin Console中，角色创建/编辑页的属性区块，只会动态渲染当前已经写入角色实体的属性键对应的输入框，没有预留全局属性配置的注入入口，遍历该版本所有Realm级、全局级配置开关、控制台源码，都找不到预设角色属性的配置入口。

• 低代码量方案：实现EventListenerProvider SPI监听管理员角色创建事件
  编写自定义事件监听器，捕获角色创建完成的AdminEvent事件，在事件回调中使用服务内部的角色管理接口，给新建角色自动写入预设的属性键（值留空即可）。注意给内部接口调用跳过事件触发逻辑，避免出现循环更新。该方案不需要修改前端控制台代码，缺点是创建角色的表单首次加载时不会展示预设属性，角色创建完成后再次进入编辑页就能看到所有预设属性项。
• 体验最优方案：扩展Admin Console+自定义Realm配置
  先通过自定义SPI在Realm设置页增加「角色默认属性列表」配置项，再对Admin Console的角色创建/编辑页做定制开发，页面加载时先读取Realm下的默认属性配置，提前在属性区块渲染对应的输入框。该方案可以做到新建角色表单打开时就直接展示所有预设属性，和原生功能体验一致，缺点是需要做前后端扩展开发，后续Keycloak版本升级时需要同步适配控制台改动。

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