风险事件字段说明面向需要配置风险通知、编写二次分析逻辑或对接外部安全系统的用户。本文说明高保真安全事件表 incident-event 的字段含义,以及可使用的 risk_type、risk_subtype、data_exposure_surface 和 operation_stage 枚举。字段和值可能随产品演进扩展,请以控制台展示和实际返回结果为准。
本文中的示例值均为脱敏、合成或文档化占位内容,用于说明字段形态和风险语义,不代表真实用户数据,也不等同于完整检测条件。实际事件中的敏感值可能经过采集侧脱敏、截断或摘要化处理。
incident-event 表示经过规则关联、过滤或提升后的高保真安全事件。一行事件通常已经具备明确的证据位置、风险主体、严重性和调查入口,适合作为风险审计明细、通知配置、自动化处置和二次开发的输入。它不保存处置状态,也不等同于工单或通知对象;如果需要处置流转,应在上层系统中基于这些字段再做聚合和状态管理。
字段说明
字段 | 类型 | 说明 |
| string | 高保真安全事件主键。该字段按确定性规则生成,适合用于去重、幂等写入和外部系统引用。 |
| string | 高保真事件名,固定采用 |
| enum | 数据来源范围,取值为 |
| int64 | 事件生成或证据链归并时间,单位为纳秒。页面查询仍以日志时间窗口过滤为准,该字段主要用于事实语义时间和证据回捞。 |
| string | 应用或服务名,无法明确时可为空或使用占位值。 |
| string | Agent 类型,例如 qoder、cursor、claude-code 等。 |
| string | 用户实体的平铺查询列,优先取自 |
| string | 主机实体的平铺查询列,优先取自 |
| string | Agent 主机 IP 实体的平铺查询列,优先取自 |
| enum | 风险严重性,表示风险成立后可能造成的影响,从高到低取 |
| number | 系统对当前风险判断的确定程度,取值为 0 到 1。取值由相应的检测规则和当前证据确定。 |
| string | 风险类型,对应产品中的主分类。该字段是配置风险筛选、通知规则和二次分析时最常用的分类字段。 |
| string | 风险子类,在所属 |
| enum | 敏感数据的暴露位置,可为空;取 |
| enum | 当前证据能够确认的操作阶段,可为空;取 |
| string | 精确风险签名,用于识别同一个具体风险实例。适合做单个风险的去重、明细聚合和复现定位。 |
| string | 同类风险聚合键,用于把同一类风险合并展示,适合风险队列、趋势和影响面分析。 |
| string | 风险判定理由或证据摘要,可为空。由模型或其他语义研判生成的事件通常使用该字段说明风险为何成立。 |
| string[] | 支撑该事件的低保真安全发现 ID 数组。 |
| string[] | 支撑该事件的原始活动事件 ID 数组。 |
| string | 事件归属的证据 Session。 |
| string | 证据主体类型,用于描述事件主要关联的主体类别。 |
| string | 证据主体值,与 |
| string | 证据主体稳定键,用于更可靠地关联主体。 |
| object[] | 结构化证据值数组,例如命中的敏感类型、脱敏后的值、文件路径、命令片段、外发目标等。 |
| object[] | 关键风险实体快照,例如应用、用户、主机、Agent 主机 IP、工具、域名、目标 IP、Secret、PII、文件路径或命令实体。多信号晋升事件应合并所有关键实体。 |
| string | 生成该事件的检测器或服务名称。 |
| string | 检测器或服务版本。 |
user、host 和 source_ip 适合直接筛选和分组;多实体关系和精确实体反查仍应使用 entities。历史记录无法提取对应值时,这些平铺列可为空。
常见字段示例
字段 | 示例值 | 说明 |
|
| 具体格式由系统生成,外部系统只需把它作为稳定 ID 使用。 |
|
| 表示事件来自应用侧审计还是运行时审计。 |
|
| 分别表示用户、Agent 运行主机和 Agent 主机 IP,可直接用于常用筛选和分组。 |
|
| 表示风险动作或高保真事件类型。 |
|
| 表示敏感数据类型、敏感文件类型与动作,或其他具体风险事实。 |
|
| 用于处置优先级,不建议脱离 |
|
| 表示事件证据链成熟度和规则确定性。 |
|
| 表示敏感数据与明确的外部目标同时出现在一次工具操作中,不表示数据已发送成功。 |
|
| 表示当前证据能够确认的操作阶段。 |
|
| 用于跳转 Session 浏览或回捞上下文。 |
|
| 用于展示具体证据。示例中的值是脱敏标记,实际值可能按采集策略脱敏。 |
|
| 用于表达关键风险主体,例如外联目的地、敏感数据、文件路径、工具或主机。 |
当前可用 risk_type
下表列出当前风险类型目录中的 risk_type。不同检测规则、数据来源和开关配置会产生不同的结果;某个类型出现在目录中,不代表它一定会在每个数据范围内生成 incident-event。
risk_type | 页面展示名 | 含义 |
| 提示词注入 | 不可信内容试图覆盖指令、劫持角色、越狱或诱导越权动作。 |
| 模型拒绝 | 模型明确拒绝高风险请求或敏感内容。 |
| 敏感数据暴露 | 敏感数据出现在模型、工具、Agent 或网络外发边界。 |
| 非预期代码执行 | 未经授权下载、解码、注入或执行代码。 |
| 破坏性操作 | 未经授权删除、覆写或终止重要资源。 |
| 权限提升 | 未经授权扩大本地或云端权限。 |
| 持久化 | 未经授权建立重启、登录或定时恢复的长期执行能力。 |
| 安全防护削弱 | 未经授权削弱访问控制、安全工具、审计或网络防护。 |
| 凭证访问 | 未经授权读取凭证存储、环境凭证、云身份凭证或私钥。 |
| 远程控制通道 | 未经授权建立交互式远程控制或 C2 通道。 |
| 未授权网络暴露 | 未经授权将本地服务、端口或网络路径暴露到更宽信任边界。 |
| Agent 执行结果失实陈述 | Agent 对重要动作完成、失败或当前状态的陈述与客观结果矛盾。 |
| 系统探测 | 身份、环境或凭证存储位置的探测行为。 |
| 外联动作 | 外部访问、消息发送或数据传输动作。 |
| 敏感文件变更 | 高价值敏感文件被创建、编辑或删除。 |
页面展示名指风险明细、筛选项和归因卡片中使用的名称。指标卡可能根据 data_exposure_surface 对同一个 risk_type 使用更具体的叙述式名称。
敏感数据风险子类(risk_subtype)
对于 sensitive_data_exposure,risk_subtype 通常表示命中的敏感数据类型。用户可以基于该字段配置不同的处置优先级。例如,直接认证凭据和高敏身份信息通常优先级更高,普通邮箱或 IP 地址通常需要结合上下文判断。
risk_subtype | 页面展示名 | 类型 | 示例形态 | 说明 |
| OpenAI Key | Secret |
| OpenAI Key 或类似模型服务 Key。 |
| GitHub Token | Secret |
| GitHub Token 或同类代码托管访问凭据。 |
| 认证头 | Secret |
| Bearer Token、Authorization Header 等直接认证信息。 |
| 私钥 | Secret |
| 私钥类内容。 |
| SSH 私钥 | Secret | OpenSSH 私钥路径或脱敏私钥内容 | SSH 私钥。 |
| PKI 私钥 | Secret |
| PKI 私钥或证书私钥。 |
| 环境变量密钥 | Secret |
| 环境变量中的密钥或敏感配置。 |
| 连接字符串 | Secret |
| 带密码的数据库、Redis 或其他服务连接串。 |
| 阿里云凭证 | Secret |
| 阿里云 AccessKey。 |
| AWS Access Key | Secret |
| AWS Access Key。 |
| 云服务凭证 | Secret |
| 云厂商访问密钥,包含采集器识别出的脱敏云密钥。 |
| 通用 API Key | Secret |
| 具备 API Key 特征的通用密钥。 |
| 身份证号 | PII | 脱敏身份证号或校验通过的身份标识 | 身份证号或同类高敏身份标识。 |
| 银行卡号 | PII | 脱敏银行卡号或校验通过的金融卡号 | 银行卡号、信用卡号或同类金融敏感信息。 |
| 手机号 | PII |
| 手机号。 |
| 座机电话 | PII | 固定电话形态 | 固定电话号码。 |
| 邮箱地址 | PII |
| 邮箱地址。 |
| IP 地址 | PII |
| IP 地址。通常需要结合内外网属性和上下文判断风险。 |
系统会结合 risk_subtype 和数据暴露位置判断敏感数据类事件的严重性。operation_stage 不参与通用严重性换算;同一敏感类型出现在不同位置时,仍应结合实际证据和处置优先级进行判断。
敏感数据暴露位置
data_exposure_surface 只描述敏感数据的暴露位置,不描述操作进度或成功与否。操作进度由 operation_stage 独立表示。
data_exposure_surface | 页面展示名 | 含义 |
| Agent 输入 | 敏感数据出现在 Agent 接收的输入中。 |
| 模型输入 | 敏感数据进入模型请求上下文。 |
| 模型输出 | 敏感数据出现在模型响应中。 |
| 工具输入 | 敏感数据出现在工具调用参数中。 |
| 工具输出 | 敏感数据出现在工具返回结果中。 |
| Agent 输出 | 敏感数据出现在 Agent 最终输出中。 |
| 网络外发 | 敏感数据与明确的外部目标同时出现在一次工具操作中。该值本身不表示数据已发送成功。 |
敏感文件变更风险子类(risk_subtype)
对于 sensitive_file_mutation,risk_subtype 通常采用 <file_type>.<action> 形式,其中 action 表示 create、edit 或 delete,页面上对应创建、编辑和删除。下表列出当前高价值敏感文件变更事件中建议重点关注的风险子类。
risk_subtype 模式 | 所属分组 | 含义 | 风险关注点 |
| SSH 私钥 | SSH 私钥被创建、编辑或删除。 | 可能影响主机登录凭据、自动化部署凭据或横向访问能力。 |
| SSH Authorized Keys | SSH authorized_keys 被创建、编辑或删除。 | 可能新增或移除主机登录入口,需重点确认是否授权。 |
| 云凭据 | 云厂商凭证文件被创建、编辑或删除。 | 可能影响云资源访问权限或凭证泄漏面。 |
| Kubernetes 配置 | Kubernetes 配置文件被创建、编辑或删除。 | 可能影响集群访问权限、上下文切换和服务账号使用。 |
| 环境变量 | 环境密钥文件被创建、编辑或删除。 | 可能改变应用运行时密钥、Token、连接串或第三方服务凭据。 |
| PKI 私钥 | PKI 私钥被创建、编辑或删除。 | 可能影响证书签发、TLS 身份和内部信任链。 |
公钥、证书材料、泛化配置文件或低置信敏感路径可能仍会作为低保真发现或上下文证据出现,但不一定会提升为高保真敏感文件变更事件。判断时应优先关注文件类型、动作类型、工具调用上下文和变更是否符合用户授权目标。
高级风险子类(risk_subtype)
高级风险的 risk_subtype 表示所属 risk_type 下的具体风险事实。对多个风险分类统计、筛选或配置通知时,应始终使用完整的 risk_type + risk_subtype 组合。
risk_type | 典型 risk_subtype | 含义 |
|
| 指令覆盖、角色劫持或间接提示词注入。 |
|
| 远程下载执行、混淆脚本执行或运行时注入。 |
|
| 文件删除、磁盘覆写、资源删除或服务终止。 |
|
| 本地或云端权限被非预期扩大。 |
|
| 通过计划任务、系统服务、启动项或授权密钥建立持久化。 |
|
| 访问控制、安全工具、审计日志或防火墙被削弱。 |
|
| 未经授权读取凭证存储、环境凭证、云身份凭证或私钥。 |
|
| 反弹 Shell、绑定 Shell 或 C2 通道。 |
|
| 隧道、公网监听或端口发布造成未授权网络暴露。 |
|
| 虚假完成声明、失败隐瞒或状态伪造。 |
同一会话可能产生多条不同风险类型或风险子类的事件。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 回放核对完整上下文。