风险事件字段说明

更新时间:
复制 MD 格式

风险事件字段说明面向需要配置风险通知、编写二次分析逻辑或对接外部安全系统的用户。本文说明高保真安全事件表 incident-event 的字段含义,以及可使用的 risk_type、risk_subtype、data_exposure_surface 和 operation_stage 枚举。字段和值可能随产品演进扩展,请以控制台展示和实际返回结果为准。

说明

本文中的示例值均为脱敏、合成或文档化占位内容,用于说明字段形态和风险语义,不代表真实用户数据,也不等同于完整检测条件。实际事件中的敏感值可能经过采集侧脱敏、截断或摘要化处理。

incident-event 表示经过规则关联、过滤或提升后的高保真安全事件。一行事件通常已经具备明确的证据位置、风险主体、严重性和调查入口,适合作为风险审计明细、通知配置、自动化处置和二次开发的输入。它不保存处置状态,也不等同于工单或通知对象;如果需要处置流转,应在上层系统中基于这些字段再做聚合和状态管理。

字段说明

字段

类型

说明

incident_event_id

string

高保真安全事件主键。该字段按确定性规则生成,适合用于去重、幂等写入和外部系统引用。

event_name

string

高保真事件名,固定采用 incident.<risk_type> 形式。来源事件类型、数据暴露位置和操作阶段不会编码进该字段。

source_scope

enum

数据来源范围,取值为 application 或 runtime,分别表示应用侧审计和运行时审计。

time_unix_nano

int64

事件生成或证据链归并时间,单位为纳秒。页面查询仍以日志时间窗口过滤为准,该字段主要用于事实语义时间和证据回捞。

service_name

string

应用或服务名,无法明确时可为空或使用占位值。

agent_type

string

Agent 类型,例如 qoder、cursor、claude-code 等。

user

string

用户实体的平铺查询列,优先取自 user.id。适合按用户筛选和分组。

host

string

主机实体的平铺查询列,优先取自 host.name;host.name 为空或缺失时,兼容使用 __tag__:__hostname__。

source_ip

string

Agent 主机 IP 实体的平铺查询列,优先取自 host.ip;host.ip 为空或缺失时,兼容使用 __source__。该字段不表示网络对端或外联目标。

severity

enum

风险严重性,表示风险成立后可能造成的影响,从高到低取 critical、high、medium、low,页面上对应严重、高危、中危和低危。

confidence

number

系统对当前风险判断的确定程度,取值为 0 到 1。取值由相应的检测规则和当前证据确定。

risk_type

string

风险类型,对应产品中的主分类。该字段是配置风险筛选、通知规则和二次分析时最常用的分类字段。

risk_subtype

string

风险子类,在所属 risk_type 下标识具体风险事实。对于敏感数据暴露事件,它通常表示敏感数据类型;对于敏感文件变更事件,它通常表示文件类型和动作。

data_exposure_surface

enum

敏感数据的暴露位置,可为空;取 agent_input、model_input、model_output、tool_input、tool_output、agent_output 或 network_egress。该字段不表示操作是否已执行。

operation_stage

enum

当前证据能够确认的操作阶段,可为空;取 intent、invoked、executed 或 completed。历史空值显示为“阶段未记录”;该字段不表示操作成功或失败。

risk_signature

string

精确风险签名,用于识别同一个具体风险实例。适合做单个风险的去重、明细聚合和复现定位。

risk_family_key

string

同类风险聚合键,用于把同一类风险合并展示,适合风险队列、趋势和影响面分析。

reason

string

风险判定理由或证据摘要,可为空。由模型或其他语义研判生成的事件通常使用该字段说明风险为何成立。

evidence_security_event_ids

string[]

支撑该事件的低保真安全发现 ID 数组。

evidence_event_ids

string[]

支撑该事件的原始活动事件 ID 数组。

evidence_session_id

string

事件归属的证据 Session。incident-event 不保存顶层 session_id,Session 下钻和统计应使用该字段。

evidence_subject_type

string

证据主体类型,用于描述事件主要关联的主体类别。

evidence_subject_value

string

证据主体值,与 evidence_subject_type 配合使用。

evidence_subject_key

string

证据主体稳定键,用于更可靠地关联主体。

evidence_values

object[]

