如何通过Spring Boot的Keycloak库将Broker领域用户关联到身份提供者

实现方案 #

完全可以通过编程方式实现Broker域用户与上游身份提供者的账户关联，你之前的写法失效是因为Keycloak的用户创建接口不会处理传入的federatedIdentities参数，该绑定操作需要调用单独的接口完成，正确实现逻辑如下：

实现步骤 #

• 第一步：先正常创建Broker域的本地用户，不需要传入联邦身份相关参数
• 第二步：获取创建成功后的用户唯一ID，调用专门的联邦身份绑定接口完成关联

示例代码 #

// 1. 先构建用户信息，创建本地Broker用户
UserRepresentation user = new UserRepresentation();
user.setUsername("testUser");
user.setEmail("test@example.com");
user.setEnabled(true);
// 其他用户自定义属性设置
Response createResponse = brokerUserResource.create(user);
// 提取创建成功的用户ID
String createdUserId = createResponse.getLocation().getPath().split("/")[createResponse.getLocation().getPath().split("/").length -1];
UserResource createdUserResource = brokerUserResource.get(createdUserId);

// 2. 构建联邦身份信息，调用绑定接口
FederatedIdentityRepresentation federatedIdentity = new FederatedIdentityRepresentation();
federatedIdentity.setIdentityProvider(super.getProviderRealmName());
federatedIdentity.setUserId(providerUserId); // 上游身份提供者侧的用户ID
federatedIdentity.setUserName(user.getUsername()); // 上游身份提供者侧的用户名
// 执行绑定操作
createdUserResource.addFederatedIdentity(super.getProviderRealmName(), federatedIdentity);

原代码失效原因 #

Keycloak的用户创建接口设计上仅处理用户基础属性的写入，setFederatedIdentities方法设置的值仅用于用户信息查询场景的返回，不会在用户创建时自动完成关联操作，必须调用addFederatedIdentity接口单独执行绑定逻辑，和控制台手动添加关联的底层逻辑一致。

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