接口功能介绍
统计最近一次弱口令检测扫描出的信息。
接口约束
此功能为收费功能。确认已经购买系统配额，并且开启服务器防护。如果没有购买配额，可按照页面提示进行购买。如果没有开启防护，请在服务器列表页开启机器防护。
URI
POST /v1/weakpw/group
路径参数
无
Query参数
无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 请求地址类型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| currentPage | 是 | Integer | 当前页 | 1 | |
| pageSize | 是 | Integer | 每页条数 | 10 | |
| param | 否 | String | 可为空 | test | |
| checkType | 否 | Integer | 1：系统弱口令:2：应用弱口令，默认为系统弱口令 | 1 | |
| agentGuid | 是 | String | 机器guid | 7D24FF9B-28E8-2636-87ED-407F577CCF4E |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 200-成功 | ||
| error | String | 返回码 CTCSSCN_000000：成功 CTCSSCN_000001：失败 CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用 CTCSSCN_000004：鉴权错误 CTCSSCN_000005：用户没有付费版配额，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回对象 | map |
表 map
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 记录总数 | 5 | |
| pageSize | Integer | 页大小 | 10 | |
| pageNum | Integer | 当前页 | 1 | |
| pages | Integer | 总页数 | 1 | |
| list | Array of Objects | 弱口令列表信息 | serverlist |
表 serverlist
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| agentIp | String | 私网IP | 172.31.0.71 | |
| publicIp | String | 公网IP | 172.31.0.71 | |
| custName | String | 服务器名称 | vm-1634888455-0003 | |
| agentGuid | String | agentGuid | 2F828AAE-55BF-410D-B393-C053AC8742F4 | |
| userName | String | 用户名 | test | |
| weakType | String | 弱口令类型 | 常见弱密码 | |
| passwd | String | 密码值 | D*** | |
| timestamp | String | 最后更新时间 | 2022-07-08 17:12:01 | |
| findTime | String | 发现时间 | 2022-07-08 17:12:01 | |
| app | String | 应用 | mysql | |
| version | String | 应用版本 | 3.2.1 |
枚举参数
无
请求示例
请求url
无
请求头header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
请求体body
{"checkType":1,"currentPage":1,"pageSize":10,"agentGuid":"11-22"}
响应示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查询成功!","returnObj":{"total": 15,"list": [{"custName": "vm-76","publicIp": null,"agentIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","userName": "test","findTime": "2022-10-09 10:16:38","timestamp": "2022-10-18 15:44:55","weakType": "Common weak password","passwd": "1***","app": null,"version": null},{"custName": "vm-27","publicIp": null,"agentIp": "192.168.0.27","agentGuid": "DAF3C42D-4983-4CBC-ABA5-0A06DA93F209","userName": "test","findTime": "2022-10-08 17:52:57","timestamp": "2022-10-09 10:16:51","weakType": "Common weak password","passwd": "1***","app": null,"version": null},{"custName": "Ubuntu1804-az1-1","publicIp": null,"agentIp": "192.168.0.7","agentGuid": "8BD932FF-903A-5CF6-547C-35263BF370E2","userName": "test","findTime": "2022-05-30 22:12:51","timestamp": "2022-08-13 16:02:05","weakType": "Common weak password","passwd": "1***","app": null,"version": null},{"custName": "Ubuntu1804-az1-1","publicIp": null,"agentIp": "192.168.0.7","agentGuid": "8BD932FF-903A-5CF6-547C-35263BF370E2","userName": "user1","findTime": "2022-05-30 22:12:51","timestamp": "2022-08-13 16:02:05","weakType": "Common weak password","passwd": "a***","app": null,"version": null},{"custName": "win2008-az1-1","publicIp": null,"agentIp": "192.168.0.9","agentGuid": "E01D1506-5095-E2DA-4DA5-6095BA687768","userName": "test","findTime": "2022-06-16 11:20:37","timestamp": "2022-08-13 16:00:09","weakType": "Common weak password","passwd": "A***","app": null,"version": null},{"custName": "win2012-az1-1","publicIp": null,"agentIp": "192.168.0.8","agentGuid": "2AE09314-D89E-24B2-F22E-9E4687A23A00","userName": "test","findTime": "2022-06-16 11:20:35","timestamp": "2022-08-13 16:00:09","weakType": "Common weak password","passwd": "A***","app": null,"version": null},{"custName": "win2016-az1-1","publicIp": null,"agentIp": "192.168.0.10","agentGuid": "FD48D74A-83A0-2C0B-E48D-81EDE3BA36C3","userName": "test","findTime": "2022-06-16 11:20:36","timestamp": "2022-08-13 16:00:06","weakType": "Common weak password","passwd": "a***","app": null,"version": null},{"custName": "win2019-az1-1","publicIp": null,"agentIp": "192.168.0.11","agentGuid": "0C5CAEA9-39BC-FC86-2EE9-9EEB5F64DFCC","userName": "test","findTime": "2022-06-16 15:59:58","timestamp": "2022-08-13 16:00:06","weakType": "Common weak password","passwd": "a***","app": null,"version": null},{"custName": "Ubuntu1804-az1-2","publicIp": null,"agentIp": "192.168.0.15","agentGuid": "C10B11E9-367C-A9F1-9111-B7E1222523D1","userName": "ruo","findTime": "2022-05-26 17:07:48","timestamp": "2022-08-13 15:54:51","weakType": "Common weak password","passwd": "1***","app": null,"version": null},{"custName": "Ubuntu1804-az1-2","publicIp": null,"agentIp": "192.168.0.15","agentGuid": "C10B11E9-367C-A9F1-9111-B7E1222523D1","userName": "test","findTime": "2022-05-24 20:18:01","timestamp": "2022-08-13 15:54:51","weakType": "Common weak password","passwd": "1***","app": null,"version": null}],"pageNum": 1,"pageSize": 10,"size": 0,"startRow": 0,"endRow": 0,"pages": 2,"prePage": 0,"nextPage": 0,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": false,"hasNextPage": false,"navigatePages": 0,"navigatepageNums": null,"navigateFirstPage": 0,"navigateLastPage": 0}}
状态码
请参考 状态码
错误码
请参考 错误码
