E-mail-phishinglogboek

Dit rapport is een phishinglogboek op gebeurtenisniveau: één rij per waargenomen simulatie-interactie (datum, actie, e-mailadres van de ontvanger, onderwerp, afzender, moeilijkheidsgraad). Het blijft long-form: de geschiedenis van een persoon wordt niet samengevoegd tot één resultaat. De query vouwt een voorafgaande periode van 12 kalendermaanden in occurred_after (middernacht UTC op dezelfde dag van de maand twaalf maanden geleden, dus niet een periode van 365 dagen). Installatie, inloggegevens, paginering en nieuwe pogingen bij rate limits zijn hetzelfde als in de connectiviteitshandleiding voor Power BI / Excel. Voeg eerst de gedeelde Fn_FetchAll-query toe; dit rapport roept deze bij naam aan.

​

Vereiste sleutelscopes

Een sleutel met alleen simulation:read kan het reporting-events-endpoint niet aanroepen (de API retourneert 403). Zie het juiste detailniveau kiezen.

​

Bronendpoints

Toegestane filters voor de lijst met gebeurtenissen (alles wat daarbuiten valt, retourneert 400): limit, page_token, simulation, entity, event_type, occurred_after. Deze reporting-familie is een preview-dataset. Bekijk het datasetschema en het databeleid op GET /v1/reporting/datasets en GET /v1/reporting/datasets/simulation_events.

​

Detailniveau

Eén rij per reporting-simulatiegebeurtenis. Een persoon die hetzelfde bericht eerst opende en er vervolgens op klikte, levert twee rijen op. Gebeurtenissen met een null-waarde voor entity_id (geen actor / ontvanger / doeldeelnemer) verschijnen nog steeds; email is dan null. Het API-venster wordt met één minuut verruimd; de exacte occurred_at >= WindowStart-grens wordt lokaal opnieuw toegepast, zodat het voorafgaande jaar er niet van afhangt of de server occurred_after als inclusief of exclusief behandelt. Aanvraagbudget: één gepagineerde doorloop van gebeurtenissen in het venster, plus één doorloop van entiteiten. Stel altijd limit = "500" in.

​

Kolommapping

De legacy-kolomnamen zijn afkomstig uit de export van uw vorige provider. De /v1-velden zijn de openbare API-namen; de query gebruikt voor sommige ervan aliassen in het rapport.

​

Actietokens

action is het gesloten reporting-token. De legacy-waarde “Email Sent” wordt gemapt naar simulation.delivered (delivered is het openbare werkwoord; het wire-token is simulation.delivered). Extra velden die behouden blijven omdat de API ze bevat: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, plus entity_type en entity_status uit de entiteitskoppeling.

​

Afwijkingen ten opzichte van de legacy-export

• Het ruwe IP-adres is nooit beschikbaar. /v1 maakt het ruwe client-IP-adres niet zichtbaar. Dit is privacy by design en geen openstaande mapping. De query voegt geen tijdelijke IP-kolom toe.
• Het apparaattype is afgeleid, niet ruw. device_type is een afgeleide apparaatklasse voor klik-, verzend- en meldgebeurtenissen. Waargenomen tokens zijn onder meer desktop, mobile, tablet en unknown, maar de emitter slaat een vrije tekenreeks op; behandel deze als open tekst, niet als een gesloten enum. De waarde is null wanneer de gebeurtenis geen afgeleide klasse heeft, en de ruwe user_agent-tekenreeks blijft privé.
• “Email Sent” is simulation.delivered. Gebruik dat token wanneer u verzendingen filtert of telt. Zoek niet naar een legacy-tekenreeks email_sent.
• Het e-mailadres van de ontvanger is een koppeling, geen veld op de gebeurtenis. De reporting-gebeurtenis bevat geen e-mailadres; de query doorloopt /entities om dit in te vullen.
• Voorafgaande 12 kalendermaanden, niet een periode van 365 dagen en niet de volledige geschiedenis.
• Long-form, niet samengevoegd. Eén rij per interactie, niet één resultaat per persoon.

​

Volgende stappen