跳至主内容

getMonitoredRuleData

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

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

参数

名称

描述

请求包含项

类型

取值

companyId

指定规则所属公司的ID。

可选

字符串

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

规则ID

需要获取信息的规则ID。

必填

整数

无额外要求。

配置文件类型

决定响应中包含的行为配置文件类型。

可选

整数

可选值:

  • 1 - 使用工具的配置文件

  • 2 - 未使用工具的配置文件

  • 3 - 受自动驾驶限制的配置文件

  • 4 - 受直接控制限制的配置文件

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

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

参数

描述

包含于请求中

类型

取值

id

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

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

必填

字符串

无额外要求

method

发起请求所调用的方法名称。

必填

字符串

必须是有效的方法名。

jsonrpc

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

必填

整数

可选值:

  • 2.0

params

包含请求配置参数的对象。

必填

对象

无额外要求。

params 对象下

page

结果页码。

可选

整数

默认值: 1

perPage

每页显示的结果数量。

可选

整数

每页上限为100项。

默认值: 30

返回值

属性

类型

描述

page

整数

当前显示的页码。

perPage

整数

每页显示的结果数量。

pagesCount

整数

响应中包含的总页数。

total

整数

响应中包含的行为配置文件总数。

profilesUsingSuchTools

整数

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

profilesNotUsingSuchTools

整数

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

restrictedProfilesByAutopilot

整数

响应中自动应用本规则生成建议的行为配置文件数量。

restrictedProfilesByDirectControl

整数

响应中经手动批准后应用本规则触发建议的行为配置文件数量。

items

对象数组

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

对象

items

属性

类型

描述

resourceName

字符串

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

resourceId

字符串

与行为档案关联设备的唯一标识符。

identityName

字符串

与行为档案关联的用户账户名称。

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
      }
    ]
  }
}