WSO2 APIM扩展组ID提取器及自定义用户声明技术咨询

我正尝试在WSO2 APIM中为应用用户映射使用自定义组ID，目前参考官方文档中扩展组ID提取器的内容。根据要求，需扩展NewPostLoginExecutor并覆写方法：

String[] getGroupingIdentifierList(String response);

但文档中关于Maven依赖的信息较少，希望获取该依赖的具体使用详情；同时也希望了解「将自定义用户声明定义为组提取器声明URI」部分的实操方法。

一、Maven依赖配置 #

1. 核心依赖引入 #

在项目的pom.xml中添加以下依赖（注意替换为你使用的APIM版本，示例以4.2.0为例）：

<dependencies>
    <!-- WSO2 APIM网关核心依赖 -->
    <dependency>
        <groupId>org.wso2.carbon.apimgt</groupId>
        <artifactId>org.wso2.carbon.apimgt.gateway</artifactId>
        <version>4.2.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- WSO2身份认证框架依赖 -->
    <dependency>
        <groupId>org.wso2.carbon.identity.framework</groupId>
        <artifactId>org.wso2.carbon.identity.application.authentication.framework</artifactId>
        <version>5.20.240</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

• scope设为provided是因为这些依赖在WSO2 APIM服务器中已内置，打包时无需包含，避免版本冲突。
• 版本号需与你的APIM版本匹配，可在APIM安装目录下的repository/components/plugins中查看对应jar包的版本。

2. WSO2 Maven仓库配置 #

在pom.xml中添加WSO2官方仓库，确保依赖能正常拉取：

<repositories>
    <repository>
        <id>wso2-public</id>
        <url>https://maven.wso2.org/nexus/content/groups/public/</url>
    </repository>
</repositories>

二、自定义用户声明实操步骤 #

1. 创建自定义用户声明 #

1. 登录WSO2 APIM管理控制台（https://<APIM_HOST>:9443/carbon）
2. 左侧导航栏进入Identity > Claims > Add
3. 填写声明信息：
   • Claim URI：自定义唯一URI，比如http://wso2.org/claims/custom/groupid
   • Display Name：自定义组ID
   • Description：用于应用用户映射的自定义组标识符
   • Supported By：勾选Default和Local Claim
4. 点击Add保存声明

2. 映射声明到用户存储 #

1. 进入Identity > Claims > List，找到刚创建的声明，点击Edit
2. 切换到Mappings标签页，选择目标用户存储（比如PRIMARY）
3. 在Attribute Mapping字段填写用户存储中对应的组ID字段名（例如数据库表中的custom_group_id）
4. 点击Update保存映射

3. 配置组提取器声明URI #

1. 进入API > Publishers > Settings > Application Settings
2. 在Group Extractor Claim URI字段填入之前创建的声明URI：http://wso2.org/claims/custom/groupid
3. 保存配置后，重启WSO2 APIM服务器使设置生效

4. 验证自定义组ID提取 #

在扩展的NewPostLoginExecutor类中，从响应中解析自定义组ID并返回，示例代码：

@Override
public String[] getGroupingIdentifierList(String response) {
    // 从登录响应（通常是JWT或JSON格式）中提取自定义组ID
    JSONObject jsonResponse = new JSONObject(response);
    String customGroupId = jsonResponse.getJSONObject("claims")
                                      .getString("http://wso2.org/claims/custom/groupid");
    return new String[]{customGroupId};
}

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