求通过SCIM为WSO2 IS添加用户扩展属性的Java实现示例

前置配置（WSO2 IS端操作） #

• 登录WSO2 IS管理控制台，进入「用户属性和角色」>「用户属性」>「添加属性」，按需求创建自定义扩展属性，记录属性的URN（默认扩展属性URN通常为urn:ietf:params:scim:schemas:extension:enterprise:2.0:User，如果是自定义Schema的话替换为自己定义的URN）
• 进入SCIM 2.0配置页，确保新增的扩展属性已开启SCIM接口读写权限
• 准备好接口调用的鉴权信息：管理员账号密码、WSO2 IS的SCIM 2.0用户接口地址（通常为https://<WSO2_IS_HOST>:<PORT>/scim2/Users）

Java代码实现 #

依赖引入（Maven示例） #

<!-- OkHttp 依赖，用于发起HTTP请求 -->
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.10.0</version>
</dependency>
<!-- JSON 处理依赖，用于构造请求体 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

完整代码示例 #

import com.fasterxml.jackson.databind.ObjectMapper;
import okhttp3.*;
import java.util.Base64;
import java.util.HashMap;
import java.util.Map;

public class ScimAddUserWithExtension {
    // WSO2 IS 配置参数
    private static final String SCIM_USERS_URL = "https://localhost:9443/scim2/Users";
    private static final String ADMIN_USER = "admin";
    private static final String ADMIN_PWD = "admin";
    // 扩展属性URN，替换为你自己配置的URN
    private static final String EXTENSION_URN = "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User";

    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient().newBuilder()
                // 测试环境可忽略SSL证书校验，生产环境请删除该配置配置正规证书
                .hostnameVerifier((hostname, session) -> true)
                .build();
        ObjectMapper objectMapper = new ObjectMapper();

        // 构造基础用户信息
        Map<String, Object> userMap = new HashMap<>();
        // 必须指定基础Schema和扩展Schema
        userMap.put("schemas", new String[]{
                "urn:ietf:params:scim:schemas:core:2.0:User",
                EXTENSION_URN
        });
        userMap.put("userName", "test_user_001");
        userMap.put("password", "Test@123456");

        // 构造扩展属性
        Map<String, Object> extensionAttrs = new HashMap<>();
        // 自定义扩展属性，替换为你自己的属性名和值
        extensionAttrs.put("department", "研发部");
        extensionAttrs.put("employeeId", "EMP00123");
        extensionAttrs.put("position", "高级工程师");
        // 将扩展属性放入请求体，key为扩展Schema的URN
        userMap.put(EXTENSION_URN, extensionAttrs);

        // 构造请求
        String jsonBody = objectMapper.writeValueAsString(userMap);
        RequestBody body = RequestBody.create(jsonBody, MediaType.get("application/json; charset=utf-8"));
        String authHeader = "Basic " + Base64.getEncoder().encodeToString((ADMIN_USER + ":" + ADMIN_PWD).getBytes());
        Request request = new Request.Builder()
                .url(SCIM_USERS_URL)
                .method("POST", body)
                .addHeader("Authorization", authHeader)
                .build();

        // 执行请求获取返回
        try (Response response = client.newCall(request).execute()) {
            System.out.println("响应状态码：" + response.code());
            System.out.println("响应内容：" + response.body().string());
            if (response.isSuccessful()) {
                System.out.println("带扩展属性的用户创建成功");
            } else {
                System.out.println("用户创建失败，请检查扩展属性配置是否正确");
            }
        }
    }
}

注意事项 #

• 扩展属性的URN必须和WSO2 IS中配置的完全一致，大小写敏感
• 请求的schemas数组必须同时包含基础用户Schema和自定义扩展Schema，否则扩展属性不会生效
• 如果需要更新已有用户的扩展属性，调用PATCH方法请求https://<WSO2_IS_HOST>:<PORT>/scim2/Users/<用户ID>接口即可，请求体构造规则和新增一致
• 生产环境必须关闭SSL忽略配置，配置正规的证书校验逻辑，避免安全风险

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