WSO2 IS用户与角色管理API：如何通过用户名/邮箱查询特定用户？

嘿，我明白你在找什么了！在WSO2 Identity Server的《Managing Users and Roles with APIs》文档里，Manage User APIs确实没有单独提供一个“按用户名/邮箱获取单个用户”的专属端点，但你可以通过以下两种常用方式轻松实现需求：

方式1：使用Search Users API（推荐，适配最新IS版本） #

这是IS官方主推的用户搜索API，支持精确匹配用户名或邮箱：

• 请求端点：POST /api/server/v1/users/search
• 请求体示例（按用户名查询）：

  {
    "filter": "userName eq 'your_target_username'",
    "domain": "PRIMARY" // 可选，指定用户域，默认是PRIMARY
  }
  

• 请求体示例（按邮箱查询）：

  {
    "filter": "email eq 'user@example.com'",
    "domain": "PRIMARY"
  }
  

• 响应说明：因为用户名和邮箱在IS中默认是唯一约束，所以响应会返回仅包含目标用户的数组，直接取第一个元素即可。

方式2：使用SCIM 2.0 Users API #

如果你的IS版本支持SCIM 2.0（大部分5.x及以上版本都支持），也可以用这个标准API：

• 请求端点：GET /scim2/Users
• 请求参数示例（按用户名查询）：

  ?filter=userName eq "your_target_username"
  

• 请求参数示例（按邮箱查询）：

  ?filter=email eq "user@example.com"
  

• 注意：请求需要携带有效的认证令牌（比如Bearer Token），且发起请求的用户需要具备view-users权限。

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