> ## 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. # Người dùng dễ bị tấn công nhất > Tái tạo báo cáo tổng hợp 12 tháng về những người dùng dễ bị tấn công nhất của nhà cung cấp trước đây từ kết quả mô phỏng và các thực thể của /v1. Báo cáo này là bản tổng hợp mức độ dễ bị tấn công trong 12 tháng theo từng người dùng: mỗi hàng tương ứng với một người đã nhận ít nhất một mô phỏng trong năm gần nhất, kèm số lượng và tỷ lệ nhấp chuột / nhập thông tin xác thực / báo cáo, chuỗi nhấp chuột hiện tại và danh sách nối 5 kết quả gần nhất. Khoảng thời gian là **12 tháng dương lịch** (00:00 UTC của cùng ngày trong tháng, mười hai tháng trước), không phải khoảng thời gian 365 ngày. Các tương tác của trình quét / bot tự động bị loại khỏi số lượng nhấp chuột và nhập thông tin xác thực. Đây là điểm khác biệt có chủ đích so với bản xuất từ hệ thống cũ. Xem [Những điểm khác biệt so với bản xuất từ hệ thống cũ](#nh%E1%BB%AFng-%C4%91i%E1%BB%83m-kh%C3%A1c-bi%E1%BB%87t-so-v%E1%BB%9Bi-b%E1%BA%A3n-xu%E1%BA%A5t-t%E1%BB%AB-h%E1%BB%87-th%E1%BB%91ng-c%C5%A9). Việc thiết lập, thông tin xác thực, phân trang và thử lại khi vượt giới hạn tốc độ giống như trong [hướng dẫn kết nối Power BI / Excel](/vi/developers/v1/powerbi). Hãy thêm truy vấn dùng chung `Fn_FetchAll` trước; báo cáo này gọi truy vấn đó theo tên. ## Phạm vi khóa bắt buộc | Phạm vi | Mục đích sử dụng | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (liên kết email và tên hiển thị) | Báo cáo này sử dụng danh sách kết quả theo từng người ở cấp **vận hành**, không phải nhóm bản xem trước báo cáo. Khóa chỉ được cấp `reporting:read` không thể gọi `GET /v1/simulation_results` (API trả về `403`). Xem [chọn đúng mức chi tiết](/vi/developers/v1/powerbi#ch%E1%BB%8Dn-%C4%91%C3%BAng-m%E1%BB%A9c-chi-ti%E1%BA%BFt). ## Endpoint nguồn | Endpoint | Vai trò | | - | - | | `GET /v1/simulation_results` | Kết quả theo từng người nhận. Đây là mức chi tiết của dữ kiện. | | `GET /v1/entities` | Chuyển đổi `entity` → email / tên hiển thị. Hàng kết quả không có email hoặc tên hiển thị của người nhận (chỉ có `entity`). | Các bộ lọc được cho phép trong danh sách kết quả: `limit`, `page_token`, `simulation`, `entity`. Danh sách này không có `delivered_after` / `start_date`, do đó khoảng 12 tháng gần nhất được áp dụng trong Power Query sau khi duyệt toàn bộ dữ liệu. Các trường được sử dụng trên mỗi kết quả: `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`. ### Mức chi tiết Mỗi hàng tương ứng với một thực thể có ít nhất một kết quả với `delivered_at` trong 12 tháng dương lịch gần nhất. Người được nhắm đến nhưng chưa từng được gửi thành công sẽ không xuất hiện. Nhiều mô phỏng của cùng một người được gộp lại tại đây. Ngân sách yêu cầu: một lượt duyệt có phân trang qua mọi kết quả mô phỏng trong tổ chức, cộng với một lượt duyệt qua các thực thể. Luôn đặt `limit = "500"`. ## Thứ tự ưu tiên kết quả (`last_5_assessments`) Mỗi kết quả trong năm kết quả đã gửi gần nhất (`delivered_at` giảm dần) được tóm tắt thành `YYYY-MM-DD: `. Mốc thời gian khớp đầu tiên sẽ được chọn, theo thứ tự ưu tiên cao nhất trước: | Ưu tiên | Mốc thời gian | Nhãn kết quả | | - | - | - | | 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` | Chỉ được gửi là `no action` (thư đã đến nơi; người dùng không thực hiện thao tác nào). Người đã nhấp chuột và sau đó báo cáo là `clicked` — trong danh sách này, báo cáo không được ưu tiên hơn một tương tác rủi ro. Các hàng bị gắn cờ bot vẫn nhận nhãn kết quả từ các mốc thời gian hiện có; chúng chỉ không làm tăng số lượng nhấp chuột / nhập thông tin xác thực. **Chuỗi nhấp chuột hiện tại:** duyệt chính các kết quả đã gửi đó từ mới nhất đến cũ nhất và đếm số hàng liên tiếp mà `clicked_at` khác null **và** `bot_activity_detected` không phải là `true`. Dừng lại tại hàng đầu tiên không thỏa điều kiện. ## Ánh xạ cột Tên cột cũ lấy từ bản xuất của nhà cung cấp trước đây của bạn. Các trường `/v1` là tên API công khai; truy vấn tự suy ra số lượng và tỷ lệ. | Cột cũ | Trường hoặc cách suy ra của `/v1` | Cột báo cáo | | - | - | - | | Email | `Entity.email` (liên kết theo `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Số kết quả có `delivered_at` khác null (bao gồm các hàng bị gắn cờ bot) | `total_received` | | Clicks # | Số kết quả có `clicked_at` khác null **và** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Số kết quả có `credential_submitted_at` khác null **và** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Số kết quả có `reported_at` khác null (bao gồm bot — không phải nhấp chuột/nhập thông tin xác thực) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Số kết quả đã gửi liên tiếp, tính từ mới nhất, mà người dùng đã nhấp chuột (bot làm gián đoạn chuỗi) | `current_click_streak` | | Last 5 assessments | Năm kết quả đã gửi mới nhất, phân tách bằng `"; "` (xem [thứ tự ưu tiên](#thứ-tự-ưu-tiên-kết-quả-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Không có trên `/v1` | Bị lược bỏ, không đặt null | Khóa liên kết được giữ lại cho mô hình lược đồ hình sao: `entity_id`. ## Những điểm khác biệt so với bản xuất từ hệ thống cũ * **Hoạt động của bot bị loại khỏi số lượng nhấp chuột và nhập thông tin xác thực.** Bản xuất của nhà cung cấp trước đây tính các tương tác của trình quét / bot tự động là nhấp chuột và nhập thông tin xác thực. Truy vấn này thì không. Một kết quả có `bot_activity_detected = true` vẫn là một mô phỏng đã được gửi — được tính trong `total_received` và trong các số liệu tổng hợp về báo cáo — nhưng được coi là không nhấp chuột và không nhập thông tin: nó bị loại khỏi `clicks` / `credential_submissions` và làm gián đoạn chuỗi nhấp chuột hiện tại. Không "khắc phục" bằng cách tính cả bot để khớp với bản xuất từ hệ thống cũ. * **Báo cáo không được ưu tiên hơn nhấp chuột** trên `last_5_assessments`. Người đã nhấp chuột và sau đó báo cáo được gắn nhãn `clicked`. * **Thông tin bổ sung từ thư mục bị lược bỏ, không đặt null.** Phòng ban và các trường tương tự không có trên `/v1`. * **Không có bộ lọc thời gian phía máy chủ.** `GET /v1/simulation_results` không có `delivered_after`. Truy vấn duyệt mọi kết quả, sau đó chỉ giữ lại `delivered_at` trong 12 tháng dương lịch gần nhất. Một tổ chức lớn có lịch sử dài có thể tiêu tốn nhiều ngân sách giới hạn tốc độ của mỗi khóa hơn so với danh sách đã được lọc. ## Các bước tiếp theo Thông tin xác thực, phân trang và cách tải các truy vấn này trong Power BI hoặc Excel. Các tương tác lừa đảo ở cấp sự kiện trong 12 tháng gần nhất. Các lượt ghi danh Đào tạo ở mức chi tiết người × lượt phân công. Cấp `simulation:read` và `entity:read` cho khóa dùng để làm mới báo cáo này. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.