查询租户的服务器安全配置检测结果列表
功能介绍
查询租户的服务器安全配置检测结果列表
URI
GET /v5/{project_id}/baseline/risk-configs
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enterprise_project_id | 否 | String | 企业项目ID,查询所有企业项目时填写:all_granted_eps |
| check_name | 否 | String | 配置检查(基线)的名称,例如SSH、CentOS 7、Windows |
| group_id | 否 | String | 策略组ID |
| severity | 否 | String | 风险等级,包含如下:
|
| standard | 否 | String | 标准类型,包含如下:
|
| host_id | 否 | String | 主机id |
| limit | 否 | Integer | 每页显示数量 |
| offset | 否 | Integer | 偏移量:指定返回记录的开始位置 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total_num | Long | 记录总数 |
| data_list | Array of SecurityCheckInfoResponseInfo objects | 服务器配置检测结果列表 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| severity | String | 风险等级,包含如下:
|
| check_name | String | 配置检查(基线)的名称,例如SSH、CentOS 7、Windows |
| check_type | String | 配置检查(基线)的类型,Linux系统支持的基线一般check_type和check_name相同,例如SSH、CentOS 7。 Windows系统支持的基线一般check_type和check_name不相同,例如check_name为Windows的配置检查(基线),它的check_type包含Windows Server 2019 R2、Windows Server 2016 R2等。 |
| standard | String | 标准类型,包含如下:
|
| check_rule_num | Integer | 当前配置检查(基线)类型下,用户共检测了多少个检查项。例如标准类型为hw_standard的SSH基线,主机安全提供了17个检查项,但用户所有主机都只检测了SSH基线的其中5个检查项,check_rule_num就是5。用户有一台主机进行了全量检查项检测,check_rule_num就是17。 |
| failed_rule_num | Integer | 未通过的检查项数量,check_rule_num中只要有一台主机没通过某个检查项,这个检查项就会被计算在failed_rule_num中 |
| host_num | Integer | 受影响的服务器的数量,进行了当前基线检测的服务器数量 |
| scan_time | Long | 最新检测时间(ms) |
| check_type_desc | String | 对配置检查(基线)类型的描述信息,概括当前基线包含的检查项是根据什么标准制定的,能够审计哪些方面的问题。 |
请求示例
查询企业项目id为xxx下的主机基线配置检测结果列表。默认返回第一页(前10条)数据。
GET https://{endpoint}/v5/{project_id}/baseline/risk-configs?enterprise_project_id=xxx 响应示例
状态码:200
请求已成功
{
"total_num" : 1,
"data_list" : [ {
"check_name" : "Docker",
"check_rule_num" : 25,
"check_type" : "Docker",
"check_type_desc" : "Configuring security audit of Docker's host configurations and container-running-related contents based on Docker Container Security Specifications V1_0.",
"failed_rule_num" : 20,
"host_num" : 0,
"scan_time" : 1661716860935,
"severity" : "High",
"standard" : "hw_standard"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
错误码
请参见错误码。