> ## 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. # E-mailes adathalászat-napló > Egy korábbi szolgáltató eseményszintű adathalászat-naplójának újraalkotása a /v1 riportolási szimulációs események és entitások alapján. Ez a riport egy eseményszintű adathalászat-napló: soronként egy megfigyelt szimulációs interakció (dátum, művelet, címzett e-mail-címe, tárgy, feladó, nehézségi szint). Hosszú formátumú marad – nem vonja össze egy személy előzményeit egyetlen eredménnyé. A lekérdezés az elmúlt **12 naptári hónapot** foglalja `occurred_after` értékbe (a tizenkét hónappal korábbi, azonos hónapnapi UTC szerinti éjfél – nem 365 napos időtartam). A nyers kliens-IP-cím soha nem szerepel itt: `/v1` – ez tudatos adatvédelmi megoldás, nem függőben lévő leképezés. Az eszköztípus az eseménysoron szereplő származtatott osztály; a nyers `user_agent` nem nyilvános. Lásd: [Eltérések a korábbi exporttól](#elt%C3%A9r%C3%A9sek-a-kor%C3%A1bbi-exportt%C3%B3l). A beállítás, a hitelesítő adatok, a lapozás és a sebességkorlát miatti újrapróbálkozás megegyezik a [Power BI / Excel csatlakozási útmutatóban](/hu/developers/v1/powerbi) leírtakkal. Először adja hozzá a közös `Fn_FetchAll` lekérdezést; ez a riport név szerint hívja meg. ## Szükséges kulcshatókörök | Hatókör | Felhasználás | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (e-mail-cím és megjelenített név összekapcsolása) | Az a kulcs, amely csak `simulation:read` jogosultságot kapott, nem hívhatja meg a riportolási eseményvégpontot (az API `403` választ ad vissza). Lásd: [a megfelelő szemcsézettség kiválasztása](/hu/developers/v1/powerbi#a-megfelel%C5%91-granularit%C3%A1s-kiv%C3%A1laszt%C3%A1sa). ## Forrásvégpontok | Végpont | Szerep | | - | - | | `GET /v1/reporting/simulation_events` | Eseményszintű ténytábla. A szemcsézettség egy típusos interakció. A `email_subject`, `sender_email`, `sender_domain` és `difficulty_tier` ezen a soron szerepel, ezért a lekérdezés ezekhez a mezőkhöz nem kapcsol kampányszintű eredményeket. | | `GET /v1/entities` | A `entity_id` azonosítót e-mail-címre / megjelenített névre oldja fel. A riportolási esemény nem tartalmazza a címzett e-mail-címét (a riportolási olvasón ez szigorú kizárás). A `/entities` bejárásával töltődik ki a korábbi „email” oszlop. | Az eseménylista engedélyezett szűrői (bármi más `400` választ eredményez): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Ez a riportolási család [előzetes adatkészlet](/hu/developers/v1/powerbi#reporting-el%C5%91n%C3%A9zeti-adatk%C3%A9szletek-szem%C3%A9lyenk%C3%A9nti-phishing). Az adatkészlet sémáját és adatkezelési szabályzatait itt tekintheti meg: `GET /v1/reporting/datasets` és `GET /v1/reporting/datasets/simulation_events`. ### Szemcsézettség Riportolási szimulációs eseményenként egy sor. Az a személy, aki megnyitotta, majd rákattintott ugyanarra az üzenetre, két sort eredményez. Azok az események is megjelennek, amelyeknél a `entity_id` null (nincs szereplő / címzett / célszemély) – ilyenkor a `email` null. Az API időablakát egy perccel kiszélesítjük; a pontos `occurred_at >= WindowStart` határt helyben újra alkalmazzuk, így az elmúlt év nem függ attól, hogy a szerver a `occurred_after` értéket zártként vagy nyitottként kezeli. Kérések költségvetése: az ablakban lévő események egy lapozott bejárása, plusz az entitások egy bejárása. Mindig állítsa be a következőt: `limit = "500"`. ## Oszlopleképezés A korábbi oszlopnevek az előző szolgáltató exportjából származnak. A `/v1` mezők a nyilvános API-nevek; a lekérdezés egyeseket álnevekkel lát el a riport számára. | Korábbi oszlop | `/v1` mező vagy származtatás | Riportoszlop | | - | - | - | | Date | `Event.occurred_at` (dátumként; a nyers `occurred_at` megmarad mint `datetimezone`) | `date` | | Action | `Event.event_type` – az alább felsorolt zárt tokenek | `action` | | Email | `Entity.email` (összekapcsolás a `entity_id` alapján) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – 1–5 közötti egész szám, 1 a legkönnyebb, 5 a legnehezebb | `difficulty` | | Raw IP | Soha nem szerepel: `/v1` | Kihagyva, nem null értékkel | | Device type | `Event.device_type` – származtatott osztály; null, ha az eseményhez nincs származtatott osztály | `device_type` | ### Műveleti tokenek A `action` a zárt riportolási token. A korábbi „Email Sent” a következőre képeződik le: `simulation.delivered` (a `delivered` a nyilvános ige; a hálózaton átvitt token a `simulation.delivered`). | `action` érték | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Az alábbi mezők azért maradnak meg, mert az API tartalmazza őket: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, valamint a `entity_type` és a `entity_status` az entitás-összekapcsolásból. ## Eltérések a korábbi exporttól * **A nyers IP-cím soha nem érhető el.** A `/v1` nem teszi elérhetővé a nyers kliens-IP-címet – ez tudatos adatvédelmi megoldás, nem függőben lévő leképezés. A lekérdezés nem ad hozzá helykitöltő IP-oszlopot. * **Az eszköztípus származtatott, nem nyers.** A `device_type` egy származtatott eszközosztály kattintási, beküldési és jelentési eseményekhez. A megfigyelt tokenek között szerepel a `desktop`, `mobile`, `tablet` és `unknown`, de a kibocsátó szabad formátumú karakterláncot tárol – kezelje nyílt szövegként, nem zárt enumként. Értéke null, ha az eseményhez nincs származtatott osztály, a nyers `user_agent` karakterlánc pedig nem nyilvános. * **Az „Email Sent” a következő: `simulation.delivered`.** Ezt a tokent használja a küldések szűrésekor vagy számolásakor. Ne keresse a korábbi `email_sent` karakterláncot. * **A címzett e-mail-címe összekapcsolással érhető el, nem az esemény mezője.** A riportolási esemény nem tartalmaz e-mail-címet; a lekérdezés a `/entities` bejárásával tölti ki. * **Az elmúlt 12 naptári hónap**, nem 365 napos időtartam, és nem a teljes előzmény. * **Hosszú formátum, nem összevont.** Interakciónként egy sor, nem személyenként egy eredmény. ## Következő lépések Hitelesítő adatok, lapozás, és ezeknek a lekérdezéseknek a betöltése Power BI-ba vagy Excelbe. Személyenkénti 12 hónapos kattintási, hitelesítőadat- és jelentési összesítés. Képzési beiratkozások személy × hozzárendelés szemcsézettséggel. Adja meg a `reporting:read` és a `entity:read` jogosultságot annak a kulcsnak, amely frissíti ezt a riportot. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.