> ## 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.

# Brukere som er mest utsatt

> Gjenskap en tidligere leverandørs 12-måneders sammenstilling av mest utsatte brukere fra /v1-simuleringsresultater og -enheter.

Denne rapporten er en 12-måneders sammenstilling av mottakelighet per bruker: én rad per
person som har mottatt minst én simulering i det siste året, med
antall og andeler for klikk, legitimasjon og rapportering, en gjeldende klikkserie og
en sammenslått liste over de fem siste utfallene.

Perioden er **12 kalendermåneder** (midnatt UTC på samme dag i måneden
for tolv måneder siden), ikke en varighet på 365 dager.

<Note>
  Interaksjoner fra automatiske skannere og roboter er utelatt fra antall klikk og
  antall innsendte legitimasjoner. Dette er et bevisst avvik fra den eldre
  eksporten. Se
  [Avvik fra den eldre eksporten](#avvik-fra-den-eldre-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 |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (kobling av e-post og visningsnavn) |

Denne rapporten bruker den **operasjonelle** resultatlisten per person, ikke
familien av forhåndsvisninger for rapportering. En nøkkel som bare har fått `reporting:read` kan ikke kalle
`GET /v1/simulation_results` (API-et returnerer `403`). Se
[velg riktig granularitet](/no/developers/v1/powerbi#velg-riktig-granularitet).

## Kildeendepunkter

| Endepunkt | Rolle |
| - | - |
| `GET /v1/simulation_results` | Utfall per mottaker. Dette er faktagranulariteten. |
| `GET /v1/entities` | Løser opp `entity` → e-post / visningsnavn. Resultatraden har ingen egen e-postadresse eller eget visningsnavn for mottakeren (bare `entity`). |

Tillatte filtre i resultatlisten: `limit`, `page_token`,
`simulation`, `entity`. Denne listen har ingen `delivered_after` / `start_date`, så
de siste 12 månedene brukes i Power Query etter at
hele listen er gjennomgått.

Felt som brukes i hvert resultat: `id`, `simulation`, `entity`, `status`,
`targeted_at`, `delivered_at`, `bounced_at`, `opened_at`, `clicked_at`,
`attachment_opened_at`, `credential_submitted_at`, `reported_at`,
`reported_before_interaction`, `bot_activity_detected`, `email_subject`,
`sender_email`, `difficulty_level`, `created_at`, `updated_at`.

### Granularitet

Én rad per enhet som har minst ett resultat med `delivered_at` i de
siste 12 kalendermånedene. En person som er målgruppe, men aldri har fått levert noe, vises
ikke. Flere simuleringer for samme person slås sammen her.

Forespørselsbudsjett: én paginert gjennomgang av alle simuleringsresultater i
organisasjonen, pluss én gjennomgang av enheter. Angi alltid `limit = "500"`.

## Prioritet for utfall (`last_5_assessments`)

Hvert av de fem siste leverte resultatene (`delivered_at`
synkende) oppsummeres som `YYYY-MM-DD: <outcome>`. Det første samsvarende
tidsstempelet gjelder, med høyeste prioritet først:

| Prioritet | Tidsstempel | Utfallsetikett |
| - | - | - |
| 1 | `credential_submitted_at` | `credential submitted` |
| 2 | `clicked_at` | `clicked` |
| 3 | `attachment_opened_at` | `attachment opened` |
| 4 | `reported_at` | `reported` |
| 5 | `opened_at` | `opened` |
| 6 | `delivered_at` | `no action` |
| 7 | `bounced_at` | `bounced` |

Bare levert er `no action` (meldingen ble levert; personen
gjorde ingenting). En person som klikket og senere rapporterte er `clicked` – rapportering
rangeres ikke over en risikofylt interaksjon i denne listen. Rader merket som robot
får fortsatt en utfallsetikett basert på tidsstemplene som finnes; de øker bare ikke
antall klikk eller innsendte legitimasjoner.

**Gjeldende klikkserie:** gå gjennom de samme leverte resultatene med nyeste først
og tell påfølgende rader der `clicked_at` ikke er null **og**
`bot_activity_detected` ikke er `true`. Stopp ved første avvik.

## Kolonnetilordning

Navnene på de eldre kolonnene er hentet fra din tidligere leverandørs eksport. `/v1`-feltene
er de offentlige API-navnene; spørringen utleder antall og andeler.

| Eldre kolonne | `/v1`-felt eller utledning | Rapportkolonne |
| - | - | - |
| Email | `Entity.email` (kobling på `Result.entity`) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | Antall resultater der `delivered_at` ikke er null (inkluderer rader merket som robot) | `total_received` |
| Clicks # | Antall der `clicked_at` ikke er null **og** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | Antall der `credential_submitted_at` ikke er null **og** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | Antall der `reported_at` ikke er null (roboter inkludert – ikke et klikk/en innsendt legitimasjon) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | Påfølgende nyeste leverte resultater som personen klikket på (roboter bryter serien) | `current_click_streak` |
| Last 5 assessments | De fem nyeste leverte utfallene, atskilt med `"; "` (se [prioritet](#prioritet-for-utfall-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | Ikke på `/v1` | Utelatt, ikke satt til null |

Koblingsnøkkel beholdt for en stjerneskjemamodell: `entity_id`.

## Avvik fra den eldre eksporten

* **Robotaktivitet er utelatt fra antall klikk og innsendte legitimasjoner.** En
  tidligere leverandørs eksport telte interaksjoner fra automatiske skannere og roboter
  som klikk og innsendte legitimasjoner. Denne spørringen gjør ikke det. Et resultat med
  `bot_activity_detected = true` er fortsatt en levert simulering – det
  telles i `total_received` og i aggregater for rapportering – men det
  behandles som et ikke-klikk og en ikke-innsending: det utelates fra
  `clicks` / `credential_submissions` og bryter en gjeldende klikkserie.
  Ikke «rett opp» dette ved å telle roboter for å samsvare med den eldre eksporten.
* **Rapportering rangeres ikke over et klikk** i `last_5_assessments`. En person
  som klikket og senere rapporterte, får etiketten `clicked`.
* **Katalogtillegg er utelatt, ikke satt til null.** Avdeling og lignende
  felt finnes ikke på `/v1`.
* **Ingen tidsfilter på serversiden.** `GET /v1/simulation_results` har ingen
  `delivered_after`. Spørringen går gjennom alle resultater og beholder deretter
  `delivered_at` i de siste 12 kalendermånedene. En stor organisasjon med lang
  historikk kan bruke mer av forespørselsbudsjettet per nøkkel enn en filtrert liste
  ville gjort.

## 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="Logg over e-postphishing" href="/no/developers/v1/reports/email-phishing-log">
    Phishing-interaksjoner på hendelsesnivå for de siste 12 månedene.
  </Card>

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

  <Card title="API-nøkler" href="/no/developers/developer-hub/api-keys">
    Gi `simulation: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.