Proofpoint Email Protection

במסמך הזה מוסבר איך לשלב את Proofpoint Email Protection עם Google SecOps.

שילוב של Proofpoint Email Protection עם Google Security Operations

הוראות מפורטות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

נתוני קלט של שילוב

כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:

פרמטרים
API Root חובה

נתיב הבסיס של ה-API במופע של Proofpoint Email Protection שלכם.
Username חובה

שם המשתמש במופע של Proofpoint Email Protection.
Password חובה

הסיסמה של מופע Proofpoint Email Protection שלכם.
Verify SSL אופציונלי

אם מסומנת, המערכת בודקת שאישור ה-SSL של החיבור לשרת Proofpoint תקף.

פעולות

לפני שמריצים פעולות, חשוב להגדיר את הפרמטרים שלהן, אם יש כאלה.

העשרת ישויות

העשרת ישויות באמצעות Proofpoint Email Protection.

ישויות

הפעולה הזו מופעלת בישויות הבאות:

  • שם המארח
  • משתמש

הוספת נתונים לפעולה

לא רלוונטי

פלט של פעולות

סוג הפלט של הפעולה
קיר המארז לא רלוונטי
קישור לקיר של הפנייה לא רלוונטי
טבלת קיר עם תושבת לא רלוונטי
טבלת העשרה יש גישה
תוצאה בפורמט JSON לא רלוונטי
תוצאת הסקריפט יש גישה
העשרה של ישויות
שדה העשרה לוגיקה
dlpviolation לא רלוונטי
messagestatus לא רלוונטי
תוצאת הסקריפט
שם התוצאה של הסקריפט ערך
is_success נכון/לא נכון

פינג

בודקים את הקישוריות של שרת ההגנה של Proofpoint.

ישויות

הפעולה הזו מופעלת על כל הישויות.

הוספת נתונים לפעולה

לא רלוונטי

פלט של פעולות

סוג הפלט של הפעולה
קיר המארז לא רלוונטי
קישור לקיר של הפנייה לא רלוונטי
טבלת קיר עם תושבת לא רלוונטי
טבלת העשרה לא רלוונטי
תוצאה בפורמט JSON לא רלוונטי
תוצאת הסקריפט יש גישה
תוצאת הסקריפט
שם התוצאה של הסקריפט ערך
is_success נכון/לא נכון

חיפוש אימיילים בהסגר

אפשר להשתמש בפעולה Search Quarantined Emails כדי לעקוב אחרי מידע על הודעות שהועברו להסגר ב-Proofpoint Email Protection ולנתח אותו.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה חיפוש אימיילים שהוכנסו להסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUID אופציונלי

מזהה ה-GUID הייחודי של ההודעה לחיפוש.
Message ID אופציונלי

מזהה ייחודי של הודעת אינטרנט לחיפוש.
Sender אופציונלי

כתובת האימייל של השולח.
Recipient אופציונלי

כתובת האימייל של הנמען.
Subject אופציונלי

הנושא של האימייל שהועבר להסגר.
Time Frame אופציונלי

מציינים מסגרת זמן לתוצאות.

הערכים האפשריים הם:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

ערך ברירת המחדל הוא Last Hour.
Start Time אופציונלי

מציינים את שעת ההתחלה של התוצאות בפורמט ISO 8601. חובה לכלול את הפרמטר הזה אם בוחרים באפשרות Custom לפרמטר Time Frame.
End Time אופציונלי

מציינים את שעת הסיום של התוצאות בפורמט ISO 8601. אם לא מציינים ערך והערך Custom נבחר לפרמטר Time Frame, המערכת משתמשת בשעה הנוכחית.
Folder Name אופציונלי

השם של תיקיית ההסגר. ערך ברירת המחדל הוא Quarantine.
Query ID אופציונלי

מזהה שמשמש את לקוח REST למעקב אחרי תוצאות החיפוש.
Fetch DLP Violation אופציונלי

בוחרים את רמת הנתונים של הפרות DLP שרוצים לאחזר.

הערכים האפשריים הם:

  • No
  • Basic
  • Detailed

ערך ברירת המחדל הוא No.
Fetch Message Status אופציונלי

אם האפשרות הזו נבחרה, המערכת מאחזרת את סטטוס ההודעה ואת התגובות. האפשרות הזו לא מסומנת כברירת מחדל.
Max Results To Return אופציונלי

המספר המקסימלי של תוצאות שיוחזרו. ערך ברירת המחדל הוא 100. הערך המקסימלי הוא 1000.

פלט של פעולות

הפעולה חיפוש אימיילים בהסגר מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת יש גישה
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Search Quarantined Emails (חיפוש אימיילים בהסגר):

[
  {
    "processingserver": "mta1",
    "date": "2026-05-25 09:30:00",
    "subject": "Test Subject",
    "messageid": "message-id-2",
    "folder": "PCI",
    "size": 1200,
    "rcpts": [
      "recipient@example.com"
    ],
    "from": "sender@example.com",
    "spamscore": 99,
    "guid": "message-guid-1",
    "host_ip": "10.10.10.10",
    "localguid": "14:14:7"
  }
]
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה חיפוש אימיילים בהסגר:

