שילוב של EmailV2 עם Google SecOps

במאמר הזה מוסבר איך לשלב את EmailV2 עם Google Security Operations ‏ (Google SecOps).

תרחישים לדוגמה

השילוב של EmailV2 משתמש ביכולות של Google SecOps כדי לתמוך בתרחישים הבאים:

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

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

  • ניהול והכלה של תיבות דואר: העברה אוטומטית של אימיילים זדוניים או כאלה שעברו טריאז' מתיבת הדואר הנכנס לתיקיות הסגר או ארכיון, או מחיקה סופית של אימיילים שתואמים למסננים ספציפיים (למשל, מחיקה של כל העותקים של אימייל עם תוכנה זדונית ידועה בתיקיות שונות).

  • תשובה בשרשור ושיתוף פעולה: אתם יכולים לשלוח תשובה מיידית או תשובה מובנית בשרשור אימיילים קיים באמצעות הפעולה "שליחת תשובה בשרשור", כדי לוודא שכל הגורמים הרלוונטיים מעודכנים לגבי עדכוני האבטחה הרלוונטיים.

לפני שמתחילים

כדי שהשילוב של EmailV2 יתחבר בהצלחה לשרת הדואר, צריך לוודא שתיבת הדואר שהוגדרה מעניקה גישה לאפליקציות של צד שלישי באמצעות IMAP/SMTP.

אם אתם משתמשים בחשבון Gmail או Google Workspace, אתם צריכים להשתמש בסיסמה לאפליקציה כדי לאמת את החשבון. סיסמאות רגילות לחשבונות לא פועלות בחיבורי IMAP/SMTP לשרתי Google .

כדי להשתמש בסיסמה לאפליקציה, צריך לוודא שהדרישות הבאות מתקיימות:

  1. הפעלת אימות דו-שלבי: אפשר ליצור סיסמאות לאפליקציות רק אם האימות הדו-שלבי מופעל בחשבון Google . פרטים נוספים מופיעים במאמר הפעלת אימות דו-שלבי.

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

גישה ל-IMAP או ל-SMTP דרך הרשת

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

דרישות רשת

תפקיד יציאת ברירת המחדל כיוון פרוטוקול
תקשורת עם שרת הדואר ערכים מרובים להעברת נתונים IMAP/SMTP

פרמטרים של שילוב

בשילוב EmailV2 צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
IMAP - Use SSL

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, הפעולה מפעילה תקשורת מאובטחת (SSL/TLS) כשמתחברים לשרת ה-IMAP.

מופעלת כברירת מחדל.
SMTP - Use Authentication

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, הפעולה מפעילה אימות לחיבור ה-SMTP.

השדה הזה נדרש כששרת ה-SMTP לא נמצא בהגדרת "ממסר פתוח" ונדרשים פרטי כניסה כדי לשלוח אימיילים יוצאים.

מופעלת כברירת מחדל.
Sender's Address

חובה.

כתובת האימייל של תיבת הדואר שמשמשת את השילוב לשליחה ולקבלה של הודעות.
Sender's Display Name

חובה.

השם שמופיע כשולח כשהשילוב שולח אימיילים.
SMTP Server Address

זה שינוי אופציונלי.

שם המארח ב-DNS או כתובת ה-IP של שרת ה-SMTP שמשמש לשליחת אימיילים, למשל smtp.gmail.com.
SMTP Port

זה שינוי אופציונלי.

מספר היציאה שמשמשת לחיבור לשרת ה-SMTP, למשל 587 או 465.
IMAP Server Address

זה שינוי אופציונלי.

שם המארח ב-DNS או כתובת ה-IP של שרת ה-IMAP שנדרש כדי לאחזר אימיילים שהתקבלו, כמו imap.gmail.com.
IMAP Port

זה שינוי אופציונלי.

מספר היציאה שמשמשת לחיבור לשרת ה-IMAP, למשל 993.
Username

חובה.

שם המשתמש שנדרש לאימות מול שרת הדואר (בדרך כלל כתובת האימייל המלאה).
Password

חובה.

הסיסמה שנדרשת לאימות מול שרת הדואר.

