资产指纹列表查询
更新时间 2025-12-24 15:47:42
最近更新时间: 2025-12-24 15:47:42
接口功能介绍
资产指纹列表查询
接口约束
已经签约安全卫士服务协议
URI
POST /v1/assert/list
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| sysType | 是 | Integer | 资产分类 1 端口 2 进程 3 账户信息 4 软件 14 自启动项 20 web服务 22对应计划任务 23对应数据库 24对应web框架 25 内核模块 26 环境变量 27 中间件 28 web站点 29 web应用 | 1 | |
| agentGuid | 否 | String | 主机ID | 1111-2222 | |
| port | 否 | String | 端口,中间件-端口,web站点-端口 | 3309 | |
| process | 否 | String | 进程名称 | test | |
| runUser | 否 | String | 运行用户名称 | test | |
| version | 否 | String | 版本,中间件-版本,web应用-版本 | 1.1.1 | |
| pid | 否 | String | 进程id,中间件-进程pid,web站点-进程pid,web应用-进程pid | 322 | |
| startParam | 否 | String | 启动参数 | /bin/test | |
| program | 否 | String | 软件名称 | test | |
| startPath | 否 | String | 软件启动路径 | /bin/test | |
| userName | 否 | String | 用户名称,环境变量-用户名,中间件-运行用户,web站点-运行用户, | root | |
| selfStart | 否 | String | 自启动项名称 | root | |
| webServer | 否 | String | web服务名称 | test-server | |
| paramType | 否 | Integer | 查询参数类型 1. 服务器名称;2.服务器ip | 1 | |
| param | 否 | String | 查询参数 | test | |
| currentPage | 是 | Integer | 分页当前页码 | 1 | |
| pageSize | 是 | Integer | 每页大小 | 10 | |
| framework | 否 | String | web框架名称 | test | |
| name | 否 | String | 内核模块-模块名称,环境变量-环境变量名,web应用-应用名称 | test | |
| isHighRiskPort | 否 | Integer | 是否高危端口 1-是 0-否 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| error | String | 返回码 | ||
| CTCSSCN_000000:成功 | ||||
| CTCSSCN_000001:失败 | ||||
| CTCSSCN_000003:用户未签署协议,安全卫士系统无法正常使用 | ||||
| CTCSSCN_000004:鉴权错误 | ||||
| CTCSSCN_000005:用户没有付费版配额,功能不可用 | CTCSSCN_000000 | |||
| message | String | 返回信息 | success | |
| returnObj | Object | 返回对象 | returnObj | |
| traceId | String | traceId | asaadasd11111 | |
| statusCode | String | 状态码 200-成功 | 200 | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 总数 | 100 | |
| list | Array of Objects | 结果集 | list | |
| pageNum | Integer | 当前页 | 1 | |
| pageSize | Integer | 每页的数量 | 10 | |
| 表 list |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| displayName | String | 实例名称 | test | |
| custName | String | 服务器名称 | test | |
| publicIp | String | 公网ip | 1.1.1.1 | |
| privateIp | String | 私网ip | 1.1.1.1 | |
| agentGuid | String | 主机id | 1111-2222 | |
| protocol | String | 网络协议 | TCP | |
| port | Integer | 端口,中间件-监听端口,web站点- 监听端口 | 3308 | |
| osType | String | 操作系统 | Linux | |
| ip | String | ip,中间件-监听ip | 1.1.1.1 | |
| process | String | 监听进程 | test.exe | |
| processPath | String | 进程路径 | c://test.exe | |
| processId | String | 进程id,中间件-进程id, web站点-进程id | 121 | |
| fatherProcess | Integer | 父进程号 | 1212 | |
| startParam | String | 启动参数 | /bin/test.sh | |
| startTime | String | 启动时间,中间件-启动时间, web站点-启动时间 | 2020-01-01 00:00:00 | |
| runUser | String | 运行用户 | test | |
| programName | String | 软件名称 | test | |
| version | String | 版本,中间件-版本,web应用-版本号 | 1.1 | |
| updateTime | String | 最后更新时间 | 2020-01-01 00:00:00 | |
| userName | String | 计划任务执行用户/账号名/环境变量-环境变量用户名,中间件-运行用户, web站点-运行用户 | test | |
| passwordFlag | Integer | 是否设置密码 0-未设置密码 1-已设置密码 | 0 | |
| userGroup | String | 用户组 | test | |
| lastTime | String | 上次登录时间 | 2020-01-01 00: | |
| expireTime | String | 到期时间 | 2020-01-01 00: | |
| loginIp | String | 上次登录IP | 1.1.1.1 | |
| selfStartName | String | 自启动项名称 | test | |
| selfStartStatus | Integer | 自启动项启动状态 0-未启动 1-启动 | 0 | |
| fileMd5 | String | 文件md5 | 111111111111111111111111111111111111111111111111111111111111111111 | |
| status | String | 状态,中间件-监听端口状态 LISTEN | LISTEN | |
| startPath | String | 启动路径,中间件-启动路径 | c://test.exe | |
| configFile | String | 配置文件 | c://test.exe | |
| installTime | String | 安装时间 | 2020-01-01 00 | |
| cmdline | String | 执行命令,计划任务-执行命令,中间件-启动命令行 | /bin/test.sh | |
| cycle | String | 任务周期,计划任务-任务周期 | 0 0 0 * * ? | |
| exeMd5 | String | 执行任务MD5 | 111111111111111111111111111111111111111111111111 | |
| versionCheck | String | 数据库- 版本验证信息,中间件-版本验证信息 | 111111111111111111111111111111111111111111111111 | |
| ppid | String | ppid | ||
| 数据库-父进程ID,中间件-父进程id | 1212 | |||
| language1 | String | 框架语言language1 | ||
| web框架-框架语言 | java | |||
| isAdmin | String | 管理员权限 isAdmin true-管理员权限,false-非管理员权限 | true | |
| name | String | 内核模块-模块名称,中间件-中间件名称,web应用-应用名称,环境变量-环境变量名 | test | |
| size | Integer | 内核模块-模块大小 | 1 | |
| path | String | 内核模块-模块路径,web 站点-web路径 | c://test.exe | |
| refCount | Integer | 内核模块-依赖模块数 | 1 | |
| envType | Integer | 环境变量-环境变量类型 1-系统变量 2-用户变量 | 1 | |
| envValue | String | 环境变量-环境变量值 | test | |
| middlewareType | Integer | 中间件-中间件类型,1-系统服务 2-软件库 3-jar包 4-DevOps应用 | 1 | |
| envVersion | String | 中间件-运行时环境版本 | ||
| domainName | String | web 站点-域名,web应用-站点域名 | ||
| siteType | String | web 站点-站点类型如: nginx, apache, tomcat, iis等。web应用-服务类型 (如: nginx, apache, tomcat, iis等) | ||
| mergedPath | String | web站点-容器路径 | ||
| webRoot | String | web站点-web根路径,web应用-web根路径 | ||
| dirMod | String | web站点-目录权限 (如: 755, 644等) | ||
| webPath | String | web应用-web路径 | ||
| pluginCount | Integer | web应用-插件数 | ||
| listenPorts | String | web站点-监听端口,多个,逗号分割 | ||
| shell | String | 账号-用户启用Shell;1-启用 0-未启用 | ||
| uidSid | String | 账号-UID/SID | ||
| isHighRiskPort | Integer | 端口-是否高危端口,1-是 0-不是 | ||
| itemType | Integer | 自启动项-自启动项类型0-自启动服务 | ||
| 1-其他 | ||||
| 2-其他 | ||||
| 3-预加载动态库 | ||||
| 4-Run注册表键 | ||||
| 5-开机启动文件夹 | ||||
| exeAttr | String | 进程-文件权限 (如: 755, 644等), | ||
| home | String | 账号-用户目录如/home/user |
枚举参数
无
请求示例
请求url
无
请求头header
{"Content-Type": "application/json"}
请求体body
{"sysType": 1, "agentGuid": "1111-2222", "port": "3309", "process": "test", "runUser": "test", "version": "1.1.1", "pid": "322", "startParam": "/bin/test", "program": "test", "startPath": "/bin/test", "userName": "root", "selfStart": "root", "webServer": "test-server", "paramType": 1, "param": "test", "currentPage": 1, "pageSize": 10, "framework": "test", "name": "test", "isHighRiskPort": ""}
响应示例
{"message": "success", "traceId": "asaadasd11111", "statusCode": "200", "error": "CTCSSCN_000000", "returnObj": {"total": 100, "list": [{"displayName": "test", "custName": "test", "publicIp": "1.1.1.1", "privateIp": "1.1.1.1", "agentGuid": "1111-2222", "protocol": "TCP", "port": 3308, "osType": "Linux", "ip": "1.1.1.1", "process": "test.exe", "processPath": "c://test.exe", "processId": "121", "fatherProcess": 1212, "startParam": "/bin/test.sh", "startTime": "2020-01-01 00:00:00", "runUser": "test", "programName": "test", "version": "1.1", "updateTime": "2020-01-01 00:00:00", "userName": "test", "passwordFlag": 0, "userGroup": "test", "lastTime": "2020-01-01 00:", "expireTime": "2020-01-01 00:", "loginIp": "1.1.1.1", "selfStartName": "test", "selfStartStatus": 0, "fileMd5": "111111111111111111111111111111111111111111111111111111111111111111", "status": "LISTEN", "startPath": "c://test.exe", "configFile": "c://test.exe", "installTime": "2020-01-01 00", "cmdline": "/bin/test.sh", "cycle": "0 0 0 * * ?", "exeMd5": "111111111111111111111111111111111111111111111111", "versionCheck": "111111111111111111111111111111111111111111111111", "ppid": "1212", "language1": "java", "isAdmin": "true", "name": "test", "size": 1, "path": "c://test.exe", "refCount": 1, "envType": 1, "envValue": "test", "middlewareType": 1, "envVersion": "", "domainName": "", "siteType": "", "mergedPath": "", "webRoot": "", "dirMod": "", "webPath": "", "pluginCount": "", "listenPorts": "", "shell": "", "uidSid": "", "isHighRiskPort": "", "itemType": "", "exeAttr": "", "home": ""}], "pageNum": 1, "pageSize": 10}}
状态码
请参考 状态码
错误码
请参考 错误码