结构化证据值数组,例如命中的敏感类型、脱敏后的值、文件路径、命令片段、外发目标等。

entities

object[]

关键风险实体快照,例如应用、用户、主机、Agent 主机 IP、工具、域名、目标 IP、Secret、PII、文件路径或命令实体。多信号晋升事件应合并所有关键实体。

detector_name

string

生成该事件的检测器或服务名称。

detector_version

string

检测器或服务版本。

user、host 和 source_ip 适合直接筛选和分组;多实体关系和精确实体反查仍应使用 entities。历史记录无法提取对应值时,这些平铺列可为空。

常见字段示例

字段

示例值

说明

incident_event_id

incident_application_7f3a...

具体格式由系统生成,外部系统只需把它作为稳定 ID 使用。

source_scope

application、runtime

表示事件来自应用侧审计还是运行时审计。

user / host / source_ip

alice / demo-host / 10.0.1.42

分别表示用户、Agent 运行主机和 Agent 主机 IP,可直接用于常用筛选和分组。

risk_type

sensitive_data_exposure、destructive_action

表示风险动作或高保真事件类型。

risk_subtype

secret.cloud_access_key、ssh_private_key.delete、resource_delete

表示敏感数据类型、敏感文件类型与动作,或其他具体风险事实。

severity

critical、high、medium、low

用于处置优先级,不建议脱离 risk_type 单独使用。

confidence

0.90

表示事件证据链成熟度和规则确定性。

data_exposure_surface

network_egress

表示敏感数据与明确的外部目标同时出现在一次工具操作中,不表示数据已发送成功。

operation_stage

intent、invoked、executed、completed

表示当前证据能够确认的操作阶段。

evidence_session_id

sess-20240630-demo

用于跳转 Session 浏览或回捞上下文。

evidence_values

[{"field":"gen_ai.tool.call.arguments","value":"[ACCESSKEY_MASKED]","label":"secret.cloud_access_key","role":"sensitive_data"}]

用于展示具体证据。示例中的值是脱敏标记,实际值可能按采集策略脱敏。

entities

[{"type":"domain","value":"example.com"},{"type":"secret","value":"secret.cloud_access_key"}]

用于表达关键风险主体,例如外联目的地、敏感数据、文件路径、工具或主机。

当前可用 risk_type

下表列出当前风险类型目录中的 risk_type。不同检测规则、数据来源和开关配置会产生不同的结果;某个类型出现在目录中,不代表它一定会在每个数据范围内生成 incident-event。

risk_type

页面展示名

含义

prompt_injection

提示词注入

不可信内容试图覆盖指令、劫持角色、越狱或诱导越权动作。

model_refusal

模型拒绝

模型明确拒绝高风险请求或敏感内容。

sensitive_data_exposure

敏感数据暴露

敏感数据出现在模型、工具、Agent 或网络外发边界。

unexpected_code_execution

非预期代码执行

未经授权下载、解码、注入或执行代码。

destructive_action

破坏性操作

未经授权删除、覆写或终止重要资源。

privilege_escalation

权限提升

未经授权扩大本地或云端权限。

persistence

持久化

未经授权建立重启、登录或定时恢复的长期执行能力。

defense_impairment

安全防护削弱

未经授权削弱访问控制、安全工具、审计或网络防护。

credential_access

凭证访问

未经授权读取凭证存储、环境凭证、云身份凭证或私钥。

remote_control_channel

远程控制通道

未经授权建立交互式远程控制或 C2 通道。

unauthorized_network_exposure

未授权网络暴露

未经授权将本地服务、端口或网络路径暴露到更宽信任边界。

agent_misrepresentation

Agent 执行结果失实陈述

Agent 对重要动作完成、失败或当前状态的陈述与客观结果矛盾。

system_discovery

系统探测

身份、环境或凭证存储位置的探测行为。

outbound_action

外联动作

外部访问、消息发送或数据传输动作。

sensitive_file_mutation

敏感文件变更

高价值敏感文件被创建、编辑或删除。

页面展示名指风险明细、筛选项和归因卡片中使用的名称。指标卡可能根据 data_exposure_surface 对同一个 risk_type 使用更具体的叙述式名称。

敏感数据风险子类(risk_subtype)

