多租户应用中如何优雅克隆含完整配置的Keycloak realm？

方案1：使用Keycloak Admin REST API程序化创建（最稳定） #

完全避开ID冲突问题，可直接嵌入租户开通自动化流程：

• 先调用master realm的认证接口获取admin权限token
• 将通用的角色、客户端、认证流、密码策略等固定配置封装为通用JSON结构体，所有内部id字段不手动赋值，Keycloak创建时会自动生成全局唯一ID
• 新增租户时仅替换结构体中realm名称、租户专属配置（如自定义主题、短信服务商配置）等字段，调用POST /admin/realms接口即可完成创建

方案2：导出无内部ID的Realm模板直接导入 #

解决你之前导出模板带固定ID触发冲突的问题：

• 进入作为模板的Realm管理后台，点击导出按钮
• 开启「导出角色」「导出组」开关，*关闭「导出内部ID」*开关，导出的JSON模板就不会携带固定唯一ID
• 导入新租户Realm前，仅修改模板中realm字段的值为新租户的Realm名称，其余通用配置无需调整，直接导入即可规避约束冲突

若使用kc.sh命令行导出模板，需添加--exclude-ids参数，效果和后台关闭导出内部ID完全一致

方案3：使用kcadm.sh命令行工具批量创建 #

适合需要批量生成大量租户的场景，操作效率远高于网页端：

• 提前将无ID的模板JSON保存为本地文件，比如realm-template.json
• 先完成kcadm工具的身份认证：
  kcadm.sh config credentials --server http://你的Keycloak服务地址 --realm master --user admin --password 你的管理员密码
• 每次新增租户执行如下命令即可，将命令中的new-tenant-id替换为对应租户的Realm名称：
  sed 's/"realm": "你的模板Realm名称"/"realm": "new-tenant-id"/' realm-template.json | kcadm.sh create realms -f -

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