> ## 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. # Jurnalul de phishing prin e-mail > Recreați jurnalul de phishing la nivel de eveniment al unui furnizor anterior, pe baza evenimentelor și entităților de simulare din raportarea /v1. 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). Adresa IP brută a clientului nu se află niciodată în `/v1` — confidențialitate prin design, nu o mapare în așteptare. Tipul dispozitivului este o clasă derivată, aflată pe rândul evenimentului; `user_agent` brut rămâne privat. Consultați [Diferențe față de exportul anterior](#diferen%C8%9Be-fa%C8%9B%C4%83-de-exportul-anterior). Configurarea, acreditările, paginarea și reîncercarea în caz de limitare a ratei sunt aceleași ca în [ghidul de conectare Power BI / Excel](/ro/developers/v1/powerbi). Adăugați mai întâi interogarea comună `Fn_FetchAll`; acest raport o apelează după nume. ## Domenii de aplicare necesare pentru chei | Domeniu | Utilizare | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (asociere după e-mail și nume afișat) | 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](/ro/developers/v1/powerbi#alege%C8%9Bi-granularitatea-potrivit%C4%83). ## Endpointuri sursă | Endpoint | Rol | | - | - | | `GET /v1/reporting/simulation_events` | Fapt la nivel de eveniment. Granularitatea este o interacțiune tipizată. `email_subject`, `sender_email`, `sender_domain` și `difficulty_tier` se află pe acest rând, deci interogarea nu asociază rezultatele la nivel de campanie pentru aceste câmpuri. | | `GET /v1/entities` | Rezolvă `entity_id` → e-mail / nume afișat. Evenimentul de raportare omite adresa de e-mail a destinatarului (o excludere strictă în cititorul de raportare). Parcurgerea `/entities` este modul în care se populează coloana „email” din exportul anterior. | 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ă](/ro/developers/v1/powerbi#seturi-de-date-de-previzualizare-pentru-raportare-phishing-la-nivel-de-persoan%C4%83). 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. | Coloană din exportul anterior | Câmp `/v1` sau derivare | Coloană în raport | | - | - | - | | Date | `Event.occurred_at` (ca dată; `occurred_at` brut este păstrat ca `datetimezone`) | `date` | | Action | `Event.event_type` — token-uri închise, listate mai jos | `action` | | Email | `Entity.email` (asociere după `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — număr întreg 1–5, 1 cel mai ușor, 5 cel mai dificil | `difficulty` | | Raw IP | Niciodată pe `/v1` | Omis, nu nulificat | | Device type | `Event.device_type` — clasă derivată; nul când evenimentul nu are clasă derivată | `device_type` | ### 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`). | Valoare `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | 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 Acreditări, paginare și încărcarea acestor interogări în Power BI sau Excel. Sinteză pe persoană, pe 12 luni, a clicurilor, acreditărilor și raportărilor. Înscrierile la Instruire la granularitatea persoană × alocare. Acordați `reporting:read` și `entity:read` cheii care actualizează acest raport. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.