对于 sensitive_data_exposure,risk_subtype 通常表示命中的敏感数据类型。用户可以基于该字段配置不同的处置优先级。例如,直接认证凭据和高敏身份信息通常优先级更高,普通邮箱或 IP 地址通常需要结合上下文判断。

risk_subtype

页面展示名

类型

示例形态

说明

secret.openai_key

OpenAI Key

Secret

sk-...

OpenAI Key 或类似模型服务 Key。

secret.github_token

GitHub Token

Secret

ghp_...

GitHub Token 或同类代码托管访问凭据。

secret.auth_header

认证头

Secret

Authorization: Bearer ...

Bearer Token、Authorization Header 等直接认证信息。

secret.private_key

私钥

Secret

[PRIVATEKEY_MASKED]

私钥类内容。

secret.ssh_private_key

SSH 私钥

Secret

OpenSSH 私钥路径或脱敏私钥内容

SSH 私钥。

secret.pki_private_key

PKI 私钥

Secret

/etc/ssl/private/server.key 或脱敏私钥内容

PKI 私钥或证书私钥。

secret.env_secret

环境变量密钥

Secret

.env 中的 TOKEN=value

环境变量中的密钥或敏感配置。

secret.connection_string

连接字符串

Secret

[DATABASEURL_MASKED]、postgresql://user:pass@example.com:5432/app

带密码的数据库、Redis 或其他服务连接串。

secret.alibaba_cloud_ak

阿里云凭证

Secret

LTAI...

阿里云 AccessKey。

secret.aws_key

AWS Access Key

Secret

AKIA...

AWS Access Key。

secret.cloud_access_key

云服务凭证

Secret

[ACCESSKEY_MASKED]

云厂商访问密钥,包含采集器识别出的脱敏云密钥。

secret.generic_api_key

通用 API Key

Secret

[APIKEY_MASKED]、长随机 token

具备 API Key 特征的通用密钥。

pii.id_card

身份证号

PII

脱敏身份证号或校验通过的身份标识

身份证号或同类高敏身份标识。

pii.credit_card

银行卡号

PII

脱敏银行卡号或校验通过的金融卡号

银行卡号、信用卡号或同类金融敏感信息。

pii.phone

手机号

PII

1380013****

手机号。

pii.landline_phone

座机电话

PII

固定电话形态

固定电话号码。

pii.email

邮箱地址

PII

alice@example.com

邮箱地址。

pii.ip_address

IP 地址

PII

203.0.113.10

IP 地址。通常需要结合内外网属性和上下文判断风险。

系统会结合 risk_subtype 和数据暴露位置判断敏感数据类事件的严重性。operation_stage 不参与通用严重性换算;同一敏感类型出现在不同位置时,仍应结合实际证据和处置优先级进行判断。

敏感数据暴露位置

data_exposure_surface 只描述敏感数据的暴露位置,不描述操作进度或成功与否。操作进度由 operation_stage 独立表示。

data_exposure_surface

页面展示名

含义

agent_input

Agent 输入

敏感数据出现在 Agent 接收的输入中。

model_input

模型输入

敏感数据进入模型请求上下文。

model_output

模型输出

敏感数据出现在模型响应中。

tool_input

工具输入

敏感数据出现在工具调用参数中。

tool_output

工具输出

敏感数据出现在工具返回结果中。

agent_output

Agent 输出

敏感数据出现在 Agent 最终输出中。

network_egress

网络外发

敏感数据与明确的外部目标同时出现在一次工具操作中。该值本身不表示数据已发送成功。

敏感文件变更风险子类(risk_subtype)

对于 sensitive_file_mutation,risk_subtype 通常采用 <file_type>.<action> 形式,其中 action 表示 create、edit 或 delete,页面上对应创建、编辑和删除。下表列出当前高价值敏感文件变更事件中建议重点关注的风险子类。

risk_subtype 模式

所属分组

含义

风险关注点

ssh_private_key.create / ssh_private_key.edit / ssh_private_key.delete

SSH 私钥

SSH 私钥被创建、编辑或删除。

可能影响主机登录凭据、自动化部署凭据或横向访问能力。

ssh_authorized_keys.create / ssh_authorized_keys.edit / ssh_authorized_keys.delete

SSH Authorized Keys

SSH authorized_keys 被创建、编辑或删除。

可能新增或移除主机登录入口,需重点确认是否授权。

