如何用Java代码创建Keycloak Realm并配置userProfile属性

Keycloak 25.0.1完全支持通过编程方式配置userProfile.unmanagedAttributePolicy，你需要通过UserProfileRepresentation这个嵌套对象来设置，而非直接在RealmRepresentation上寻找对应方法。具体步骤如下：

1. 确保依赖版本匹配
   你的Keycloak Admin Client依赖版本必须和服务端一致（25.0.1），避免API不兼容：

   <!-- Maven依赖示例 -->
   <dependency>
       <groupId>org.keycloak</groupId>
       <artifactId>keycloak-admin-client</artifactId>
       <version>25.0.1</version>
   </dependency>
   

2. 构建UserProfile配置并关联到Realm
   创建UserProfileRepresentation实例，设置unmanagedAttributePolicy为ENABLED，再将其绑定到RealmRepresentation的userProfile字段：

   import org.keycloak.representations.idm.RealmRepresentation;
   import org.keycloak.representations.idm.UserProfileRepresentation;
   import org.keycloak.representations.idm.UserProfileUnmanagedAttributePolicy;
   
   // 初始化Realm基础配置
   RealmRepresentation realm = new RealmRepresentation();
   realm.setRealm("custom-realm");
   realm.setEnabled(true);
   // 添加其他Realm配置（如登录设置、客户端等）...
   
   // 配置UserProfile的未管理属性策略
   UserProfileRepresentation userProfile = new UserProfileRepresentation();
   userProfile.setUnmanagedAttributePolicy(UserProfileUnmanagedAttributePolicy.ENABLED);
   
   // 将UserProfile关联到目标Realm
   realm.setUserProfile(userProfile);
   

3. 生成realm-config.json文件
   若需要直接生成JSON配置文件，可使用Jackson将RealmRepresentation序列化为格式化后的JSON：

   import com.fasterxml.jackson.databind.ObjectMapper;
   
   ObjectMapper objectMapper = new ObjectMapper();
   String realmConfigJson = objectMapper.writerWithDefaultPrettyPrinter()
                                       .writeValueAsString(realm);
   
   // 输出到控制台或写入本地文件
   System.out.println(realmConfigJson);
   

4. 验证生成的配置
   最终生成的JSON中会包含如下片段，说明配置生效：

   "userProfile": {
       "unmanagedAttributePolicy": "ENABLED"
   }
   

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