接口功能介绍
资产指纹列表查询
接口约束
无
URI
POST /v1/assert/list
路径参数
无
Query参数
无
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
userid | 是 | String | 用户id | 3416ab34d51e43bd97bc32b23ffbb443 | |
accountid | 是 | String | 账户id | 9e471e00e1c6485192b4478c96a14254 | |
regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
accessKey | 是 | String | 鉴权公钥(安全卫士系统提供) | 18ee9b6b63e411e8b4a7186590d96509 | |
contentMD5 | 是 | String | 参数MD5值。默认使用空字符（""）计算 | 1B2M2Y8AsgTpgAmY7PhCfg== | |
requestDate | 是 | String | 请求时间 | Mon, 29 Aug 2022 00:59:26 UTC | |
hmac | 是 | String | 使用HMAC算法生成信息摘要。HMAC原始信息中需要的字段：使用HMAC加密是，需要密钥和待加密消息。 1.密钥使用接口方提供的secretKey，作为加密密钥。 2.待加密消息：contentMD5、requestDate 、servicePath；三个部分通过"\n"进行连接。连接顺序contentMD5\nrequestDate\nservicePath： | mTOyK30c+4Poit2857iXCb8N7Qc= | |
urlType | 否 | String | 请求地址类型。EOPAPI（默认），CTAPI，API | EOPAPI |
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
currentPage | 是 | Integer | 当前页 | 1 | |
pageSize | 是 | Integer | 每页记录数 | 10 | |
sysType | 是 | Integer | 资产类型： 1：端口。 2：进程。 3：账号。 4：软件。 | 1 | |
paramType | 否 | String | 参数类型： 1：服务器名称。 2：服务器ip。 | ||
param | 否 | String | 参数值（配合paramType使用） | ||
agentGuid | 否 | String | 不传查全部 | ||
sendCommand | 是 | Integer | 是否下发命令： 0：不下发。 1：下发。 | ||
port | 否 | String | 端口查询 | ||
userName | 否 | String | 用户名 | ||
process | 否 | String | 进程名 | ||
program | 否 | String | 软件名称 |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
code | 是 | String | 返回码。取值范围： 0：成功。 -1：失败。 -3：用户未签署协议，安全卫士系统无法正常使用。 -4：鉴权错误。 -5：用户没有付费版配额，功能不可用。 | 0 | |
message | 是 | String | 返回信息 | 成功 | |
data | 是 | Object | 返回对象 | pageInfo |
表pageInfo
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
pageNum | 是 | Integer | 当前页 | 1 | |
pageSize | 是 | Integer | 每页记录数 | 10 | |
pages | 是 | Integer | 总页数 | 2 | |
total | 是 | Integer | 总记录数 | 20 | |
isFirstPage | 是 | boolean | 是否为首页 | false | |
isLastPage | 是 | boolean | 是否为末页 | false | |
list | 是 | Object | 列表 | list |
表list
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
custName | 是 | String | 服务器名称 | CentOS76-az1-2 | |
agentGuid | 是 | String | 服务器id | F5283205-CB2C-45E6-8629-9D5DB63D3AC3 | |
publicIp | 是 | String | 服务器公网ip | 172.18.208.172 | |
privateIp | 是 | String | 服务器ip | 172.18.208.172 | |
osType | 是 | String | 操作系统 | linux | |
userName | 否 | String | 用户名（账户部分） | test | |
passwordFlag | 否 | Integer | 是否设置密码： 1：是。 0：否（账户部分）。 | 1 | |
userGroup | 否 | String | 用户组（账户部分） | test | |
expireTime | 否 | String | 到期时间（账户部分） | never：永不过期。2022-10-10 15:08:38 | |
lastTime | 否 | String | 上次登录时间（账户部分） | 2022-10-10 15:08:38 | |
loginIp | 否 | String | 上次登录ip（账户部分） | ||
protocol | 否 | String | 网络协议（端口部分） | ||
port | 否 | String | 端口号（端口部分） | ||
ip | 否 | String | 监听IP（端口部分） | ||
process | 否 | String | 监听进程|进程名（端口部分|进程部分） | ||
programName | 否 | String | 软件名称（软件部分） | ||
version | 否 | String | 软件版本（软件部分） | ||
updateTime | 否 | String | 最后更新时间（软件部分） | ||
processPath | 否 | String | 进程路径（进程部分） | ||
processId | 否 | String | 进程号（进程部分） | ||
fatherProcess | 否 | Integer | 父进程（进程部分） | ||
startParam | 否 | String | 启动参数（进程部分） | ||
startTime | 否 | String | 启动时间（进程部分） | ||
runUser | 否 | String | 运行用户（进程部分） |
请求示例
请求头header
{
"userid": "3416ab34d51e43bd97bc32b23ffbb443",
"accountid": "9e471e00e1c6485192b4478c96a14254",
"regionid": "100054c0416811e9a6690242ac110002",
"accessKey": "18ee9b6b63e411e8b4a7186590d96509",
"contentMD5": "1B2M2Y8AsgTpgAmY7PhCfg==",
"hmac": "mTOyK30c+4Poit2857iXCb8N7Qc=",
"requestDate": "Mon, 29 Aug 2022 00:59:26 UTC"
}
请求体body
{
"currentPage":1,
"pageSize":10,
"sysType":3,
"sendCommand":0
}
响应示例
{
"code": "0",
"message": "成功!",
"data": {
"total": 93,
"list": [
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "test",
"passwordFlag": 1,
"userGroup": "test",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "secure",
"passwordFlag": 1,
"userGroup": "wheel",
"lastTime": "2022-10-10 15:08:38",
"expireTime": "never",
"loginIp": "192.168.0.126"
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "polkitd",
"passwordFlag": 0,
"userGroup": "polkitd",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "dbus",
"passwordFlag": 0,
"userGroup": "dbus",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "systemd-network",
"passwordFlag": 0,
"userGroup": "systemd-network",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "nobody",
"passwordFlag": 0,
"userGroup": "nobody",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "ftp",
"passwordFlag": 0,
"userGroup": "ftp",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "games",
"passwordFlag": 0,
"userGroup": "users",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "adm",
"passwordFlag": 0,
"userGroup": "adm",
"lastTime": null,
"expireTime": "never",
"loginIp": null
},
{
"custName": "vm-76",
"publicIp": null,
"privateIp": "192.168.0.76",
"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C",
"protocol": null,
"port": null,
"osType": "linux",
"ip": null,
"process": null,
"processPath": null,
"processId": null,
"fatherProcess": null,
"startParam": null,
"startTime": null,
"runUser": null,
"programName": null,
"version": null,
"updateTime": null,
"userName": "daemon",
"passwordFlag": 0,
"userGroup": "daemon",
"lastTime": null,
"expireTime": "never",
"loginIp": null
}
],
"pageNum": 1,
"pageSize": 10,
"size": 0,
"startRow": 0,
"endRow": 0,
"pages": 10,
"prePage": 0,
"nextPage": 0,
"isFirstPage": false,
"isLastPage": false,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 0,
"navigatepageNums": null,
"navigateFirstPage": 0,
"navigateLastPage": 0
}
}
状态码
状态码 | 描述 |
200 | 表示请求成功。 |
错误码
请参考错误码说明。
