> ## 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. # Protokol phishingových e-mailů > Znovu vytvořte protokol phishingu na úrovni událostí z předchozího poskytovatele pomocí simulačních událostí a entit z reportingu /v1. 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ů). Nezpracovaná IP adresa klienta se nikdy nevyskytuje v `/v1` – jde o ochranu soukromí již v návrhu, nikoli o nedokončené mapování. Typ zařízení je odvozená třída v řádku události; nezpracovaný `user_agent` zůstává neveřejný. Viz [Rozdíly oproti původnímu exportu](#rozd%C3%ADly-oproti-p%C5%AFvodn%C3%ADmu-exportu). 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](/cs/developers/v1/powerbi). Nejprve přidejte sdílený dotaz `Fn_FetchAll`; tento report jej volá podle názvu. ## Požadované rozsahy klíče | Rozsah | Použití | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (propojení e-mailu a zobrazovaného jména) | 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](/cs/developers/v1/powerbi#v%C3%BDb%C4%9Br-spr%C3%A1vn%C3%A9-granularity). ## Zdrojové koncové body | Koncový bod | Role | | - | - | | `GET /v1/reporting/simulation_events` | Fakta na úrovni událostí. Granularitou je jedna zadaná interakce. `email_subject`, `sender_email`, `sender_domain` a `difficulty_tier` jsou v tomto řádku, takže dotaz pro tato pole nepropojuje výsledky na úrovni kampaně. | | `GET /v1/entities` | Převádí `entity_id` na e-mail / zobrazované jméno. Reportingová událost e-mail příjemce neobsahuje (jde o pevné vyloučení v reportingovém čtečce). Sloupec „email“ z původního exportu se vyplňuje procházením `/entities`. | 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](/cs/developers/v1/powerbi#reportingov%C3%A9-n%C3%A1hledov%C3%A9-datov%C3%A9-sady-phishing-na-%C3%BArovni-osob). 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á. | Původní sloupec | Pole nebo odvození `/v1` | Sloupec reportu | | - | - | - | | Date | `Event.occurred_at` (jako datum; nezpracovaná hodnota `occurred_at` je zachována jako `datetimezone`) | `date` | | Action | `Event.event_type` – uzavřené tokeny uvedené níže | `action` | | Email | `Entity.email` (propojení přes `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – celé číslo 1–5, 1 nejlehčí, 5 nejtěžší | `difficulty` | | Raw IP | Nikdy v `/v1` | Vynecháno, nikoli null | | Device type | `Event.device_type` – odvozená třída; null, pokud událost nemá odvozenou třídu | `device_type` | ### 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`). | Hodnota `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | 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 Přihlašovací údaje, stránkování a načítání těchto dotazů v Power BI nebo Excelu. Souhrn kliknutí, zadání přihlašovacích údajů a nahlášení za 12 měsíců na jednotlivé osoby. Zápisy do Školení na úrovni osoba × přiřazení. Udělte `reporting:read` a `entity:read` klíči, který tento report obnovuje. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.