> ## 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.
# יומן פישינג בדוא"ל
> יצירה מחדש של יומן פישינג ברמת אירוע של ספק קודם, מתוך אירועי סימולציה וישויות בדיווח של /v1.
דוח זה הוא יומן פישינג ברמת אירוע: שורה אחת לכל אינטראקציית סימולציה שנצפתה (תאריך, פעולה, כתובת דוא"ל של הנמען, נושא, שולח, רמת קושי). הוא נשאר בפורמט ארוך — הוא אינו מכווץ את ההיסטוריה של אדם לתוצאה אחת.
השאילתה מקפלת **12 חודשי לוח** אחרונים אל תוך `occurred_after`
(חצות UTC באותו יום בחודש לפני שנים עשר חודשים — ולא משך של 365 ימים).
כתובת IP גולמית של הלקוח אינה מופיעה לעולם ב-`/v1` — זהו עיקרון של פרטיות מעצם התכנון, ולא מיפוי שממתין להשלמה. סוג המכשיר הוא סיווג נגזר בשורת האירוע; הערך הגולמי
`user_agent` נשאר פרטי. ראו
[הבדלים ביחס לייצוא הקודם](#%D7%94%D7%91%D7%93%D7%9C%D7%99%D7%9D-%D7%91%D7%99%D7%97%D7%A1-%D7%9C%D7%99%D7%99%D7%A6%D7%95%D7%90-%D7%94%D7%A7%D7%95%D7%93%D7%9D).
ההגדרה, האישורים, ההחלוקה לעמודים וניסיונות חוזרים במקרה של הגבלת קצב זהים ל[מדריך החיבור ל-Power BI / Excel](/he/developers/v1/powerbi). הוסיפו תחילה את שאילתת `Fn_FetchAll` המשותפת; דוח זה קורא לה בשמה.
## היקפי מפתח נדרשים
| היקף | שימוש |
| - | - |
| `reporting:read` | `GET /v1/reporting/simulation_events` |
| `entity:read` | `GET /v1/entities` (צירוף לפי דוא"ל ושם תצוגה) |
מפתח שניתן לו רק `simulation:read` אינו יכול לקרוא לנקודת הקצה של אירועי הדיווח (ה-API מחזיר `403`). ראו
[בחירת רמת הפירוט המתאימה](/he/developers/v1/powerbi#%D7%91%D7%97%D7%99%D7%A8%D7%AA-%D7%A8%D7%9E%D7%AA-%D7%94%D7%A4%D7%99%D7%A8%D7%95%D7%98-%D7%94%D7%A0%D7%9B%D7%95%D7%A0%D7%94).
## נקודות קצה מקור
| נקודת קצה | תפקיד |
| - | - |
| `GET /v1/reporting/simulation_events` | עובדה ברמת אירוע. רמת הפירוט היא אינטראקציה מוקלדת אחת. `email_subject`, `sender_email`, `sender_domain` ו-`difficulty_tier` נמצאים בשורה זו, ולכן השאילתה אינה מצרפת תוצאות ברמת קמפיין עבור שדות אלה. |
| `GET /v1/entities` | מפענחת `entity_id` ← דוא"ל / שם תצוגה. אירוע הדיווח אינו כולל את כתובת הדוא"ל של הנמען (החרגה מוחלטת בקורא הדיווח). מעבר על `/entities` הוא האופן שבו מתמלאת עמודת "email" מהייצוא הקודם. |
מסננים מותרים ברשימת האירועים (כל מסנן אחר מחזיר `400`):
`limit`, `page_token`, `simulation`, `entity`, `event_type`,
`occurred_after`.
משפחת דיווח זו היא [מערך נתוני תצוגה מקדימה](/he/developers/v1/powerbi#%D7%9E%D7%A2%D7%A8%D7%9B%D7%99-%D7%A0%D7%AA%D7%95%D7%A0%D7%99%D7%9D-%D7%9C%D7%93%D7%99%D7%95%D7%95%D7%97-%D7%91%D7%92%D7%A8%D7%A1%D7%AA-%D7%AA%D7%A6%D7%95%D7%92%D7%94-%D7%9E%D7%A7%D7%93%D7%99%D7%9E%D7%94-%D7%A4%D7%99%D7%A9%D7%99%D7%A0%D7%92-%D7%91%D7%A8%D7%9E%D7%AA-%D7%90%D7%93%D7%9D).
ניתן לעיין בסכמת מערך הנתונים ובמדיניות הנתונים בכתובות
`GET /v1/reporting/datasets` ו-
`GET /v1/reporting/datasets/simulation_events`.
### רמת פירוט
שורה אחת לכל אירוע סימולציה בדיווח. אדם שפתח ולאחר מכן לחץ על אותה הודעה יוצר שתי שורות. אירועים עם `entity_id` ריק
(ללא משתתף פועל / נמען / יעד) עדיין מופיעים — `email` ריק.
חלון ה-API מורחב בדקה אחת; הגבול המדויק של
`occurred_at >= WindowStart` מוחל מחדש באופן מקומי, כך שהשנה האחרונה אינה תלויה בשאלה אם השרת מתייחס ל-`occurred_after` ככולל או כבלעדי.
תקציב בקשות: מעבר אחד מחולק לעמודים על האירועים בחלון, ועוד מעבר אחד על הישויות. הקפידו תמיד להגדיר את `limit = "500"`.
## מיפוי עמודות
שמות העמודות הקודמים לקוחים מהייצוא של הספק הקודם שלכם. שדות `/v1` הם שמות ה-API הציבוריים; השאילתה נותנת כינוי לחלקם עבור הדוח.
| עמודה קודמת | שדה `/v1` או נגזרת | עמודה בדוח |
| - | - | - |
| Date | `Event.occurred_at` (כתאריך; `occurred_at` הגולמי נשמר כ-`datetimezone`) | `date` |
| Action | `Event.event_type` — אסימונים סגורים המפורטים להלן | `action` |
| Email | `Entity.email` (צירוף לפי `entity_id`) | `email` |
| Subject | `Event.email_subject` | `subject` |
| From | `Event.sender_email` | `from` |
| Difficulty | `Event.difficulty_tier` — מספר שלם 1–5, כאשר 1 הקל ביותר ו-5 הקשה ביותר | `difficulty` |
| Raw IP | אינו מופיע לעולם ב-`/v1` | מושמט, לא מאופס |
| Device type | `Event.device_type` — סיווג נגזר; ריק כאשר לאירוע אין סיווג נגזר | `device_type` |
### אסימוני פעולה
`action` הוא אסימון הדיווח הסגור. "Email Sent" מהייצוא הקודם ממופה ל-`simulation.delivered` (`delivered` הוא הפועל הציבורי; האסימון בפרוטוקול הוא `simulation.delivered`).
| ערך `action` |
| - |
| `simulation.delivered` |
| `simulation.opened` |
| `simulation.link_clicked` |
| `simulation.credentials_submitted` |
| `simulation.attachment_opened` |
| `simulation.reported` |
| `simulation.bounced` |
| `simulation.qr_scanned` |
| `simulation.replied` |
שדות נוספים נשמרים מפני שה-API כולל אותם: `sender_domain`, `full_name`,
`event_id`, `entity_id`, `simulation_id`, `occurred_at`, וכן
`entity_type` ו-`entity_status` מצירוף הישויות.
## הבדלים ביחס לייצוא הקודם
* **כתובת IP גולמית אינה זמינה לעולם.** `/v1` לא יחשוף כתובת IP גולמית של לקוח — זהו עיקרון של פרטיות מעצם התכנון, ולא מיפוי שממתין להשלמה. השאילתה אינה מוסיפה עמודת IP זמנית.
* **סוג המכשיר נגזר ואינו גולמי.** `device_type` הוא סיווג מכשיר נגזר עבור אירועי לחיצה, שליחה ודיווח. האסימונים שנצפו כוללים
`desktop`, `mobile`, `tablet` ו-`unknown`, אך המשדר שומר מחרוזת חופשית — יש להתייחס אליה כטקסט פתוח ולא כמספר סגור של ערכים. הוא ריק כאשר לאירוע אין סיווג נגזר, ומחרוזת `user_agent` הגולמית נשארת פרטית.
* **"Email Sent" הוא `simulation.delivered`.** השתמשו באסימון זה בעת סינון או ספירה של שליחות. אל תחפשו מחרוזת `email_sent` מהייצוא הקודם.
* **כתובת הדוא"ל של הנמען היא צירוף ולא שדה באירוע.** אירוע הדיווח אינו כולל דוא"ל; השאילתה עוברת על `/entities` כדי למלא אותו.
* **12 חודשי לוח אחרונים**, ולא משך של 365 ימים, ולא ההיסטוריה המלאה.
* **פורמט ארוך, ללא כיווץ.** שורה אחת לכל אינטראקציה, ולא תוצאה אחת לכל אדם.
## השלבים הבאים
אישורים, החלוקה לעמודים וטעינת שאילתות אלה ב-Power BI או ב-Excel.
סיכום לכל אדם של לחיצות, אישורים ודיווחים ב-12 החודשים האחרונים.
הרשמות להדרכה ברמת אדם × הקצאה.
הענקת `reporting:read` ו-`entity:read` למפתח שמרענן דוח זה.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.