查入侵事件列表
功能介绍
查入侵事件列表
URI
GET /v5/{project_id}/event/events
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
租户企业项目ID,查询所有企业项目时填写:all_granted_eps |
|
last_days |
否 |
Integer |
查询时间范围天数,与自定义查询时间begin_time,end_time互斥 |
|
host_name |
否 |
String |
服务器名称 |
|
host_id |
否 |
String |
服务器ID |
|
private_ip |
否 |
String |
服务器私有IP |
|
public_ip |
否 |
String |
服务器公网IP |
|
container_name |
否 |
String |
容器实例名称 |
|
offset |
否 |
Integer |
偏移量:指定返回记录的开始位置,必须为数字,取值范围为大于或等于0,默认0 |
|
limit |
否 |
Integer |
每页显示个数 |
|
event_types |
否 |
Array of integers |
事件类型,包含如下:
|
|
handle_status |
否 |
String |
处置状态,包含如下:
|
|
severity |
否 |
String |
威胁等级,包含如下:
|
|
category |
是 |
String |
事件类别,包含如下:
|
|
begin_time |
否 |
String |
自定义查询时间,与查询时间范围天数互斥,查询时间段的起始时间,毫秒级时间戳,end_time减去begin_time小于等于2天,与查询时间范围天数互斥 |
|
end_time |
否 |
String |
自定义时间,查询时间段的终止时间,毫秒级时间戳,end_time减去begin_time小于等于2天,与查询时间范围天数互斥 |
|
event_class_ids |
否 |
Array of strings |
事件标识,包含如下:
|
|
severity_list |
否 |
Array of strings |
威胁等级,包含如下:
|
|
attack_tag |
否 |
String |
攻击标识,包含如下:
|
|
asset_value |
否 |
String |
资产重要性,包含如下3种
|
|
tag_list |
否 |
Array of strings |
事件标签列表,例如:["热点事件"] |
|
att_ck |
否 |
String |
ATT&CK攻击阶,包含如下:
|
|
event_name |
否 |
String |
告警名称 |
|
auto_block |
否 |
Boolean |
是否自动阻断告警 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-auth-token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_num |
Integer |
总数 |
|
data_list |
Array of EventManagementResponseInfo objects |
事件列表详情 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
event_id |
String |
事件编号 |
|
event_class_id |
String |
事件分类,包含如下:
|
|
event_type |
Integer |
事件类型,包含如下:
|
|
event_name |
String |
事件名称 |
|
severity |
String |
威胁等级,包含如下:
|
|
container_name |
String |
容器实例名称 |
|
image_name |
String |
镜像名称 |
|
host_name |
String |
服务器名称 |
|
host_id |
String |
服务器ID |
|
private_ip |
String |
服务器私有IP |
|
public_ip |
String |
弹性公网IP地址 |
|
os_type |
String |
操作系统类型,包含如下2种。
|
|
host_status |
String |
服务器状态,包含如下4种。
|
|
agent_status |
String |
Agent状态,包含如下5种。
|
|
protect_status |
String |
防护状态,包含如下2种。
|
|
asset_value |
String |
资产重要性,包含如下4种
|
|
attack_phase |
String |
攻击阶段,包含如下:
|
|
attack_tag |
String |
攻击标识,包含如下:
|
|
occur_time |
Integer |
发生时间,毫秒 |
|
handle_time |
Integer |
处理时间,毫秒 |
|
handle_status |
String |
处理状态,包含如下:
|
|
handle_method |
String |
处理方式,包含如下:
|
|
handler |
String |
备注信息 |
|
operate_accept_list |
Array of strings |
支持的处理操作 |
|
operate_detail_list |
Array of EventDetailResponseInfo objects |
操作详情信息列表(页面不展示) |
|
forensic_info |
Object |
取证信息,json格式 |
|
resource_info |
EventResourceResponseInfo object |
资源信息 |
|
geo_info |
Object |
地理位置信息,json格式 |
|
malware_info |
Object |
恶意软件信息,json格式 |
|
network_info |
Object |
网络信息,json格式 |
|
app_info |
Object |
应用信息,json格式 |
|
system_info |
Object |
系统信息,json格式 |
|
extend_info |
Object |
事件扩展信息,json格式 |
|
recommendation |
String |
处置建议 |
|
description |
String |
告警说明 |
|
event_abstract |
String |
告警摘要 |
|
process_info_list |
Array of EventProcessResponseInfo objects |
进程信息列表 |
|
user_info_list |
Array of EventUserResponseInfo objects |
用户信息列表 |
|
file_info_list |
Array of EventFileResponseInfo objects |
文件信息列表 |
|
event_details |
String |
事件信息的简述 |
|
tag_list |
Array of strings |
标签列表 |
|
event_count |
Integer |
事件发生次数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
agent_id |
String |
Agent ID |
|
process_pid |
Integer |
进程id |
|
is_parent |
Boolean |
是否是父进程 |
|
file_hash |
String |
文件哈希 |
|
file_path |
String |
文件路径 |
|
file_attr |
String |
文件属性 |
|
private_ip |
String |
服务器私有IP |
|
login_ip |
String |
登录源IP |
|
login_user_name |
String |
登录用户名 |
|
keyword |
String |
告警事件关键字,仅用于告警白名单 |
|
hash |
String |
告警事件hash,仅用于告警白名单 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain_id |
String |
租户账号ID |
|
project_id |
String |
项目ID |
|
enterprise_project_id |
String |
企业项目ID |
|
region_name |
String |
Region名称 |
|
vpc_id |
String |
VPC ID |
|
cloud_id |
String |
云主机ID |
|
vm_name |
String |
虚拟机名称 |
|
vm_uuid |
String |
虚拟机UUID |
|
container_id |
String |
容器ID |
|
container_status |
String |
容器状态 |
|
pod_uid |
String |
pod uid |
|
pod_name |
String |
pod name |
|
namespace |
String |
namespace |
|
cluster_id |
String |
集群id |
|
cluster_name |
String |
集群名称 |
|
image_id |
String |
镜像ID |
|
image_name |
String |
镜像名称 |
|
host_attr |
String |
主机属性 |
|
service |
String |
业务服务 |
|
micro_service |
String |
微服务 |
|
sys_arch |
String |
系统CPU架构 |
|
os_bit |
String |
操作系统位数 |
|
os_type |
String |
操作系统类型 |
|
os_name |
String |
操作系统名称 |
|
os_version |
String |
操作系统版本 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
process_name |
String |
进程名称 |
|
process_path |
String |
进程文件路径 |
|
process_pid |
Integer |
进程id |
|
process_uid |
Integer |
进程用户id |
|
process_username |
String |
运行进程的用户名 |
|
process_cmdline |
String |
进程文件命令行 |
|
process_filename |
String |
进程文件名 |
|
process_start_time |
Long |
进程启动时间 |
|
process_gid |
Integer |
进程组ID |
|
process_egid |
Integer |
进程有效组ID |
|
process_euid |
Integer |
进程有效用户ID |
|
parent_process_name |
String |
父进程名称 |
|
parent_process_path |
String |
父进程文件路径 |
|
parent_process_pid |
Integer |
父进程id |
|
parent_process_uid |
Integer |
父进程用户id |
|
parent_process_cmdline |
String |
父进程文件命令行 |
|
parent_process_filename |
String |
父进程文件名 |
|
parent_process_start_time |
Long |
父进程启动时间 |
|
parent_process_gid |
Integer |
父进程组ID |
|
parent_process_egid |
Integer |
父进程有效组ID |
|
parent_process_euid |
Integer |
父进程有效用户ID |
|
child_process_name |
String |
子进程名称 |
|
child_process_path |
String |
子进程文件路径 |
|
child_process_pid |
Integer |
子进程id |
|
child_process_uid |
Integer |
子进程用户id |
|
child_process_cmdline |
String |
子进程文件命令行 |
|
child_process_filename |
String |
子进程文件名 |
|
child_process_start_time |
Long |
子进程启动时间 |
|
child_process_gid |
Integer |
子进程组ID |
|
child_process_egid |
Integer |
子进程有效组ID |
|
child_process_euid |
Integer |
子进程有效用户ID |
|
virt_cmd |
String |
虚拟化命令 |
|
virt_process_name |
String |
虚拟化进程名称 |
|
escape_mode |
String |
逃逸方式 |
|
escape_cmd |
String |
逃逸后后执行的命令 |
|
process_hash |
String |
进程启动文件hash |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
Integer |
用户uid |
|
user_gid |
Integer |
用户gid |
|
user_name |
String |
用户名称 |
|
user_group_name |
String |
用户组名称 |
|
user_home_dir |
String |
用户home目录 |
|
login_ip |
String |
用户登录ip |
|
service_type |
String |
登录的服务类型 |
|
service_port |
Integer |
登录服务端口 |
|
login_mode |
Integer |
登录方式 |
|
login_last_time |
Long |
用户最后一次登录时间 |
|
login_fail_count |
Integer |
用户登录失败次数 |
|
pwd_hash |
String |
口令hash |
|
pwd_with_fuzzing |
String |
匿名化处理后的口令 |
|
pwd_used_days |
Integer |
密码使用的天数 |
|
pwd_min_days |
Integer |
口令的最短有效期限 |
|
pwd_max_days |
Integer |
口令的最长有效期限 |
|
pwd_warn_left_days |
Integer |
口令无效时提前告警天数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
file_path |
String |
文件路径 |
|
file_alias |
String |
文件别名 |
|
file_size |
Integer |
文件大小 |
|
file_mtime |
Long |
文件最后一次修改时间 |
|
file_atime |
Long |
文件最后一次访问时间 |
|
file_ctime |
Long |
文件最后一次状态改变时间 |
|
file_hash |
String |
文件hash |
|
file_md5 |
String |
文件md5 |
|
file_sha256 |
String |
文件sha256 |
|
file_type |
String |
文件类型 |
|
file_content |
String |
文件内容 |
|
file_attr |
String |
文件属性 |
|
file_operation |
Integer |
文件操作类型 |
|
file_action |
String |
文件动作 |
|
file_change_attr |
String |
变更前后的属性 |
|
file_new_path |
String |
新文件路径 |
|
file_desc |
String |
文件描述 |
|
file_key_word |
String |
文件关键字 |
|
is_dir |
Boolean |
是否目录 |
|
fd_info |
String |
文件句柄信息 |
|
fd_count |
Integer |
文件句柄数量 |
请求示例
查询前50条企业项目为xxx下未处理的主机事件信息
GET https://{endpoint}/v5/{project_id}/event/events?offset=0&limit=50&handle_status=unhandled&category=host&enterprise_project_id=xxx
响应示例
状态码:200
入侵事件列表
{
"total_num" : 1,
"data_list" : [ {
"attack_phase" : "exploit",
"attack_tag" : "abnormal_behavior",
"event_class_id" : "lgin_1002",
"event_id" : "d8a12cf7-6a43-4cd6-92b4-aabf1e917",
"event_name" : "different locations",
"event_type" : 4004,
"forensic_info" : {
"country" : "中国",
"city" : "兰州市",
"ip" : "127.0.0.1",
"user" : "zhangsan",
"sub_division" : "甘肃省",
"city_id" : 3110
},
"handle_status" : "unhandled",
"host_name" : "xxx",
"occur_time" : 1661593036627,
"operate_accept_list" : [ "ignore" ],
"operate_detail_list" : [ {
"agent_id" : "c9bed5397db449ebdfba15e85fcfc36accee125c68954daf5cab0528bab59bd8",
"file_hash" : "e8b50f0b91e3dce0885ccc5902846b139d28108a0a7976c9b8d43154c5dbc44d",
"file_path" : "/usr/test",
"process_pid" : 3123,
"file_attr" : 33261,
"keyword" : "file_path=/usr/test",
"hash" : "e8b50f0b91e3dce0885ccc5902846b139d28108a0a7976c9b8d43154c5dbc44d",
"login_ip" : "127.0.0.1",
"private_ip" : "127.0.0.2",
"login_user_name" : "root",
"is_parent" : false
} ],
"private_ip" : "127.0.0.1",
"resource_info" : {
"region_name" : "",
"project_id" : "",
"enterprise_project_id" : "0",
"os_type" : "Linux",
"os_version" : "2.5",
"vm_name" : "",
"vm_uuid" : "71a15ecc",
"cloud_id" : "",
"container_id" : "",
"container_status" : "running / terminated",
"image_id" : "",
"pod_uid" : "",
"pod_name" : "",
"namespace" : "",
"cluster_id" : "",
"cluster_name" : ""
},
"severity" : "Medium",
"extend_info" : "",
"os_type" : "Linux",
"agent_status" : "online",
"asset_value" : "common",
"protect_status" : "opened",
"host_status" : "ACTIVE",
"event_details" : "file_path:/root/test",
"user_info_list" : [ {
"login_ip" : "",
"service_port" : 22,
"service_type" : "ssh",
"user_name" : "zhangsan",
"login_mode" : 0,
"login_last_time" : 1661593024,
"login_fail_count" : 0
} ],
"description" : "",
"event_abstract" : "",
"tag_list" : [ "热点事件" ]
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
入侵事件列表 |
错误码
请参见错误码。