如何通过REST API向Keycloak Realm导入客户端授权设置？

这是Keycloak的预期设计，不是你的API调用方式或JSON配置结构错误。
/admin/realms/{realm}/clients 下的客户端POST创建、PUT更新接口，默认会直接忽略请求体里的authorizationSettings字段。你从其他Realm导出的JSON里带这个字段，是全量导出逻辑额外关联拉取了授权服务配置，但客户端基础CRUD接口本身没有对接授权配置的写入逻辑，这个行为在Keycloak 15及更早/后续多个版本中都存在，和你传的配置内容无关。

不要尝试在创建客户端的请求里直接带授权配置，按以下分层调用接口即可：

• 第一步：先完成客户端基础信息创建，就是你当前代码已经跑通的逻辑，记录下目标客户端的内部UUID（你JSON里自定义的id只要不冲突可以直接使用，建议创建后调用GET客户端接口做一次确认）
• 第二步：调用客户端PUT接口，将客户端的authorizationServicesEnabled字段设为true，这一步操作后Keycloak才会为该客户端初始化授权服务的独立存储空间
• 第三步：调用授权服务专属管理接口，按依赖顺序写入授权配置，所有授权相关接口的根路径为 /admin/realms/{realm}/clients/{client-uuid}/authz/resource-server，对应配置项的写入端点如下：
  • 全局授权配置（allowRemoteResourceManagement、policyEnforcementMode等）：调用PUT接口提交到根路径
  • 授权Scope：POST到/scope路径
  • 授权资源：POST到/resource路径，注意提交时需要关联已经创建完成的Scope ID，不能直接传Scope名称
  • 授权策略、权限、JS策略等其余授权配置，都在该根路径下有对应的专属端点，按依赖顺序依次创建即可

你的需求是更新Realm配置同时保留原有用户、用户组及部分存量授权设置，不要使用全量Realm导入功能，全量导入会直接覆盖/清空目标Realm的存量数据。推荐采用增量导入方案：

• 导入前先拉取目标TestRealm内现有用户、用户组、需要保留的授权规则做本地备份
• 导入新客户端时严格按照「客户端基础信息→开启授权服务开关→全局授权配置→授权Scope→授权资源→授权策略→授权权限」的顺序提交请求，Keycloak 15的授权配置存在强依赖顺序，顺序颠倒会报关联资源不存在的错误
• 新客户端配置导入完成后，将之前备份的需要保留的存量配置做校验合并，确认没有覆盖原有业务数据即可

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