בחשבונות Gmail או Google Workspace, צריך להזין את הסיסמה לאפליקציה בת 16 הספרות שנוצרה בהגדרות האבטחה של החשבון ב- Google.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

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

מחיקת האימייל

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

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

קלט של הפעולה

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

פרמטר תיאור
Folder Name

חובה.

רשימה מופרדת בפסיקים של תיקיות תיבת הדואר שבהן הפעולה מחפשת אימיילים.
Message IDs

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של מזהי הודעות ספציפיים שרוצים לחפש ולמחוק.

אם הרשימה הזו מסופקת, היא מבטלת את Subject Filter, Sender Filter ו-Recipient Filter.
Subject Filter

זה שינוי אופציונלי.

שורת נושא שמשמשת לצמצום החיפוש של אימיילים תואמים.
Sender Filter

זה שינוי אופציונלי.

כתובת של שולח שמשמשת לחיפוש אימיילים תואמים.
Recipient Filter

זה שינוי אופציונלי.

כתובת של נמען שמשמשת לחיפוש אימיילים תואמים.
Days Back

זה שינוי אופציונלי.

חלון הזמן (בימים) שבו הפעולה מחפשת אימיילים למחיקה.

מסגרת הזמן מחושבת ברמת פירוט של יום.

אם משתמשים בערך 0, החיפוש מוגבל לאימיילים שהתקבלו רק ביום הנוכחי.

ערך ברירת המחדל הוא 0.
Delete all matching emails

זה שינוי אופציונלי.

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

מושבתת כברירת מחדל.

ערכי פלט של פעולות

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

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

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

{
    "deleted_emails": {
        "email_1_deleted": {
            "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
            "deleted_from_folder": "Inbox",
            "subject": "Suspicious Login Alert - Deleted",
            "sender": "noreply@system.com",
            "timestamp": "2025-11-20T14:30:00Z"
        },
        "email_2_deleted": {
            "message_id": "<u1v2w3x4y5z6a7b8c9d0e1f2g3h4i5j6k7l8m9n0@mail.example.com>",
            "deleted_from_folder": "Spam",
            "subject": "Phishing Offer",
            "sender": "scam@badsite.net",
            "timestamp": "2025-11-15T09:15:00Z"
        }
    }
}
הודעות פלט

הפעולה Delete Email יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

NUMBER_OF_DELETED_EMAILS email(s) were deleted successfully

Failed to find emails for deletion!

 הפעולה בוצעה בהצלחה.

Error deleting emails ERROR_REASON

הפעולה נכשלה.

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

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

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

DownloadEmailAttachments

משתמשים בפעולה Download Email Attachments כדי לאחזר קבצים מצורפים מאימיילים ספציפיים ולשמור אותם בנתיב ייעודי בשרת Google SecOps.

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

קלט של הפעולה

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

פרמטר תיאור
Folder Name

חובה.

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

ערך ברירת המחדל הוא Inbox.
Download Path

חובה.

הנתיב בשרת Google SecOps שבו נשמרים הקבצים המצורפים שהורדתם.
Message IDs

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של מזהי הודעות שמהן רוצים להוריד קבצים מצורפים.
Subject filter

זה שינוי אופציונלי.

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

ערכי פלט של פעולות

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

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

הפעולה הורדת קבצים מצורפים לאימייל יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Downloaded NUMBER_OF_ATTACHMENTS attachments. ATTACHMENT_PATHS

 הפעולה בוצעה בהצלחה.

failed to download email attachments, the error is: ERROR_REASON

הפעולה נכשלה.

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

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

שם תוצאת הסקריפט ערך
attachments_local_paths מחרוזת של נתיבים מלאים לקבצים המצורפים שנשמרו, מופרדים בפסיקים.

העברת אימייל

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

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

קלט של הפעולה

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

פרמטר תיאור
Folder Name

חובה.

התיקיות בתיבת הדואר שבהן נמצא האימייל המקורי.

  • אם בודקים כמה תיקיות, צריך להזין רשימה מופרדת בפסיקים.
  • שם התיקייה חייב להיות זהה בדיוק לשם של תיקיית ה-IMAP.
  • אם שם התיקייה מכיל רווחים, צריך להקיף אותו במירכאות כפולות.

ערך ברירת המחדל הוא Inbox.
Message ID of the email to forward

