Email phishing log

Ushbu hisobot hodisa darajasidagi phishing jurnalidir: kuzatilgan har bir simulyatsiya o‘zaro ta’siri uchun bitta qator (sana, harakat, qabul qiluvchining email manzili, mavzu, jo‘natuvchi, murakkablik darajasi). U uzun shaklda saqlanadi — shaxs tarixini yagona natijaga jamlamaydi. So‘rov oxirgi 12 taqvim oyini occurred_after ichiga jamlaydi (12 oy avvalgi xuddi shu oy kunidagi UTC yarim tun — 365 kunlik davomiylik emas). Sozlash, hisob ma’lumotlari, sahifalash va rate-limit bo‘yicha qayta urinish Power BI / Excel connectivity guide dagi kabi. Avval umumiy Fn_FetchAll so‘rovini qo‘shing; ushbu hisobot uni nomi bilan chaqiradi.

​

Required key scopes

Faqat simulation:read berilgan kalit reporting events endpointini chaqira olmaydi (API 403 qaytaradi). Qarang: choose the right grain.

​

Source endpoints

Events ro‘yxatidagi ruxsat etilgan filtrlar (boshqa har qanday filtr 400 qaytaradi): limit, page_token, simulation, entity, event_type, occurred_after. Ushbu reporting oilasi preview dataset hisoblanadi. Dataset sxemasi va ma’lumotlar siyosatlarini GET /v1/reporting/datasets va GET /v1/reporting/datasets/simulation_events orqali ko‘rib chiqing.

​

Grain

Har bir reporting simulation event uchun bitta qator. Bir xil xabarni avval ochgan, so‘ng bosgan shaxs ikki qator hosil qiladi. entity_id qiymati null bo‘lgan hodisalar (aktor / qabul qiluvchi / nishon ishtirokchi yo‘q) ham ko‘rsatiladi — email null bo‘ladi. API oynasi bir daqiqaga kengaytiriladi; aniq occurred_at >= WindowStart chegarasi lokal darajada qayta qo‘llanadi, shu tufayli oxirgi yil server occurred_after ni kiritilgan yoki kiritilmagan deb hisoblashiga bog‘liq bo‘lmaydi. So‘rovlar byudjeti: oynadagi hodisalarni sahifalab bir marta aylanib chiqish va entities ni bir marta aylanib chiqish. Har doim limit = "500" ni belgilang.

​

Column mapping

Eski ustun nomlari oldingi provayderingiz eksportidan olingan. /v1 maydonlari — ommaviy API nomlari; so‘rov ulardan ba’zilariga hisobot uchun taxallus beradi.

​

Action tokens

action — yopiq reporting tokeni. Eski “Email Sent” simulation.delivered ga mos keladi (delivered — ommaviy fe’l; wire tokeni simulation.delivered). API’da mavjud bo‘lgani uchun saqlangan qo‘shimcha maydonlar: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, shuningdek entity bog‘lanishidan entity_type va entity_status.

​

Divergences from the legacy export

• Xom IP hech qachon mavjud emas. /v1 mijozning xom IP manzilini ochib bermaydi — bu maxfiylikni ta’minlash maqsadidagi dizayn bo‘lib, kutilayotgan moslashtirish emas. So‘rov IP uchun o‘rinbosar ustun qo‘shmaydi.
• Qurilma turi xom emas, hosilaviy. device_type — click, submit va report hodisalari uchun hosilaviy qurilma sinfi. Kuzatiladigan tokenlar orasida desktop, mobile, tablet va unknown bor, ammo emitter erkin shakldagi satrni saqlaydi — uni yopiq enum emas, ochiq matn deb hisoblang. Hodisada hosilaviy sinf bo‘lmasa, u null bo‘ladi, xom user_agent satri esa yopiq qoladi.
• “Email Sent” — bu simulation.delivered. Yuborilganlarni filtrlash yoki sanashda shu tokendan foydalaning. Eski email_sent satrini izlamang.
• Qabul qiluvchining email manzili hodisadagi maydon emas, bog‘lanishdir. Reporting hodisasida email yo‘q; so‘rov uni to‘ldirish uchun /entities ni aylanib chiqadi.
• Oxirgi 12 taqvim oyi, 365 kunlik davomiylik emas va to‘liq tarix ham emas.
• Uzun shakl, jamlanmagan. Har bir o‘zaro ta’sir uchun bitta qator, har bir shaxs uchun bitta natija emas.

​

Next steps