> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 最易受攻击的用户

> 基于 /v1 模拟结果和实体，重现原服务提供商的 12 个月最易受攻击用户汇总报告。

本报告是按用户统计的 12 个月易受攻击性汇总：在过去一年中至少收到一次模拟的每位人员对应一行，包含点击、凭据和报告的次数及比率、当前连续点击次数，以及拼接而成的最近 5 次结果列表。

时间范围为 **12 个日历月**（即 12 个月前同一日期的 UTC 午夜起），而非 365 天的时长。

<Note>
  自动化扫描器/机器人的交互不计入点击和凭据次数。这是与旧版导出有意为之的差异。请参阅
  [与旧版导出的差异](#%E4%B8%8E%E6%97%A7%E7%89%88%E5%AF%BC%E5%87%BA%E7%9A%84%E5%B7%AE%E5%BC%82)。
</Note>

设置、凭据、分页和速率限制重试与
[Power BI / Excel 连接指南](/zh-Hans/developers/v1/powerbi)相同。请先添加共享的
`Fn_FetchAll`查询；本报告将按名称调用该查询。

## 所需的密钥范围

| 范围 | 用途 |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities`（电子邮件和显示名称关联） |

本报告使用**操作型**的按人员结果列表，而不是报告预览系列。仅被授予 `reporting:read` 的密钥无法调用
`GET /v1/simulation_results`（API 将返回 `403`）。请参阅
[选择合适的粒度](/zh-Hans/developers/v1/powerbi#%E9%80%89%E6%8B%A9%E5%90%88%E9%80%82%E7%9A%84%E7%B2%92%E5%BA%A6)。

## 源端点

| 端点 | 作用 |
| - | - |
| `GET /v1/simulation_results` | 按接收者统计的结果。这是事实粒度。 |
| `GET /v1/entities` | 将 `entity` 解析为电子邮件/显示名称。结果行本身不包含接收者的电子邮件或显示名称（仅有 `entity`）。 |

结果列表上允许使用的筛选条件：`limit`、`page_token`、
`simulation`、`entity`。此列表上没有 `delivered_after` / `start_date`，
因此在完整遍历之后，需在 Power Query 中应用过去 12 个月的筛选。

每条结果中使用的字段：`id`、`simulation`、`entity`、`status`、
`targeted_at`、`delivered_at`、`bounced_at`、`opened_at`、`clicked_at`、
`attachment_opened_at`、`credential_submitted_at`、`reported_at`、
`reported_before_interaction`、`bot_activity_detected`、`email_subject`、
`sender_email`、`difficulty_level`、`created_at`、`updated_at`。

### 粒度

在过去 12 个日历月内，至少有一条结果包含 `delivered_at` 的每个实体对应一行。被设为目标但从未送达的人员不会出现。同一人员的多次模拟在此合并。

请求预算：对组织中所有模拟结果进行一次分页遍历，再对实体进行一次遍历。请务必设置 `limit = "500"`。

## 结果优先级（`last_5_assessments`）

最近五条已送达的结果（按 `delivered_at`
降序）将分别汇总为 `YYYY-MM-DD: <outcome>`。匹配到的第一个时间戳生效，优先级由高到低：

| 优先级 | 时间戳 | 结果标签 |
| - | - | - |
| 1 | `credential_submitted_at` | `credential submitted` |
| 2 | `clicked_at` | `clicked` |
| 3 | `attachment_opened_at` | `attachment opened` |
| 4 | `reported_at` | `reported` |
| 5 | `opened_at` | `opened` |
| 6 | `delivered_at` | `no action` |
| 7 | `bounced_at` | `bounced` |

仅送达为 `no action`（邮件已送达；该人员未进行任何操作）。先点击后报告的人员为 `clicked`——在此列表中，报告的优先级不高于有风险的交互。被标记为机器人的行仍会根据已有的时间戳获得结果标签；只是不会增加点击/凭据次数。

**当前连续点击次数：**按从新到旧的顺序遍历这些已送达的结果，统计 `clicked_at` 非空**且** `bot_activity_detected` 不是 `true` 的连续行数。遇到第一个不符合条件的行即停止。

## 列映射

旧版列名来自您之前的服务提供商的导出。`/v1` 字段是公共 API 名称；次数和比率由查询派生。

| 旧版列 | `/v1` 字段或派生方式 | 报告列 |
| - | - | - |
| Email | `Entity.email`（基于 `Result.entity` 关联） | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | `delivered_at` 非空的结果数（包含被标记为机器人的行） | `total_received` |
| Clicks # | `clicked_at` 非空**且** `bot_activity_detected` ≠ `true` 的数量 | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | `credential_submitted_at` 非空**且** `bot_activity_detected` ≠ `true` 的数量 | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | `reported_at` 非空的数量（包含机器人——不属于点击/凭据） | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | 该人员点击的连续最新已送达结果数（机器人会中断连续） | `current_click_streak` |
| Last 5 assessments | 最近五条已送达的结果，以 `"; "` 分隔（请参阅[优先级](#结果优先级（last_5_assessments）)） | `last_5_assessments` |
| Directory extras (department, …) | 不在 `/v1` 上 | 省略，不置空 |

为星型架构模型保留的关联键：`entity_id`。

## 与旧版导出的差异

* **机器人活动不计入点击和凭据次数。** 之前的服务提供商的导出会将自动化扫描器/机器人的交互计为点击和凭据提交。本查询不会这样做。带有 `bot_activity_detected = true` 的结果仍然是一次已送达的模拟——它会计入 `total_received` 以及报告汇总——但会被视为未点击和未提交：它不会计入 `clicks` / `credential_submissions`，并且会中断当前连续点击次数。请勿为了与旧版导出保持一致而将机器人计入。
* **在 `last_5_assessments` 上，报告的优先级不高于点击。** 先点击后报告的人员会被标记为 `clicked`。
* **目录扩展信息被省略，而非置空。** 部门及类似字段不在 `/v1` 上。
* **没有服务器端时间筛选。** `GET /v1/simulation_results` 没有
  `delivered_after`。查询会遍历所有结果，然后仅保留过去 12 个日历月内的
  `delivered_at`。对于历史数据量较大的组织，相比使用筛选后的列表，可能会消耗更多的单密钥速率预算。

## 后续步骤

<CardGroup cols={2}>
  <Card title="Power BI 和 Excel 设置" href="/zh-Hans/developers/v1/powerbi">
    凭据、分页，以及在 Power BI 或 Excel 中加载这些查询。
  </Card>

  <Card title="电子邮件钓鱼日志" href="/zh-Hans/developers/v1/reports/email-phishing-log">
    过去 12 个月的事件级钓鱼交互。
  </Card>

  <Card title="按人员的合规情况" href="/zh-Hans/developers/v1/reports/per-person-compliance">
    人员 × 分配粒度的培训注册情况。
  </Card>

  <Card title="API 密钥" href="/zh-Hans/developers/developer-hub/api-keys">
    在用于刷新本报告的密钥上授予 `simulation:read` 和 `entity:read`。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.