如何在OKTA中获取特定用户组的用户列表 解决API调用4xx报错

正确实现步骤 #

1. 前置权限配置 #

首先确认你使用的Okta API令牌已分配okta.groups.read、okta.users.read权限，权限缺失会直接返回401/403类错误。

2. 查询目标用户组ID #

调用如下GET接口查询对应用户组的ID：
GET https://xxx.oktapreview.com/api/v1/groups?q={你的用户组名称}
请求要求：必须在Header中携带Authorization: SSWS 你的Okta API令牌，同时设置Accept: application/json
接口返回结果中取对应组的id字段值，即为后续需要用到的groupId。

3. 获取用户组下的用户列表 #

调用如下GET接口即可拿到指定组内的所有用户：
GET https://xxx.oktapreview.com/api/v1/groups/{替换为上一步获取的groupId}/users
如果需要对用户列表做过滤，可以追加filter参数，例如筛选活跃用户可使用：?filter=status eq "ACTIVE"

你之前请求4xx错误的常见原因 #

• 接口路径错误：/oauth2/前缀的端点为Okta授权服务端点，不用于用户/用户组资源查询；/api/v1/users//groups路径多写了斜杠属于无效路径
• 请求方法错误：所有资源查询接口均为GET方法，使用POST/PUT等其他方法请求会返回405错误
• 请求头缺失/错误：未携带带SSWS前缀的API令牌、Accept字段配置不符合要求都会返回400/401错误
• 权限不足：API令牌没有分配对应资源的读权限会返回403错误

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