> ## 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 個日曆月**（自十二個月前同一日期的 UTC 午夜起算），而非 365 天的時間長度。

<Note>
  自動化掃描器／機器人的互動不計入點擊和憑證次數。這是與舊版匯出內容刻意不同之處。請參閱
  [與舊版匯出內容的差異](#%E8%88%87%E8%88%8A%E7%89%88%E5%8C%AF%E5%87%BA%E5%85%A7%E5%AE%B9%E7%9A%84%E5%B7%AE%E7%95%B0)。
</Note>

設定、憑證、分頁和速率限制重試方式，均與
[Power BI / Excel 連線指南](/zh-Hant/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-Hant/developers/v1/powerbi#%E9%81%B8%E6%93%87%E6%AD%A3%E7%A2%BA%E7%9A%84%E8%B3%87%E6%96%99%E7%B2%92%E5%BA%A6)。

## 來源端點

| 端點 | 角色 |
| - | - |
| `GET /v1/simulation_results` | 每位收件者的成果。這是事實粒度。 |
| `GET /v1/entities` | 將 `entity` 解析為電子郵件／顯示名稱。結果列本身沒有收件者電子郵件或顯示名稱（僅有 `entity`）。 |

結果清單上允許使用的篩選條件：`limit`、`page_token`、
`simulation`、`entity`。此清單上沒有 `delivered_after` / `start_date`，
因此過去 12 個月的範圍是在完整走訪後於 Power Query 中套用。

每筆結果所使用的欄位：`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-Hant/developers/v1/powerbi">
    憑證、分頁，以及在 Power BI 或 Excel 中載入這些查詢。
  </Card>

  <Card title="電子郵件網路釣魚記錄" href="/zh-Hant/developers/v1/reports/email-phishing-log">
    過去 12 個月的事件層級網路釣魚互動。
  </Card>

  <Card title="個別人員合規性" href="/zh-Hant/developers/v1/reports/per-person-compliance">
    以人員 × 指派為粒度的訓練註冊。
  </Card>

  <Card title="API 金鑰" href="/zh-Hant/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.