cloud_credentials.create / cloud_credentials.edit / cloud_credentials.delete

云凭据

云厂商凭证文件被创建、编辑或删除。

可能影响云资源访问权限或凭证泄漏面。

k8s_config.create / k8s_config.edit / k8s_config.delete

Kubernetes 配置

Kubernetes 配置文件被创建、编辑或删除。

可能影响集群访问权限、上下文切换和服务账号使用。

env_secret.create / env_secret.edit / env_secret.delete

环境变量

环境密钥文件被创建、编辑或删除。

可能改变应用运行时密钥、Token、连接串或第三方服务凭据。

pki_private_key.create / pki_private_key.edit / pki_private_key.delete

PKI 私钥

PKI 私钥被创建、编辑或删除。

可能影响证书签发、TLS 身份和内部信任链。

公钥、证书材料、泛化配置文件或低置信敏感路径可能仍会作为低保真发现或上下文证据出现,但不一定会提升为高保真敏感文件变更事件。判断时应优先关注文件类型、动作类型、工具调用上下文和变更是否符合用户授权目标。

高级风险子类(risk_subtype)

高级风险的 risk_subtype 表示所属 risk_type 下的具体风险事实。对多个风险分类统计、筛选或配置通知时,应始终使用完整的 risk_type + risk_subtype 组合。

risk_type

典型 risk_subtype

含义

prompt_injection

injection_pattern、role_hijack、indirect_injection

指令覆盖、角色劫持或间接提示词注入。

unexpected_code_execution

remote_download_execute、obfuscated_script_execution、runtime_injection

远程下载执行、混淆脚本执行或运行时注入。

destructive_action

file_delete、disk_overwrite、resource_delete、service_termination

文件删除、磁盘覆写、资源删除或服务终止。

privilege_escalation

setuid_escalation、root_ownership_change、cloud_role_escalation

本地或云端权限被非预期扩大。

persistence

scheduled_task、system_service、startup_item、authorized_key

通过计划任务、系统服务、启动项或授权密钥建立持久化。

defense_impairment

access_control_weakening、security_tool_tampering、audit_logging_disable、firewall_weakening

访问控制、安全工具、审计日志或防火墙被削弱。

credential_access

credential_store_read、environment_credential_read、cloud_identity_credential_read、private_key_read

未经授权读取凭证存储、环境凭证、云身份凭证或私钥。

remote_control_channel

reverse_shell、bind_shell、c2_channel

反弹 Shell、绑定 Shell 或 C2 通道。

unauthorized_network_exposure

cloud_tunnel、reverse_tunnel、public_listener、port_publish

隧道、公网监听或端口发布造成未授权网络暴露。

agent_misrepresentation

false_completion、failure_concealment、state_fabrication

虚假完成声明、失败隐瞒或状态伪造。

同一会话可能产生多条不同风险类型或风险子类的事件。reason 说明当前事件的判定理由;严重性根据实际影响确定,不能直接复制初步候选的严重性。

字段使用建议

配置风险通知或二次分析时,建议优先使用 risk_type 区分风险大类,再使用 risk_subtype 区分敏感类型或文件动作。对于去重和聚合,单条风险明细可使用 risk_signature,同类风险队列可使用 risk_family_key,证据回放应使用 evidence_session_id 和 evidence_event_ids。

不要仅凭 risk_subtype 判断最终优先级。例如,邮箱地址出现在模型输入中和同一工具操作中与外部目标绑定,处置优先级可能不同;SSH 私钥被读取和 SSH 私钥文件被修改,也代表不同性质的风险。更稳妥的方式是同时结合 risk_type、data_exposure_surface、operation_stage、severity、confidence、entities 和 Session 上下文。

severity、confidence 和 operation_stage 分别回答不同问题:严重性表示风险成立后的影响与处置优先级,置信度表示系统对风险判断的确定程度,操作阶段表示当前证据能够确认的执行进度。三者之间没有通用换算规则,不能从严重性反推执行阶段,也不能因为阶段是 intent 就自动降低严重性。

对于 network_egress,页面会同时展示操作阶段:intent 表示外发意图,invoked 表示已发起外发调用,executed 表示外发操作已实际执行,completed 表示已收到工具返回结果。operation_stage 为空时显示“阶段未记录”。如果敏感内容来自工具返回结果,则使用 tool_output + completed;不应将返回内容解释为之前已发出的数据。executed 和 completed 都不表示操作成功;如需判断操作结果,应查看工具返回结果中的状态、退出码或错误信息。

