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

# المستخدمون الأكثر عرضة للاختراق

> أعد إنشاء تقرير المستخدمين الأكثر عرضة للاختراق لمدة 12 شهرًا الذي كان يوفره مزود سابق، وذلك من نتائج المحاكاة والكيانات في /v1.

هذا التقرير هو ملخص تجميعي لمدى التعرض للاختراق على مستوى كل مستخدم خلال 12 شهرًا: صف واحد لكل
شخص تلقى محاكاة واحدة على الأقل خلال السنة الأخيرة، مع أعداد ونسب النقرات
وبيانات الاعتماد والإبلاغات، وسلسلة النقرات الحالية، وقائمة مجمّعة
لنتائج آخر 5 محاكاات.

تبلغ مدة النافذة الزمنية **12 شهرًا تقويميًا** (منتصف الليل بالتوقيت العالمي المنسق في اليوم نفسه من الشهر
قبل اثني عشر شهرًا)، وليست مدة 365 يومًا.

<Note>
  تُستبعد تفاعلات الماسحات الآلية / الروبوتات من أعداد النقرات
  وبيانات الاعتماد. وهذا اختلاف متعمد عن التصدير القديم. راجع
  [الاختلافات عن التصدير القديم](#%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D9%84%D8%A7%D9%81%D8%A7%D8%AA-%D8%B9%D9%86-%D8%A7%D9%84%D8%AA%D8%B5%D8%AF%D9%8A%D8%B1-%D8%A7%D9%84%D9%82%D8%AF%D9%8A%D9%85).
</Note>

إن الإعداد وبيانات الاعتماد والترقيم الصفحي وإعادة المحاولة عند تجاوز حد المعدل هي نفسها الواردة في
[دليل الاتصال بـ Power BI / Excel](/ar/developers/v1/powerbi). أضف أولًا استعلام
`Fn_FetchAll` المشترك؛ إذ يستدعيه هذا التقرير بالاسم.

## نطاقات المفاتيح المطلوبة

| النطاق | الاستخدام |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (الربط عبر البريد الإلكتروني واسم العرض) |

يستخدم هذا التقرير قائمة النتائج **التشغيلية** على مستوى كل شخص،
وليس عائلة المعاينة الخاصة بالتقارير. لا يمكن لمفتاح مُنح `reporting:read` فقط أن يستدعي
`GET /v1/simulation_results` (تُرجع واجهة برمجة التطبيقات `403`). راجع
[اختيار مستوى التفصيل المناسب](/ar/developers/v1/powerbi#%D8%A7%D8%AE%D8%AA%D8%B1-%D9%85%D8%B3%D8%AA%D9%88%D9%89-%D8%A7%D9%84%D8%AA%D9%81%D8%B5%D9%8A%D9%84-%D8%A7%D9%84%D9%85%D9%86%D8%A7%D8%B3%D8%A8).

## نقاط النهاية المصدر

| نقطة النهاية | الدور |
| - | - |
| `GET /v1/simulation_results` | النتيجة لكل مستلم. وهذا هو مستوى تفصيل الحقائق. |
| `GET /v1/entities` | يحوّل `entity` ← البريد الإلكتروني / اسم العرض. لا يحتوي صف النتيجة على بريد المستلم الإلكتروني أو اسم العرض الخاص به (بل `entity` فقط). |

المرشحات المسموح بها في قائمة النتائج: `limit` و`page_token` و
`simulation` و`entity`. لا يوجد `delivered_after` / `start_date` في
هذه القائمة، ولذلك تُطبَّق فترة الأشهر الـ 12 الأخيرة في Power Query بعد
المرور الكامل على جميع النتائج.

الحقول المستخدمة في كل نتيجة: `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`.

### مستوى التفصيل

صف واحد لكل كيان لديه نتيجة واحدة على الأقل مع `delivered_at` خلال
الأشهر التقويمية الـ 12 الأخيرة. لا يظهر الشخص الذي استُهدف ولكن لم تُسلَّم إليه أي رسالة. وتُدمج هنا
المحاكاة المتعددة للشخص نفسه.

ميزانية الطلبات: مرور واحد مقسّم إلى صفحات على جميع نتائج المحاكاة في
المؤسسة، بالإضافة إلى مرور واحد على الكيانات. اضبط `limit = "500"` دائمًا.

## أولوية النتائج (`last_5_assessments`)

تُلخَّص كل نتيجة من النتائج الخمس الأحدث المُسلَّمة (بترتيب `delivered_at`
التنازلي) على أنها `YYYY-MM-DD: <outcome>`. يُعتمد أول طابع زمني مطابق،
بدءًا من الأعلى أولوية:

| الأولوية | الطابع الزمني | تسمية النتيجة |
| - | - | - |
| 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` |

الحالة «مُسلَّمة فقط» هي `no action` (وصلت الرسالة؛ ولم يفعل الشخص
شيئًا). أما الشخص الذي نقر ثم أبلغ لاحقًا فهو `clicked` — فالإبلاغ
لا يتقدم على التفاعل الخطر في هذه القائمة. وتحصل الصفوف الموسومة كروبوتات
على تسمية نتيجة من الطوابع الزمنية الموجودة؛ لكنها فقط
لا تزيد أعداد النقرات / بيانات الاعتماد.

**سلسلة النقرات الحالية:** امرّ على نتائج الرسائل المُسلَّمة نفسها بدءًا من الأحدث
واحسب الصفوف المتتالية التي يكون فيها `clicked_at` غير فارغ **و**
`bot_activity_detected` لا يساوي `true`. توقف عند أول صف لا يستوفي ذلك.

## مطابقة الأعمدة

أسماء الأعمدة القديمة مأخوذة من تصدير مزودك السابق. حقول `/v1`
هي أسماء واجهة برمجة التطبيقات العامة؛ ويشتق الاستعلام الأعداد والنسب.

| العمود القديم | حقل `/v1` أو طريقة الاشتقاق | عمود التقرير |
| - | - | - |
| Email | `Entity.email` (الربط عبر `Result.entity`) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | عدد النتائج التي يكون فيها `delivered_at` غير فارغ (يشمل الصفوف الموسومة كروبوتات) | `total_received` |
| Clicks # | عدد الحالات التي يكون فيها `clicked_at` غير فارغ **و** `bot_activity_detected` ≠ `true` | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | عدد الحالات التي يكون فيها `credential_submitted_at` غير فارغ **و** `bot_activity_detected` ≠ `true` | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | عدد الحالات التي يكون فيها `reported_at` غير فارغ (تشمل الروبوتات — فهي ليست نقرة / بيانات اعتماد) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | عدد نتائج الرسائل المُسلَّمة الأحدث المتتالية التي نقر عليها الشخص (تقطعها الروبوتات) | `current_click_streak` |
| Last 5 assessments | نتائج الرسائل الخمس الأحدث المُسلَّمة، مفصولة بـ `"; "` (راجع [الأولوية](#أولوية-النتائج-last_5_assessments)) | `last_5_assessments` |
| Directory extras (department, …) | غير موجودة في `/v1` | محذوفة وليست فارغة |

مفتاح الربط المحتفَظ به لنموذج المخطط النجمي: `entity_id`.

## الاختلافات عن التصدير القديم

* **يُستبعد نشاط الروبوتات من أعداد النقرات وبيانات الاعتماد.** كان تصدير
  المزود السابق يحتسب تفاعلات الماسحات الآلية / الروبوتات
  كنقرات وعمليات إرسال لبيانات الاعتماد. أما هذا الاستعلام فلا يفعل ذلك. فالنتيجة التي
  تحمل `bot_activity_detected = true` تظل محاكاة مُسلَّمة — إذ
  تُحتسب في `total_received` وفي إجماليات الإبلاغ — لكنها
  تُعامل على أنها ليست نقرة وليست عملية إرسال: فهي مستبعدة من
  `clicks` / `credential_submissions` وتقطع سلسلة النقرات
  الحالية. لا «تصحح» ذلك باحتساب الروبوتات لمطابقة التصدير القديم.
* **الإبلاغ لا يتقدم على النقرة** في `last_5_assessments`. فالشخص
  الذي نقر ثم أبلغ لاحقًا يُسمّى `clicked`.
* **الحقول الإضافية في الدليل محذوفة وليست فارغة.** القسم وما شابهه من
  الحقول غير موجودة في `/v1`.
* **لا يوجد مرشح زمني من جهة الخادم.** لا يحتوي `GET /v1/simulation_results` على
  `delivered_after`. يمرّ الاستعلام على كل النتيجة، ثم يُبقي
  `delivered_at` ضمن الأشهر التقويمية الـ 12 الأخيرة. وقد تستهلك
  المؤسسة الكبيرة ذات السجل التاريخي الواسع جزءًا أكبر من ميزانية المعدل لكل مفتاح
  مقارنة بقائمة مرشَّحة.

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="إعداد Power BI وExcel" href="/ar/developers/v1/powerbi">
    بيانات الاعتماد والترقيم الصفحي وتحميل هذه الاستعلامات في Power BI أو Excel.
  </Card>

  <Card title="سجل التصيد عبر البريد الإلكتروني" href="/ar/developers/v1/reports/email-phishing-log">
    تفاعلات التصيد على مستوى الأحداث خلال الأشهر الـ 12 الأخيرة.
  </Card>

  <Card title="الامتثال لكل شخص" href="/ar/developers/v1/reports/per-person-compliance">
    تسجيلات التدريب على مستوى الشخص × التكليف.
  </Card>

  <Card title="مفاتيح واجهة برمجة التطبيقات" href="/ar/developers/developer-hub/api-keys">
    امنح `simulation:read` و`entity:read` للمفتاح الذي يحدّث هذا التقرير.
  </Card>
</CardGroup>


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