使用Keycloak-admin-client Java API获取权限时遇404错误求助

可能的原因及解决方法 #

1. 目标客户端未启用Authorization功能 #

Keycloak中，只有开启Authorization功能的客户端，才能访问权限相关API接口。

• 操作步骤：
  1. 登录Keycloak控制台，进入对应Realm
  2. 找到目标客户端，进入Settings标签页
  3. 开启Authorization Enabled选项并保存设置

2. Admin Client的realm-management角色缺少必要权限 #

即便关联了realm-management角色，默认权限不足以操作客户端授权，需添加以下权限：

• manage-clients：管理客户端权限
• view-clients：查看客户端权限
• manage-authorization：管理客户端授权设置权限
• view-authorization：查看客户端授权设置权限
• 操作步骤：
  1. 进入Realm的Clients页面，找到你的Admin Client
  2. 切换到Service Account Roles标签页
  3. 在Client Roles下拉框选择realm-management
  4. 将上述权限添加到Assigned Roles列表，保存变更

3. 调整API调用方式 #

Keycloak 12.0.4中，权限相关数据需先通过授权设置对象获取，而非直接链式调用。修改代码如下：

Keycloak keycloak = this.getAdminClient();
// 确保clientId是客户端的唯一ID（而非显示名称）
ClientResource clientResource = keycloak.realm(kcProperties.getRealm()).clients().get(clientId);

// 先获取授权设置对象
AuthorizationSettingsRepresentation authSettings = clientResource.authorization().getSettings().toRepresentation();

// 从设置对象中提取所需数据
List<ScopeRepresentation> scopes = authSettings.getScopes();
List<ResourceRepresentation> resources = authSettings.getResources();
List<PolicyRepresentation> policies = authSettings.getPolicies();

额外注意：确认传入的clientId是Keycloak客户端的唯一ID，而非客户端显示名称，用名称调用会导致404错误。

内容的提问来源于stack exchange，提问作者Pio Antonio Perugini