> ## 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.
# Pengguna paling rentan
> Buat ulang rekap pengguna paling rentan selama 12 bulan dari penyedia sebelumnya menggunakan hasil simulasi dan entitas /v1.
Laporan ini adalah rekap kerentanan per pengguna selama 12 bulan: satu baris untuk
setiap orang yang menerima setidaknya satu simulasi dalam setahun terakhir,
dengan jumlah dan persentase klik / kredensial / pelaporan, rangkaian klik saat ini, dan
daftar gabungan lima hasil terakhir.
Jendela waktunya adalah **12 bulan kalender** (pukul 00.00 UTC pada tanggal yang sama
dua belas bulan lalu), bukan durasi 365 hari.
Interaksi pemindai / bot otomatis tidak dihitung dalam jumlah klik dan
kredensial. Hal ini merupakan perbedaan yang disengaja dari ekspor
lama. Lihat
[Perbedaan dari ekspor lama](#perbedaan-dari-ekspor-lama).
Penyiapan, kredensial, paginasi, dan percobaan ulang saat terkena batas laju sama dengan
[panduan konektivitas Power BI / Excel](/id/developers/v1/powerbi). Tambahkan terlebih dahulu kueri
`Fn_FetchAll` bersama; laporan ini memanggilnya berdasarkan nama.
## Cakupan kunci yang diperlukan
| Cakupan | Digunakan untuk |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (penggabungan email dan nama tampilan) |
Laporan ini menggunakan daftar hasil per orang yang **operasional**, bukan
rangkaian pratinjau pelaporan. Kunci yang hanya diberi `reporting:read` tidak dapat memanggil
`GET /v1/simulation_results` (API mengembalikan `403`). Lihat
[pilih granularitas yang tepat](/id/developers/v1/powerbi#pilih-granularitas-yang-tepat).
## Endpoint sumber
| Endpoint | Peran |
| - | - |
| `GET /v1/simulation_results` | Hasil per penerima. Ini adalah granularitas fakta. |
| `GET /v1/entities` | Menyelesaikan `entity` → email / nama tampilan. Baris hasil tidak memiliki email atau nama tampilan penerima sendiri (hanya `entity`). |
Filter yang diizinkan pada daftar hasil: `limit`, `page_token`,
`simulation`, `entity`. Tidak ada `delivered_after` / `start_date` pada
daftar ini, sehingga 12 bulan terakhir diterapkan di Power Query setelah
seluruh data ditelusuri.
Kolom yang digunakan pada setiap hasil: `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`.
### Granularitas
Satu baris untuk setiap entitas yang memiliki setidaknya satu hasil dengan `delivered_at` dalam
12 bulan kalender terakhir. Orang yang menjadi target tetapi tidak pernah menerima pengiriman
tidak muncul. Beberapa simulasi untuk orang yang sama digabungkan di sini.
Anggaran permintaan: satu penelusuran berpaginasi atas seluruh hasil simulasi di
organisasi, ditambah satu penelusuran entitas. Selalu atur `limit = "500"`.
## Prioritas hasil (`last_5_assessments`)
Masing-masing dari lima hasil terkirim terbaru (`delivered_at`
menurun) diringkas sebagai `YYYY-MM-DD: `. Stempel waktu pertama yang cocok
menang, dengan prioritas tertinggi lebih dahulu:
| Prioritas | Stempel waktu | Label hasil |
| - | - | - |
| 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` |
Hanya terkirim adalah `no action` (pesan sudah diterima; orang tersebut
tidak melakukan apa pun). Orang yang mengklik lalu melaporkan adalah `clicked` — pelaporan
tidak mengungguli interaksi berisiko pada daftar ini. Baris yang ditandai bot tetap
mendapat label hasil dari stempel waktu yang ada; baris tersebut hanya tidak
menambah jumlah klik / kredensial.
**Rangkaian klik saat ini:** telusuri hasil terkirim yang sama dari yang terbaru
dan hitung baris berturut-turut yang `clicked_at`-nya tidak null **dan**
`bot_activity_detected`-nya bukan `true`. Berhenti pada ketidakcocokan pertama.
## Pemetaan kolom
Nama kolom lama berasal dari ekspor penyedia Anda sebelumnya. Kolom `/v1`
adalah nama API publik; kueri menurunkan jumlah dan persentasenya.
| Kolom lama | Kolom atau penurunan `/v1` | Kolom laporan |
| - | - | - |
| Email | `Entity.email` (gabungkan pada `Result.entity`) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | Jumlah hasil dengan `delivered_at` tidak null (termasuk baris yang ditandai bot) | `total_received` |
| Clicks # | Jumlah dengan `clicked_at` tidak null **dan** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | Jumlah dengan `credential_submitted_at` tidak null **dan** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | Jumlah dengan `reported_at` tidak null (termasuk bot — bukan klik/kredensial) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | Hasil terkirim terbaru secara berturut-turut yang diklik orang tersebut (bot memutusnya) | `current_click_streak` |
| Last 5 assessments | Lima hasil terkirim terbaru, dipisahkan dengan `"; "` (lihat [prioritas](#prioritas-hasil-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | Tidak ada di `/v1` | Dihilangkan, bukan diisi null |
Kunci gabungan yang dipertahankan untuk model skema bintang: `entity_id`.
## Perbedaan dari ekspor lama
* **Aktivitas bot tidak dihitung dalam jumlah klik dan kredensial.** Ekspor
penyedia sebelumnya menghitung interaksi pemindai / bot otomatis
sebagai klik dan pengiriman kredensial. Kueri ini tidak demikian. Hasil dengan
`bot_activity_detected = true` tetap merupakan simulasi yang terkirim — hasil tersebut
dihitung dalam `total_received` dan dalam agregat pelaporan — tetapi
diperlakukan sebagai bukan klik dan bukan pengiriman: hasil tersebut dikecualikan dari
`clicks` / `credential_submissions` dan memutus rangkaian klik
saat ini. Jangan "memperbaikinya" dengan menghitung bot agar sesuai dengan ekspor lama.
* **Pelaporan tidak mengungguli klik** pada `last_5_assessments`. Orang
yang mengklik lalu melaporkan diberi label `clicked`.
* **Tambahan direktori dihilangkan, bukan diisi null.** Departemen dan kolom
serupa tidak ada di `/v1`.
* **Tidak ada filter waktu sisi server.** `GET /v1/simulation_results` tidak memiliki
`delivered_after`. Kueri menelusuri setiap hasil, lalu hanya mempertahankan
`delivered_at` dalam 12 bulan kalender terakhir. Organisasi dengan riwayat besar
mungkin menghabiskan lebih banyak anggaran batas laju per kunci dibandingkan
daftar yang difilter.
## Langkah berikutnya
Kredensial, paginasi, dan memuat kueri ini di Power BI atau Excel.
Interaksi phishing tingkat peristiwa selama 12 bulan terakhir.
Pendaftaran Pelatihan pada granularitas orang × penugasan.
Berikan `simulation:read` dan `entity:read` pada kunci yang menyegarkan laporan ini.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.