Jurnalul de phishing prin e-mail

Acest raport este un jurnal de phishing la nivel de eveniment: un rând pentru fiecare interacțiune de simulare observată (data, acțiunea, adresa de e-mail a destinatarului, subiectul, expeditorul, dificultatea). Rămâne în format extins — nu restrânge istoricul unei persoane la un singur rezultat. Interogarea include în occurred_after ultimele 12 luni calendaristice (miezul nopții UTC, în aceeași zi a lunii, cu douăsprezece luni în urmă — nu o durată de 365 de zile). Configurarea, acreditările, paginarea și reîncercarea în caz de limitare a ratei sunt aceleași ca în ghidul de conectare Power BI / Excel. Adăugați mai întâi interogarea comună Fn_FetchAll; acest raport o apelează după nume.

​

Domenii de aplicare necesare pentru chei

O cheie căreia i s-a acordat doar simulation:read nu poate apela endpointul de evenimente de raportare (API-ul returnează 403). Consultați alegerea nivelului de granularitate potrivit.

​

Endpointuri sursă

Filtre permise pentru lista de evenimente (orice altceva returnează 400): limit, page_token, simulation, entity, event_type, occurred_after. Această familie de rapoarte este un set de date în versiune preliminară. Inspectați schema setului de date și politicile de date la GET /v1/reporting/datasets și GET /v1/reporting/datasets/simulation_events.

​

Granularitate

Un rând pentru fiecare eveniment de simulare din raportare. O persoană care a deschis și apoi a făcut clic pe același mesaj generează două rânduri. Evenimentele cu entity_id nul (fără actor / destinatar / participant țintă) apar în continuare — email este nul. Fereastra API este extinsă cu un minut; limita exactă occurred_at >= WindowStart este reaplicată local, astfel încât ultimul an să nu depindă de faptul că serverul tratează occurred_after ca inclusiv sau exclusiv. Buget de cereri: o parcurgere paginată a evenimentelor din fereastră, plus o parcurgere a entităților. Setați întotdeauna limit = "500".

​

Maparea coloanelor

Numele coloanelor din exportul anterior provin de la furnizorul dumneavoastră anterior. Câmpurile /v1 sunt numele publice din API; interogarea atribuie alias unora dintre ele pentru raport.

​

Token-uri de acțiune

action este token-ul închis de raportare. „Email Sent” din exportul anterior corespunde lui simulation.delivered (delivered este verbul public; token-ul transmis este simulation.delivered). Câmpuri suplimentare păstrate deoarece există în API: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, plus entity_type și entity_status din asocierea cu entitățile.

​

Diferențe față de exportul anterior

• Adresa IP brută nu este disponibilă niciodată. /v1 nu va expune adresa IP brută a clientului — confidențialitate prin design, nu o mapare în așteptare. Interogarea nu adaugă o coloană IP substituent.
• Tipul dispozitivului este derivat, nu brut. device_type este o clasă derivată de dispozitiv pentru evenimentele de clic, trimitere și raportare. Token-urile observate includ desktop, mobile, tablet și unknown, dar emițătorul stochează un șir de text liber — tratați-l ca text deschis, nu ca enumerare închisă. Este nul când evenimentul nu are clasă derivată, iar șirul user_agent brut rămâne privat.
• „Email Sent” este simulation.delivered. Utilizați acest token când filtrați sau numărați trimiterile. Nu căutați un șir email_sent din exportul anterior.
• Adresa de e-mail a destinatarului este o asociere, nu un câmp al evenimentului. Evenimentul de raportare omite adresa de e-mail; interogarea parcurge /entities pentru a o completa.
• Ultimele 12 luni calendaristice, nu o durată de 365 de zile și nu istoricul complet.
• Format extins, nu restrâns. Un rând pentru fiecare interacțiune, nu un rezultat pentru fiecare persoană.

​

Pașii următori