חובה.

ה-message_id הייחודי של האימייל הקיים שהפעולה מעבירה.
Recipients

חובה.

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

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של כתובות אימייל שצריך לכלול בשדה "עותק".
BCC

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של כתובות אימייל שצריך לכלול בשדה "עותק מוסתר".
Subject

חובה.

שורת הנושא של האימייל שמועבר.
Content

זה שינוי אופציונלי.

תוכן נוסף שצריך לכלול בגוף האימייל שמועבר.
Return message id for the forwarded email

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, הפעולה מחזירה את מזהה ההודעה הייחודי של האימייל שהועבר בתוצאת ה-JSON.

מושבתת כברירת מחדל.
Attachment Paths

זה שינוי אופציונלי.

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

ערכי פלט של פעולות

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

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

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

{
   "Date"
   "message_id"
   "Recipient"
}
הודעות פלט

הפעולה העברת אימייל יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Email was forwarded successfully.

Mail was forwarded successfully. Mail message ID is: MESSAGE_ID

 הפעולה בוצעה בהצלחה.

Failed to forward the email! The Error is ERROR_REASON

הפעולה נכשלה.

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

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

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

העברת אימייל לתיקייה

משתמשים בפעולה Move Email to Folder כדי להעביר אימיילים מתיקיית מקור מסוימת לתיקיית יעד אחרת בתיבת הדואר.

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

קלט של הפעולה

הפעולה Move Email to Folder דורשת את הפרמטרים הבאים:

פרמטר תיאור
Source Folder Name

חובה.

השם של תיקיית המקור שממנה מועברים האימיילים.
Destination Folder Name

חובה.

שם תיקיית היעד שאליה מועברים האימיילים.
Message IDs

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של מזהי הודעות ספציפיים שרוצים לחפש ולהעביר.

אם הרשימה הזו מסופקת, היא מבטלת את Subject Filter.
Subject Filter

זה שינוי אופציונלי.

שורת נושא שמשמשת לצמצום החיפוש של אימיילים תואמים.
Only Unread

זה שינוי אופציונלי.

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

מושבתת כברירת מחדל.

ערכי פלט של פעולות

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

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

בדוגמה הבאה מוצג פלט התוצאות ב-JSON שמתקבל כשמשתמשים בפעולה Move Email to Folder:

{
    "emails": {
        "email_1": {
            "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1@mail.example.com>",
            "received": "Mon, 24 Nov 2025 10:00:00 +0000",
            "sender": "security-alert@example.com",
            "recipients": "user@example.com",
            "subject": "Phishing Alert: Urgent Action Required",
            "plaintext_body": "Original alert content...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Quarantine"
        },
        "email_2": {
            "message_id": "<a5b6c7d8e9f01g2h3i4j5k6l7m8n9o0p1q2r3s4t@mail.example.com>",
            "received": "Sun, 23 Nov 2025 14:30:00 +0000",
            "sender": "noreply@system.com",
            "recipients": "user@example.com",
            "subject": "System Update Notification",
            "plaintext_body": "System update successful...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Archive"
        }
    }
}
הודעות פלט

הפעולה Move Email to Folder יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

NUMBER_OF_MOVED_EMAILS mails were successfully moved from SOURCE_FOLDER עד DESTINATION_FOLDER

No mails were found matching the search criteria!

 הפעולה בוצעה בהצלחה.

Error search emails: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Move Email to Folder:

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

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Email V2.

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

קלט של הפעולה

אין.

ערכי פלט של פעולות

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

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

הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully connected to the email server server with the provided connection parameters!

 הפעולה בוצעה בהצלחה.

Failed to connect to the IMAP server! Error is ERROR_REASON

Failed to connect to the SMTP server! Error is ERROR_REASON

SMTP (or IMAP) configuration is needed to execute action. Please configure STMP (or IMAP) on integration configuration page in Content Hub.

הפעולה נכשלה.

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

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

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

שמירת קבצים מצורפים לאימייל בבקשת התמיכה

הפעולה שמירת קבצים מצורפים לאימייל בפנייה מאפשרת לאחזר קבצים מצורפים מאימיילים ספציפיים בתיבת הדואר ולשמור אותם באופן אוטומטי ישירות ב-Case Wall של הפנייה הנוכחית.

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

