> ## 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-postlogg for phishing

> Gjenskap en tidligere leverandørs phishing-logg på hendelsesnivå fra /v1-rapporteringens simuleringshendelser og entiteter.

Denne rapporten er en phishing-logg på hendelsesnivå: én rad per observerte simuleringsinteraksjon (dato, handling, mottakerens e-postadresse, emne, avsender, vanskelighetsgrad). Den forblir i langt format – den slår ikke sammen en persons historikk til ett enkelt resultat.

Spørringen samler de siste **12 kalendermånedene** i `occurred_after`
(midnatt UTC på samme dag i måneden for tolv måneder siden – ikke en varighet på 365 dager).

<Note>
  Rå IP-adresse for klienten finnes aldri på `/v1` – personvern som er innebygd i designet, ikke en ventende tilordning. Enhetstype er en avledet klasse på hendelsesraden; rå
  `user_agent` forblir privat. Se
  [Avvik fra den tidligere eksporten](#avvik-fra-den-tidligere-eksporten).
</Note>

Oppsett, legitimasjon, paginering og nye forsøk ved rate-begrensning er de samme som i
[veiledningen for Power BI / Excel-tilkobling](/no/developers/v1/powerbi). Legg først til den delte
`Fn_FetchAll`-spørringen; denne rapporten kaller den ved navn.

## Nødvendige nøkkelomfang

| Omfang | Brukes til |
| - | - |
| `reporting:read` | `GET /v1/reporting/simulation_events` |
| `entity:read` | `GET /v1/entities` (kobling av e-postadresse og visningsnavn) |

En nøkkel som kun har fått `simulation:read` kan ikke kalle endepunktet for rapporteringshendelser (API-et returnerer `403`). Se
[velg riktig granularitet](/no/developers/v1/powerbi#velg-riktig-granularitet).

## Kildeendepunkter

| Endepunkt | Rolle |
| - | - |
| `GET /v1/reporting/simulation_events` | Faktatabell på hendelsesnivå. Granulariteten er én registrert interaksjon. `email_subject`, `sender_email`, `sender_domain` og `difficulty_tier` finnes på denne raden, så spørringen kobler ikke til resultater på kampanjenivå for disse feltene. |
| `GET /v1/entities` | Løser `entity_id` → e-postadresse / visningsnavn. Rapporteringshendelsen utelater mottakerens e-postadresse (en fast utelukkelse i rapporteringsleseren). Gjennomgang av `/entities` er måten den tidligere «email»-kolonnen fylles ut på. |

Tillatte filtre på hendelseslisten (alt annet returnerer `400`):
`limit`, `page_token`, `simulation`, `entity`, `event_type`,
`occurred_after`.

Denne rapporteringsfamilien er et [forhåndsvisningsdatasett](/no/developers/v1/powerbi#forh%C3%A5ndsvisningsdatasett-for-rapportering-phishing-per-person).
Inspiser datasettets skjema og datapolicyer på
`GET /v1/reporting/datasets` og
`GET /v1/reporting/datasets/simulation_events`.

### Granularitet

Én rad per rapporteringssimuleringshendelse. En person som åpnet og deretter klikket på den samme meldingen, gir to rader. Hendelser med null i `entity_id`
(ingen aktør / mottaker / målrettet deltaker) vises likevel – `email` er
null.

API-vinduet utvides med ett minutt; den nøyaktige
`occurred_at >= WindowStart`-grensen anvendes på nytt lokalt, slik at det siste året ikke avhenger av om serveren behandler `occurred_after` som
inkluderende eller ekskluderende.

Forespørselsbudsjett: én paginert gjennomgang av hendelser i vinduet, pluss én gjennomgang av entiteter. Angi alltid `limit = "500"`.

## Kolonnetilordning

Navnene på de tidligere kolonnene stammer fra eksporten fra din forrige leverandør. `/v1`-felt
er de offentlige API-navnene; spørringen gir noen av dem aliaser i rapporten.

| Tidligere kolonne | `/v1`-felt eller avledning | Rapportkolonne |
| - | - | - |
| Date | `Event.occurred_at` (som dato; rå `occurred_at` beholdes som `datetimezone`) | `date` |
| Action | `Event.event_type` – lukkede tokens er oppført nedenfor | `action` |
| Email | `Entity.email` (kobling på `entity_id`) | `email` |
| Subject | `Event.email_subject` | `subject` |
| From | `Event.sender_email` | `from` |
| Difficulty | `Event.difficulty_tier` – heltall 1–5, der 1 er enklest og 5 er vanskeligst | `difficulty` |
| Raw IP | Finnes aldri på `/v1` | Utelatt, ikke satt til null |
| Device type | `Event.device_type` – avledet klasse; null når hendelsen ikke har noen avledet klasse | `device_type` |

### Handlingstokens

`action` er det lukkede rapporteringstokenet. Den tidligere «Email Sent» tilsvarer
`simulation.delivered` (`delivered` er det offentlige verbet; token på wire er
`simulation.delivered`).

| `action`-verdi |
| - |
| `simulation.delivered` |
| `simulation.opened` |
| `simulation.link_clicked` |
| `simulation.credentials_submitted` |
| `simulation.attachment_opened` |
| `simulation.reported` |
| `simulation.bounced` |
| `simulation.qr_scanned` |
| `simulation.replied` |

Ekstra felt som beholdes fordi API-et har dem: `sender_domain`, `full_name`,
`event_id`, `entity_id`, `simulation_id`, `occurred_at`, samt
`entity_type` og `entity_status` fra entitetskoblingen.

## Avvik fra den tidligere eksporten

* **Rå IP-adresse er aldri tilgjengelig.** `/v1` eksponerer ikke rå IP-adresse for klienten –
  personvern som er innebygd i designet, ikke en ventende tilordning. Spørringen legger ikke til noen plassholderkolonne for IP.
* **Enhetstype er avledet, ikke rå.** `device_type` er en avledet enhetsklasse for klikk-, innsendings- og rapporteringshendelser. Observerte tokens inkluderer
  `desktop`, `mobile`, `tablet` og `unknown`, men avsenderen lagrer en
  fritekststreng – behandle den som åpen tekst, ikke som en lukket enum. Den er null
  når hendelsen ikke har noen avledet klasse, og den rå `user_agent`-strengen
  forblir privat.
* **«Email Sent» er `simulation.delivered`.** Bruk dette tokenet når du
  filtrerer eller teller utsendelser. Ikke let etter en tidligere `email_sent`-streng.
* **Mottakerens e-postadresse er en kobling, ikke et felt på hendelsen.** Rapporteringshendelsen utelater e-postadressen; spørringen går gjennom `/entities` for å fylle den ut.
* **Siste 12 kalendermåneder**, ikke en varighet på 365 dager, og ikke
  hele historikken.
* **Langt format, ikke sammenslått.** Én rad per interaksjon, ikke ett resultat
  per person.

## Neste steg

<CardGroup cols={2}>
  <Card title="Oppsett av Power BI og Excel" href="/no/developers/v1/powerbi">
    Legitimasjon, paginering og innlasting av disse spørringene i Power BI eller Excel.
  </Card>

  <Card title="Mest sårbare brukere" href="/no/developers/v1/reports/most-susceptible-users">
    Oppsummering per person over 12 måneder for klikk, legitimasjon og rapportering.
  </Card>

  <Card title="Etterlevelse per person" href="/no/developers/v1/reports/per-person-compliance">
    Påmeldinger til opplæring på granularitet person × tildeling.
  </Card>

  <Card title="API-nøkler" href="/no/developers/developer-hub/api-keys">
    Gi `reporting:read` og `entity:read` til nøkkelen som oppdaterer denne rapporten.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.