Skip to main content
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ä.
Asetukset, tunnistetiedot, sivutus ja nopeusrajoituksen uudelleenyritys ovat samat kuin Power BI- ja Excel-yhteysoppaassa. Lisää ensin jaettu Fn_FetchAll-kysely; tämä raportti kutsuu sitä nimellä.

Vaaditut avaimen oikeudet

Avain, jolle on myönnetty vain simulation:read, ei voi kutsua raportoinnin tapahtumien rajapintaa (API palauttaa 403). Katso valitse oikea tarkkuustaso.

Lähderajapinnat

Sallittujen luettelossa olevat suodattimet tapahtumaluettelossa (kaikki muu palauttaa 400): limit, page_token, simulation, entity, event_type, occurred_after. Tämä raportointiperhe on esikatseluaineisto. 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.

Toimintotunnisteet

action on suljettu raportointitunniste. Vanha “Email Sent” vastaa arvoa simulation.delivered (delivered on julkinen verbi; siirrossa käytettävä tunniste on simulation.delivered). 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

Power BI- ja Excel-asetukset

Tunnistetiedot, sivutus ja näiden kyselyjen lataaminen Power BI:hin tai Exceliin.

Alttiimmat käyttäjät

Henkilökohtainen 12 kuukauden yhteenveto napsautuksista, tunnistetiedoista ja ilmoituksista.

Henkilökohtainen vaatimustenmukaisuus

Koulutus-ilmoittautumiset henkilö × tehtävä -tarkkuustasolla.

API-avaimet

Myönnä reporting:read ja entity:read tämän raportin päivittävälle avaimelle.