List SSO Users


获取指定组织的 SSO 用户列表信息。

操作权限

应用被授权组织的 administrator 策略。

请求格式

GET https://{apigw-address}/enos-iam-service/v2.3/user/sso/list

请求参数(URI)

名称 位置(Path/Query) 必需/可选 数据类型 描述
orgId Query 必需 String SSO 用户所属的组织 ID。如何获取 orgId 信息>>
userName Query 可选 String SSO 用户的用户名。
email Query 可选 String SSO 用户的邮箱。
phone Query 可选 String SSO 用户的手机号码。

响应参数

名称 数据类型 描述
users SSO User 结构体数组 SSO 用户列表,参见 SSO User 结构体

SSO User 结构体

名称 数据类型 描述
id String SSO 用户 ID。
name String SSO 用户的用户名。
type Integer
用户身份类型。

1:普通用户

2:组织所有者

3:组织管理员

email String SSO 用户的邮箱。
emailVerified Boolean 邮箱是否绑定。
emailVerifiedAt String 邮箱绑定时间。
phoneArea String SSO 用户的手机号码的国码。
phone String SSO 用户的手机号码。
phoneVerified Boolean 手机号码是否绑定。
phoneVerifiedAt String 手机号码绑定时间。
organizationId String SSO 用户所属组织。
state Integer

账号状态。

  • 0:启用
  • 1:禁用
domain String 配置的 SSO 身份供应商名称。
authType Integer 用户类型,SSO 用户类型固定为 2。
createTime String SSO 用户的创建时间。
createdByUserId String 创建者 ID。
resourceId String SSO 用户在 IAM 中的资源 ID。
description String SSO 用户的描述。
passwordState Integer 密码状态,一般为 0。(不用的字段)
passwordExpireTime Long 密码过期时间,SSO 用户此值固定为 0。
extra Map 一般为空(不用的字段)

示例

请求示例

url: https://{apigw-address}/enos-iam-service/v2.3/user/sso/list?orgId=yourOrgId
method: GET

返回示例

{
  "fail": false,
  "success": true,
  "failed": false,
  "message": "",
  "users": [
    {
      "id": "userId",
      "name": "john",
      "type": 1,
      "email": "john@doe.com",
      "extra": {},
      "phone": "",
      "state": 0,
      "domain": "ssodemo",
      "authType": 2,
      "phoneArea": "86",
      "createTime": "2021-10-20 10:36:04.0",
      "resourceId": "rsrcId4695382",
      "description": "SSO USER",
      "emailVerified": true,
      "passwordState": 0,
      "phoneVerified": false,
      "organizationId": "orgId",
      "createdByUserId": "0",
      "emailVerifiedAt": "2021-10-20 10:36:04.0",
      "phoneVerifiedAt": "1970-01-01 00:00:00.0",
      "passwordExpireTime": 0
    },
    {
      "id": "userId2",
      "name": "jane",
      "type": 1,
      "email": "jane@doe.com",
      "extra": {},
      "phone": "1888888888",
      "state": 0,
      "domain": "ssodemo",
      "authType": 2,
      "phoneArea": "86",
      "createTime": "2021-10-20 10:29:45.0",
      "resourceId": "rsrcId9865829",
      "description": "SSO USER",
      "emailVerified": true,
      "passwordState": 0,
      "phoneVerified": false,
      "organizationId": "orgId",
      "createdByUserId": "0",
      "emailVerifiedAt": "2021-10-20 10:29:45.0",
      "phoneVerifiedAt": "1970-01-01 00:00:00.0",
      "passwordExpireTime": 0
    }
  ],
  "status": 0,
  "successful": true
}