安全云脑 SECMASTER-创建事件:请求参数
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
content-type |
是 |
String |
内容类型 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
data_object |
否 |
Incident object |
事件实体信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
version |
否 |
String |
事件对象的版本,该字段的值必须为云SSA服务确定的官方发布版本之一 |
id |
否 |
String |
事件唯一标识,UUID格式,最大36个字符 |
domain_id |
否 |
String |
数据投递后,被委托用户的domain_id |
region_id |
否 |
String |
数据投递后,被委托用户的region_id |
workspace_id |
否 |
String |
当前的工作空间id |
labels |
否 |
String |
标签,仅展示 |
environment |
否 |
environment object |
事件产生的环境坐标信息 |
data_source |
否 |
data_source object |
首次上报数据源 |
first_observed_time |
否 |
String |
首次发现时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
last_observed_time |
否 |
String |
最近发现时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
create_time |
否 |
String |
记录时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
arrive_time |
否 |
String |
接收时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
title |
否 |
String |
事件标题 |
description |
否 |
String |
事件描述信息 |
source_url |
否 |
String |
事件URL链接,指向数据源产品中有关当前事件说明的页面 |
count |
否 |
Integer |
事件发生次数 |
confidence |
否 |
Integer |
事件的置信度。置信度的定义旨在说明识别的行为或问题的可能性。 取值范围:0-100,0表示置信度为0%,100表示置信度为100% |
severity |
否 |
String |
严重性等级,取值范围:Tips | Low | Medium | High | Fatal 说明: 0: Tips – 未发现任何问题。 1: Low – 无需针对问题执行任何操作。 2: Medium – 问题需要处理,但不紧急。 3: High – 问题必须优先处理。 4: Fatal – 问题必须立即处理,以防止产生进一步的损害 |
criticality |
否 |
Integer |
关键性,是指事件涉及的资源的重要性级别。 取值范围:0-100,0表示资源不关键,100表示最关键资源 |
incident_type |
否 |
incident_type object |
事件分类,详细定义参考《告警事件类型定义》 |
network_list |
否 |
Array of network_list objects |
网络信息 |
resource_list |
否 |
Array of resource_list objects |
受影响资源 |
remediation |
否 |
remediation object |
补救措施 |
verification_state |
否 |
String |
验证状态,标识事件的准确性。可选类型如下: Unknown – 未知 True_Positive – 确认 False_Positive – 误报 默认填写Unknown |
handle_status |
否 |
String |
事件处理状态,可选类型如下: Open – 打开,默认 Block – 阻塞 Closed – 关闭 默认填写Open |
sla |
否 |
Integer |
约束闭环时间:设置风险接受持续时间。单位:小时 |
update_time |
否 |
String |
更新时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
close_time |
否 |
String |
关闭时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
ipdrr_phase |
否 |
String |
周期/处置阶段编号 Prepartion|Detection and Analysis|Containm,Eradication& Recovery|Post-Incident-Activity |
simulation |
否 |
String |
调试字段 |
actor |
否 |
String |
事件调查员 |
owner |
否 |
String |
责任人、服务责任人 |
creator |
否 |
String |
创建人 |
close_reason |
否 |
String |
关闭原因: 误检 - False detection 已解决 - Resolved 重复 - Repeated 其他 - Other |
close_comment |
否 |
String |
关闭评论 |
malware |
否 |
malware object |
恶意软件 |
system_info |
否 |
Object |
系统信息 |
process |
否 |
Array of process objects |
进程信息 |
user_info |
否 |
Array of user_info objects |
用户信息 |
file_info |
否 |
Array of file_info objects |
文件信息 |
system_alert_table |
否 |
Object |
事件管理列表的布局字段 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vendor_type |
否 |
String |
环境供应商 |
domain_id |
否 |
String |
租户id |
region_id |
否 |
String |
区域id,全局服务global |
cross_workspace_id |
否 |
String |
数据投递前的源工作空间id,在源空间下值为null,投递后为被委托用户的id |
project_id |
否 |
String |
项目id, 全局服务默认null |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
source_type |
否 |
Integer |
数据源类型,取值范围如下: 1 - 云上产品 2 - 第三方产品 3 - 租户私有产品 |
domain_id |
否 |
String |
数据源产品所属账号的id |
project_id |
否 |
String |
数据源产品所属项目的id |
region_id |
否 |
String |
数据源产品所在区域,具体取值范围查看云地区和终端节点定义,例如cn-north-1 |
company_name |
否 |
String |
数据源产品所属公司的名称 |
product_name |
否 |
String |
数据源产品的名称 |
product_feature |
否 |
String |
产品功能特性名称,用来指明检测到当前事件的产品的功能特性 |
product_module |
否 |
String |
检测模块列表 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
direction |
否 |
String |
方向,取值范围:IN | OUT |
protocol |
否 |
String |
协议,包含7层和4层的协议 参考:IANA registered name https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml |
src_ip |
否 |
String |
源IP地址 |
src_port |
否 |
Integer |
源端口,0–65535 |
src_domain |
否 |
String |
源 域名 |
src_geo |
否 |
src_geo object |
源IP的地理位置信息 |
dest_ip |
否 |
String |
目的IP地址 |
dest_port |
否 |
String |
目的端口,0–65535 |
dest_domain |
否 |
String |
目的域名 |
dest_geo |
否 |
dest_geo object |
目标IP的地理位置信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
latitude |
否 |
Number |
纬度 |
longitude |
否 |
Number |
经度 |
city_code |
否 |
String |
城市编码,Beijing | Shanghai |
country_code |
否 |
String |
国家简码,参考ISO 3166-1 alpha-2,例如:CN | US | DE | IT | SG |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
latitude |
否 |
Number |
纬度 |
longitude |
否 |
Number |
经度 |
city_code |
否 |
String |
城市编码,Beijing | Shanghai |
country_code |
否 |
String |
国家简码,参考ISO 3166-1 alpha-2,例如:CN | US | DE | IT | SG |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
云服务资源id |
name |
否 |
String |
资源名称 |
type |
否 |
String |
资源类型;引用云 RMS type字段 |
provider |
否 |
String |
云服务名称;引用云RMS provider字段 |
region_id |
否 |
String |
区域;按照云regionId填写,如cn-north-1等 |
domain_id |
否 |
String |
资源所属账号ID,UUID格式 |
project_id |
否 |
String |
资源所属项目ID,UUID格式 |
ep_id |
否 |
String |
企业项目id |
ep_name |
否 |
String |
企业项目名称 |
tags |
否 |
String |
资源标签 1、最多50个key/values对 2、values:最大255字符,取值范围:字母数字,空格,+, -, =, ., _, :, /,@ |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
recommendation |
否 |
String |
推荐处理方法 |
url |
否 |
String |
链接,指向该事件的一般修复信息。该URL必须可以从公网访问,不需要提供凭证 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
process_name |
否 |
String |
进程名 |
process_path |
否 |
String |
进程执行文件路径 |
process_pid |
否 |
Integer |
进程id |
process_uid |
否 |
Integer |
进程用户id |
process_cmdline |
否 |
String |
进程命令行 |
process_parent_name |
否 |
String |
父进程名称 |
process_parent_path |
否 |
String |
父进程执行文件路径 |
process_parent_pid |
否 |
Integer |
父进程id |
process_parent_uid |
否 |
Integer |
父进程用户id |
process_parent_cmdline |
否 |
String |
父进程命令行 |
process_child_name |
否 |
String |
子进程名称 |
process_child_path |
否 |
String |
子进程执行文件路径 |
process_child_pid |
否 |
Integer |
子进程id |
process_child_uid |
否 |
Integer |
子进程用户id |
process_child_cmdline |
否 |
String |
子进程命令行 |
process_launche_time |
否 |
String |
进程启动时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |
process_terminate_time |
否 |
String |
进程结束时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区 |