Protokol phishingových e-mailů

Tento report je protokol phishingu na úrovni událostí: jeden řádek odpovídá jedné zaznamenané interakci v simulaci (datum, akce, e-mail příjemce, předmět, odesílatel, obtížnost). Zůstává v dlouhém formátu – historii osoby nesloučí do jediného výsledku. Dotaz zahrnuje posledních 12 kalendářních měsíců do occurred_after (půlnoc UTC ve stejný den v měsíci před dvanácti měsíci – nejde o období 365 dnů). Nastavení, přihlašovací údaje, stránkování a opakování při dosažení limitu požadavků jsou stejné jako v průvodci připojením Power BI / Excel. Nejprve přidejte sdílený dotaz Fn_FetchAll; tento report jej volá podle názvu.

​

Požadované rozsahy klíče

Klíč, který má udělen pouze simulation:read, nemůže volat koncový bod reportingových událostí (API vrátí 403). Viz výběr správné granularity.

​

Zdrojové koncové body

Povolené filtry v seznamu událostí (cokoli jiného vrátí 400): limit, page_token, simulation, entity, event_type, occurred_after. Tato reportingová rodina je náhledová datová sada. Schéma datové sady a zásady práce s daty si můžete zobrazit na GET /v1/reporting/datasets a GET /v1/reporting/datasets/simulation_events.

​

Granularita

Jeden řádek odpovídá jedné reportingové simulační události. Osoba, která stejnou zprávu otevřela a poté na ni klikla, vytvoří dva řádky. Události s hodnotou null v entity_id (bez aktéra / příjemce / cílového účastníka) se stále zobrazují – email je null. Časové okno API je rozšířeno o jednu minutu; přesná hranice occurred_at >= WindowStart se znovu použije lokálně, aby posledních 12 měsíců nezáviselo na tom, zda server bere occurred_after jako včetně, nebo bez dané hodnoty. Rozpočet požadavků: jedno stránkované procházení událostí v daném období plus jedno procházení entit. Vždy nastavte limit = "500".

​

Mapování sloupců

Názvy původních sloupců pocházejí z exportu vašeho předchozího poskytovatele. Pole /v1 jsou veřejné názvy API; dotaz některá z nich pro report přejmenovává.

​

Tokeny akcí

action je uzavřený reportingový token. Původní „Email Sent“ se mapuje na simulation.delivered (delivered je veřejné sloveso; token v přenosu je simulation.delivered). Další pole zachovaná, protože je API poskytuje: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, a dále entity_type a entity_status z propojení entit.

​

Rozdíly oproti původnímu exportu

• Nezpracovaná IP adresa není nikdy k dispozici. /v1 nezveřejní nezpracovanou IP adresu klienta – jde o ochranu soukromí již v návrhu, nikoli o nedokončené mapování. Dotaz nepřidává zástupný sloupec IP.
• Typ zařízení je odvozený, nikoli nezpracovaný. device_type je odvozená třída zařízení pro události kliknutí, odeslání a nahlášení. Pozorované tokeny zahrnují desktop, mobile, tablet a unknown, ale odesílatel ukládá řetězec ve volném tvaru – považujte jej za volný text, nikoli za uzavřený výčet. Je null, pokud událost nemá odvozenou třídu, a nezpracovaný řetězec user_agent zůstává neveřejný.
• „Email Sent“ je simulation.delivered. Tento token použijte při filtrování nebo počítání odeslaných zpráv. Nehledejte původní řetězec email_sent.
• E-mail příjemce je výsledkem propojení, nikoli pole události. Reportingová událost e-mail neobsahuje; dotaz jej doplní procházením /entities.
• Posledních 12 kalendářních měsíců, nikoli období 365 dnů a ani celá historie.
• Dlouhý formát, nikoli sloučený. Jeden řádek na interakci, nikoli jeden výsledek na osobu.

​

Další kroky