> ## 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. # Nhật ký phishing qua email > Tái tạo nhật ký phishing ở cấp sự kiện của nhà cung cấp trước đây từ các sự kiện và thực thể mô phỏng báo cáo /v1. Báo cáo này là nhật ký phishing ở cấp sự kiện: mỗi hàng tương ứng một tương tác mô phỏng được ghi nhận (ngày, hành động, email người nhận, tiêu đề, người gửi, mức độ khó). Báo cáo được giữ ở dạng dài — không gộp lịch sử của một người thành một kết quả duy nhất. Truy vấn gộp **12 tháng dương lịch** gần nhất vào `occurred_after` (00:00 UTC của cùng ngày trong tháng, cách đây mười hai tháng — không phải khoảng thời gian 365 ngày). IP máy khách gốc không bao giờ có trên `/v1` — đây là thiết kế bảo vệ quyền riêng tư, không phải một ánh xạ đang chờ xử lý. Loại thiết bị là một lớp được suy ra trên hàng sự kiện; `user_agent` gốc vẫn được giữ kín. Xem [Những điểm khác biệt so với bản xuất 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-c%C5%A9). Việc thiết lập, thông tin xác thực, phân trang và thử lại khi bị 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 `Fn_FetchAll` dùng chung 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 | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (kết hợp email và tên hiển thị) | Khóa chỉ được cấp `simulation:read` không thể gọi endpoint sự kiện báo cáo (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/reporting/simulation_events` | Dữ kiện cấp sự kiện. Mức chi tiết là một tương tác đã phân loại. `email_subject`, `sender_email`, `sender_domain` và `difficulty_tier` nằm trên hàng này, vì vậy truy vấn không kết hợp kết quả cấp chiến dịch cho các trường đó. | | `GET /v1/entities` | Phân giải `entity_id` → email / tên hiển thị. Sự kiện báo cáo không có email người nhận (một loại trừ cứng trên trình đọc báo cáo). Việc duyệt `/entities` là cách điền cột "email" của bản cũ. | Các bộ lọc được cho phép trên danh sách sự kiện (mọi bộ lọc khác sẽ trả về `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Nhóm báo cáo này là một [bộ dữ liệu xem trước](/vi/developers/v1/powerbi#t%E1%BA%ADp-d%E1%BB%AF-li%E1%BB%87u-xem-tr%C6%B0%E1%BB%9Bc-b%C3%A1o-c%C3%A1o-phishing-theo-t%E1%BB%ABng-c%C3%A1-nh%C3%A2n). Kiểm tra lược đồ bộ dữ liệu và chính sách dữ liệu tại `GET /v1/reporting/datasets` và `GET /v1/reporting/datasets/simulation_events`. ### Mức chi tiết Mỗi hàng tương ứng một sự kiện mô phỏng báo cáo. Một người đã mở rồi nhấp vào cùng một thư sẽ tạo ra hai hàng. Các sự kiện có `entity_id` null (không có tác nhân / người nhận / người tham gia mục tiêu) vẫn xuất hiện — `email` là null. Cửa sổ API được mở rộng thêm một phút; giới hạn `occurred_at >= WindowStart` chính xác được áp dụng lại cục bộ để khoảng một năm gần nhất không phụ thuộc vào việc máy chủ xử lý `occurred_after` là bao gồm hay loại trừ. Ngân sách yêu cầu: một lượt duyệt phân trang các sự kiện trong cửa sổ, cộng với một lượt duyệt các thực thể. Luôn đặt `limit = "500"`. ## Á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 bí danh cho một số trường trong số đó để dùng cho báo cáo. | Cột cũ | Trường `/v1` hoặc cách suy ra | Cột báo cáo | | - | - | - | | Date | `Event.occurred_at` (dưới dạng ngày; `occurred_at` gốc được giữ là `datetimezone`) | `date` | | Action | `Event.event_type` — các token đóng được liệt kê bên dưới | `action` | | Email | `Entity.email` (kết hợp trên `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — số nguyên 1–5, 1 dễ nhất, 5 khó nhất | `difficulty` | | Raw IP | Không bao giờ có trên `/v1` | Bị bỏ qua, không đặt null | | Device type | `Event.device_type` — lớp được suy ra; null khi sự kiện không có lớp được suy ra | `device_type` | ### Token hành động `action` là token báo cáo đóng. "Email Sent" của bản cũ ánh xạ tới `simulation.delivered` (`delivered` là động từ công khai; token trên đường truyền là `simulation.delivered`). | Giá trị `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Các trường bổ sung được giữ lại vì API có chúng: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, cùng với `entity_type` và `entity_status` từ phép kết hợp thực thể. ## Những điểm khác biệt so với bản xuất cũ * **IP gốc không bao giờ khả dụng.** `/v1` sẽ không hiển thị IP máy khách gốc — đây là thiết kế bảo vệ quyền riêng tư, không phải một ánh xạ đang chờ xử lý. Truy vấn không thêm cột IP giữ chỗ. * **Loại thiết bị là giá trị được suy ra, không phải giá trị gốc.** `device_type` là lớp thiết bị được suy ra cho các sự kiện nhấp, gửi và báo cáo. Các token đã quan sát được gồm `desktop`, `mobile`, `tablet` và `unknown`, nhưng bộ phát lưu một chuỗi tự do — hãy coi đó là văn bản mở, không phải enum đóng. Giá trị này là null khi sự kiện không có lớp được suy ra, và chuỗi `user_agent` gốc vẫn được giữ kín. * **"Email Sent" là `simulation.delivered`.** Hãy dùng token này khi bạn lọc hoặc đếm số lượt gửi. Đừng tìm chuỗi `email_sent` của bản cũ. * **Email người nhận là kết quả của phép kết hợp, không phải một trường trên sự kiện.** Sự kiện báo cáo không có email; truy vấn duyệt `/entities` để điền giá trị này. * **12 tháng dương lịch gần nhất**, không phải khoảng thời gian 365 ngày, và không phải toàn bộ lịch sử. * **Dạng dài, không gộp.** Mỗi hàng là một tương tác, không phải một kết quả cho mỗi người. ## 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. Tổng hợp theo từng người trong 12 tháng về lượt nhấp, thông tin xác thực và báo cáo. Các lượt ghi danh Đào tạo ở mức chi tiết người × phân công. Cấp `reporting:read` và `entity:read` trên 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.