E-mail-phishinglog

Denne rapport er en phishinglog på hændelsesniveau: én række pr. observeret simulationsinteraktion (dato, handling, modtagerens e-mail, emne, afsender, sværhedsgrad). Den forbliver i langt format – den samler ikke en persons historik i ét enkelt resultat. Forespørgslen omfatter de seneste 12 kalendermåneder i occurred_after (midnat UTC på samme dag i måneden for tolv måneder siden – ikke en varighed på 365 dage). Opsætning, legitimationsoplysninger, paginering og genforsøg ved rate limit er de samme som i vejledningen til Power BI-/Excel-forbindelse. Tilføj først den delte Fn_FetchAll-forespørgsel; denne rapport kalder den ved navn.

​

Påkrævede nøgleomfang

En nøgle, der kun har fået simulation:read, kan ikke kalde endpointet for rapporteringshændelser (API’en returnerer 403). Se vælg det rette detaljeringsniveau.

​

Kildeendpoints

Tilladte filtre på hændelseslisten (alt andet returnerer 400): limit, page_token, simulation, entity, event_type, occurred_after. Denne rapporteringsfamilie er et forhåndsvisningsdatasæt. Undersøg datasættets skema og datapolitikker på GET /v1/reporting/datasets og GET /v1/reporting/datasets/simulation_events.

​

Detaljeringsniveau

Én række pr. rapporteringssimulationshændelse. En person, der åbnede og derefter klikkede på den samme besked, giver to rækker. Hændelser med en null-værdi for entity_id (ingen aktør / modtager / målrettet deltager) vises stadig – email er null. API-vinduet udvides med ét minut; den præcise occurred_at >= WindowStart-grænse anvendes igen lokalt, så det seneste år ikke afhænger af, om serveren behandler occurred_after som inklusiv eller eksklusiv. Anmodningsbudget: ét pagineret gennemløb af hændelser i vinduet plus ét gennemløb af entiteter. Angiv altid limit = "500".

​

Kolonnemapping

De tidligere kolonnenavne stammer fra din tidligere udbyders eksport. /v1-felterne er de offentlige API-navne; forespørgslen giver nogle af dem aliasser i rapporten.

​

Handlingstokens

action er det lukkede rapporteringstoken. Den tidligere “Email Sent” mappes til simulation.delivered (delivered er det offentlige verbum; wire-tokenet er simulation.delivered). Ekstra felter, der bevares, fordi API’en har dem: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at samt entity_type og entity_status fra entitetsjoinet.

​

Afvigelser fra den tidligere eksport

• Rå IP er aldrig tilgængelig. /v1 eksponerer ikke rå klient-IP – det er privacy by design og ikke en afventende mapping. Forespørgslen tilføjer ikke en pladsholderkolonne for IP.
• Enhedstype er afledt, ikke rå. device_type er en afledt enhedsklasse for klik-, indsendelses- og rapporteringshændelser. Observerede tokens omfatter desktop, mobile, tablet og unknown, men emitteren gemmer en fritekststreng – behandl den som åben tekst, ikke som en lukket enum. Den er null, når hændelsen ikke har nogen afledt klasse, og den rå user_agent-streng forbliver privat.
• “Email Sent” er simulation.delivered. Brug dette token, når du filtrerer eller tæller udsendelser. Søg ikke efter en tidligere email_sent-streng.
• Modtagerens e-mail er et join, ikke et felt på hændelsen. Rapporteringshændelsen udelader e-mail; forespørgslen gennemløber /entities for at udfylde den.
• De seneste 12 kalendermåneder, ikke en varighed på 365 dage og ikke hele historikken.
• Langt format, ikke samlet. Én række pr. interaktion, ikke ét resultat pr. person.

​

Næste trin