查入侵事件列表
功能介绍
查入侵事件列表
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 |
入侵事件列表 |
错误码
请参见错误码。