Nhật ký phishing qua email

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). 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. 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

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.

​

Endpoint nguồn

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. 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.

​

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). 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