שם התוצאה של הסקריפט ערך
is_success true או false

העברת אימייל בהסגר

כדי להעביר הודעות שנמצאות בהסגר לנמען אחר, משתמשים בפעולה העברת אימייל שנמצא בהסגר. הערה: הפעולה הזו פועלת על הודעות שנוצרו ב-30 הימים האחרונים. הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה העברת אימייל שהוכנס להסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

רשימה מופרדת בפסיקים של מזהי GUID של הודעות בהסגר.
Folder Name חובה

שם התיקייה שבה ההודעה מאוחסנת.
Deleted Folder Name אופציונלי

התיקייה שאליה תועבר ההודעה אחרי ההעברה.
New Subject אופציונלי

הנושא המקורי מוחלף.
Append Old Subject אופציונלי

אם האפשרות הזו נבחרה, הנושא המקורי יצורף לנושא של ההודעה המועברת. ההגדרה מושבתת כברירת מחדל.
From Address אופציונלי

שינוי כתובת השולח.
Header From אופציונלי

מחליף את הכותרת 'מאת'.
To Address חובה

כתובות האימייל של הנמענים שאליהם תתבצע ההעברה.
New Body Comment אופציונלי

תגובה חדשה בגוף ההודעה.

פלט של פעולות

הפעולה העברת אימייל בהסגר מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה העברת אימייל שהוכנס להסגר:

{
  "success": [
    {
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "folder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "james.bond@siemplifycyarx.onmicrosoft.com",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה העברה של אימייל שהוכנס להסגר:

שם התוצאה של הסקריפט ערך
is_success true או false
הודעות פלט של פעולות

הפעולה העברת אימייל בהסגר מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully forwarded quarantined email(s) in Proofpoint Email Protection. הפעולה הסתיימה בהצלחה.
Error executing action "Forward Quarantined Email". Reason: ERROR_REASON הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

הוצאת אימייל מההסגר

משתמשים בפעולה הוצאת אימייל מההסגר כדי להוציא מההסגר הודעות ספציפיות.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה שחרור אימייל שהוכנס להסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

רשימה מופרדת בפסיקים של מזהי GUID של הודעות בהסגר.
Folder Name חובה

שם התיקייה שבה ההודעה מאוחסנת.
Deleted Folder Name אופציונלי

התיקייה שאליה תועבר ההודעה אחרי השחרור.
Rescan Message אופציונלי

אם האפשרות הזו נבחרה, המערכת תסרוק מחדש את ההודעה שהועברה באמצעות DLP והגנה על קבצים מצורפים. ההגדרה מושבתת כברירת מחדל.
Branding Template אופציונלי

תבנית המיתוג שבה יש להשתמש כשהסרטון מוכן לפרסום.
Security Policy אופציונלי

פרופיל מאובטח של תגובות ב-Reader.

פלט של פעולות

הפעולה שחרור אימייל שהוכנס להסגר מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה

תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה שחרור אימייל שהוכנס להסגר:

{
  "success": [
    {
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "quarantinefolder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "james.bond@siemplifycyarx.onmicrosoft.com",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה שחרור אימייל שהוכנס להסגר:

שם התוצאה של הסקריפט ערך
is_success true או false
הודעות פלט של פעולות

הפעולה שחרור אימייל בהסגר מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully released quarantined email(s) in Proofpoint Email Protection. הפעולה הסתיימה בהצלחה.
Error executing action "Release Quarantined Email". Reason: ERROR_REASON הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

מחיקה של אימייל בהסגר

כדי למחוק סופית הודעות בהסגר מתיקיית ההסגר של Proofpoint, משתמשים בפעולה מחיקת אימייל בהסגר.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה מחיקת אימייל בהסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

מזהי ה-GUID הייחודיים של ההודעות שרוצים למחוק. תומך ברשימה מופרדת בפסיקים עבור מזהי GUID מרובים.
Folder Name חובה

שם התיקייה שבה ההודעה מאוחסנת (לדוגמה, Quarantine או PCI).
Time Frame אופציונלי

מציינים מסגרת זמן לתוצאות.

הערכים האפשריים הם:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

ערך ברירת המחדל הוא Last Hour.
Start Time אופציונלי

מציינים את שעת ההתחלה של התוצאות בפורמט ISO 8601. חובה לכלול את הפרמטר הזה אם בוחרים באפשרות Custom לפרמטר Time Frame.
End Time אופציונלי

מציינים את שעת הסיום של התוצאות בפורמט ISO 8601. אם לא מציינים ערך והערך Custom נבחר לפרמטר Time Frame, המערכת משתמשת בשעה הנוכחית.
Deleted Folder Name אופציונלי

שם התיקייה שאליה יועברו ההודעות שנמחקו.

פלט של פעולות

הפעולה מחיקה של אימייל בהסגר מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה מחיקת אימייל בהסגר:

שם התוצאה של הסקריפט ערך
is_success true או false

העברת אימייל בהסגר

משתמשים בפעולה העברת אימייל להסגר כדי להעביר הודעות בהסגר לתיקיית יעד או לתור כללים שצוינו.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה העברת אימייל בהסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

מזהי ה-GUID הייחודיים של ההודעות שרוצים להעביר. תומך ברשימה מופרדת בפסיקים עבור מזהי GUID מרובים.
Folder Name חובה

שם התיקייה שבה ההודעה מאוחסנת (לדוגמה, Quarantine או PCI).
Time Frame אופציונלי

מציינים מסגרת זמן לתוצאות.

הערכים האפשריים הם:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

ערך ברירת המחדל הוא Last Hour.
Start Time אופציונלי

מציינים את שעת ההתחלה של התוצאות בפורמט ISO 8601. חובה לכלול את הפרמטר הזה אם בוחרים באפשרות Custom לפרמטר Time Frame.
End Time אופציונלי

מציינים את שעת הסיום של התוצאות בפורמט ISO 8601. אם לא מציינים ערך והערך Custom נבחר לפרמטר Time Frame, המערכת משתמשת בשעה הנוכחית.
Target Folder Name חובה

שם תיקיית היעד שאליה יועברו האימיילים שהוכנסו להסגר.

פלט של פעולות

הפעולה העברת אימייל בהסגר מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה העברת אימייל שהוכנס להסגר:

שם התוצאה של הסקריפט ערך
is_success true או false

שליחה מחדש של אימייל שהועבר להסגר

משתמשים בפעולה שליחה מחדש של אימייל בהסגר כדי לשלוח מחדש הודעות ספציפיות בהסגר בחזרה לתור של תהליך הסינון הראשי לצורך הערכה מחדש.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Resubmit Quarantined Email (שליחה מחדש של אימייל שהוכנס להסגר) דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

מזהי ה-GUID הייחודיים של ההודעות שרוצים לשלוח מחדש. תומך ברשימה מופרדת בפסיקים עבור מזהי GUID מרובים.
Folder Name חובה

שם התיקייה שבה ההודעה מאוחסנת (לדוגמה, Quarantine או PCI).
Time Frame אופציונלי

מציינים מסגרת זמן לתוצאות.

הערכים האפשריים הם:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

ערך ברירת המחדל הוא Last Hour.
Start Time אופציונלי

מציינים את שעת ההתחלה של התוצאות בפורמט ISO 8601. חובה לכלול את הפרמטר הזה אם בוחרים באפשרות Custom לפרמטר Time Frame.
End Time אופציונלי

מציינים את שעת הסיום של התוצאות בפורמט ISO 8601. אם לא מציינים ערך והערך Custom נבחר לפרמטר Time Frame, המערכת משתמשת בשעה הנוכחית.

פלט של פעולות

הפעולה שליחה מחדש של אימייל שהוכנס להסגר מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה שליחה מחדש של אימייל שהוכנס להסגר:

שם התוצאה של הסקריפט ערך
is_success true או false

הורדה של אימייל בהסגר

אפשר להשתמש בפעולה הורדת אימייל בהסגר כדי להוריד נתוני הודעות גולמיים של אימיילים שהוכנסו להסגר ב-30 הימים האחרונים.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה הורדת אימייל שהוכנס להסגר דורשת את הפרמטרים הבאים:

פרמטרים
Message GUIDs חובה

מזהי ה-GUID הייחודיים של ההודעות באימיילים שרוצים להוריד.
Folder Name אופציונלי

השם של התיקייה שבה ההודעה מאוחסנת. אם לא מציינים ערך, ברירת המחדל היא Quarantine.
Download Folder Path חובה

נתיב התיקייה שבה צריך לאחסן את הקובץ. ערך ברירת המחדל הוא /tmp.
Overwrite חובה

אם בוחרים באפשרות הזו, כל קובץ קיים עם אותו שם יידרס. ההגדרה הזו מופעלת כברירת מחדל.
Save To Case Wall אופציונלי

אם האפשרות הזו מסומנת, הקובץ שהורדתם נשמר כקובץ מצורף בפיד של בקשת התמיכה. ההגדרה מושבתת כברירת מחדל.

פלט של פעולות

הפעולה הורדה של אימייל בהסגר מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז יש גישה
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה הורדת אימייל בהסגר:

{
  "success": [
    {
      "downloaded_file_path": "/tmp/filename",
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "folder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "data",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}
תוצאת הסקריפט

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה הורדת אימייל שהוכנס להסגר:

שם התוצאה של הסקריפט ערך
is_success true או false
הודעות פלט של פעולות

הפעולה הורדה של אימייל בהסגר מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully downloaded quarantined email(s) in Proofpoint Email Protection. הפעולה הסתיימה בהצלחה.
Error executing action "Download Quarantined Email". Reason: ERROR_REASON הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את פרמטרי הקלט או את פרטי הכניסה.

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.