Log phishing email

Laporan ini adalah log phishing tingkat peristiwa: satu baris untuk setiap interaksi simulasi yang teramati (tanggal, tindakan, email penerima, subjek, pengirim, tingkat kesulitan). Laporan ini tetap berbentuk long-form — tidak meringkas riwayat seseorang menjadi satu hasil tunggal. Kueri ini mencakup 12 bulan kalender terakhir ke dalam occurred_after (tengah malam UTC pada tanggal yang sama dua belas bulan yang lalu — bukan durasi 365 hari). Pengaturan, kredensial, paginasi, dan percobaan ulang batas laju sama dengan panduan konektivitas Power BI / Excel. Tambahkan terlebih dahulu kueri Fn_FetchAll bersama; laporan ini memanggilnya berdasarkan nama.

​

Cakupan kunci yang diperlukan

Kunci yang hanya diberi simulation:read tidak dapat memanggil endpoint peristiwa pelaporan (API mengembalikan 403). Lihat pilih granularitas yang tepat.

​

Endpoint sumber

Filter yang diizinkan pada daftar peristiwa (filter lainnya mengembalikan 400): limit, page_token, simulation, entity, event_type, occurred_after. Keluarga pelaporan ini merupakan dataset pratinjau. Periksa skema dataset dan kebijakan data di GET /v1/reporting/datasets dan GET /v1/reporting/datasets/simulation_events.

​

Granularitas

Satu baris untuk setiap peristiwa simulasi pelaporan. Seseorang yang membuka lalu mengeklik pesan yang sama menghasilkan dua baris. Peristiwa dengan entity_id bernilai null (tanpa aktor / penerima / peserta target) tetap muncul — email bernilai null. Jendela API diperlebar satu menit; batas occurred_at >= WindowStart yang tepat diterapkan kembali secara lokal sehingga periode satu tahun terakhir tidak bergantung pada apakah server memperlakukan occurred_after sebagai inklusif atau eksklusif. Anggaran permintaan: satu penelusuran berpaginasi atas peristiwa dalam jendela tersebut, ditambah satu penelusuran atas entitas. Selalu atur limit = "500".

​

Pemetaan kolom

Nama kolom lama berasal dari ekspor penyedia Anda sebelumnya. Kolom /v1 adalah nama API publik; kueri memberi alias pada sebagian di antaranya untuk laporan.

​

Token tindakan

action adalah token pelaporan tertutup. “Email Sent” lama dipetakan ke simulation.delivered (delivered adalah kata kerja publik; token pada jalur transmisi adalah simulation.delivered). Kolom tambahan yang dipertahankan karena tersedia di API: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, ditambah entity_type dan entity_status dari penggabungan entitas.

​

Perbedaan dari ekspor lama

• IP mentah tidak pernah tersedia. /v1 tidak akan mengekspos IP klien mentah — ini merupakan privasi berdasarkan desain, bukan pemetaan yang masih tertunda. Kueri tidak menambahkan kolom IP pengganti.
• Jenis perangkat bersifat turunan, bukan mentah. device_type adalah kelas perangkat turunan untuk peristiwa klik, pengiriman, dan pelaporan. Token yang teramati meliputi desktop, mobile, tablet, dan unknown, tetapi pengirim peristiwa menyimpan string bebas — perlakukan sebagai teks terbuka, bukan enum tertutup. Nilainya null jika peristiwa tidak memiliki kelas turunan, dan string user_agent mentah tetap bersifat privat.
• “Email Sent” adalah simulation.delivered. Gunakan token tersebut saat Anda memfilter atau menghitung pengiriman. Jangan mencari string email_sent lama.
• Email penerima merupakan hasil penggabungan, bukan kolom pada peristiwa. Peristiwa pelaporan tidak menyertakan email; kueri menelusuri /entities untuk mengisinya.
• 12 bulan kalender terakhir, bukan durasi 365 hari, dan bukan seluruh riwayat.
• Long-form, tidak diringkas. Satu baris per interaksi, bukan satu hasil per orang.

​

Langkah berikutnya