> ## 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. # Sähköpostiphishing-loki > Luo aiemman palveluntarjoajan tapahtumatason phishing-loki uudelleen /v1-raportoinnin simulaatiotapahtumista ja entiteeteistä. Tämä raportti on tapahtumatason phishing-loki: yksi rivi jokaista havaittua simulaatiovuorovaikutusta kohden (päivämäärä, toiminto, vastaanottajan sähköpostiosoite, aihe, lähettäjä, vaikeustaso). Raportti pysyy pitkässä muodossa – se ei tiivistä henkilön historiaa yhdeksi tulokseksi. Kysely rajaa mukaan viimeiset **12 kalenterikuukautta** `occurred_after`-arvolla (UTC-keskiyö saman kuukaudenpäivän kohdalla kaksitoista kuukautta sitten – ei 365 päivän kestoa). Raaka asiakkaan IP-osoite ei koskaan sisälly kohteeseen `/v1` – tämä on tietosuojan huomioiva suunnitteluratkaisu, ei odottava yhdistämistyö. Laitetyyppi on tapahtumariville johdettu luokka; raaka `user_agent` pysyy yksityisenä. Katso [Poikkeamat vanhasta viennistä](#poikkeamat-vanhasta-viennist%C3%A4). Asetukset, tunnistetiedot, sivutus ja nopeusrajoituksen uudelleenyritys ovat samat kuin [Power BI- ja Excel-yhteysoppaassa](/fi/developers/v1/powerbi). Lisää ensin jaettu `Fn_FetchAll`-kysely; tämä raportti kutsuu sitä nimellä. ## Vaaditut avaimen oikeudet | Oikeus | Käyttötarkoitus | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (sähköpostiosoitteen ja näyttönimen liitos) | Avain, jolle on myönnetty vain `simulation:read`, ei voi kutsua raportoinnin tapahtumien rajapintaa (API palauttaa `403`). Katso [valitse oikea tarkkuustaso](/fi/developers/v1/powerbi#valitse-oikea-granulaarisuus). ## Lähderajapinnat | Rajapinta | Rooli | | - | - | | `GET /v1/reporting/simulation_events` | Tapahtumatason faktataulu. Tarkkuustaso on yksi tyypitetty vuorovaikutus. `email_subject`, `sender_email`, `sender_domain` ja `difficulty_tier` ovat tällä rivillä, joten kysely ei liitä kampanjatason tuloksia näitä kenttiä varten. | | `GET /v1/entities` | Muuntaa `entity_id`-arvon sähköpostiosoitteeksi / näyttönimeksi. Raportointitapahtuma jättää vastaanottajan sähköpostiosoitteen pois (ehdoton poissulkeminen raportointilukijassa). Vanhan "email"-sarakkeen täyttö tapahtuu käymällä läpi `/entities`. | Sallittujen luettelossa olevat suodattimet tapahtumaluettelossa (kaikki muu palauttaa `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Tämä raportointiperhe on [esikatseluaineisto](/fi/developers/v1/powerbi#reporting-esikatselutietojoukot-henkil%C3%B6kohtainen-phishing). Tarkastele aineiston skeemaa ja tietokäytäntöjä osoitteissa `GET /v1/reporting/datasets` ja `GET /v1/reporting/datasets/simulation_events`. ### Tarkkuustaso Yksi rivi jokaista raportoinnin simulaatiotapahtumaa kohden. Henkilö, joka avasi ja sen jälkeen napsautti samaa viestiä, tuottaa kaksi riviä. Tapahtumat, joiden `entity_id` on tyhjä (ei toimijaa / vastaanottajaa / kohdeosallistujaa), näkyvät silti – `email` on tyhjä. API-ikkunaa laajennetaan yhdellä minuutilla; tarkka `occurred_at >= WindowStart`-raja sovelletaan uudelleen paikallisesti, jotta viimeisen vuoden rajaus ei riipu siitä, käsitteleekö palvelin `occurred_after`-arvoa mukaan lukien vai sen ulkopuolelle jättäen. Pyyntöbudjetti: yksi sivutettu läpikäynti ikkunan tapahtumista sekä yksi läpikäynti entiteeteistä. Aseta aina `limit = "500"`. ## Sarakkeiden vastaavuus Vanhat sarakenimet ovat aiemman palveluntarjoajasi viennistä. `/v1`-kentät ovat julkisia API-nimiä; kysely antaa osalle niistä raportissa aliaksen. | Vanha sarake | `/v1`-kenttä tai johtaminen | Raportin sarake | | - | - | - | | Date | `Event.occurred_at` (päivämääränä; raaka `occurred_at` säilytetään nimellä `datetimezone`) | `date` | | Action | `Event.event_type` – suljetut tunnisteet alla | `action` | | Email | `Entity.email` (liitos avaimella `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – kokonaisluku 1–5, 1 helpoin, 5 vaikein | `difficulty` | | Raw IP | Ei koskaan kohteessa `/v1` | Jätetty pois, ei nollattu | | Device type | `Event.device_type` – johdettu luokka; tyhjä, jos tapahtumalla ei ole johdettua luokkaa | `device_type` | ### Toimintotunnisteet `action` on suljettu raportointitunniste. Vanha "Email Sent" vastaa arvoa `simulation.delivered` (`delivered` on julkinen verbi; siirrossa käytettävä tunniste on `simulation.delivered`). | `action`-arvo | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Lisäkentät, jotka on säilytetty, koska API sisältää ne: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, sekä `entity_type` ja `entity_status` entiteettiliitoksesta. ## Poikkeamat vanhasta viennistä * **Raaka IP-osoite ei ole koskaan saatavilla.** `/v1` ei paljasta raakaa asiakkaan IP-osoitetta – tämä on tietosuojan huomioiva suunnitteluratkaisu, ei odottava yhdistämistyö. Kysely ei lisää paikkamerkkinä toimivaa IP-saraketta. * **Laitetyyppi on johdettu, ei raaka.** `device_type` on johdettu laiteluokka napsautus-, lähetys- ja ilmoitustapahtumille. Havaittuja tunnisteita ovat `desktop`, `mobile`, `tablet` ja `unknown`, mutta lähettäjä tallentaa vapaamuotoisen merkkijonon – käsittele sitä avoimena tekstinä, ei suljettuna luettelotyyppinä. Se on tyhjä, kun tapahtumalla ei ole johdettua luokkaa, ja raaka `user_agent`-merkkijono pysyy yksityisenä. * **"Email Sent" on `simulation.delivered`.** Käytä tätä tunnistetta, kun suodatat tai lasket lähetyksiä. Älä etsi vanhaa `email_sent`-merkkijonoa. * **Vastaanottajan sähköpostiosoite on liitos, ei tapahtuman kenttä.** Raportointitapahtuma jättää sähköpostiosoitteen pois; kysely käy läpi `/entities` täyttääkseen sen. * **Viimeiset 12 kalenterikuukautta**, ei 365 päivän kestoa eikä koko historiaa. * **Pitkä muoto, ei tiivistetty.** Yksi rivi vuorovaikutusta kohden, ei yksi tulos henkilöä kohden. ## Seuraavat vaiheet Tunnistetiedot, sivutus ja näiden kyselyjen lataaminen Power BI:hin tai Exceliin. Henkilökohtainen 12 kuukauden yhteenveto napsautuksista, tunnistetiedoista ja ilmoituksista. Koulutus-ilmoittautumiset henkilö × tehtävä -tarkkuustasolla. Myönnä `reporting:read` ja `entity:read` tämän raportin päivittävälle avaimelle. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.