קלט של הפעולה

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

פרמטר תיאור
Folder Name

חובה.

רשימה מופרדת בפסיקים של תיקיות תיבת הדואר שבהן הפעולה מחפשת את האימייל.
Message ID

זה שינוי אופציונלי.

מזהה ההודעה הייחודי של האימייל שממנו רוצים להוריד קבצים מצורפים.
Attachment To Save

זה שינוי אופציונלי.

השם הספציפי של הקובץ המצורף שנשמר.

אם לא מציינים ערך, הפעולה שומרת את כל הקבצים המצורפים מהאימייל ב-Case Wall.

ערכי פלט של פעולות

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

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

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

{
    "saved_attachments_from_email": {
        "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
        "subject": "Email with Malicious Attachment",
        "sender": "external@suspicious.com",
        "attachments_saved": [
            {
                "file_name": "Invoice_Q3_2025.pdf",
                "file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
                "saved_to_case_wall": "True"
            },
            {
                "file_name": "Report_Data.docx",
                "file_hash_md5": "b3e0c1a9f8d7c6b5a4e3d2c1b0a9f8e7",
                "saved_to_case_wall": "True"
            }
        ]
    }
}
הודעות פלט

הפעולה Save Email Attachments to Case יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully saved the following attachments from the email MESSAGE_ID: MESSAGE_INFO

 הפעולה בוצעה בהצלחה.

Failed to save the email attachments to the case, the error is: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Save Email Attachments to Case:

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

חיפוש אימייל

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

הפעולה מאחזרת פרטים על ההודעות התואמות בקובץ JSON, שאפשר להשתמש בו לניתוח אוטומטי או ידני לאחר מכן.

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

קלט של הפעולה

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

פרמטר תיאור
Folder Name

חובה.

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

ערך ברירת המחדל הוא Inbox.
Subject Filter

זה שינוי אופציונלי.

שורת נושא שמשמשת לצמצום החיפוש של אימיילים תואמים.
Sender Filter

זה שינוי אופציונלי.

כתובת של שולח שמשמשת לחיפוש אימיילים תואמים.
Recipient Filter

זה שינוי אופציונלי.

כתובת של נמען שמשמשת לחיפוש אימיילים תואמים.
Time frame (minutes)

חובה.

חלון הזמן (בדקות) שבו החיפוש בודק אימיילים.

ערך ברירת המחדל הוא 60.
Only Unread

זה שינוי אופציונלי.

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

מושבתת כברירת מחדל
Max Emails To Return

חובה.

המספר המקסימלי של אימיילים שהפעולה מחזירה כתוצאה.

ערך ברירת המחדל הוא 100.

ערכי פלט של פעולות

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

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

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

