跳至主内容

getMonitoredRuleData

您可通过此方法获取特定PHASR规则及其适用行为配置文件的详细信息。

发起请求的用户必须对规则ID所属公司具备网络管理员权限。

参数

名称

描述

请求包含项

类型

取值

companyId

指定规则所属公司的ID。

可选

字符串

默认值:请求所用API密钥关联的公司ID。

ruleId

需获取信息的规则ID。

必填

整数

无额外要求。

profileType

决定响应中包含哪些类型的行为画像。

可选

整数

可选值:

  • 1 - 使用工具的画像

  • 2 - 未使用工具的画像

  • 3 - 受自动驾驶限制的画像

  • 4 - 受直接控制限制的画像

默认值:若请求未包含该参数,将返回所有资源类型。

这些是公共API方法通用的参数。

参数

说明

是否包含在请求中

类型

取值

id

该参数为请求添加标识符,用于关联对应的响应。

目标方在响应中返回相同的值,便于调用追踪。

必填

字符串

无额外要求

method

用于发送请求的方法名称。

必填

字符串

必须是有效的方法名。

jsonrpc

请求与响应所使用的JSON-RPC版本。

必填

整数

可选值:

  • 2.0

params

包含请求配置的对象。

必填

对象

无额外要求。

params 对象

页码

结果页的页码。

可选

整数

默认值: 1

每页条数

每页显示的结果数量。

可选

整数

每页上限为100条。

默认值: 30

返回值

属性

类型

描述

页码

整数

当前显示的页码。

每页条数

整数

每页显示的结果数量。

总页数

整数

响应中包含的总页数。

总数

整数

响应中包含的行为画像总数。

profilesUsingSuchTools

Integer

响应中包含的行为配置文件中,显示使用规则所针对工具或技术迹象的数量。

profilesNotUsingSuchTools

Integer

响应中包含的行为配置文件中,未显示使用规则所针对工具或技术迹象的数量。

restrictedProfilesByAutopilot

Integer

响应中包含的行为配置文件中,该规则生成建议被自动应用的数量。

restrictedProfilesByDirectControl

Integer

响应中包含的行为配置文件中,该规则触发建议经人工审批后应用的数量。

items

Array of objects

提供与请求参数匹配的每个行为配置文件信息的对象列表。

Objects

items

Attribute

Type

Description

resourceName

String

与行为配置文件关联的设备名称。

resourceId

String

与行为配置文件关联设备的唯一标识符。

identityName

String

与行为配置文件关联的用户账户名称。

identityId

字符串

与行为档案关联的用户在系统中的唯一标识符。

departmentId

字符串

用户所属部门的唯一ID。

departmentName

字符串

用户所属部门的名称。

userSid

字符串

用户的系统安全标识符(SID)。

profileType

整数

行为档案的类型

示例

请求 :

{
    "params": {
      "companyId": "68306c15c9b5cb3e920ffe22",
      "ruleId": 61,
      "page": 1,
      "perPage": 2
    },
    "jsonrpc": "2.0",
    "method": "getMonitoredRuleData",
    "id": "d4d50719-3215-455a-a329-086fe77f6d72"
}

响应 :

{
  "id": "d4d50719-3215-455a-a329-086fe77f6d72",
  "jsonrpc": "2.0",
  "result": {
    "page": 1,
    "perPage": 2,
    "pagesCount": 10,
    "total": 19,
    "profilesUsingSuchTools": 1,
    "profilesNotUsingSuchTools": 9,
    "restrictedProfilesByAutopilot": 1,
    "restrictedProfilesByDirectControl": 1,
    "items": [
      {
        "resourceName": "CMOCANU-SELENIU",
        "resourceId": "6a7f1642-bdbc-810b-a42b-e04f2611c538-005056965bef",
        "identityName": "CMOCANU-SELENIU\\bdvm",
        "identityId": "Local_S-1-5-21-2018264366-2484004464-1617746128-1001_68308694de453e6a039e1f6d",
        "departmentId": "683072526ed41db183242348",
        "departmentName": "部门8",
        "userSid": "S-1-5-21-2018264366-2484004464-1617746128-1001",
        "profileType": 1
      },
      {
        "resourceName": "WIN-06",
        "resourceId": "62c11642-236f-e7bd-cf05-0f91f9346073-005056961e20",
        "identityName": "ROOT\\hr1",
        "identityId": "AD_S-1-5-21-4282359893-3999216301-2697700004-1108",
        "departmentId": "6834222e6ed41db1833ca84c",
        "departmentName": "部门7",
        "userSid": "S-1-5-21-4282359893-3999216301-2697700004-1108",
        "profileType": 2
      }
    ]
  }
}