跳至主内容

获取账户详情

使用此方法可获取特定 GravityZone 账户的信息。

参数

参数

描述

包含于请求中

类型

取值

accountId

需要显示信息的账户ID。

可选

字符串

默认值：用于生成API密钥的 GravityZone 账户ID。

返回值

属性

类型

描述

email

字符串

该账户的电子邮箱地址。

profile

对象

该对象包含账户的个人资料信息：

  • fullName - 与该账户关联的用户全名。

  • language - 在 GravityZone 控制台中显示的语言。

  • timezone - 用户所在时区。

  • landingPage - 用户登录 GravityZone .

phoneNumber

对象

该对象包含账户的电话号码信息：

  • 国家代码 - 电话号码所在国家的前缀。

  • 用户号码 - 不含前缀的电话号码。

角色

整数

新账户的角色。

可选值：

  • 1 - 公司管理员

  • 2 - 网络管理员

  • 3 - 报告员

  • 4 - 合作伙伴

  • 5 - 自定义

有关用户角色及对应权限的详细信息，请参阅 用户角色

权限

对象

该对象包含用户账户关联的权限：

  • 管理公司 - 允许用户创建、删除、暂停客户公司，并管理其授权与安全。

  • 管理网络 - 提供以下网络安全设置的行政权限：

    • 网络资产清单

    • 策略

    • 任务

    • 安装包

    • 隔离区

  • 管理用户 - 允许用户为其所属公司创建、删除或编辑用户账户。

  • 管理报告 - 允许用户为其所属公司创建、查看和编辑报告。

  • 公司管理员 - 授予用户编辑公司资料设置及调整许可协议的权限。

  • 管理远程Shell - 允许用户在托管目标终端上启动远程Shell会话并执行高级取证操作。

  • 管理资产 - 提供对网络资产清单、任务、安装包和隔离项目的管理权限。

  • 读取策略 - 允许用户查看公司策略。

  • 编辑策略 - 允许用户创建和修改公司策略。

  • 管理MSP试用功能 - 允许用户访问并使用MSP试用中心功能。

密码有效期

整数

表示分配给用户账户的密码过期策略。

可选值：

  • 0 - 密码永不过期。

  • 90 - 密码每90天过期一次。

    提示

    密码过期后，所有者将无法继续使用该密码登录 GravityZone 并会被提示创建新密码。

accountLockdown

布尔值

表示用户账户是否会在5次失败尝试后被锁定。

twoFactorAuthenticationStatus

布尔值

表示用户账户是否启用了双因素认证（2FA）。

companyName

字符串

用户账户所属公司的名称。

companyId

字符串

用户账户所属公司的ID。

authenticationMethod

整数

用户登录所需的认证方式。

可能取值：

  • 0 - GravityZone凭据 GravityZone凭据

  • 1 - 身份提供商

  • 2 - GravityZone身份提供商

  • 3 - Vifor认证（已弃用）

  • -1 - 无效认证方式

hasOwnCompanyInTargets

布尔值

指示用户是否有权管理其所属公司。此设置等同于 选择目标 部分（该部分在 创建或编辑用户账户 时 GravityZone 中可见），表示用户可访问最高层级目标。

示例

请求 : 

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",    
    "method": "getAccountDetails",
    "params": {
      "accountId": "6718732309e2be32df0550c2"
    }
   }

响应 : 

{
  "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
  "jsonrpc": "2.0",
  "result": {
    "id": "6718732309e2be32df0550c2",
    "email": "customer2@email.com",
    "profile": {
      "fullName": "customer2",
      "language": "en_US",
      "timezone": "UTC",
      "landingPage": "dashboard"
    },
    "phoneNumber": {
      "countryCode": null,
      "subscriberNumber": null
    },
    "role": 1,
    "rights": {
      "manageCompanies": false,
      "manageInventory": true,
      "managePoliciesRead": true,
      "managePoliciesWrite": true,
      "manageUsers": true,
      "manageReports": true,
      "companyManager": true,
      "manageRemoteShell": true,
      "manageMspTrialFeatures": false
    },
    "passwordLifetime": 90,
    "accountLockdown": true,
    "twoFactorAuthenticationStatus": false,
    "companyName": "Customer_0_0",
    "companyId": "670fa2a2e0d7e2ea2907fec2",
  }
}"authenticationMethod" : 0,"hasOwnCompanyInTargets": true
  }
}
本节内容 :