{
    "emails": {
        "email_1": {
            "message id": "<CAJP=A_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Mon, 26 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user1@example.com,user2@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "pdfdocument.pdf",
            "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        },
        "email_2": {
            "message id": "<WEAA=D_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Wen, 21 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user3@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "photo.jpg",        "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
            "attachmment_2": "word_document.docx",
            "attachment_2_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        }
    }
}
הודעות פלט

הפעולה חיפוש אימייל יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Search found NUMBER_OF_FOUND_EMAILS emails based on the provided search criteria

Search didn't found any matching emails

 הפעולה בוצעה בהצלחה.

Search didn't completed successfully due to error: ERROR_REASON

הפעולה נכשלה.

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

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

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

שלח אימייל

משתמשים בפעולה Send Email כדי לשלוח אימיילים מתיבת הדואר שהוגדרה לכמה נמענים.

הפעולה הזו מחזירה את מזהה ההודעה, ואז אפשר להשתמש בו בפעולה Wait for Email From User כדי לעקוב אחרי התשובות של המשתמשים ולשלוט בהפעלה של הפלייבוק.

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

קלט של הפעולה

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

פרמטר תיאור
Recipients

חובה.

כתובות האימייל של הנמענים הראשיים.

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

זה שינוי אופציונלי.

כתובות האימייל שצריך לכלול בשדה "עותק" (CC).

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

זה שינוי אופציונלי.

כתובות האימייל שצריך לכלול בשדה "עותק מוסתר" (Bcc).

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

חובה.

שורת הנושא של הודעת האימייל.
Content

חובה.

התוכן של הודעת האימייל.
Return message id for the sent email

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, הפעולה מחזירה את מזהה ההודעה הייחודי בתוצאת ה-JSON.

הפעולה Wait for Email From User יכולה להשתמש במזהה הזה כדי לעקוב אחרי התשובות.

מושבתת כברירת מחדל.
Attachments Paths

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של נתיבי קבצים מוחלטים בשרת לקבצים מצורפים.

ערכי פלט של פעולות

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

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

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

{
    "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1-10013525-100078757@example.com>"
}
הודעות פלט

הפעולה שליחת אימייל יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Mail sent successfully.

Mail sent successfully. Mail message ID is: MESSAGE_ID

 הפעולה בוצעה בהצלחה.

Execution Failed: ERROR_REASON

הפעולה נכשלה.

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

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

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

שליחת תשובה לשרשור

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

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

קלט של הפעולה

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

פרמטר תיאור
Message ID

חובה.

המזהה הייחודי של ההודעה שאליה נשלחת התשובה.
Folder Name

חובה.

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

שם התיקייה חייב להיות זהה בדיוק לשם של תיקיית ה-IMAP. אם השם מכיל רווחים, צריך להקיף אותו במירכאות כפולות (למשל, "[Gmail]/All Mail").

ערך ברירת המחדל הוא Inbox.
Content

חובה.

התוכן של הודעת התשובה.
Attachment Paths

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של נתיבי קבצים בשרת, של קבצים מצורפים שרוצים לכלול בתשובה.
Reply All

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, התשובה נשלחת לכל הנמענים בשרשור האימיילים המקורי.

הפרמטר הזה מקבל עדיפות על פני Reply To.

מופעלת כברירת מחדל.
Reply To

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של כתובות אימייל ספציפיות שאליהן תישלח התשובה.

אם המדיניות Reply All מושבתת ולא צוין ערך, התשובה נשלחת רק לשולח של האימייל המקורי.

ערכי פלט של פעולות

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

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

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

{
    "message_id": "<162556278608.14165.480701790user@example>",
    "recipients": "test@example.com"
}
הודעות פלט

הפעולה שליחת תשובה לשרשור יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully sent reply to the message with ID MESSAGE_ID in Exchange.

 הפעולה בוצעה בהצלחה.

Error executing action "Send Thread Reply". Reason: ERROR_REASON

הפעולה נכשלה.

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

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

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

המתנה לאימייל מהמשתמש

משתמשים בפעולה Wait for Email From User כדי להשהות את ההפעלה של הפלייבוק ולעקוב אחרי תיבת דואר כדי לראות אם התקבלה תשובה להודעה שנשלחה קודם באמצעות הפעולה Send Email.

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

קלט של הפעולה

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

פרמטר תיאור
Email Message_id

חובה.

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

אם ההודעה נשלחה באמצעות הפעולה "שליחת אימייל", צריך לבחור באפשרות SendEmail.JSONResult.message_id כפלייסהולדר.
Email Date

חובה.

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

אם ההודעה נשלחה באמצעות הפעולה "שליחת אימייל", משתמשים בפלייסהולדר SendEmail.JSONResult.email_date.
Email Recipients

חובה.

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

אם ההודעה נשלחה באמצעות הפעולה "שליחת אימייל", משתמשים בפלייסהולדר SendEmail.JSONResult.email_date.
Wait stage timeout (minutes)

זה שינוי אופציונלי.

משך הזמן (בדקות) שהפעולה ממתינה לתשובה לפני שהיא מסמנת את שלב ההמתנה כפג תוקף.

ערך ברירת המחדל הוא 1440.
Wait for all recipients to reply?

זה שינוי אופציונלי.

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

מופעלת כברירת מחדל.
Wait stage exclude pattern

זה שינוי אופציונלי.

תבנית של ביטוי רגולרי שמשמשת להחרגת תשובות ספציפיות (כמו הודעות אוטומטיות של "לא בעבודה") כדי שלא ייחשבו כתשובות תקינות.
Folder to check for reply

זה שינוי אופציונלי.

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

הפרמטר הזה תלוי אותיות רישיות.

ערך ברירת המחדל הוא Inbox.
Fetch Response Attachments

זה שינוי אופציונלי.

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

מושבתת כברירת מחדל.

ערכי פלט של פעולות

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

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

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

{
    "Responses":
    {[
     "user1@example.com": "Approved",
     "user2@example.com": "",
     "user3@example.com": ""
     ]}
}
תוצאת הסקריפט

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

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

מחברים

איך מגדירים מחברים ב-Google SecOps?

מחבר אימייל גנרי של IMAP

אתם יכולים להשתמש ב-Generic IMAP Email Connector כדי להתחבר מדי פעם לשרת דואר IMAP ולבדוק אם יש אימיילים חדשים בתיבת דואר מסוימת. המחבר מעבד אימיילים חדשים כמעט בזמן אמת, ומתרגם אותם להתראות ולמקרים לפי ההקשר בפלטפורמת Google SecOps.

בעיות ומגבלות ידועות

  1. קבצים מצורפים ב-Outlook‏ (‎.eml): יכול להיות שהמחבר לא יעבד קבצים מצורפים שהומרו לפורמט ‎ .eml על ידי Microsoft Outlook אם חסרות כותרות קריטיות. מערכת Google SecOps עדיין יוצרת התראה לגבי האימייל, אבל בלי אירוע שמבוסס על הקובץ המצורף. היומן הבא מציין את הבעיה הזו:

    Error Code 1: Encountered an email object with missing headers. Please
visit documentation portal for more details.

  2. שמות קבצים חסרים: כשמעבדים קובצי דואר מצורפים שאין להם שם קובץ בכותרות האימייל, המחבר מקצה שם קובץ ייחודי של placeholder: ‏Undefined_{UUID}.eml, כדי שהקובץ המצורף יופיע כאירוע ב-Google SecOps.

העברת פנייה באימייל

‫Google SecOps מתקשר עם שרת האימייל כדי לחפש אימיילים ולהטמיע אותם, ומעביר אותם לפלטפורמה לתרגום כמעט בזמן אמת ולהוספת הקשר כהתראות אבטחה.

כללי מחברים

  • המחבר משתמש ב-SSL/TLS כדי להבטיח תקשורת מוצפנת עם שרת האימייל.
  • המחבר תומך בחיבור לשרת הדואר באמצעות שרת proxy לתעבורת נתונים גם ב-IMAP וגם ב-IMAPS.
  • המחבר מאפשר לחפש אימיילים בכמה תיקיות של תיבות דואר. הפרמטר Folder מקבל רשימה של שמות תיקיות, מופרדים בפסיקים ותלויי אותיות רישיות.
  • המחבר תומך בקידוד Unicode, שמאפשר לו לעבד אימיילים שנשלחו בשפות שאינן אנגלית.

כניסות קלט של מחברים

כדי להשתמש במחבר הגנרי לאימייל IMAP, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Default Environment

זה שינוי אופציונלי.

שם הסביבה שאליה מוקצות ההתראות שנקלטו.
Run Every

זה שינוי אופציונלי.

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

ערך ברירת המחדל הוא 00:00:10:00 (10 דקות).
Product Field Name

חובה.

שם השדה שבו מאוחסן שם המוצר.

שם המוצר משפיע בעיקר על המיפוי. כדי לייעל ולשפר את תהליך המיפוי של המחבר, ערך ברירת המחדל הופך לערך חלופי שאליו מתייחס הקוד. כל קלט לא חוקי בפרמטר הזה יוחלף בערך חלופי כברירת מחדל.

ערך ברירת המחדל הוא Product Name.
Event Field Name

חובה.

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

ערך ברירת המחדל הוא event_name_mail_type.
Additional headers to extract from emails

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של שדות כותרת בהתאמה אישית שצריך לחלץ מהודעת האימייל במהלך העיבוד של המחבר.
Script Timeout (Seconds)

חובה.

מגבלת הזמן הקצוב לתפוגה, בשניות, של תהליך Python שמריץ את הסקריפט הנוכחי.

ערך ברירת המחדל הוא 60.
IMAP Server Address

חובה.

כתובת ה-IP או שם המארח של ה-DNS של שרת ה-IMAP שאליו רוצים להתחבר.

ערך ברירת המחדל הוא imap.gmail.com.
IMAP Port

חובה.

מספר היציאה שמשמשת לחיבור לשרת ה-IMAP.

ערך ברירת המחדל הוא 993.
Username

חובה.

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

ערך ברירת המחדל הוא username.
Password

חובה.

הסיסמה לתיבת הדואר שמשמשת למשיכת אימיילים.

ערך ברירת המחדל הוא 1.
Folder to check for emails

חובה.

רשימה מופרדת בפסיקים של תיקיות בתיבת הדואר שבהן המחבר מחפש אימיילים.

הפרמטר הזה תלוי אותיות רישיות.

ערך ברירת המחדל הוא Inbox.
Server Time Zone

זה שינוי אופציונלי.

אזור הזמן שמוגדר בשרת הדואר.

ערך ברירת המחדל הוא UTC.
Environment Regex Pattern

זה שינוי אופציונלי.

תבנית של ביטוי רגולרי שמשמשת לשינוי הנתונים בשדה האירוע ולחילוץ שם הסביבה.
IMAP USE SSL

זה שינוי אופציונלי.

אם האפשרות הזו נבחרת, המחבר משתמש ב-SSL/TLS כדי ליצור חיבור IMAP מאובטח לשרת הדואר.

מופעלת כברירת מחדל.
Unread Emails Only

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, המחבר שולף רק אימיילים שלא נקראו.

מופעלת כברירת מחדל.
Mark Emails as Read

זה שינוי אופציונלי.

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

מופעלת כברירת מחדל.
Attach Original EML

זה שינוי אופציונלי.

אם האפשרות הזו נבחרת, ההודעה המקורית מצורפת להתראה שנוצרה כקובץ ‎.eml.

מושבתת כברירת מחדל.
Regex expressions to handle forwarded emails

זה שינוי אופציונלי.

מחרוזת JSON בשורה אחת שמכילה תבניות של ביטויים רגולריים כדי לחלץ את השדות המקוריים של הנושא, השולח והנמען מאימיילים שהועברו.
Exclusion Body Regex

זה שינוי אופציונלי.

תבנית של ביטוי רגולרי שמשמשת להחרגת אימיילים מההטמעה אם התוכן של גוף האימייל תואם לתבנית, למשל ([N|n]ewsletter)|([O|o]ut of office).
Exclusion Subject Regex

זה שינוי אופציונלי.

תבנית של ביטוי רגולרי שמשמשת להחרגת אימיילים מהטמעה אם שורת הנושא תואמת לתבנית, למשל ([N|n]ewsletter)|([O|o]ut of office).
Offset Time In Days

חובה.

מספר הימים המקסימלי לאחור שהמחבר מאחזר מהם אימיילים (חלון הזמן המקסימלי).

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

ערך ברירת המחדל הוא 5.
Max Emails Per Cycle

חובה.

מספר האימיילים המקסימלי שהמחבר מעבד במחזור דגימה אחד.

ערך ברירת המחדל הוא 10.
Proxy Server Address

זה שינוי אופציונלי.

כתובת שרת ה-Proxy שבו רוצים להשתמש.
Proxy Username

זה שינוי אופציונלי.

שם המשתמש לאימות שרת ה-proxy.
Proxy Password

זה שינוי אופציונלי.

הסיסמה לאימות של שרת ה-proxy.
Create a Separate Siemplify Alert per Attached Mail File?

זה שינוי אופציונלי.

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

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

מושבתת כברירת מחדל.
Original Received Mail Prefix

זה שינוי אופציונלי.

קידומת (כמו orig) שנוספת למפתחות שחולצו (אל, מאת, נושא וכו') מהאימייל המקורי שהתקבל בתיבת הדואר שבמעקב.

ערך ברירת המחדל הוא orig.
Attached Mail File Prefix

זה שינוי אופציונלי.

קידומת (כמו attach) שנוספת למפתחות שחולצו (אל, מאת, נושא וכו') מקובצי דואר מצורפים שנמצאו באימייל.

ערך ברירת המחדל הוא attach.

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