Logg över e-postphishing

Den här rapporten är en phishinglogg på händelsenivå: en rad per observerad simuleringsinteraktion (datum, åtgärd, mottagarens e-postadress, ämne, avsändare, svårighetsgrad). Den förblir i långformat – en persons historik slås inte samman till ett enda resultat. Frågan omfattar de senaste 12 kalendermånaderna i occurred_after (midnatt UTC på samma dag i månaden tolv månader tillbaka – inte en period på 365 dagar). Konfiguration, autentiseringsuppgifter, paginering och nya försök vid hastighetsbegränsning fungerar på samma sätt som i anslutningsguiden för Power BI / Excel. Lägg först till den delade frågan Fn_FetchAll; den här rapporten anropar den vid namn.

​

Nödvändiga nyckelbehörigheter

En nyckel som endast har beviljats simulation:read kan inte anropa slutpunkten för rapporteringshändelser (API:et returnerar 403). Se välj rätt detaljnivå.

​

Källslutpunkter

Tillåtna filter för händelselistan (allt annat returnerar 400): limit, page_token, simulation, entity, event_type, occurred_after. Den här rapporteringsfamiljen är en förhandsgranskningsdatamängd. Granska datamängdens schema och dataprinciper på GET /v1/reporting/datasets och GET /v1/reporting/datasets/simulation_events.

​

Detaljnivå

En rad per rapporteringssimuleringshändelse. En person som öppnade och sedan klickade på samma meddelande ger två rader. Händelser med ett null-värde för entity_id (ingen aktör / mottagare / målmottagare) visas ändå – email är null. API-fönstret utökas med en minut; den exakta gränsen för occurred_at >= WindowStart tillämpas på nytt lokalt, så att det senaste året inte beror på om servern behandlar occurred_after som inklusive eller exklusive. Begäranbudget: en paginerad genomgång av händelser i fönstret, plus en genomgång av entiteter. Ange alltid limit = "500".

​

Kolumnmappning

Äldre kolumnnamn kommer från din tidigare leverantörs export. /v1-fälten är de offentliga API-namnen; frågan använder alias för några av dem i rapporten.

​

Åtgärdstoken

action är den slutna rapporteringstoken. Äldre ”Email Sent” mappas till simulation.delivered (delivered är det offentliga verbet; token i själva överföringen är simulation.delivered). Extra fält som behålls eftersom API:et har dem: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, samt entity_type och entity_status från entitetskopplingen.

​

Avvikelser från den äldre exporten

• Rå IP-adress är aldrig tillgänglig. /v1 exponerar inte klientens råa IP-adress – det är integritet genom design, inte en väntande mappning. Frågan lägger inte till någon platshållarkolumn för IP.
• Enhetstyp är härledd, inte rå. device_type är en härledd enhetsklass för klick-, inskicknings- och rapporteringshändelser. Observerade token är bland annat desktop, mobile, tablet och unknown, men sändaren lagrar en fri sträng – behandla den som öppen text, inte som en sluten uppräkning. Den är null när händelsen saknar härledd klass, och den råa user_agent-strängen förblir privat.
• ”Email Sent” är simulation.delivered. Använd den token när du filtrerar eller räknar utskick. Leta inte efter en äldre email_sent-sträng.
• Mottagarens e-postadress är en koppling, inte ett fält på händelsen. Rapporteringshändelsen utelämnar e-postadressen; frågan går igenom /entities för att fylla i den.
• Senaste 12 kalendermånaderna, inte en period på 365 dagar och inte hela historiken.
• Långformat, inte sammanslaget. En rad per interaktion, inte ett resultat per person.

​

Nästa steg