事件示例

以下示例用于说明字段组合方式,字段名和枚举值可以直接作为对接参考;ID、时间、证据值和实体值均为合成或脱敏内容。

敏感数据外发事件

{
  "incident_event_id": "incident_application_demo_outbound_001",
  "event_name": "incident.sensitive_data_exposure",
  "source_scope": "application",
  "service_name": "agent-demo-service",
  "agent_type": "qoder",
  "user": "alice",
  "host": "demo-host",
  "source_ip": "10.0.1.42",
  "severity": "high",
  "confidence": 0.9,
  "risk_type": "sensitive_data_exposure",
  "risk_subtype": "secret.cloud_access_key",
  "data_exposure_surface": "network_egress",
  "operation_stage": "completed",
  "evidence_session_id": "sess-demo-001",
  "evidence_values": [
    {
      "field": "gen_ai.tool.call.arguments",
      "value": "[ACCESSKEY_MASKED]",
      "label": "secret.cloud_access_key",
      "role": "sensitive_data"
    },
    {
      "field": "gen_ai.tool.call.arguments",
      "value": "https://example.com/upload",
      "label": "example.com",
      "role": "outbound_target"
    }
  ],
  "entities": [
    { "type": "tool", "value": "WebFetch" },
    { "type": "domain", "value": "example.com" },
    { "type": "secret", "value": "secret.cloud_access_key" }
  ]
}

这个事件表示脱敏云密钥与外部上传目标同时出现在一次工具调用中,并且系统已收到匹配的工具返回结果。外部系统应结合 data_exposure_surface 与 operation_stage 判断外发路径和执行进度,使用 risk_subtype 判断涉及的敏感数据类型,使用 entities 提取外部目标和敏感实体。如果需要确认操作是否成功,应进一步检查工具返回结果中的结构化状态。

敏感文件变更事件

{
  "incident_event_id": "incident_application_demo_file_001",
  "event_name": "incident.sensitive_file_mutation",
  "source_scope": "application",
  "service_name": "agent-demo-service",
  "agent_type": "qoder",
  "severity": "high",
  "confidence": 0.86,
  "risk_type": "sensitive_file_mutation",
  "risk_subtype": "ssh_private_key.delete",
  "evidence_session_id": "sess-demo-002",
  "evidence_values": [
    {
      "field": "gen_ai.tool.call.arguments",
      "value": "/home/alice/.ssh/id_ed25519",
      "label": "ssh_private_key.delete",
      "role": "file_path"
    }
  ],
  "entities": [
    { "type": "tool", "value": "Bash" },
    { "type": "file_path", "value": "/home/alice/.ssh/id_ed25519" },
    { "type": "host", "value": "demo-host" }
  ]
}

这个事件表示 Agent 对稳定敏感文件执行了删除类动作。调查时应优先确认该删除是否符合任务授权目标,以及是否影响主机登录凭据或自动化部署凭据。

破坏性操作事件

{
  "incident_event_id": "incident_application_demo_destructive_001",
  "event_name": "incident.destructive_action",
  "source_scope": "application",
  "service_name": "agent-demo-service",
  "agent_type": "qoder",
  "severity": "high",
  "confidence": 0.8,
  "risk_type": "destructive_action",
  "risk_subtype": "resource_delete",
  "reason": "用户仅授权处理指定测试实例,Agent 实际对额外实例执行了批量删除。",
  "evidence_session_id": "sess-demo-003",
  "evidence_event_ids": ["evt-demo-destructive-001"],
  "evidence_security_event_ids": ["security-demo-destructive-001"],
  "entities": [
    { "type": "tool", "value": "Bash" },
    { "type": "user", "value": "alice" },
    { "type": "host", "value": "demo-host" },
    { "type": "source_ip", "value": "10.0.1.42" }
  ]
}

这个事件表示系统结合用户授权、实际操作和执行结果,确认 Agent 删除了超出用户授权范围的资源。外部系统可以使用 risk_type 识别破坏性操作,使用 risk_subtype 区分资源删除等具体风险事实,并通过证据事件和 Session 回放核对完整上下文。